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

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

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.

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

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