SYS_CONTEXT (espace de noms SNOWFLAKE$ENVIRONMENT)¶

Syntaxe¶

SYS_CONTEXT(
  'SNOWFLAKE$ENVIRONMENT' ,
  '<property>'
)

Arguments¶

'SNOWFLAKE$ENVIRONMENT'

Spécifie que vous voulez récupérer une propriété pour renvoyer des informations de contexte sur l’environnement dans lequel la fonction est appelée.

'property'

Nom de la propriété à récupérer. Vous pouvez spécifier les propriétés suivantes :

Propriété	Description
CLIENT	Nom et version du client, du pilote ou de la bibliothèque utilisés pour appeler la fonction. Si cette fonction est appelée dans Snowsight, la fonction renvoie le nom et la version du pilote Go Snowflake. Si cette fonction est appelée dans Snowflake CLI, la fonction renvoie le nom et la version du Snowflake Connector pour Python. La valeur de cette propriété est la même que la valeur de retour de la fonction:doc:current_client.
ACCOUNT	Le localisateur de compte du compte pour la session en cours. La valeur de cette propriété est la même que la valeur de retour de la fonction:doc:current_account.
REGION	Le nom de la région du compte pour la session en cours. Pour les organisations ayant des comptes dans plusieurs groupes de régions, la valeur de la propriété est region_group.region. La valeur de cette propriété est la même que la valeur de retour de la fonction:doc:current_region.

Renvoie¶

La fonction renvoie une valeur VARCHAR.

Notes sur l’utilisation¶

• Si vous spécifiez l’appel de fonction dans une chaîne entre guillemets doubles dans un shell, isolez le caractère $ avec une barre oblique inverse (\) de sorte que $ENVIRONMENT ne soit pas interprété comme une variable de shell.

  Par exemple, si vous utilisez Snowflake CLI et que vous spécifiez l’instruction SQL comme argument de ligne de commande entre guillemets doubles :

  snow sql --query "SELECT SYS_CONTEXT('SNOWFLAKE\$ENVIRONMENT', 'CLIENT');"
  

  Copy

Exemples¶

L’exemple suivant renvoie le nom et la version du client utilisé pour exécuter la commande :

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'CLIENT');

L’exemple suivant renvoie le localisateur de compte du compte pour la session en cours :

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'ACCOUNT');

L’exemple suivant renvoie la région du compte pour la session en cours :

SELECT SYS_CONTEXT('SNOWFLAKE$ENVIRONMENT', 'REGION');