Categorias:

Funções de contexto (Sessão)

LAST_QUERY_ID

Retorna a ID de uma consulta específica na sessão atual. Se nenhuma consulta for especificada, a mais recente será retornada.

Dica

Em vez de usar esta função com a função RESULT_SCAN para processar os resultados de um comando anterior, você pode usar o operador de canal (->>). Dessa forma, você pode executar o comando e processar seu conjunto de resultados em uma única etapa.

Sintaxe

LAST_QUERY_ID( [ <num> ] )
Copy

Argumentos

num

Especifica a consulta a retornar, com base na posição da consulta (dentro da sessão).

Padrão: -1

Notas de uso

  • Os números positivos começam com a primeira consulta executada na sessão. Por exemplo:

    • LAST_QUERY_ID(1) retorna a primeira consulta.

    • LAST_QUERY_ID(2) retorna a segunda consulta.

    • LAST_QUERY_ID(6) retorna a sexta consulta.

  • Os números negativos começam com a consulta mais recente na sessão. Por exemplo:

    • LAST_QUERY_ID(-1) retorna a consulta mais recente (equivalente a LAST_QUERY_ID()).

    • LAST_QUERY_ID(-2) retorna a segunda consulta mais recente.

  • A última função LAST_QUERY_ID considera todas as instruções que foram executadas dentro da sessão atual, incluindo as instruções filhas (por exemplo, instruções que foram executadas como parte de um procedimento armazenado, bloco anônimo ou instrução de operador de canal). Se você quiser obter o ID da consulta de uma instrução com base apenas em sua posição em uma série de instruções, considere o uso do operador de canal. Para casos de uso mais complexos, recomendamos usar a variável global SQLID em blocos do Snowflake Scripting.

Exemplos

Retornar o ID da consulta mais recente:

SELECT LAST_QUERY_ID();
Copy

Retornar o ID da primeira consulta executada na sessão:

SELECT LAST_QUERY_ID(1);
Copy