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 ver o histórico de uma sessão no console do Google Cloud, é possível filtrar o Histórico pessoal ou o Histórico do projeto por ID da sessão para visualizar todas as consultas SQL. são executadas em uma sessão específica. Para informações sobre como encontrar o ID da sessão, consulte Como 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 Session ID, 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