ALTER ACCOUNT

Ändert ein Konto. Kann verwendet werden, um jede Art von Parameter (Konto, Sitzung oder Objekt) auf Kontoebene zu ändern. Wird auch zum Umbenennen eines Kontos und zum Zuweisen von Ressourcenmonitoren und Tags zu einem Konto verwendet. Der Befehl kann nur ausgeführt werden durch:

  • Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN), um Folgendes festzustellen bzw. zu deaktivieren:

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

    • Sitzungs- und Objektparameter, die als Parametervorgaben für Benutzer, Sitzungen und die relevanten Objekte dienen. Diese Standardwerte können jederzeit überschrieben werden.

    • Ressourcenmonitore

    • Tags

  • Sicherheitsadministratoren (d. h. Benutzer mit der Rolle SECURITYADMIN) oder eine höhere Rolle zum Festlegen und Deaktivieren des Kontoparameters NETWORK_POLICY.

  • Organisationsadministratoren (d. h. Benutzer mit der Rolle ORGADMIN) für:

    • Umbenennen eines Kontos und angeben, ob die ursprüngliche URL für den Zugriff auf das Konto verwendet werden kann.

    • Aktivieren der Rolle ORGADMIN für ein Konto.

Kann auch verwendet werden, um einen Ressourcenmonitor zur Steuerung der Credit-Nutzung für alle im Konto erstellten virtuellen Warehouses anzugeben.

Weitere Informationen zum Festlegen von Parametern auf Kontoebene finden Sie unter Parameterverwaltung. Details zu den Parametern finden Sie unter Parameter.

Syntax

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

Ändern des aktuellen Kontos

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

Wobei:

accountParams ::=
    ALLOW_ID_TOKEN = TRUE | FALSE
    CLIENT_ENCRYPTION_KEY_SIZE = <integer>
    ENABLE_INTERNAL_STAGES_PRIVATELINK = TRUE | FALSE
    ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES = TRUE | FALSE
    EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST = TRUE | FALSE
    INITIAL_REPLICATION_SIZE_LIMIT_IN_TB = <num>
    NETWORK_POLICY = <string>
    OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST = TRUE | FALSE
    PERIODIC_DATA_REKEYING = TRUE | FALSE
    PREVENT_UNLOAD_TO_INLINE_URL = TRUE | FALSE
    PREVENT_UNLOAD_TO_INTERNAL_STAGES = TRUE | FALSE
    REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION = TRUE | FALSE
    REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION = TRUE | FALSE
    SAML_IDENTITY_PROVIDER = <json_object>
    SSO_LOGIN_PAGE = TRUE | FALSE
Copy
objectParams ::=
    DATA_RETENTION_TIME_IN_DAYS = <integer>
    ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR = TRUE | FALSE
    MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer>
    DEFAULT_DDL_COLLATION = '<collation_specification>'
    MAX_CONCURRENCY_LEVEL = <num>
    NETWORK_POLICY = <string>
    PIPE_EXECUTION_PAUSED = TRUE | FALSE
    STATEMENT_QUEUED_TIMEOUT_IN_SECONDS = <num>
    STATEMENT_TIMEOUT_IN_SECONDS = <num>
Copy
sessionParams ::=
    ABORT_DETACHED_QUERY = TRUE | FALSE
    AUTOCOMMIT = TRUE | FALSE
    BINARY_INPUT_FORMAT = <string>
    BINARY_OUTPUT_FORMAT = <string>
    DATE_INPUT_FORMAT = <string>
    DATE_OUTPUT_FORMAT = <string>
    ERROR_ON_NONDETERMINISTIC_MERGE = TRUE | FALSE
    ERROR_ON_NONDETERMINISTIC_UPDATE = TRUE | FALSE
    JSON_INDENT = <num>
    LOCK_TIMEOUT = <num>
    QUERY_TAG = <string>
    ROWS_PER_RESULTSET = <num>
    S3_STAGE_VPCE_DNS_NAME = <string>
    SEARCH_PATH = <string>
    SIMULATED_DATA_SHARING_CONSUMER = <string>
    STATEMENT_TIMEOUT_IN_SECONDS = <num>
    STRICT_JSON_OUTPUT = TRUE | FALSE
    TIMESTAMP_DAY_IS_ALWAYS_24H = TRUE | FALSE
    TIMESTAMP_INPUT_FORMAT = <string>
    TIMESTAMP_LTZ_OUTPUT_FORMAT = <string>
    TIMESTAMP_NTZ_OUTPUT_FORMAT = <string>
    TIMESTAMP_OUTPUT_FORMAT = <string>
    TIMESTAMP_TYPE_MAPPING = <string>
    TIMESTAMP_TZ_OUTPUT_FORMAT = <string>
    TIMEZONE = <string>
    TIME_INPUT_FORMAT = <string>
    TIME_OUTPUT_FORMAT = <string>
    TRANSACTION_DEFAULT_ISOLATION_LEVEL = <string>
    TWO_DIGIT_CENTURY_START = <num>
    UNSUPPORTED_DDL_ACTION = <string>
    USE_CACHED_RESULT = TRUE | FALSE
    WEEK_OF_YEAR_POLICY = <num>
    WEEK_START = <num>
Copy

Bemerkung

Aus Gründen der Lesbarkeit ist die vollständige Liste der Sitzungsparameter, die für ein Konto festgelegt werden können, hier nicht enthalten. Eine vollständige Liste aller Sitzungsparameter mit ihren Beschreibungen sowie Konto- und Objektparametern finden Sie unter Parameter.

Ändern eines anderen Kontos

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
Copy

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:

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