- 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> ] )
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 aLAST_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();
Retornar o ID da primeira consulta executada na sessão:
SELECT LAST_QUERY_ID(1);