在 BigQuery 中向嵌套（RECORD）字段插入数据时，不能使用点号路径（如 "geo_location.City.Names.en"）直接赋值，而必须构建与表 Schema 完全匹配的嵌套 JSON 对象结构。
在 bigquery 中向嵌套（record）字段插入数据时，不能使用点号路径（如 `"geo_location.city.names.en"`）直接赋值，而必须构建与表 schema 完全匹配的嵌套 json 对象结构。
Google BigQuery 的 TableData.InsertAll API 要求传入的 Json 字段必须是语义正确的嵌套对象，而非扁平化的键路径字符串。当你写 jsonRow["geo_location.City.Names.en"] = ... 时，Go SDK 并不会自动解析并创建多层嵌套结构，而是将整个字符串 "geo_location.City.Names.en" 视为一个字面键名，最终生成非法的扁平 JSON：
{
"geo_location.City.Names.en": "Irvine"
}
这与 BigQuery 表中定义的 RECORD 类型字段（如 geo_location 是 RECORD，其下 City 是 RECORD，Names 是 RECORD，en 是 STRING）不兼容，导致插入失败或字段被忽略（即使启用了 IgnoreUnknownValues = true）。
✅ 正确做法：逐层构造嵌套 map[string]interface{} 或使用 SDK 提供的类型安全对象（如 bigquery.JsonObject），确保结构与 Schema 严格一致。
以下为推荐的 Go 实现方式（假设使用 google.golang.org/api/bigquery/v2）：
帮助用户满足已验证的需求：代理用户在Clawhub上对Gog式工作流有强烈需求，需要实际帮助修复bug、强化设置等。
// 构建嵌套结构：geo_location → City → Names → en
geo := make(map[string]interface{})
city := make(map[string]interface{})
names := make(map[string]interface{})
names["en"] = "Irvine"
city["Names"] = names
geo["City"] = city
jsonRow["geo_location"] = geo
// 注意：不要设置 jsonRow["name"] = ... 等其他字段时覆盖已构建结构
若使用 bigquery.JsonObject（部分 SDK 版本支持），可更清晰地表达层级：
jsonRow["geo_location"] = &bigquery.JsonObject{
Properties: map[string]*bigquery.JsonValue{
"City": {
Value: &bigquery.JsonObject{
Properties: map[string]*bigquery.JsonValue{
"Names": {
Value: &bigquery.JsonObject{
Properties: map[string]*bigquery.JsonValue{
"en": {Value: "Irvine"},
},
},
},
},
},
},
},
}
⚠️ 注意事项：
- Schema 必须提前定义：确保目标表的 geo_location 字段类型为 RECORD（STRUCT），且子字段（City, Names, en）的类型、是否可为空（mode: NULLABLE/REQUIRED/REPEATED）与插入数据完全一致；
- 避免空层缺失：若 City 为 REQUIRED，则不可省略；若为 NULLABLE 且未提供，应显式设为 nil；
- 重复字段（ARRAY）需用 slice：如 geo_location.Addresses 是 REPEATED RECORD，则应赋值为 []map[string]interface{...}；
- 调试建议：本地打印 jsonRow 并 json.MarshalIndent 验证结构，或先用 bq insert CLI + JSON 文件验证 Schema 兼容性。
总结：BigQuery 不支持“路径式键名”语法插入嵌套字段。务必以编程方式构建嵌套 map 或 JsonObject，使其 JSON 序列化结果与 Schema 的嵌套层次完全对齐——这是成功写入嵌套/重复字段的唯一可靠方式。
