Kategorien:

Kontextfunktionen (Allgemein)

SYS_CONTEXT (SNOWFLAKE$ORGANIZATION_SESSION-Namespace)

Gibt Informationen zu der Sitzung zurück, in der die Funktion aufgerufen wird, und zum aktuellen Organisationsbenutzenden.

Sie können diese Funktion in den folgenden Kontexten aufrufen:

  • Sie können diese Funktion direkt in der aktuellen Sitzung aufrufen.

  • Sie können eine ausführbare Datei mit Aufruferrechten ausführen (z. B. eine gespeicherte Prozedur mit Aufruferrechten), die diese Funktion aufruft.

  • Sie können eine ausführbare Datei mit Eigentümerrechten (z. B. eine gespeicherte Prozedur mit Eigentümerrechten) ausführen, die diese Funktion aufruft, sofern Folgendes gilt:

    • Der Eigentümerrolle wurde die READ SESSION-Berechtigung für das Konto zugewiesen.

    • Das Konto mit der Eigentümerrolle ist dieselbe Organisation wie das aktuelle Konto für die Sitzung.

In jedem anderen Kontext gibt die Funktion NULL zurück.

Siehe auch:

SYS_CONTEXT, SYS_CONTEXT (SNOWFLAKE$APPLICATION-Namespace), SYS_CONTEXT (SNOWFLAKE$ENVIRONMENT-Namespace), SYS_CONTEXT (SNOWFLAKE$ORGANIZATION-Namespace)

Syntax

Syntax für das Abrufen von Eigenschaften:

SYS_CONTEXT(
  'SNOWFLAKE$ORGANIZATION_SESSION' ,
  '<property>'
)
Copy

Argumente

'SNOWFLAKE$ORGANIZATION_SESSION'

Gibt an, dass Sie eine Eigenschaft abrufen oder eine Funktion aufrufen möchten, um Informationen zu der Sitzung zurückzugeben, in der die Funktion aufgerufen wird, wenn sich das aktuelle Konto in einer Organisation befindet.

'property'

Name der Eigenschaft, die Sie abrufen möchten. Sie können die folgenden Eigenschaften angeben:

Eigenschaft

Beschreibung

PRINCIPAL_NAME

Name des Prinzipals (der Organisationsbenutzende), der die Sitzung gestartet hat.

Wenn der aktuelle Benutzende kein Organisationsbenutzender ist, ist der Wert dieser Eigenschaft NULL.

Rückgabewerte

Die Funktion gibt einen VARCHAR-Wert oder NULL zurück:

  • Der Rückgabewert hängt von:ref:der Eigenschaft ab, die Sie abrufen <label-sys_context_snowflake_organization_session_property>.

  • Wenn Sie SYS_CONTEXT mit dem SNOWFLAKE$ORGANIZATION_SESSION-Namespace außerhalb von jeglichem unterstützten Kontext aufrufen, gibt die Funktion NULL zurück.

Nutzungshinweise

  • Wenn Sie den Funktionsaufruf in einer Zeichenfolge in doppelten Anführungszeichen angeben, versehen Sie das $-Zeichen mit einem Backslash (\), als Escapezeichen, damit $ORGANIZATION_SESSION nicht als Shell-Variable interpretiert wird.

    Wenn Sie beispielsweise Snowflake CLI verwenden und die SQL-Anweisung als Befehlszeilenargument in doppelten Anführungszeichen angeben:

    snow sql --query "SELECT SYS_CONTEXT('SNOWFLAKE\$ORGANIZATION_SESSION', 'PRINCIPAL_NAME');"
    Copy

Beispiele

Das folgende Beispiel gibt den Namen des Organisationsbenutzenden für die aktuelle Sitzung zurück:

SELECT SYS_CONTEXT('SNOWFLAKE$ORGANIZATION_SESSION', 'PRINCIPAL_NAME');
Copy
+-----------------------------------------------------------------+
| SYS_CONTEXT('SNOWFLAKE$ORGANIZATION_SESSION', 'PRINCIPAL_NAME') |
|-----------------------------------------------------------------|
| my_organization_user_name                                       |
+-----------------------------------------------------------------+
Sprache: Deutsch