Kategorien:

DDL für Benutzer und Sicherheit

ALTER SESSION POLICY

Ändert die Eigenschaften für eine bestehende Sitzungsrichtlinie.

Alle an den Sitzungsrichtlinien-Eigenschaften vorgenommenen Änderungen werden bei Ausführung der nächsten SQL-Abfrage wirksam, bei der die Sitzungsrichtlinie verwendet wird.

Siehe auch:

DDL und Berechtigungen für Sitzungsrichtlinien

Syntax

ALTER SESSION POLICY [ IF EXISTS ] <name> [UN]SET [ SESSION_IDLE_TIMEOUT_MINS = <integer> ]
                                                  [ SESSION_UI_IDLE_TIMEOUT_MINS = <integer> ]
                                                  [ COMMENT = '{string_literal}' ]

ALTER SESSION POLICY [ IF EXISTS ] <name> RENAME TO <new_name>

Parameter

Name

Bezeichner für die Sitzungsrichtlinie. Dieser muss für Ihr Konto eindeutig sein.

Der Bezeichnerwert muss mit einem alphabetischen Zeichen beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

SESSION_IDLE_TIMEOUT_MINS = <integer>

Für Snowflake-Clients und programmgesteuerte Clients die Anzahl der Minuten, in denen eine Sitzung inaktiv sein kann, bevor sich Benutzer erneut bei Snowflake authentifizieren müssen. Die Anzahl der Minuten kann eine beliebige Ganzzahl zwischen 5 und 240 inklusive sein. Wenn kein Wert angegeben wird, verwendet Snowflake den Standardwert.

Standard: 240 (d. h. 4 Stunden).

SESSION_UI_IDLE_TIMEOUT_MINS = <integer>

Für die Snowflake-Weboberfläche die Anzahl der Minuten, in denen eine Sitzung inaktiv sein kann, bevor sich Benutzer erneut bei Snowflake authentifizieren müssen. Die Anzahl der Minuten kann eine beliebige Ganzzahl zwischen 5 und 240 inklusive sein. Wenn kein Wert angegeben wird, verwendet Snowflake den Standardwert.

Standard: 240 (d. h. 4 Stunden).

COMMENT = 'Zeichenfolgenliteral'

Fügt einen Kommentar hinzu oder überschreibt einen vorhandenen Kommentar für die Sitzungsrichtlinie.

RENAME TO neuer_Name

Gibt den neuen Bezeichner für die Sitzungsrichtlinie an. Dieser muss für Ihr Konto eindeutig sein.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

Nutzungshinweise

  • Wenn Sie eine bestehende Sitzungsrichtlinie aktualisieren möchten und dazu die aktuelle Definition der Richtlinie anzeigen müssen, können Sie die Funktion GET_DDL aufrufen oder den Befehl DESCRIBE SESSION POLICY ausführen.

  • Bevor Sie eine ALTER-Anweisung ausführen, können Sie eine DESCRIBE SESSION POLICY-Anweisung ausführen, um die Attributwerte der Richtlinie zu bestimmen.

  • Das Verschieben einer Sitzungsrichtlinie in ein verwaltetes Zugriffsschema (unter Verwendung der ALTER SESSIONPOLICY … RENAME TO-Syntax) ist nicht erlaubt, es sei denn, der Eigentümer der Sitzungsrichtlinie (d. h. die Rolle mit der Berechtigung OWNERSHIP für die Sitzungsrichtlinie) ist auch Eigentümer des Zielschemas. Weitere Informationen dazu finden Sie unter Übersicht zu Zugriffssteuerungsrechten.

Beispiele

Im folgenden Beispiel wird die Sitzungsrichtlinie so aktualisiert, dass der Wert für das Sitzungstimeout der Weboberfläche 60 Minuten beträgt.

DESC SESSION POLICY session_policy_prod_1;

+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+
| createdOn                       | name                  | sessionIdleTimeoutMins | sessionUIIdleTimeoutMins | comment                                          |
+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+
| Mon, 11 Jan 2021 00:00:00 -0700 | session_policy_prod_1 | 60                     | 30                       | session policy for use in the prod_1 environment |
+---------------------------------+-----------------------+------------------------+--------------------------+--------------------------------------------------+

ALTER SESSION POLICY session_policy_prod_1 set session_ui_idle_timeout_mins = 60;