Funções de contexto¶

Lista de funções¶

Notas de uso¶

• Funções de contexto geralmente não requerem argumentos (exceto para SYS_CONTEXT).

• Para cumprir com o padrão ANSI, as seguintes funções de contexto podem ser chamadas sem parênteses em instruções SQL:

  • CURRENT_DATE

  • CURRENT_TIME

  • CURRENT_TIMESTAMP

  • CURRENT_USER

  • LOCALTIME

  • LOCALTIMESTAMP

  Nota

  Se você estiver configurando uma variável Snowflake Scripting para uma expressão que chama uma dessas funções (por exemplo, my_var := <function_name>();), é necessário incluir os parênteses.

Exemplos¶

Exibir o warehouse, banco de dados e esquema atuais para a sessão:

SELECT CURRENT_WAREHOUSE(), CURRENT_DATABASE(), CURRENT_SCHEMA();

+---------------------+--------------------+------------------+
| CURRENT_WAREHOUSE() | CURRENT_DATABASE() | CURRENT_SCHEMA() |
|---------------------+--------------------+------------------+
| MY_WAREHOUSE        | MY_DB              | PUBLIC           |
|---------------------+--------------------+------------------+

Mostrar a data, hora e carimbo de data/hora atuais (observe que não é necessário usar parênteses para chamar essas funções):

SELECT CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP;

+--------------+--------------+-------------------------------+
| CURRENT_DATE | CURRENT_TIME | CURRENT_TIMESTAMP             |
|--------------+--------------+-------------------------------|
| 2024-06-07   | 10:45:15     | 2024-06-07 10:45:15.064 -0700 |
+--------------+--------------+-------------------------------+

Em um bloco de Snowflake Scripting, chame a função CURRENT_DATE sem parênteses para definir uma variável em uma instrução SQL:

EXECUTE IMMEDIATE
$$
DECLARE
  currdate DATE;
BEGIN
  SELECT CURRENT_DATE INTO currdate;
  RETURN currdate;
END;
$$
;

+-----------------+
| anonymous block |
|-----------------|
| 2024-06-07      |
+-----------------+

Em um bloco de Snowflake Scripting, tentar definir uma variável para uma expressão que chama a função CURRENT_DATE sem parênteses resulta em um erro:

EXECUTE IMMEDIATE
$$
DECLARE
  today DATE;
BEGIN
  today := CURRENT_DATE;
  RETURN today;
END;
$$
;

000904 (42000): SQL compilation error: error line 5 at position 11
invalid identifier 'CURRENT_DATE'

O mesmo bloco retorna a data atual quando a função é chamada entre parênteses:

EXECUTE IMMEDIATE
$$
DECLARE
  today DATE;
BEGIN
  today := CURRENT_DATE();
  RETURN today;
END;
$$
;

+-----------------+
| anonymous block |
|-----------------|
| 2024-06-07      |
+-----------------+