QUERY_HISTORY , QUERY_HISTORY_BY_*¶

Sintaxe¶

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

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

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

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

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'). Você não pode especificar SYSTEM (USER_NAME =>'SYSTEM'), que é um serviço em segundo plano e não um usuário. No entanto, você pode filtrar em user_name='SYSTEM' ao executar consultas nas funções de tabela QUERY_HISTORY.

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.

INCLUDE_CLIENT_GENERATED_STATEMENT => 'boolean_expr'

Especifica se as instruções geradas pelo cliente estão incluídas nas consultas de função de tabela (dado o valor da coluna is_client_generated_statement).

Padrão: FALSE.

O ACCOUNT_USAGE Exibição QUERY_HISTORY também contém uma coluna is_client_generated_statement, mas as consultas dessa exibição retornam todas as instruções, sejam elas geradas pelo cliente ou não. Se necessário, você pode filtrar o resultado de consulta.

Notas de uso¶

• Retorna consultas executadas pelo usuário atual. Também retorna as consultas executadas por qualquer usuário quando a função de execução, ou uma função superior em uma hierarquia, tiver um dos seguintes privilégios:

  • O privilégio MONITOR ou OPERATE nos warehouses gerenciados pelo usuário em que as consultas foram executadas.

  • O privilégio MONITOR ou OPERATE na tarefa. Exceção: se a tarefa executar um procedimento armazenado de direito do proprietário ou UDF, a função exigirá pelo menos o privilégio MONITOR no warehouse em que a tarefa foi executada para visualizar a consulta do procedimento armazenado e a consulta da UDF.

  • O privilégio MONITOR EXECUTION na conta em que a tarefa reside.

  • Exceções: nem os procedimentos armazenados nem as funções definidas pelo usuário (UDFs) podem executar essa consulta.

  Para obter mais informações, consulte Privilégios de warehouse virtual.

• Quando você chama uma função de tabela do Information Schema, sua sessão deve usar INFORMATION_SCHEMA, ou o nome da função deve ser totalmente qualificado. Para obter mais informações, 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).

• As consultas canceladas são identificadas por seu texto error_message (SQL execution canceled), não por seu valor execution_status.

Saída¶

A função retorna as seguintes colunas:

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;

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;

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;

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) em um bloco de tempo de 30 minutos especificado 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')));

Recuperar o número de instruções geradas pelo cliente que foram executadas em um warehouse chamado my_xsmall_wh:

SELECT COUNT(*)
  FROM TABLE(INFORMATION_SCHEMA.QUERY_HISTORY_BY_WAREHOUSE(
    WAREHOUSE_NAME => 'my_xsmall_wh',
    INCLUDE_CLIENT_GENERATED_STATEMENT => TRUE));