ALTER ACCOUNT¶

Syntax¶

Die Syntax für ALTER ACCOUNT variiert je nachdem, ob Sie das aktuelle Konto oder ein anderes Konto ändern.

ALTER ACCOUNT SET { [ accountParams ] [ objectParams ] [ sessionParams ] }

ALTER ACCOUNT UNSET <param_name> [ , ... ]

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

ALTER ACCOUNT SET { AUTHENTICATION | PASSWORD | SESSION } POLICY <policy_name>

ALTER ACCOUNT UNSET { AUTHENTICATION | PASSWORD | SESSION } POLICY

ALTER ACCOUNT SET PACKAGES POLICY <policy_name> [ FORCE ]

ALTER ACCOUNT UNSET { PACKAGES | PASSWORD | SESSION } POLICY

ALTER ACCOUNT SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER ACCOUNT UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER ACCOUNT <name> SET IS_ORG_ADMIN = { TRUE | FALSE }

ALTER ACCOUNT <name> RENAME TO <new_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]

ALTER ACCOUNT <name> DROP OLD URL

ALTER ACCOUNT <name> DROP OLD ORGANIZATION URL

Parameter für das Ändern des aktuellen Kontos¶

Verwenden Sie die folgenden Parameter, wenn Sie das aktuelle Konto ändern.

SET ...

Gibt einen (oder mehrere) Konto-, Sitzungs- und/oder Objektparameter an, die für Ihr Konto festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder neue Zeilen):

• Die Kontoparameter können von anderen Benutzern nicht geändert werden.

• Die auf Kontoebene eingestellten Sitzungs- und Objektparameter dienen nur als Voreinstellung und können von anderen Benutzern geändert werden.

Beschreibungen der Parameter, die Sie für Ihr Konto festlegen können, finden Sie unter Parameter.

UNSET ...

Gibt einen (oder mehrere) Konto-, Sitzungs- und/oder Objektparameter an, die für Ihr Konto gelöscht werden sollen, wodurch sie auf die Standardwerte des Systems zurückgesetzt werden.

Sie können mehrere Eigenschaften mit einer einzigen ALTER-Anweisung zurücksetzen; jede Eigenschaft muss jedoch durch ein Komma getrennt werden. Wenn Sie eine Eigenschaft zurücksetzen, geben Sie nur den Namen an. Die Angabe eines Wertes für die Eigenschaft gibt einen Fehler zurück.

SET RESOURCE_MONITOR resource_monitor_name

Spezieller Parameter auf Kontoebene, der den Namen des Ressourcenmonitors angibt, der zur Steuerung aller im Konto erstellten virtuellen Warehouses verwendet wird.

Wichtig

Das Festlegen eines Ressourcenmonitors auf Kontoebene wirkt sich nicht auf die von Snowflake bereitgestellten Warehouses aus, die Snowflake für Snowpipe, automatisches Reclustering oder materialisierte Ansichten verwendet. Die von diesen Warehouses verbrauchten Credits werden nicht auf das Credit-Kontingent für einen Ressourcenmonitor auf Kontoebene angerechnet.

Weitere Details dazu finden Sie unter Verwenden von Ressourcenmonitoren.

SET { AUTHENTICATION | PASSWORD | SESSION } POLICY policy_name

Gibt eine der folgenden Richtlinien für das Konto an:

• Authentifizierungsrichtlinie

• Kennwortrichtlinie

• Sitzungsrichtlinie

SET PACKAGES POLICY policy_name [ FORCE ]

Gibt die Paketrichtlinie an, die für das Konto festgelegt werden soll. Wenn für das aktuelle Konto bereits eine Paketrichtlinie festgelegt ist, können Sie FORCE verwenden, um die Paketrichtlinie festzulegen, ohne die bisherige Paketrichtlinie aufheben zu müssen.

UNSET { PACKAGES | PASSWORD | SESSION } POLICY

Hebt die Paketrichtlinie, die Kennwortrichtlinie oder die Sitzungsrichtlinien für das Konto auf.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingente für Objekte und Spalten.

Parameter zum Ändern eines anderen Kontos¶

Verwenden Sie die folgenden Parameter, wenn Sie das aktuelle Konto verwenden, um ein anderes Konto zu ändern. Nur Organisationsadministratoren (d. h. Benutzer mit der Rolle ORGADMIN) können diese Parameter verwenden.

name

Gibt den Namen des Kontos an, das geändert werden soll.

SET

Gibt eine Kontoeigenschaft an, die für das Konto festgelegt werden soll.

IS_ORG_ADMIN = { TRUE | FALSE }

Legt eine Kontoeigenschaft fest, die bestimmt, ob die Rolle ORGADMIN in dem Konto aktiviert ist. Nur ein Organisationsadministrator (d. h. ein Benutzer mit der Rolle ORGADMIN) kann diese Eigenschaft festlegen.

