本文详解如何在 Go 中使用 Google Cloud BigQuery 客户端库定义支持 NULL 值的表结构，解决 InferSchema 默认将所有非重复字段设为 REQUIRED 导致空值被写为默认零值的问题。
本文详解如何在 go 中使用 google cloud bigquery 客户端库定义支持 null 值的表结构，解决 `inferschema` 默认将所有非重复字段设为 required 导致空值被写为默认零值的问题。
在 BigQuery 中，字段的“可空性”（NULLABLE）是 Schema 的核心属性之一，直接影响数据写入行为。默认情况下，Go SDK 的 bigquery.InferSchema() 会将所有非重复（non-repeated）、非指针基础类型字段（如 string, int, bool）推断为 REQUIRED 模式——这意味着即使结构体字段未赋值，BigQuery 也会用类型的零值（如 ""、0、false）填充，而非 NULL。
要真正支持 NULL，必须显式使用 BigQuery 提供的可空封装类型（nullable wrapper types），它们均位于 cloud.google.com/go/bigquery 包中，包括：
-
bigquery.NullString -
bigquery.NullInt64 -
bigquery.NullFloat64 -
bigquery.NullBool -
bigquery.NullTimestamp -
bigquery.NullDate -
bigquery.NullTime bigquery.NullDateTime
这些类型内部包含一个 Value 字段和一个 Valid 布尔标志。仅当 Valid == true 时，Value 才被写入；否则写入 NULL。
✅ 正确示例：将原始结构体改造为支持 NULL 的版本：
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.InferSchema(Stats{}) 将自动推断出三个字段均为 NULLABLE 模式（即 Required: false），无需额外配置标签。
写入时，需显式设置 Valid 字段控制是否写入 NULL：
rows := []*Stats{
{
Name: bigquery.NullString{Value: "testA", Valid: true},
LastName: bigquery.NullInt64{Valid: false}, // → 写入 NULL
PhoneNumber: bigquery.NullString{Valid: false}, // → 写入 NULL
},
}
u := table.Uploader()
if err := u.Put(ctx, rows); err != nil {
log.Fatal(err)
}⚠️ 注意事项：
- 不要混用基础类型与
Null*类型：例如int和NullInt64在同一结构体中会导致 Schema 推断不一致； -
Null*类型的零值（如bigquery.NullString{}）默认Valid == false，因此未显式初始化即等价于NULL，但显式赋值更清晰、可读性更强； - 若需兼容 JSON 反序列化（如 API 请求体），可为
Null*字段实现json.Unmarshaler，或改用指针类型（如*string）配合自定义 Schema —— 但Null*是官方推荐且语义最明确的方式； -
InferSchema对切片（[]T）和嵌套结构体同样适用，其REPEATED和RECORD模式推断逻辑保持不变。
总结：BigQuery Go SDK 中实现字段可空性的标准且可靠方式，是*统一使用 `bigquery.Null封装类型替代原生基础类型**，并依赖Valid` 字段精确控制 NULL 行为。这不仅确保 Schema 正确，也使业务逻辑中对“缺失值”的表达更加严谨和无歧义。
