Como usar a IU da Web do BigQuery

A IU da Web do BigQuery exibe soluções gráficas para gerenciar recursos e fazer consultas SQL. Nesta página, você encontra uma visão geral de como usá-la.

Para uma introdução sobre a IU da Web, consulte o Guia de início rápido da IU da Web do BigQuery.

Antes de começar

Para usar a ferramenta de navegação do BigQuery, é preciso ter acesso a um projeto habilitado. O BigQuery é ativado por padrão em novos projetos. Também é necessário ativar o faturamento para ir além dos limites do Nível gratuito do Google Cloud Platform.

  1. Faça login na sua Conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. Selecione ou crie um projeto do GCP.

    Acessar a página Gerenciar recursos

  3. Verifique se o faturamento foi ativado para o projeto.

    Saiba como ativar o faturamento

  4. O BigQuery é ativado automaticamente em novos projetos. Para ativar o BigQuery em um projeto já existente, Ativar BigQuery API.

    Ativar a API

Como abrir a IU da Web

Para abrir a IU da Web, digite o URL a seguir no seu navegador e troque project_id pelo código do projeto que você quer abrir:

https://bigquery.cloud.google.com/project_id

Ao clicar no botão abaixo, você abre a IU da Web para seu projeto mais recente.

Acessar a IU da Web

Visão geral da IU da Web

A IU da Web tem três seções principais:

  1. O painel de navegação, à esquerda da página:
    Na parte superior dessa seção há uma lista de ações que descrevem como criar uma consulta, ver o histórico de consultas e ver o histórico de trabalhos.
    Na parte inferior estão os conjuntos de dados do projeto em que você está trabalhando, além do conjunto de dados públicos do BigQuery. Aqui, também é possível filtrar o conjunto de dados pelo código ou marcador.
  2. O painel de detalhes:
    Essa seção exibe informações sobre a ação selecionada no painel de navegação. Por exemplo: quando você clica em um conjunto de dados, os detalhes dele são exibidos aqui.
  3. A janela de consulta:
    Uma janela Nova consulta é incluída acima do painel de detalhes quando você clica em Escrever consulta. Essa janela pode ser fechada quando você desejar.

Captura de tela da IU da Web do BigQuery

Como exibir recursos

O painel de navegação exibe os conjuntos de dados do seu projeto atual. Clique no nome do conjunto de dados ou no ícone ícone de expansão do conjunto de dados para ver as tabelas dele.

Clique em uma tabela para ver as informações dela no painel de detalhes. Para preencher a caixa de consulta com informações básicas sobre a tabela, clique no botão Query Table, localizado no lado direito do painel. É possível modificar a consulta manualmente. Basta especificar campos ou personalizar a consulta. Também é possível consultar outras tabelas além da selecionada. Para mais informações sobre como consultar tabelas, consulte Como executar consultas alternativas.

Como adicionar e remover projetos

Seu trabalho no BigQuery é feito dentro de um projeto. O nome dele é exibido na barra de navegação, acima da lista de conjuntos de dados. O trabalho que você realiza num projeto é cobrado na conta de faturamento ligada a ele. Para mais informações sobre cobranças do BigQuery, consulte Preços.

Na IU da Web é possível:

  • adicionar ou "fixar" projetos;
  • remover projetos fixados;
  • alternar entre projetos.

Como adicionar um projeto

É possível adicionar ou "fixar" um projeto na IU da Web usando o menu suspenso. Fixar um projeto ao painel de navegação torna possível a procura e consulta de recursos em outro projeto. A consulta de recursos em um projeto fixado é cobrada diretamente na conta de faturamento do projeto principal. O projeto fixado não é cobrado.

Para adicionar um projeto à IU:

  1. Clique no ícone de seta para baixo ícone de seta para baixo ao lado do nome do projeto no painel de navegação.

  2. No menu suspenso, clique em Alternar para projeto > Exibir projeto.

  3. Na caixa de diálogo Exibir projeto:

    • Digite o código do projeto.
    • Selecione Exibir projeto no painel de navegação.
    • Clique em OK para adicionar um projeto ao painel de navegação.

    Mostrar caixa de diálogo do projeto

Como remover um projeto da IU

Para remover um projeto fixado:

  1. Clique no ícone de seta para baixo ícone de seta para baixo ao lado do nome do projeto no painel de navegação.

  2. No menu suspenso, clique em Remover projeto do painel.

Como alternar projetos

Se você preferir, alterne entre projetos em vez de trabalhar com projetos fixados. Para isso, use o menu de contexto.

