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 :

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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;