QUERY_HISTORY , QUERY_HISTORY_BY_*¶

Sintaxe¶

QUERY_HISTORY(
      [ END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_SESSION(
      [ SESSION_ID => <constant_expr> ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_USER(
      [ USER_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_WAREHOUSE(
      [ WAREHOUSE_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

Argumentos¶

Todos os argumentos são opcionais.

END_TIME_RANGE_START => constant_expr , . END_TIME_RANGE_END => constant_expr

Intervalo de tempo (no formato TIMESTAMP_LTZ), dos últimos 7 dias, nos quais a consulta terminou em execução:

• Se END_TIME_RANGE_END não for especificado, a função retorna todas as consultas, inclusive as que ainda estão em execução.

• Se END_TIME_RANGE_END for CURRENT_TIMESTAMP, a função retorna apenas aquelas consultas que foram concluídas.

Se o intervalo não ficar dentro dos últimos 7 dias, um erro é retornado.

Nota

Se não for especificada a hora de início ou fim, as consultas mais recentes são retornadas até o limite especificado.

SESSION_ID => constant_expr

Aplica-se somente a QUERY_HISTORY_BY_SESSION

O identificador numérico de uma sessão ou CURRENT_SESSION. Somente as consultas da sessão especificada são retornadas.

Padrão: CURRENT_SESSION

USER_NAME => 'string'

Aplica-se somente a QUERY_HISTORY_BY_USER

Uma cadeia de caracteres especificando um nome de login de usuário ou CURRENT_USER. Somente as consultas feitas pelo usuário especificado são retornadas. Observe que o nome de login deve ser delimitado por aspas simples. Além disso, se o nome de login contiver quaisquer espaços, letras maiúsculas e minúsculas misturadas ou caracteres especiais, o nome deve ser delimitado por aspas duplas dentro das aspas simples (por exemplo, '"User 1"' vs 'user1').

Padrão: CURRENT_USER

WAREHOUSE_NAME => 'string'

Aplica-se somente a QUERY_HISTORY_BY_WAREHOUSE

Uma cadeia de caracteres especificando um nome de warehouse ou CURRENT_WAREHOUSE. Somente as consultas executadas por esse warehouse são retornadas. Observe que o nome do warehouse deve ser delimitado por aspas simples. Além disso, se o nome do warehouse contiver quaisquer espaços, letras maiúsculas e minúsculas misturadas ou caracteres especiais, o nome deve ser delimitado por aspas duplas dentro das aspas simples (por exemplo, '"My Warehouse"' vs 'mywarehouse').

Padrão: CURRENT_WAREHOUSE

RESULT_LIMIT => num

Um número especificando o número máximo de linhas retornadas pela função:

Se o número de linhas correspondentes for maior que este limite, as consultas com o tempo final mais recente (ou aquelas que ainda estão em execução) são retornadas até o limite especificado.

Intervalo: 1 a 10000

Padrão: 100.

Notas de uso¶

• Retorna consultas executadas pelo usuário atual. Também retorna consultas executadas por qualquer usuário quando a função de execução, ou uma função superior em uma hierarquia, tem o privilégio MONITOR ou OPERATE nos warehouses em que as consultas foram executadas. Para obter mais informações, consulte Privilégios de warehouse virtual.

• Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

• Os valores para as colunas EXTERNAL_FUNCTION_TOTAL_INVOCATIONS, EXTERNAL_FUNCTION_TOTAL_SENT_ROWS, EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS, EXTERNAL_FUNCTION_TOTAL_SENT_BYTES e EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES são afetados por muitos fatores, inclusive:

  • O número de funções externas na instrução SQL.

  • O número de linhas por lote enviadas para cada serviço remoto.

  • O número de tentativas devido a erros transitórios (por exemplo, porque uma resposta não foi recebida dentro do tempo esperado).

Saída¶

A função retorna as seguintes colunas:

1(1,2,3,4)

Esta coluna está presente somente quando o pacote de mudança de comportamento 2023_06 está ativado. Esta coluna faz parte do recurso hash de consulta.

Os valores potenciais para a coluna QUERY_TYPE incluem:

• CREATE_USER

• CREATE_ROLE

• CREATE_NETWORK_POLICY

• ALTER_ROLE

• ALTER_NETWORK_POLICY

• ALTER_ACCOUNT

• DROP_SEQUENCE

• DROP_USER

• DROP_ROLE

• DROP_NETWORK_POLICY

• RENAME_NETWORK_POLICY

• REVOKE

Exemplos¶

Recuperar até as últimas 100 consultas executadas na sessão atual:

select *
from table(information_schema.query_history_by_session())
order by start_time;

Copy

Recuperar as 100 últimas consultas executadas pelo usuário atual (ou executadas por qualquer usuário em qualquer warehouse no qual o usuário atual tenha o privilégio MONITOR):

select *
from table(information_schema.query_history())
order by start_time;

Copy

Recuperar as 100 últimas consultas executadas na última hora pelo usuário atual (ou executadas por qualquer usuário em qualquer warehouse no qual o usuário atual tenha o privilégio MONITOR):

select *
from table(information_schema.query_history(dateadd('hours',-1,current_timestamp()),current_timestamp()))
order by start_time;

Copy

Recuperar todas as consultas executadas pelo usuário atual (ou executadas por qualquer usuário em qualquer warehouse no qual o usuário atual tenha o privilégio MONITOR) dentro de um intervalo de tempo especificado de 30 minutos nos últimos 7 dias:

select *
  from table(information_schema.query_history(
    END_TIME_RANGE_START=>to_timestamp_ltz('2017-12-4 12:00:00.000 -0700'),
    END_TIME_RANGE_END=>to_timestamp_ltz('2017-12-4 12:30:00.000 -0700')));

Copy