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 :
Syntaxe¶
ALTER DATASET <name> ADD VERSION <version_name>
FROM <select_statement>
[ PARTITION BY <string_expr> ]
[ COMMENT = <string_literal> ]
[ METADATA = <json_string_literal> ]
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"}
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"}';