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>
Copy

Parameter

experiment_name

Gibt 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_name

Fügt eine neue Ausführung mit dem Bezeichner run_name hinzu; muss für die Ausführungen im Experiment experiment_name eindeutig 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_name

Schließt die Ausführung mit dem Bezeichner run_name für das Experiment experiment_name ab. 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_name

Lö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;
Copy

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;
Copy