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.

Console

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
    

bq

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

API

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:

Console

  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

SQL

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