Como usar o Console do Cloud

O Console do Google Cloud fornece uma interface gráfica que pode ser usada para criar e gerenciar recursos do BigQuery e executar consultas SQL.

Consulte o guia de início rápido do Console do Cloud para uma introdução ao uso do Console do Cloud.

Antes de começar

Antes de usar o Console do Cloud, você precisa criar ou selecionar um projeto do Google Cloud.

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

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

  2. No Console do Cloud, na página do seletor de projetos, selecione ou crie um projeto do Cloud.

    Acessar a página do seletor de projetos

  3. O BigQuery é ativado automaticamente em novos projetos. Para ativar o BigQuery em um projeto preexistente, acesse Ative a API BigQuery.

    Ative a API

  4. Se não quiser informar um cartão de crédito ou ativar o faturamento do seu projeto, use o sandbox fornecido pelo BigQuery. É possível seguir as etapas deste tópico mesmo que seu projeto não tenha o faturamento ativado. Se quiser ativá-lo, consulte Saiba como ativar o faturamento.

Como abrir a página do BigQuery no Console do Cloud

Para abrir a página do BigQuery no Console do Cloud:

  1. Abra o Console do Cloud.

    Acessar Console do Cloud

  2. No painel de navegação, clique em BigQuery.

Também é possível abrir a página do BigQuery diretamente digitando o URL a seguir no seu navegador.

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

Se preferir, clique aqui para abrir a página do BigQuery no Console do Cloud diretamente usando seu projeto mais recente:

Acessar a página do BigQuery

Como mudar para a IU da Web clássica

Para utilizar a IU da Web clássica, use o ícone de informações à direita da barra de título. Basta clicar no botão Acessar a interface clássica na parte superior da janela.

Link para a IU da Web clássica.

Visão geral do Console do Cloud

O Console do Cloud tem três seções principais:

  1. Painel de navegação, à esquerda da página:

    O painel de navegação contém uma lista de recursos do BigQuery.

    • A seção Histórico de consultas exibe os jobs de consultas do seu projeto.
    • A seção Consultas salvas exibe suas consultas salvas e compartilhadas.
    • A seção Histórico de jobs exibe os jobs de carga, exportação e cópia do seu projeto.
    • A seção Transferências abre a IU do serviço de transferência de dados do BigQuery.
    • A seção Consultas programadas exibe suas consultas programadas.
    • A seção BI Engine exibe o console do BI Engine.
    • A seção Recursos contém uma lista de projetos fixados. Expanda um projeto para visualizar os conjuntos de dados e tabelas a que você tem acesso. Na seção Recursos há uma caixa de pesquisa em que é possível procurar recursos por nome (do projeto, do conjunto de dados, da tabela ou da visualização) ou por rótulo. A barra de pesquisa encontra todos os recursos correspondentes ou que contêm correspondências nos projetos atuais e fixados.
    • Para usar a pesquisa e o preenchimento automático com tecnologia do Data Catalog (versão Beta), no Teste a pesquisa e o preenchimento automático com tecnologia do Data Catalog clique em Ativar. Com esse recurso ativado, o BigQuery carrega os resultados sob demanda para pesquisas no painel Recursos e para o preenchimento automático no Editor de consultas. Se você tiver muitos recursos, o Data Catalog melhorará o desempenho do Console do Cloud. Ele também permite procurar recursos fora dos seus projetos fixados atuais.
  2. Painel de detalhes:
    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. Editor de consultas:
    O editor de consultas é exibido acima do painel de detalhes quando você clica em Escrever nova consulta. Clique em Ocultar editor quando não precisar mais dele.

Captura de tela do Console do Google Cloud

Como exibir recursos

O painel de navegação exibe os conjuntos de dados do seu projeto atual. Clique no ícone ícone de expansão do conjunto de dados ao lado do projeto para exibir os conjuntos de dados dele. Clique no ícone ao lado de qualquer conjunto de dados para expandi-lo e exibir as tabelas presentes nele.

Ao clicar no conjunto de dados ou na tabela, você vê informações sobre o recurso no painel de detalhes. Após clicar em uma tabela no painel de navegação, é possível pressionar o botão Consultar tabela, à direita do painel de detalhes, para preencher a caixa com uma consulta básica daquela tabela. É possível personalizar ou modificar a consulta manualmente se você quiser especificar campos. Também é possível consultar outras tabelas além da selecionada. Para mais informações sobre como consultar tabelas, consulte Como executar consultas interativas.

