Como ver o histórico de consultas em sessões

Neste documento, você verá como ver o histórico de uma sessão no BigQuery. Ela é destinada a usuários que já têm uma compreensão geral das sessões do BigQuery.

Antes de concluir estas etapas, verifique se você tem as permissões necessárias para visualizar o histórico de uma sessão.

Ver o histórico de uma sessão

Uma sessão captura suas atividades SQL dentro de um período. Essas informações são armazenadas no histórico da sessão. O histórico de sessões permite acompanhar as alterações feitas na sessão. Se um job falhar ou ser bem-sucedido, ele será registrado no histórico da sessão para que você possa voltar mais tarde e ver o que fez.

Console

Para conferir o histórico de uma sessão no console do Google Cloud, filtre seu Histórico pessoal ou Histórico do projeto por ID da sessão para ver tudo As consultas SQL são executadas em uma sessão específica. Para informações sobre como encontrar seus ID da sessão, consulte Encontrar sessões.

  1. No console do Google Cloud, acesse a página do BigQuery.

    Ir para o BigQuery

  2. Selecione o tipo de histórico de jobs que você quer ver:

    • Para exibir informações dos jobs recentes, clique em Histórico pessoal.
    • Para exibir informações de jobs recentes no projeto, clique em Histórico do projeto.

  3. Clique em Filtrar e selecione ID da sessão.

  4. No campo ID da sessão, procure o ID da sessão:

    Session ID: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ

SQL

Para ver os dados históricos de uma sessão específica, primeiro acesse o ID da sessão e, depois, siga estas etapas:

  1. No Console do Google Cloud, acesse a página BigQuery.

    Ir para o BigQuery

  2. No editor de consultas, digite a seguinte instrução:

    SELECT
  *
FROM
  region-us.INFORMATION_SCHEMA.VIEW
WHERE
  session_info.session_id = 'SESSION_ID';

    Substitua:

    • VIEW: a visualização INFORMATION_SCHEMA para trabalhar

      Selecione uma das seguintes visualizações:

      • JOBS_BY_USER retorna apenas as sessões criadas pelo usuário atual no projeto atual.
      • SESSIONS_BY_USER: retorna apenas as sessões criadas pelo usuário atual no projeto atual.
      • SESSIONS_BY_PROJECT: retorna todas as sessões no projeto atual.
    • SESSION_ID: o ID da sessão para a qual dados históricos serão recuperados.

  3. Clique em Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

Exemplo

O exemplo a seguir retorna o histórico de uma sessão que tem o ID CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0. É possível substituir esse ID de sessão pelo seu.

SELECT
  creation_time, query
FROM
  region-us.INFORMATION_SCHEMA.JOBS_BY_USER
WHERE
  session_info.session_id = 'CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0'
  AND creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 20 DAY);

O resultado será semelhante ao seguinte:

+---------------------+------------------------------------------------------------------------------------------+
|    creation_time    |                                          query                                           |
+---------------------+------------------------------------------------------------------------------------------+
| 2021-06-01 23:04:26 | SELECT * FROM Purchases;                                                                 |
| 2021-06-01 23:02:51 | CREATE TEMP TABLE Purchases(total INT64) AS SELECT * FROM UNNEST([10,23,3,14,55]) AS a;  |
+---------------------+------------------------------------------------------------------------------------------+

A seguir