如何以编程方式在BigQuery表中添加字段描述

Question

我想以编程方式在bq表中添加字段描述 ，我知道如何在UI中进行操作。 我有这个要求，因为我的数据集中每天都有几张表被刷新，并且我们使用“ writeMode”：“ WRITE_TRUNCATE” 。 这也将删除表中所有字段名称的描述。

我还在表的架构文件中添加了描述，如下所示

                    {
                            "name" : "tax",
                            "type" : "FLOAT",
                            "description" : "Tax amount customer paid"
                    }

但是运行脚本加载数据后，我在最终表中看不到描述。

Answer 1

某些Tables API（ https://cloud.google.com/bigquery/docs/reference/v2/tables ）允许您设置表和架构的字段描述

您可以在
表格创建-https : //cloud.google.com/bigquery/docs/reference/v2/tables/insert
或使用以下API之一创建的表格之后：
补丁-https : //cloud.google.com/bigquery/docs/reference/v2/tables/patch
或更新-https : //cloud.google.com/bigquery/docs/reference/v2/tables/update

我认为，在您的情况下，Patch API更合适
下面的链接显示了您可以使用这些API设置的表格资源https://cloud.google.com/bigquery/docs/reference/v2/tables#resource

Answer 2

BigQuery加载作业接受在每个字段中包含“描述”的架构。

https://cloud.google.com/bigquery/docs/reference/v2/jobs#configuration.load

如果在WRITE_TRUNCATE操作期间指定描述以及要创建的每个字段，则应将描述应用于目标表。

这是上面链接的摘录，其中包含您指定的架构：

"load": {
  "sourceUris": [
    string
  ],
  "schema": {
    "fields": [
      {
        "name": string,
        "type": string,
        "mode": string,
        "fields": [
          (TableFieldSchema)
        ],
        "description": string
      }
    ]
  },