SYS_CONTEXT (namespace SNOWFLAKE$ENVIRONMENT)¶

Sintaxe¶

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

Argumentos¶

'SNOWFLAKE$ENVIRONMENT'

Especifica que você deseja recuperar uma propriedade para retornar informações de contexto sobre o ambiente no qual a função é chamada.

'property'

Nome da propriedade que você deseja recuperar. Você pode especificar as seguintes propriedades:

Propriedade	Descrição
CLIENT	Nome e versão do cliente, driver ou biblioteca usada para chamar a função. Se essa função for chamada em Snowsight, ela retornará o nome e a versão do driver Go Snowflake. Se essa função for chamada em Snowflake CLI, ela retornará o nome e a versão do conector Snowflake para Python. O valor dessa propriedade é o mesmo que o valor de retorno da função CURRENT_CLIENT.
ACCOUNT	O localizador da conta para a sessão atual. O valor dessa propriedade é o mesmo que o valor de retorno da função CURRENT_ACCOUNT.
REGION	O nome da região da conta para a sessão atual. Para organizações que têm contas em vários grupos de regiões, o valor da propriedade é region_group.region. O valor dessa propriedade é o mesmo que o valor de retorno da função CURRENT_REGION.

Retornos¶

A função retorna um valor VARCHAR.

Notas de uso¶

• Se você estiver especificando a chamada da função em uma cadeia de caracteres entre aspas duplas em um shell, aplique o escape do caractere $ com uma barra invertida (\) para que $ENVIRONMENT não seja interpretado como uma variável do shell.

  Por exemplo, se você estiver usando Snowflake CLI e especificando a instrução SQL como um argumento de linha de comando entre aspas duplas:

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

  Copy

Exemplos¶

O exemplo a seguir retorna o nome e a versão do cliente utilizado para executar o comando:

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

O exemplo a seguir retorna o localizador da conta para a sessão atual:

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

O exemplo a seguir retorna a região da conta para a sessão atual:

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