Go database/sql ColumnType.DecimalSize 怎样读取 DECIMAL 精度和小数位

如果你要根据查询结果动态生成表头、导出字段说明或拼装数据字典，只有列名还不够：DECIMAL 列的总精度和小数位也会影响展示与后续处理。Go 的 database/sql 可以先通过 Rows.ColumnTypes() 拿到列描述，再调用每个 ColumnType 的 DecimalSize()。

DecimalSize() 返回 precision、scale 和 ok。ok=true 才表示当前驱动提供了可用的 DECIMAL 精度信息；ok=false 应当作为“元数据不可用或不适用”处理，而不是把它当成查询失败。

官方文档：https://pkg.go.dev/database/sql#ColumnType.DecimalSize

先把列值和列元数据分开

Rows.Scan 面向的是当前行的值，Rows.ColumnTypes 面向的是结果集的列描述。两者解决的问题不同：前者回答“这一行有什么值”，后者回答“结果集有哪些列、列名是什么、数据库类型和可扫描类型是什么”。

因此，读取 DECIMAL 的精度时，不需要先调用 Next，也不需要为了观察列定义而扫描一行。可以把列元数据看成查询结果旁边的一张说明卡：

DecimalSize 的三个返回值分别表示什么

方法签名可以概括为：

precision, scale, ok := columnType.DecimalSize()

其中：

这里最容易误读的是 ok。文档的语义是：如果当前类型不适用，或者驱动没有提供这项信息，ok 会是 false。这时 precision 和 scale 的数值不应被当成真实的零值来解释。

用 ColumnTypes 读取 DECIMAL 元数据

下面的函数只负责读取列定义，不连接具体数据库驱动。它把“拿不到元数据”和“拿到元数据”分成两条路径，调用方可以据此决定是否继续导出。

package decimalmeta

import (
    "database/sql"
    "fmt"
)

// ReadDecimalMeta 读取查询结果中的 DECIMAL 精度信息。
// 它不扫描行值，只处理结果集的列元数据。
func ReadDecimalMeta(rows *sql.Rows) error {
    columnTypes, err := rows.ColumnTypes()
    if err != nil {
        // 列元数据获取失败时保留原始错误，方便上层决定是否降级。
        return fmt.Errorf("读取列元数据: %w", err)
    }

    for _, columnType := range columnTypes {
        precision, scale, ok := columnType.DecimalSize()
        if !ok {
            // ok=false 表示信息不可用或不适用，不能把 0 当成真实精度。
            fmt.Printf("%s: DECIMAL 元数据不可用\n", columnType.Name())
            continue
        }

        // precision 是总位数，scale 是小数位数。
        fmt.Printf("%s: precision=%d scale=%d\n",
            columnType.Name(), precision, scale)
    }
    return nil
}

这个示例有两个关键点。第一，ColumnTypes 本身返回的是列描述切片，真正的精度读取发生在每个 ColumnType 上。第二，函数没有把 ok=false 包装成错误，因为查询可能是成功的，只是驱动没有暴露完整的列元数据。

把 DecimalSize 放进完整的列描述

动态导出通常还需要列名、数据库类型名和可扫描类型。可以把这些信息集中到一个结构中，避免在多个分支里重复访问 ColumnType：

type ColumnMeta struct {
    Name          string
    DatabaseType  string
    ScanType      string
    Precision     int64
    Scale         int64
    HasDecimalSize bool
}

// DescribeColumn 将 database/sql 的列描述转换成导出层使用的结构。
func DescribeColumn(columnType *sql.ColumnType) ColumnMeta {
    precision, scale, ok := columnType.DecimalSize()

    // ScanType 可能为 nil，因此先转成可安全展示的字符串。
    scanType := ""
    if valueType := columnType.ScanType(); valueType != nil {
        scanType = valueType.String()
    }

    return ColumnMeta{
        Name:           columnType.Name(),
        DatabaseType:   columnType.DatabaseTypeName(),
        ScanType:       scanType,
        Precision:      precision,
        Scale:          scale,
        HasDecimalSize: ok,
    }
}

HasDecimalSize 这个字段比直接暴露两个数字更重要。下游在生成表头、JSON 元数据或导出配置时，可以明确区分“值为零”和“没有可用信息”。如果业务必须知道精度，应该在 HasDecimalSize=false 时返回可读错误；如果业务只是尽量展示，则可以保留其他列信息并把精度字段留空。

别把 ok=false 当成查询失败

DecimalSize 只描述列类型元数据，不负责判断 SQL 是否执行成功。下面三种情况需要分开理解：

• 查询失败：QueryContext 或 ColumnTypes 返回了错误，应该按错误路径处理。
• 查询成功但元数据缺失：ColumnTypes 成功，某个列的 DecimalSize 返回 ok=false，可以降级或记录原因。
• 列不是适用的十进制类型：同一个结果集可能同时包含整数、文本和 DECIMAL，不能要求每列都有 precision 与 scale。

因此，调用层最好把状态设计成“元数据错误”和“元数据不可用”两个分支，不要用 precision == 0 作为唯一判断条件。不同驱动的能力也可能不同，真正需要兼容多个数据库时，应把 ok 作为接口契约的一部分。

什么时候值得读取 DecimalSize

可以把采用原则压缩成一句话：需要“描述查询结果长什么样”时读取 DecimalSize，需要“保证业务数值正确”时仍要在业务层明确类型、舍入和校验规则。

常见问题

DecimalSize 返回的 precision 是小数点前的位数吗？

不是。precision 表示总精度，scale 表示小数位数。若要估算整数部分的位数，通常需要结合二者理解，但最终展示规则仍应服从具体数据库和业务约束。

ok=false 时应该把 precision 和 scale 清零吗？

不应该把它们当作有意义的零值。可以在导出结构中保留数字字段，但必须同时保留一个布尔字段或可选状态，让下游知道这两个数字不可用。

读取 DecimalSize 前需要先调用 Rows.Next 吗？

不需要。DecimalSize 读取的是 ColumnType 元数据，先通过 ColumnTypes 获取列描述即可；只有读取具体行值时才需要按 Rows 的遍历规则调用 Next 和 Scan。

掌握 ColumnTypes 与 DecimalSize 的分工后，动态结果集就可以同时表达列名、数据库类型和 DECIMAL 精度，而不会把“没有元数据”误判为“精度为零”。