Kategorien:

DDL für Konten und Sitzungen

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) können ein Konto umbenennen und angeben, ob die ursprüngliche URL für den Zugriff auf das Konto verwendet werden kann.

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

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

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

ALTER ACCOUNT SET RESOURCE_MONITOR = <monitor_name>

ALTER ACCOUNT SET SESSION POLICY = '<string_literal>'

ALTER ACCOUNT UNSET SESSION POLICY

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

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

ALTER ACCOUNT <account_name> RENAME TO <new_account_name> [ SAVE_OLD_URL = { TRUE | FALSE } ]

ALTER ACCOUNT <account_name> DROP OLD URL

Wobei:

accountParams ::=
    ALLOW_ID_TOKEN = TRUE | FALSE
    CLIENT_ENCRYPTION_KEY_SIZE = <integer>
    ENFORCE_SESSION_POLICY = TRUE | FALSE
    EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST = TRUE | FALSE
    INITIAL_REPLICATION_SIZE_LIMIT_IN_TB = <num>
    NETWORK_POLICY = <string>
    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
objectParams ::=
    DATA_RETENTION_TIME_IN_DAYS = <integer>
    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>
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>
    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>

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.

Parameter

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.

SESSION POLICY session_policy_name

Gibt die Sitzungsrichtlinie an, die für den Benutzer festgelegt werden soll.

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.

RENAME TO new_account_name

Ändert den Namen eines Kontos in den angegebenen Namen.

SAVE_OLD_URL

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

Nutzungshinweise

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

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

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

Entfernen Sie die Zuordnung der Netzwerkrichtlinien von Ihrem Konto:

ALTER ACCOUNT UNSET NETWORK_POLICY;
Zurück zum Anfang