Introdução às sessões

Este guia descreve como ativar, criar e rastrear alterações em uma sessão do BigQuery. Ele é destinado a usuários familiarizados com o BigQuery e o GoogleSQL.

É possível capturar suas atividades de SQL em uma sessão do BigQuery. Variáveis, tabelas e funções temporárias podem ser usadas durante a sessão para criar de maneira interativa uma ou mais consultas. Várias sessões podem estar ativas ao mesmo tempo e o histórico de cada sessão é salvo. É possível ver o histórico de uma sessão por até 20 dias após o encerramento dela.

Os usos típicos de uma sessão incluem o seguinte:

  • Mantenha dados temporários de sessão. Defina variáveis e tabelas temporárias uma vez e use-as durante a sessão.

  • Pesquisar o histórico de consultas por sessão. Se você quiser acompanhar um comportamento que aconteceu em um determinado momento durante a sessão, poderá ver o histórico de alterações feitas durante a sessão.

  • Crie transações com várias instruções em várias consultas. Em uma sessão, é possível iniciar uma transação, fazer alterações e ver o resultado temporário antes de confirmar ou reverter. É possível fazer isso em várias consultas na sessão. Se você não usar uma sessão, uma transação com várias instruções precisará ser concluída em uma única consulta.

Preços

  • Não há custos adicionais para usar sessões.

  • Para projetos que usam sistema de preços sob demanda, as consultas nas cobranças INFORMATION_SCHEMA são realizadas. Para saber mais informações, consulte INFORMATION_SCHEMAPreços.

  • Você será cobrado por tabelas temporárias que criar em sessões. As cobranças de armazenamento são baseadas na quantidade de dados armazenados nas tabelas. Para informações sobre preços de armazenamento, consulte esta página.

Limitações

  • Cada consulta em uma sessão é executada no local em que a sessão foi criada.

  • Uma sessão é encerrada automaticamente após 24 horas de inatividade.

  • Uma sessão é encerrada automaticamente sete dias após a criação.

  • O tamanho máximo de uma variável é 1 MB, e o tamanho máximo de todas as variáveis usadas em um script é de 10 MB.

  • Não são permitidas consultas simultâneas na mesma sessão.

Papéis e permissões

Nesta seção, descrevemos as permissões do gerenciamento de identidade e acesso (IAM, na sigla em inglês) e os papéis do IAM que você precisa para executar ações com sessões.

Ações Permissões necessárias Papéis padrão
Criar uma nova sessão. Trabalhe com uma sessão criada por você. bigquery.jobs.create bigquery.user
bigquery.Jobuser
bigquery.admin
Encerre uma sessão que você criou. bigquery.jobs.create bigquery.user
bigquery.Jobuser
bigquery.admin
Encerre uma sessão criada por outro usuário. bigquery.jobs.create
bigquery.jobs.update
bigquery.admin
Ver uma lista das suas sessões em um projeto Esta lista inclui os IDs das sessões que você criou em um projeto com INFORMATION_SCHEMA.JOBS_BY_USER. bigquery.jobs.list bigquery.user
bigquery.Jobuser
bigquery.admin
Ver todas as sessões de todos os usuários em um projeto Esta lista inclui os IDs de todas as sessões criadas no projeto INFORMATION_SCHEMA.JOBS. bigquery.jobs.listAll bigquery.admin
Visualize os metadados das sessões criadas pelo usuário atual no projeto atual com INFORMATION_SCHEMA.SESSIONS_BY_USER. bigquery.jobs.list bigquery.user
bigquery.Jobuser
bigquery.admin
Ver metadados de todas as sessões no projeto atual com INFORMATION_SCHEMA.SESSIONS_BY_PROJECT. bigquery.jobs.listAll bigquery.admin

A seguir