ALTER EXPERIMENT¶

Syntaxe¶

ALTER EXPERIMENT <experiment_name> ADD RUN <run_name>

ALTER EXPERIMENT <experiment_name> COMMIT RUN <run_name>

ALTER EXPERIMENT <experiment_name> DROP RUN <run_name>

Paramètres¶

experiment_name

Spécifie l’identificateur de l’expérience à modifier.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

ADD RUN run_name

Ajoute une nouvelle exécution avec l’identificateur run_name ; doit être unique pour les exécutions dans l’expérience experiment_name.

Pour obtenir des informations sur la manière de réaliser manuellement une exécution d’expérience dans SQL, voir Démarrer une exécution d’expérience.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

COMMIT RUN run_name

Termine l’exécution avec l’identificateur run_name pour l’expérience experiment_name. Les exécutions validées ne peuvent pas être modifiées.

Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

Pour plus d’informations sur la manière de récupérer les résultats et les artefacts d’une exécution d’expérience, voir Terminer une exécution.

DROP RUN run_name

Supprime l’exécution avec l’identificateur run_name.

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 :

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. Notez qu’un rôle doté d’un privilège quelconque sur un schéma permet à ce rôle de résoudre le schéma. Par exemple, un rôle doté du privilège CREATE sur un schéma peut créer des objets sur ce schéma sans également avoir le privilège USAGE attribué sur ce 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.

Notes sur l’utilisation¶

• Concernant les métadonnées :

  Attention

  Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples¶

L’exemple suivant crée une nouvelle exécution nommée run_1 dans l’expérience my_experiment :

ALTER EXPERIMENT my_experiment ADD RUN run_1;

L’exemple suivant complète et enregistre l’exécution nommée run_1 dans l’expérience my_experiment :

ALTER EXPERIMENT my_experiment COMMIT RUN run_1;