Kategorien:

DDL für Konten und Sitzungen

ALTER ACCOUNT

Ändert die Parameter für Ihr Konto. Kann verwendet werden, um jede Art von Parameter (Konto, Sitzung oder Objekt) auf Kontoebene zu ändern. 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.

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

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>

Wobei:

accountParams ::=
    ALLOW_ID_TOKEN = TRUE | FALSE
    CLIENT_ENCRYPTION_KEY_SIZE = <integer>
    INITIAL_REPLICATION_SIZE_LIMIT_IN_TB = <num>
    NETWORK_POLICY = <string>
    PERIODIC_DATA_REKEYING = TRUE | FALSE
    PREVENT_UNLOAD_TO_INLINE_URL = 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 = <num>
    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 ...

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

Werte

Beliebiger vorhandener Ressourcenmonitor.

Standard

Keine

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.

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.

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;