Como encontrar sessões

Este documento descreve como conseguir um ID de sessão no BigQuery. Ela é destinada a usuários que já têm uma compreensão geral das sessões do BigQuery e que criaram uma sessão.

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

Receber o ID da sessão ativa

Em algumas situações, é necessário fazer referência a uma sessão para continuar trabalhando nela. Por exemplo, se você estiver trabalhando com o Cloud Shell, será necessário incluir o código da sessão sempre que executar um comando para essa sessão.

Não é necessário fornecer o ID da sessão para executar uma nova consulta dentro de uma sessão no console do Google Cloud. Continue trabalhando na guia do editor que contém a sessão. No entanto, se quiser fazer referência à sessão no Cloud Shell ou a uma chamada de API, você precisa saber o ID da sessão criada no console.

Antes de concluir estas etapas, verifique se você executou pelo menos uma consulta em uma sessão ativa.

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

    Ir para o BigQuery

  2. Clique na guia do editor que contém a sessão.

  3. Nos resultados da consulta, clique em Informações do job.

  4. Na lista Informações do job, procure o ID da sessão:

    Session ID: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ
    

Para executar comandos de consulta em uma sessão dentro do Cloud Shell, é necessário incluir o código da sessão no comando. Você pode conseguir o ID da sessão ao criar uma sessão ou recuperar uma lista de sessões.

Quando você cria uma sessão com o Cloud Shell, o ID da sessão retornado é semelhante a este:

In session: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ

Para passar comandos SQL em uma sessão com uma chamada de API, você precisa incluir o ID da sessão na chamada de API. Você pode conseguir o ID da sessão ao criar uma sessão ou recuperar uma lista de sessões.

Quando você cria uma sessão com uma chamada de API, o ID da sessão na resposta tem esta aparência:

sessionId: CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZ

Conseguir uma lista das suas sessões ativas e inativas

Para ver os IDs de sessões ativas e inativas, siga estas etapas:

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

    Ir para o BigQuery

  2. Selecione o tipo de histórico de jobs:

    • 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. Na coluna ID da sessão, é possível conferir os IDs de sessão dos seus jobs.

    ID da sessão no histórico do job

Para ver uma lista das suas três sessões mais recentes, incluindo as sessões ativas e encerradas, execute a seguinte consulta na guia do editor:

  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
      session_id,
      MAX(creation_time) AS last_modified_time
    FROM region-us.INFORMATION_SCHEMA.VIEW
    WHERE
      session_id IS NOT NULL
      AND creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 20 DAY)
    GROUP BY session_id
    ORDER BY last_modified_time DESC;

    Substitua:

    • VIEW: a visualização INFORMATION_SCHEMA:
      • JOBS_BY_USER: retorna apenas os jobs criados 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

  3. Clique em Executar.

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

A consulta produz resultados semelhantes a este:

+-------------------------------------------------------------------------+
| session_id                                        | last_modified_time  |
+-------------------------------------------------------------------------+
| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm     | 2021-06-01 23:04:26 |
| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-30 22:43:02 |
| CgwKCmZhbGl1LXRlc3QQY2MzLTg4ZDEtYzVhOWZiYmM5NzZk  | 2021-04-07 22:31:21 |
+-------------------------------------------------------------------------+

Obter uma lista das suas sessões ativas

Para ver uma lista das sessões ativas que não foram encerradas nas últimas 24 horas, execute a seguinte consulta:

SELECT
  session_id,
  MAX(creation_time) AS last_modified_time
FROM `region-us`.INFORMATION_SCHEMA.VIEW
WHERE
  session_id IS NOT NULL
  AND creation_time > TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
  AND is_active
GROUP BY session_id
ORDER BY last_modified_time DESC;

A consulta produz resultados semelhantes a este:

+-------------------------------------------------------------------------+
| session_id                                        | last_modified_time  |
+-------------------------------------------------------------------------+
| CgwKCmZhbGl1LXRlc3QQARokMGQ5YWWYzZmE0YjhkMDBm     | 2021-06-01 23:04:26 |
| CgwKCmZhbGl1LXRlc3QQARokMDAzYjI0OWQtZTczwZjA1NDc2 | 2021-05-30 22:43:02 |
+-------------------------------------------------------------------------+

Substitua:

  • VIEW: a visualização INFORMATION_SCHEMA:
    • JOBS_BY_USER: retorna apenas os jobs criados 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

A seguir