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