ALTER ORGANIZATION PROFILE¶

Syntax¶

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER ORGANIZATION PROFILE [ IF EXISTS ] <name> PUBLISH

ALTER ORGANIZATION PROFILE <name> ADD VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM @<yaml_manifest_stage_location>

ALTER ORGANIZATION PROFILE <name> ADD LIVE VERSION [ [ IF NOT EXISTS ] <version_alias_name> ]
  FROM LAST

ALTER ORGANIZATION PROFILE <name> COMMIT

ALTER ORGANIZATION PROFILE <name> ABORT

Parameter¶

name

Gibt den Bezeichner (Namen) für das zu ändernde Organisationsprofil an. Namen von Organisationsprofilen dürfen nur Großbuchstaben oder Zahlen enthalten und müssen mit einem Großbuchstaben beginnen.

RENAME TO new_name

Ändert den Namen des Organisationsprofils in new_name. Der neue Bezeichner muss innerhalb der aktuellen Organisation eindeutig sein. Der Bezeichner muss den Anforderungen für Snowflake-Bezeichner entsprechen. Siehe Anforderungen an Bezeichner. Außerdem dürfen die Namen von Organisationsprofilen nur Großbuchstaben oder Zahlen enthalten und müssen mit einem Großbuchstaben beginnen.

Bemerkung

Ein Organisationsprofil mit demselben Namen darf nicht bereits in der Organisation vorhanden sein, sonst gibt die Anweisung einen Fehler zurück.

PUBLISH

Macht ein zuvor nicht auffindbares Organisationsprofil auffindbar.

ADD VERSION [ [ IF NOT EXISTS ] version_alias_name ]

Gibt den eindeutigen Bezeichner der Version an, die hinzugefügt wird. Wenn version_alias_name nicht angegeben wird, wird kein Alias erstellt. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss der gesamte Bezeichner in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelten Anführungszeichen eingeschlossen sind, wird ebenfalls zwischen Groß- und Kleinschreibung unterschieden. Die Schlüsselwörter FIRST, LAST, DEFAULT und LIVE sind als Versionskürzel reserviert und können nicht verwendet werden. Der eindeutige Bezeichner für die Version darf nicht mit „version$“ beginnen und keine Schrägstriche ( / ) enthalten. Informationen zur Syntax von Bezeichnern finden Sie unter Anforderungen an Bezeichner.

ADD LIVE VERSION [ [ IF NOT EXISTS ] version_alias_name ]

Fügt eine neue bearbeitbare Live-Version mit dem angegebenen Namen aus der zuletzt übertragenen Version hinzu. version_alias_name ist optional. Wenn er nicht angegeben wird, wird kein Alias erstellt. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss der gesamte Bezeichner in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelten Anführungszeichen eingeschlossen sind, wird ebenfalls zwischen Groß- und Kleinschreibung unterschieden. Die Schlüsselwörter FIRST, LAST, DEFAULT und LIVE sind als Versionskürzel reserviert und können nicht verwendet werden. Der eindeutige Bezeichner für die Version darf nicht mit „version$“ beginnen und keine Schrägstriche ( / ) enthalten. Informationen zur Syntax von Bezeichnern finden Sie unter Anforderungen an Bezeichner.

Änderungen, die an den Dateien in einer Live-Version vorgenommen werden, werden erst dann in das Organisationsprofil übernommen, wenn die Live-Version übertragen wird. Die Eigenschaften eines Organisationsprofils bleiben unverändert, bis die Live-Version übertragen wird.

FROM 'yaml_manifest_stage_location'

Gibt den externen Stagingbereich, den internen Stagingbereich oder den Stagingbereich-Standort des Manifests im YAML-Format für den Snowflake-Git-Repository-Klon an.

COMMIT

Übernimmt die Änderungen im Organisationsprofil. Die Live-Version, die übertragen wird, muss eine gültige Organisationsprofil-Manifestdatei enthalten.

ABORT

Verwirft die Änderungen im Organisationsprofil.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen 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¶

• Organisationsprofile können nur umbenannt werden, wenn sie sich im Entwurfsstatus befinden.

• Wenn Sie die Live-Version des Manifests im YAML-Format für ein Organisationsprofil einstellen, müssen Sie COMMIT verwenden, um die Änderungen zu übernehmen, oder ABORT, um die Änderungen zu verwerfen. Ein Organisationsprofil kann immer nur eine Live-Version haben.

Beispiele¶

Ändern Sie das Organisationsprofil MYORGPROFILE, um eine aktualisierte Manifestdatei zu verwenden:

ALTER ORGANIZATION PROFILE MYORGPROFILE ADD VERSION V2 FROM @STAGE_PATH_WITH_UPDATED_MANIFEST;

Veröffentlichen Sie das Organisationsprofil MYORGPROFILE:

ALTER ORGANIZATION PROFILE MYORGPROFILE PUBLISH;