如何为BigQuery中的Materialized Views添加自定义列描述？

BigQuery支持直接为物化视图的列添加或修改描述，分两种场景操作：

创建物化视图时添加列描述 #

在列定义后通过OPTIONS(description='描述文本')指定，示例：

CREATE MATERIALIZED VIEW my_dataset.user_order_mv
OPTIONS (refresh_interval_minutes = 60)
AS
SELECT
  user_id OPTIONS(description='用户唯一标识ID') AS user_id,
  COUNT(*) OPTIONS(description='用户累计下单次数') AS total_orders
FROM my_dataset.orders
GROUP BY user_id;

给已存在的物化视图添加/修改列描述 #

用ALTER MATERIALIZED VIEW语句修改列的描述属性，示例：

-- 添加user_id列的描述
ALTER MATERIALIZED VIEW my_dataset.user_order_mv
ALTER COLUMN user_id
SET OPTIONS(description='用户系统唯一标识');

-- 更新total_orders列的描述
ALTER MATERIALIZED VIEW my_dataset.user_order_mv
ALTER COLUMN total_orders
SET OPTIONS(description='用户近90天下单次数');

验证描述是否生效 #

可以通过查询INFORMATION_SCHEMA确认：

SELECT column_name, description
FROM my_dataset.INFORMATION_SCHEMA.COLUMNS
WHERE table_name = 'user_order_mv';

权限要求 #

操作前确保你拥有该物化视图的ALTER权限（对应IAM权限bigquery.tables.update）。

内容的提问来源于stack exchange，提问作者Lura Andrasson