BigQuery 不支持通过点号路径（如 "geo_location.City.Names.en"）直接设置嵌套字段值；必须构建与表 Schema 严格匹配的嵌套 JSON 对象结构，否则字段将被忽略或写入失败。
bigquery 不支持通过点号路径（如 `"geo_location.city.names.en"`）直接设置嵌套字段值；必须构建与表 schema 严格匹配的嵌套 json 对象结构，否则字段将被忽略或写入失败。
在 Google BigQuery 中向包含嵌套（RECORD）和重复（REPEATED）字段的表插入数据时，关键在于：JSON 表示必须精确反映表 Schema 的层级结构，而非使用扁平化的点号键名。你遇到的问题——jsonRow["geo_location.City.Names.en"] = ... 未生效——正是因为该写法在底层生成的是一个非法键名的扁平对象：
{
"geo_location.City.Names.en": "Irvine"
}
而 BigQuery 期望的是符合 RECORD 类型定义的嵌套对象：
{
"geo_location": {
"City": {
"Names": {
"en": "Irvine"
}
}
}
}
✅ 正确做法：逐层构造嵌套 JsonObject
假设你的表 schema 定义如下（含多层嵌套）：
geo_location: RECORD, REQUIRED
City: RECORD, NULLABLE
Names: RECORD, NULLABLE
en: STRING, NULLABLE
zh: STRING, NULLABLE
则 Go 代码应使用 bigquery.JsonObject 显式构建层级：
// 创建顶层嵌套对象
geo := bigquery.JsonObject{}
city := bigquery.JsonObject{}
names := bigquery.JsonObject{}
// 设置最内层字段
names["en"] = bigquery.JsonValue("Irvine")
names["zh"] = bigquery.JsonValue("尔湾")
// 组装层级
city["Names"] = names
geo["City"] = city
// 将完整嵌套结构挂载到行数据
jsonRow["geo_location"] = geo
// 其他字段（如顶层字符串）
jsonRow["name"] = bigquery.JsonValue("Name")
⚠️ 注意事项：
- bigquery.JsonObject 是 map[string]bigquery.JsonValue 的别名，不可用 map[string]interface{} 替代，否则序列化会失败；
- 所有中间 RECORD 字段（如 City, Names）都必须显式初始化为 bigquery.JsonObject{}，空值需设为 nil（对应 NULL）；
- 若字段为 REPEATED（数组），则需使用 []bigquery.JsonValue，例如：geo["tags"] = []bigquery.JsonValue{bigquery.JsonValue("web"), bigquery.JsonValue("mobile")}；
- 建议开启 IgnoreUnknownValues: true 仅作兜底，不能替代 Schema 对齐——未知字段会被丢弃，但类型/结构不匹配仍会导致插入静默失败或部分字段为空。
✅ 验证技巧
插入前可打印序列化结果辅助调试：
data, _ := json.Marshal(jsonRow)
log.Printf("Inserting row: %s", string(data))
确保输出结构与 BigQuery JSON 加载规范 完全一致。
掌握嵌套对象的构造逻辑，是高效、可靠地将复杂结构化数据写入 BigQuery 的核心前提。
