SET / UNSET / SHOW PROPERTIES

SET PROPERTIES
SET PROPERTIES
用于为数据对象(表、Schema、Workspace)设置持久化属性,属性写入元数据,永久生效直到被显式移除。

SET PROPERTIES

语法

ALTER TABLE [schema_name.]table_name SET PROPERTIES ('key1'='value1' [, 'key2'='value2' ...]); ALTER SCHEMA schema_name SET PROPERTIES ('key1'='value1' [, ...]); ALTER WORKSPACE workspace_name SET PROPERTIES ('key1'='value1' [, ...]);

示例

-- 为表设置压缩和自动刷新属性 ALTER TABLE sales_records SET PROPERTIES ('compression'='zstd', 'auto_refresh'='true'); -- 为 Schema 设置数据保留期 ALTER SCHEMA reporting SET PROPERTIES ('data_retention_days'='90'); -- 为 Workspace 设置属性 ALTER WORKSPACE analytics_ws SET PROPERTIES ('aa'='bb');

UNSET PROPERTIES

移除数据对象上已设置的属性,恢复为系统默认配置。

语法

ALTER TABLE [schema_name.]table_name UNSET PROPERTIES (key1 [, key2 ...]); ALTER SCHEMA schema_name UNSET PROPERTIES (key1 [, ...]); ALTER WORKSPACE workspace_name UNSET PROPERTIES (key1 [, ...]);

示例

-- 移除表的单个属性 ALTER TABLE sales_records UNSET PROPERTIES ('compression'); -- 同时移除多个属性 ALTER TABLE customer_feedback UNSET PROPERTIES ('auto_refresh', 'compression'); -- 移除 Schema 属性 ALTER SCHEMA reporting UNSET PROPERTIES ('data_retention_days');

SHOW PROPERTIES

查看数据对象当前设置的所有属性。

语法

SHOW PROPERTIES IN TABLE [schema_name.]table_name; SHOW PROPERTIES IN SCHEMA schema_name; SHOW PROPERTIES IN WORKSPACE workspace_name;

示例

SHOW PROPERTIES IN TABLE sales_data; SHOW PROPERTIES IN SCHEMA reporting; SHOW PROPERTIES IN WORKSPACE data_science;

返回格式

+------------------+----------------+ | property_key | property_value | +------------------+----------------+ | compression | zstd | | auto_refresh | true | +------------------+----------------+


表支持的属性

属性名说明取值范围
data_lifecycle
data_lifecycle
数据生命周期(天),-1 表示未开启正整数或 -1
data_retention_days
data_retention_days
Time Travel 保留期限,影响 UNDROP、TABLE STREAM、RESTORE0-90
cz.storage.write.max.string.bytes
cz.storage.write.max.string.bytes
STRING 类型最大写入长度,默认 16MB正整数(字节)
cz.storage.write.max.binary.bytes
cz.storage.write.max.binary.bytes
BINARY 类型最大写入长度,默认 16MB正整数(字节)
cz.storage.write.max.json.bytes
cz.storage.write.max.json.bytes
JSON 类型最大写入长度,默认 16MB正整数(字节)

示例:将 STRING 最大长度调整为 32MB

ALTER TABLE my_table SET PROPERTIES ("cz.storage.write.max.string.bytes"="33554432");


注意事项

  • 需要对应对象的
    ALTER
    ALTER
    权限
  • Workspace 级别属性修改通常约 1 分钟后生效
  • 可在一个命令中批量设置或移除多个属性

相关文档

联系我们
预约咨询
微信咨询
电话咨询