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> ]

Copy

参数¶

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"}

Copy

访问控制要求¶

A role used to execute this operation must have the following privileges at a minimum:

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

The USAGE privilege on the parent database and schema are required to perform operations on any object in a schema.

For instructions on creating a custom role with a specified set of privileges, see 创建自定义角色.

For general information about roles and privilege grants for performing SQL actions on securable objects, see 访问控制概述.

示例¶

以下示例使用分区向 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"}';

Copy