Para alternar projetos:

  1. Clique no ícone de seta para baixo ícone de seta para baixo ao lado do nome do projeto no painel de navegação.

  2. No menu suspenso, clique em Alternar projeto e escolha um nome da lista. Seu projeto anterior será substituído pelo selecionado.

Como adicionar um conjunto de dados compartilhado

Um usuário pode compartilhar o conjunto de dados de um projeto sem que você tenha acesso a ele. Se isso acontecer, você receberá o nome desse projeto por e-mail. O projeto e o conjunto de dados não vão aparecer automaticamente na IU.

Para abrir esse projeto, clique no link browser tool presente no e-mail. O projeto é exibido na IU da Web. Também é possível fixar o projeto com o conjunto de dados compartilhados. Siga as instruções em Adicionando um projeto.

Como ver o histórico de jobs e consultas

A IU da Web guarda no painel de navegação um histórico dos seus jobs e consultas. Consultas são um tipo de job, mas o histórico delas fica guardado separadamente para facilitar o uso.

O histórico da IU inclui todos os carregamentos, cópias e jobs de consulta realizados por você nos últimos seis meses, com um limite de até 1.000 entradas. Esse limite é cumulativo entre todos os tipos de jobs.

Como ver o histórico de jobs

Para ver seu histórico de jobs:

  • Clique no link Histórico de jobs no painel de navegação.

  • Digite o seguinte URL no seu navegador:

    https://bigquery.cloud.google.com/jobs/project_id

É possível repetir o carregamento de um job por meio da IU da Web, mas não é possível repetir uma exportação nem copiar um job.

Como ver o histórico de consultas

Para ver seu histórico de consultas:

  • Clique no link Histórico de consultas no painel de navegação.

  • Digite o seguinte URL no seu navegador:

    https://bigquery.cloud.google.com/queries/project_id

É possível repetir um job de consulta por meio da IU da Web.

Como procurar no histórico de jobs e consultas

É possível filtrar seu histórico de jobs e consultas usando critérios específicos. Os resultados limitam-se aos jobs recuperados pela IU. Por definição, com a IU é possível procurar os últimos 1.000 jobs.

Para listar todos os jobs disponíveis, use o método da API jobs.list ou o comando CLI bq ls.

Para filtrar os históricos de jobs e consultas:

  1. No painel de navegação, clique em Histórico de jobs ou Histórico de consultas.
  2. Clique na lista suspensa "filtrar jobs" para abrir a expressão de filtro.
  3. Na caixa da expressão de filtro:

    • Clique em Qualquer um para escolher um filtro.
    • Clique na lista suspensa de operador para escolher um deles. Essa lista muda de acordo com os filtros escolhidos. A lista de operador inclui, por exemplo, substring e regex se você escolhe um filtro de texto.
    • Insira um valor na caixa.

      Filtrar criador de expressões

  4. Clique em E para adicionar outras opções de filtro.

  5. Clique em Pesquisar.

Filtre jobs de consulta usando qualquer uma destas propriedades:

  • Qualquer um - qualquer propriedade.
  • Código do job (jobid) — o código único e opaco do job.
  • Usuário (user) — o usuário que enviou o job.
  • Horário de início (start) — hora de início do job, em milissegundos, desde o início. Essa propriedade está presente quando o job faz a transição de PENDING para RUNNING ou DONE.
  • Horário de término (end) — horário de término do trabalho, em milissegundos, desde o início. Essa propriedade está presente quando o job está com status DONE.
  • Tabela de destino (dest) — o nome da tabela de destino da operação, como carregar, copiar ou consultar.
  • Texto da consulta — o texto enviado para consulta SQL.
  • Bytes processados — o número total de bytes processados pela consulta.
  • Código UDF — um recurso in-line que contém o código de funções definidas pelo usuário (UDF, na sigla em inglês).

É possível filtrar, carregar, copiar ou extrair os jobs usando qualquer uma das seguintes propriedades:

  • Qualquer um - qualquer propriedade.
  • Código do job (jobid) — o código único e opaco do job.
  • Usuário (user) — o usuário que enviou o job.
  • Horário de início (start) — hora de início do job, em milissegundos, desde o início. Essa propriedade está presente quando o job faz a transição de PENDING para RUNNING ou DONE.
  • Horário de término (end) — horário de término do trabalho, em milissegundos, desde o início. Essa propriedade está presente quando o job está com status DONE.
  • Tabela de destino (dest) — o nome da tabela de destino da operação, como carregar, copiar ou consultar.
  • Título (title) — o título como aparece no histórico. Por exemplo: "Arquivo enviado ao meuprojeto:meuconjutnodedados.minhatabela".
  • Tipo (type) — o tipo de job: carregar, consultar, copiar ou extrair/exportar.
  • Copiar fonte (copysrc) — a tabela de origem de um job de cópia.
  • Destino URI (desturi) — o destino Cloud Storage URI para uma extração/exportação de job.
  • Tabela fonte (srctable) — a tabela de origem para um job de extração.
  • Fonte URI (srcuri) — a fonte Cloud Storage URI para o carregamento de job.

