在 Go 中使用 cloud.google.com/go/bigquery 创建表时，bigquery.InferSchema 默认将非重复字段设为 REQUIRED 模式；若需支持 NULL 值，必须显式使用 bigquery.Null* 类型（如 NullString、NullInt64）并配合结构体标签控制模式。
在 go 中使用 `cloud.google.com/go/bigquery` 创建表时，`bigquery.inferschema` 默认将非重复字段设为 required 模式；若需支持 null 值，必须显式使用 `bigquery.null*` 类型（如 `nullstring`、`nullint64`）并配合结构体标签控制模式。
BigQuery 的字段空值语义与 Go 原生类型存在本质差异：Go 的 string、int 等零值（""、0）会被自动映射为 BigQuery 中的默认填充值，而非 SQL NULL。要真正实现字段可空（即 MODE = NULLABLE），不能依赖原生类型推断，而应改用 cloud.google.com/go/bigquery 提供的专用空值封装类型。
以下是正确做法：
✅ 正确声明可空字段的结构体
import "cloud.google.com/go/bigquery"
type Stats struct {
Name bigquery.NullString `bigquery:"name"`
LastName bigquery.NullInt64 `bigquery:"last_name"`
PhoneNumber bigquery.NullString `bigquery:"phone_number"`
}
⚠️ 注意：
bigquery.Null*类型是带Valid bool字段的结构体（例如NullString{String: "abc", Valid: true}），仅当Valid == true时才写入值；若Valid == false，则写入NULL。
✅ 构建并上传数据示例
rows := []*Stats{
{
Name: bigquery.NullString{String: "testA", Valid: true},
LastName: bigquery.NullInt64{Valid: false}, // ← 显式表示 NULL
PhoneNumber: bigquery.NullString{Valid: false}, // ← 不设置 String 字段，Valid 为 false 即 NULL
},
}
u := table.Uploader()
if err := u.Put(ctx, rows); err != nil {
log.Fatal(err)
}
此时生成的 schema 将自动识别为： | Field Name | Type | Mode | |----------------|---------|-----------| | name | STRING | NULLABLE | | last_name | INT64 | NULLABLE | | phone_number | STRING | NULLABLE |
? 补充说明与最佳实践
-
无需手动指定
bigquery:"field,nullable"标签：InferSchema会自动根据字段类型（Null*）推断MODE = NULLABLE；添加,nullable标签无效且不被推荐。 - *避免混用原生类型与 Null 类型**：同一结构体中若部分字段用
string、部分用NullString，会导致模式不一致，可能引发运行时错误或意外填充。 -
JSON 反序列化友好：
Null*类型支持标准 JSON 解析（null→Valid=false，字符串/数字 →Valid=true），适合 API 接收动态字段。 -
性能提示：
Null*类型无显著性能开销，是 Google 官方推荐的标准方式。
通过统一采用 bigquery.Null* 类型建模，即可确保 BigQuery 表结构符合预期，并在数据写入时精确区分 NULL 与默认零值，从根本上解决空字段被误写为 "" 或 0 的问题。
