ALTER DATASET … ADD VERSION

Ajoute une version à un jeu de données. Lorsque vous ajoutez une version, vous pouvez spécifier des propriétés telles que la partition, les commentaires ou les métadonnées personnalisées.

Voir aussi :

ALTER DATASET, ALTER DATASET … DROP VERSION

Syntaxe

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

Paramètres

name

Le nom de l’ensemble de données que vous modifiez.

ADD VERSION version_name

Le nom de la nouvelle version du jeu de données que vous créez.

FROM select_statement

L’instruction SQL qui définit les données pour la nouvelle version du jeu de données.

PARTITION BY string_expr

L’expression de partitionnement pour la nouvelle version du jeu de données.

COMMENT = string_literal

Un commentaire pour la nouvelle version du jeu de données.

METADATA = json_string_literal

Une chaîne JSON contenant les métadonnées de la nouvelle version du jeu de données. Voici un exemple de chaîne JSON.

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

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

Remarques

OWNERSHIP

Jeu de données

Donne le privilège de lire et de modifier l’ensemble de données.

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Exemples

L’exemple suivant ajoute la version v1 à l’ensemble de données abc avec partitionnement :

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