Como classificar o histórico de consultas

Também é possível classificar seu histórico de consultas na IU usando a opção Classificar por no painel de Consultas. Para abrir o painel de Consultas, clique em Histórico de consultas no painel de navegação.

Botão "Classificar por histórico de consultas"

As opções de classificação incluem as seguintes alternativas:

  • Data — classifica as consultas pela data de execução.
  • Duração — classifica as consultas pelo tempo total de execução.
  • Duração/byte — classifica as consultas por duração, normalizadas por bytes de entrada. Isso facilita a comparação do tempo de execução das consultas com diferentes tamanhos de entrada. Por exemplo, você tem um conjunto de tabelas que crescem ao longo do tempo e quer comparar a eficiência de suas consultas, enquanto desconta a diferença causada somente pela alteração do tamanho da entrada. Isso pressupõe que a relação entre tamanho de entrada e tempo de execução é linear.
  • Bytes de entrada — classifica as consultas por bytes lidos.
  • Slot-ms — classifica as consultas pela soma de milissegundos ativos em todos os slots usados pela consulta. A classificação por slot-ms é uma medida mais estável do esforço de processamento por ser menos afetada pelos atrasos do sistema e outras fontes de incerteza que afetam a duração observada.
  • Slot-ms/byte — semelhante à Duração/byte, é uma forma normalizada de slot-ms.

    Opções de classificação do histórico de consultas

Limite de exibições da IU da Web

A IU da Web tem os seguintes limites de exibição:

  • Até 10.000 projetos no painel de navegação.
  • Até 1.000 conjuntos de dados por projeto.
  • Até 30.000 tabelas por conjunto de dados. No total, é possível exibir 75.000 tabelas entre seus conjuntos de dados, incluindo conjuntos de dados em projetos fixados.

Como controlar o desempenho de exibição do IU da Web

Em casos raros, o desempenho da IU da Web pode ser afetado quando um projeto tem um alto número de conjuntos de dados com uma grande quantidade de tabelas. Se isso acontecer, use ? para melhorar o desempenho da IU. Com o parâmetro minimal, o número de recursos exibidos é limitado em 10.000 tabelas por projeto. Para isso, digite, por exemplo, o seguinte URL no seu navegador:

https://bigquery.cloud.google.com/queries/project_id?minimal

Atalhos do teclado

Estes são os atalhos usados na IU da Web:

Combinação de teclas (Windows/Linux) Combinação de teclas (Mac OS) Ação
Ctrl + Espaço Cmd + Espaço Se nenhuma consulta estiver aberta: criar nova consulta.
Se o editor de consultas estiver aberto: preencher a palavra atual automaticamente.
Ctrl + Enter Cmd + Enter Executar a consulta atual.
Tab Tab Preencher a palavra atual automaticamente.
Ctrl Cmd Destacar nomes de tabelas.
Ctrl + clique no nome da tabela Cmd + clique no nome da tabela Abrir o esquema da tabela.
Ctrl + E Cmd + E Executar consulta a partir da seleção.
Ctrl + / Cmd + / Comentar linhas atuais ou selecionadas.
Ctrl + Shift + F Cmd + Shift + F Formatar consulta

Exemplos

Consulte a seção Guias de instrução na documentação do BigQuery para exemplos da IU da Web. Abaixo estão links sobre tarefas comuns da IU da Web, como executar consultas e criar, listar, deletar modificar e receber recursos do BigQuery.

Como consultar dados

Para informações de como executar consultas na IU da Web, consulte:

Como criar recursos

Para informações sobre como usar a IU da Web para criar recursos, consulte:

Como encontrar informações sobre recursos

Para encontrar informações sobre recursos na IU da Web, consulte:

Como listar recursos

Para informações sobre como listar recursos na IU da Web, consulte:

Como atualizar recursos

Para informações sobre como atualizar recursos usando a IU da Web, consulte:

Como carregar dados

Para informações sobre como carregar dados usando a IU da Web, consulte:

Como usar fontes de dados externas

Para informações sobre como consultar dados em fontes externas usando a IU da Web, consulte:

Como exportar dados

Para informações sobre como exportar dados usando a IU da Web, consulte:

Como usar o BigQuery Data Transfer Service

Para informações sobre como usar o serviço de transferência de dados do BigQuery na IU da Web, consulte:

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.