Como trabalhar com projetos

Todo o trabalho no BigQuery é feito dentro de um projeto. O nome desse projeto pode ser visto no painel de navegação, abaixo da caixa do filtro de conjuntos de dados. Também é possível visualizar o projeto atual com a barra da plataforma na parte superior da página.

Barra da plataforma.

O trabalho realizado em um projeto é cobrado na conta de faturamento ligada a ele. Para mais informações sobre cobranças do BigQuery, consulte a página de preços.

No Console do Cloud, é possível:

  • alterna projetos.
  • adicionar ou fixar projetos;
  • remover projetos fixados.

Como trocar de projeto

Para alternar projetos no Console do Cloud:

  1. Clique no projeto na barra da plataforma, localizada na parte superior da página.

    Barra da plataforma.

  2. Clique no nome do projeto na lista da caixa de diálogo. Isso substitui o projeto anterior no Console do Cloud pelo que você escolheu.

Como fixar (adicionar) um projeto

É possível adicionar ou "fixar" um projeto no Console do Cloud usando a opção "fixar projeto".

Existem duas formas de fixar um projeto:

  • Trocar de projeto, depois fixá-lo.
  • Usar a opção Fixar projeto no painel de navegação.

Opção 1: abrir e fixar um projeto

Para abrir e fixar um projeto, faça o seguinte:

  1. Mude para o projeto que você quer fixar ao painel de navegação.

  2. Clique no ID do projeto no painel de navegação.

  3. Clique em Fixar Projeto no painel de detalhes, à direita.

    Fixar projeto.

Opção 2: usar a opção Fixar projeto

Para fixar um projeto usando o diálogo Fixar projeto, faça o seguinte:

  1. Clique em Fixar projeto na seção Recursos do painel de navegação.

  2. Na caixa de diálogo Fixar projeto, clique na lista Selecionar projeto. Você pode escolher um projeto na lista Projetos selecionados recentemente ou usar a caixa Filtrar por para conferir rapidamente a lista Todos os projetos.

  3. Clique em Fixar projeto para fechar a caixa de diálogo Fixar projeto.

Como remover um projeto do Console do Cloud

Para remover um projeto fixado:

  1. Clique no ID do projeto no painel de navegação.

  2. Clique em Liberar Projeto no painel de detalhes.

Como ver o histórico de jobs e consultas

Conforme você executar jobs e executar consultas usando o Console do Cloud, seu histórico é mantido no painel de navegação. Consultas são um tipo de job, mas o histórico delas fica guardado separadamente para facilitar o uso.

O histórico de jobs e consultas no Console do Cloud inclui todos os jobs de carga, exportação, cópia e consulta que você enviou nos últimos seis meses (até 1.000 entradas). Esse limite é cumulativo entre todos os tipos de jobs.

Para listar todos os jobs disponíveis no histórico, use o método da API jobs.list ou o comando bq ls na ferramenta de linha de comando bq.

Como ver o histórico de jobs

Clique no link Histórico de jobs para visualizá-lo no painel de navegação.

No painel de detalhes do histórico, clique em um job para ver os detalhes ou repeti-lo. É possível repetir um job de carregamento por meio do Console do Cloud, mas não é possível repetir um job de cópia ou exportação.

Como ver o histórico de consultas

Clique no link Histórico de consultas para visualizá-lo no painel de navegação.

No painel de detalhes do histórico, clique em um job de consulta para ver os detalhes ou abri-lo no editor de consultas. Para repetir a consulta no editor de consultas, clique em Executar consulta.

Limites de exibição do Console do Cloud

O Console do Cloud tem os seguintes limites de exibição:

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

Atalhos do teclado

Os seguintes atalhos de teclado são compatíveis com o Console do Cloud:

Combinação de teclas (Windows/Linux) Combinação de teclas (Mac OS) Ação
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ções na documentação do BigQuery para ver exemplos do Console do Cloud.

Para ver exemplos de como carregar dados e consultar dados usando o Console do Cloud, consulte o Guia de início rápido sobre como usar o Console do Cloud.

A seguir