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

访问控制要求

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

权限

对象

备注

OWNERSHIP

数据集

提供读取和修改数据集的权限。

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

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

有关对 安全对象 执行 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"}';
Copy
语言: 中文