ALTER DATASET … ADD VERSION¶

Adiciona uma versão a um conjunto de dados. Ao adicionar uma versão, você pode especificar propriedades como particionamento, comentários ou metadados personalizados.

Consulte também:: ALTER DATASET , ALTER DATASET … DROP VERSION

Sintaxe¶

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

Parâmetros¶

name

O nome do conjunto de dados que você está alterando.

ADD VERSION version_name

O nome da nova versão do conjunto de dados que você está criando.

FROM select_statement

A instrução SQL que define os dados para a nova versão do conjunto de dados.

PARTITION BY string_expr

A expressão de particionamento para a nova versão do conjunto de dados.

COMMENT = string_literal

Um comentário para a nova versão do conjunto de dados.

METADATA = json_string_literal

Uma cadeia de caracteres JSON contendo metadados para a nova versão do conjunto de dados. A seguir, um exemplo de uma cadeia de caracteres JSON.

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

Requisitos de controle de acesso¶

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:


Privilégio	Objeto	Notas
OWNERSHIP	Conjunto de dados	Fornece o privilégio de ler e modificar o conjunto de dados.

A operação em um objeto de esquema requer pelo menos um privilégio no banco de dados pai e um privilégio no esquema pai.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Exemplos¶

O exemplo a seguir adiciona a versão v1 ao conjunto de dados abc com particionamento:

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