ALTER DATASET ...ADD VERSION¶

将版本添加到数据集。添加版本时，可以指定分区、注释或自定义元数据等属性。

另请参阅：: ALTER DATASET、ALTER DATASET ...DROP VERSION

语法¶

ALTER DATASET <name> ADD VERSION <version_name>
  FROM <select_statement>
  [ PARTITION BY <string_expr> ]
  [ COMMENT = <string_literal> ]
  [ METADATA = <json_string_literal> ]

参数¶

name

您正在修改的数据集的名称。

ADD VERSION version_name

您正在创建的新数据集版本的名称。

FROM select_statement

定义新数据集版本数据的 SQL 语句。

PARTITION BY string_expr

新数据集版本的分区表达式。

COMMENT = string_literal

新数据集版本的注释。

METADATA = json_string_literal

包含新数据集版本元数据的 JSON 字符串。以下是 JSON 字符串的示例。

{"source": "my_table", "job_id": "123"}

访问控制要求¶

用于执行此操作的角色必须至少具有以下权限：


权限	对象	备注
OWNERSHIP	数据集	提供读取和修改数据集的权限。

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

示例¶

以下示例使用分区向 abc 数据集添加版本 v1：

ALTER DATASET abc
ADD VERSION 'v1' FROM (
    SELECT seq4() as ID, uniform(1, 10, random(721)) as PART
    FROM TABLE(GENERATOR(ROWCOUNT => 100000)) v)
PARTITION BY PART
COMMENT = 'Initial version'
METADATA = '{"source":"some_table","created_by":"analyst1"}';