Um die Rolle ORGADMIN für ein Konto zu aktivieren, geben Sie SET IS_ORG_ADMIN = TRUE an.

Sie können die Eigenschaft nicht vom aktuellen Konto aus auf FALSE einstellen. Als Problemumgehung aktivieren Sie die Rolle in einem anderen Konto und wechseln dann zu diesem Konto, bevor Sie den Befehl ALTER ACCOUNT ausführen.

In der Standardeinstellung kann die ORGADMIN-Rolle in maximal 8 Konten aktiviert werden. Wenn Ihre Organisation weitere Konten mit der Rolle ORGADMIN benötigt, wenden Sie sich an den Snowflake-Support.

RENAME TO new_name

Ändert den Namen eines Kontos in den angegebenen Namen.

Organisationsadministratoren können ein Konto nicht umbenennen, während sie bei diesem Konto angemeldet sind. Sie müssen sich also erst bei einem anderen Konto anmelden, bevor sie den ALTER ACCOUNT-Befehl ausführen können. Wenn Ihre Organisation aus einem einzigen Konto besteht, das umbenannt werden muss, wenden Sie sich an den Snowflake-Support.

SAVE_OLD_URL = { TRUE | FALSE }

Optionaler Parameter, der in Verbindung mit RENAME TO verwendet wird und die Konto-URL beibehält, die vor der Umbenennung für den Zugriff auf Snowflake verwendet wurde. Standardmäßig speichert Snowflake die ursprünglichen URL, d. h. Sie können auf das Konto entweder mit der alten URL oder mit der URL zugreifen, die den neuen Kontonamen enthält. Wenn diese Option auf FALSE gesetzt ist, müssen Sie die neue URL verwenden, um auf das Konto zuzugreifen.

Standard:

TRUE

DROP OLD URL

Entfernt die ursprüngliche Konto-URL eines Kontos, das umbenannt wurde. Sobald die alte URL gelöscht ist, müssen Sie auf das Konto mit der URL zugreifen, die den neuen Kontonamen enthält.

Wenn ein Konto eine alte Konto-URL hat, weil es in eine andere Organisation verschoben wurde, seine Organisation umbenannt wurde oder Teil einer Organisation war, die fusioniert wurde, verwenden Sie stattdessen die ALTER ACCOUNT … DROP OLD ORGANIZATION URL.

DROP OLD ORGANIZATION URL

Entfernt die ursprüngliche Konto-URL eines Kontos, wenn eine der folgenden Bedingungen eintritt:

• Konto wurde zu einer anderen Organisation verschoben

• Die Organisation des Kontos wurde umbenannt.

• Das Konto gehörte zu einer Organisation, die mit einer anderen Organisation fusioniert wurde.

Wenn ein Konto eine alte Konto-URL hat, weil das Konto, nicht die Organisation, umbenannt wurde, verwenden Sie stattdessen den Befehl ALTER ACCOUNT … DROP OLD URL.

Nutzungshinweise¶

• Die Kontoparameter können nur auf Kontoebene eingestellt werden.

• Sitzungs- und Objektparameter, die mit diesem Befehl eingestellt werden, dienen nur als Voreinstellung:

  • Benutzerparameter können auf individueller Benutzerebene überschrieben werden.

  • Sitzungsparameter können auf Benutzer- und Sitzungsebene überschrieben werden.

  • Objektparameter können auf der Ebene der einzelnen Objekte überschrieben werden.

• Durch das Festlegen eines Ressourcenmonitors auf der Kontoebene wird die Credit-Nutzung für alle im Konto erstellten virtuellen Warehouses gesteuert; die Credit-Nutzung für die von Snowflake bereitgestellten Warehouses wird jedoch nicht beeinflusst. Weitere Details dazu finden Sie unter Verwenden von Ressourcenmonitoren.

• Metadaten:

  Achtung

  Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Beispiele¶

Ordnen Sie Ihrem Konto eine Netzwerkrichtlinie mit dem Namen mypolicy zu:

ALTER ACCOUNT SET NETWORK_POLICY = mypolicy;

Copy

Entfernen Sie die Zuordnung der Netzwerkrichtlinien von Ihrem Konto:

ALTER ACCOUNT UNSET NETWORK_POLICY;

Copy

Legen Sie die Paketrichtlinie auf Kontoebene fest.

ALTER ACCOUNT SET PACKAGES POLICY packages_policy_prod_1 FORCE;

Copy

Bemerkung

Wenn für das aktuelle Konto bereits eine Paketrichtlinie festgelegt ist, können Sie FORCE verwenden, um die Paketrichtlinie festzulegen, ohne die bisherige Paketrichtlinie aufheben zu müssen.

Heben Sie die Paketrichtlinie auf.

ALTER ACCOUNT UNSET PACKAGES POLICY;

Copy