ALTER-EXPERIMENT¶
Ändert die Eigenschaften eines vorhandenen Experiments.
- Siehe auch:
CREATE-EXPERIMENT, SHOW-EXPERIMENTS, DROP-EXPERIMENT, SHOW RUNS IN EXPERIMENT, SHOW RUN … IN EXPERIMENT
Syntax¶
ALTER EXPERIMENT <experiment_name> ADD RUN <run_name>
ALTER EXPERIMENT <experiment_name> COMMIT RUN <run_name>
ALTER EXPERIMENT <experiment_name> DROP RUN <run_name>
Parameter¶
experiment_nameGibt den Bezeichner für das zu ändernde Experiment an.
Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.
Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.
ADD RUN run_nameFügt eine neue Ausführung mit dem Bezeichner
run_namehinzu; muss für die Ausführungen im Experimentexperiment_nameeindeutig sein.Informationen darüber, wie Sie ein Experiment manuell durchführen, das in SQL ausgeführt wird, finden Sie unter Experimentausführung starten.
Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.
Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.
COMMIT RUN run_nameSchließt die Ausführung mit dem Bezeichner
run_namefür das Experimentexperiment_nameab. Bestätigte Ausführungen können nicht geändert werden.Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.
Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.
Informationen zum Abrufen der Ergebnisse und Artefakte einer Experimentausführung finden Sie unter Eine Ausführung abschließen.
DROP RUN run_nameLöscht die Ausführung mit dem Bezeichner
run_name.
Anforderungen an die Zugriffssteuerung¶
Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:
Berechtigung |
Objekt |
Anmerkungen |
|---|---|---|
MODIFY |
Experiment |
USAGE-Berechtigung für die übergeordnete Datenbank und das Schema ist erforderlich, um Operationen an einem beliebigen Objekt in einem Schema durchzuführen. Beachten Sie, dass eine Rolle, die eine beliebige Berechtigung für ein Schema erhalten hat, es dieser Rolle erlaubt, das Schema aufzulösen. Zum Beispiel kann eine Rolle, der die CREATE-Berechtigung für ein Schema gewährt wurde, Objekte in diesem Schema erstellen, ohne auch USAGE für dieses Schema gewährt bekommen zu haben.
Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.
Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.
Nutzungshinweise¶
Hinweis zu Metadaten:
Achtung
Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.
Beispiele¶
Im folgenden Beispiel wird eine neue Ausführung mit dem Namen run_1 im Experiment my_experiment erstellt:
ALTER EXPERIMENT my_experiment ADD RUN run_1;
Im folgenden Beispiel wird die Ausführung namens run_1 im Experiment my_experiment abgeschlossen und aufgezeichnet:
ALTER EXPERIMENT my_experiment COMMIT RUN run_1;