Conhecer o BigQuery no console do Google Cloud

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

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  4. Enable the BigQuery API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    Para novos projetos, a API BigQuery é ativada automaticamente.

  5. Opcional: ative o faturamento do projeto. Se você não quiser ativar o faturamento ou informar um cartão de crédito, as etapas deste documento ainda funcionarão. O BigQuery fornece um sandbox para executar as etapas. Para mais informações, consulte Ativar o sandbox do BigQuery.
  6. Abra a página "Visão geral" no console do Google Cloud .

    A página de visão geral do BigQuery é seu hub para descobrir tutoriais, recursos e recursos que ajudam você a aproveitar ao máximo o BigQuery. Ele oferece caminhos guiados para usuários de todos os níveis de habilidade, seja executando sua primeira consulta ou explorando recursos avançados de IA/ML.

    Use a página "Visão geral" para encontrar recursos organizados por função ou interesse, como análise ou ciência de dados. Assim, você encontra o conteúdo mais relevante para começar rapidamente.

    Para abrir a página "Visão geral", siga estas etapas.

    1. Acesse o console do Google Cloud .

      Acesse o console do Google Cloud .

    2. Na barra de ferramentas do console Google Cloud , clique em Menu de navegação.

    3. Clique em Soluções > Todos os produtos.

    4. Na seção Analytics, clique em BigQuery.

    5. Na navegação, clique em Visão geral.

    Também é possível abrir a página "Visão geral do BigQuery" digitando o URL a seguir no seu navegador:

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

    O BigQuery é aberto no projeto que foi acessado mais recentemente.

    Seções da página de visão geral

    A página "Visão geral" é dividida nas seguintes seções:

    • Introdução: a seção Introdução oferece uma visão geral rápida dos recursos do BigQuery.

    • Começar: a seção Começar foi criada para aprender na prática. Aqui, você pode abrir guias interativos que ajudam a aprender a usar os recursos do BigQuery.

    • Saiba mais: a seção Saiba mais mostra as notas da versão do BigQuery para que você possa conferir os anúncios e atualizações mais recentes de recursos.

    • Conhecer as possibilidades: a seção Conhecer as possibilidades oferece tutoriais detalhados e oportunidades de aprendizado para recursos específicos.

    Personalizar a página "Visão geral"

    No canto superior direito da página, há uma barra de filtro. Clique na função que melhor corresponde à sua tarefa ou função atual:

    • Análise de dados
    • Ciência de dados
    • Engenharia de dados
    • Administração de dados

    Ao selecionar uma tarefa, o conteúdo das seções Introdução, Começar e Explorar possibilidades muda dinamicamente para mostrar o conteúdo mais relevante.

    Ocultar conteúdo irrelevante

    É possível adaptar o conteúdo da página "Visão geral" às suas necessidades específicas ocultando cards individuais em seções. Para ocultar um card:

    1. No card, clique em Mais opções.
    2. Escolha Ocultar card.
    3. Para mostrar o card, clique em Mostrar conteúdo oculto no final da seção.

    Se uma seção inteira não for relevante, você poderá recolhê-la. Suas preferências de seções recolhidas e cards ocultos são salvas por usuário.

    Abra a página do BigQuery Studio no console Google Cloud .

    1. Acesse o console do Google Cloud .

      Acesse o console do Google Cloud .

    2. Na barra de ferramentas do console Google Cloud , clique em Menu de navegação.

    3. Clique em Soluções > Todos os produtos.

    4. Na seção Analytics, clique em BigQuery.

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

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

    O BigQuery é aberto no projeto que foi acessado mais recentemente.

    Para simplificar a navegação, adicione (ou fixe) o BigQuery como um produto superior no menu de navegação:

    1. No menu de navegação do console do Google Cloud , mantenha o ponteiro do mouse sobre BigQuery.

    2. Clique em Marcar.

    Visão geral da página do BigQuery Studio

    A página Studio do BigQuery tem as seguintes seções principais:

    • Menu de navegação do BigQuery
    • O painel esquerdo
    • O painel de detalhes
    • A caixa de diálogo Adicionar dados
    • As guias "Início" e "Consulta"

    No menu de navegação do BigQuery, é possível selecionar qualquer opção das seguintes categorias:

    • Visão geral (prévia): a página de visão geral do BigQuery é seu novo hub central para descobrir tutoriais, recursos e recursos que ajudam você a aproveitar ao máximo o BigQuery.

    • Studio: mostra seus conjuntos de dados, tabelas e outros recursos do BigQuery. Nesse espaço de trabalho, é possível realizar tarefas comuns do BigQuery, como:

      • Criar, executar, salvar e compartilhar consultas e notebooks do Colab Enterprise.
      • Trabalhe com tabelas, visualizações, rotinas e outros recursos do BigQuery.
      • Veja seu histórico de jobs do BigQuery.
    • Pesquisa (prévia): permite pesquisar recursos Google Cloud do BigQuery usando consultas em linguagem natural.

    • Pipelines e integração

      • Transferências de dados: permite acessar o serviço de transferência de dados do BigQuery para criar e configurar transferências de dados.

      • Pipelines (Dataform): mostra uma lista de repositórios do Dataform criados para seu projetoGoogle Cloud .

      • Consultas programadas: mostra suas consultas programadas.

      • Programação: fornece uma lista de pipelines e programações para seu projeto Google Cloud .

    • Governança

      • Compartilhamento (Analytics Hub): mostra todas as trocas de dados que podem ser acessadas no seu projeto Google Cloud .

      • Tags de política: mostra uma lista de taxonomias que podem ser usadas para criar grupos hierárquicos de tags de política.

      • Criação de metadados: permite escanear dados em buckets do Cloud Storage para extrair e catalogar metadados.

    • Administração

      • Monitoring: permite monitorar a integridade operacional e a utilização de recursos em uma organização.

      • Análise de jobs: ajuda você a monitorar a atividade de jobs em toda a organização.

      • Gerenciamento de capacidade: mostra compromissos de slot, reservas e atribuições de reserva.

      • BI Engine: permite gerenciar a capacidade de reserva para otimização de consultas usando o BigQuery BI Engine.

      • Recuperação de desastres: mostra reservas e conjuntos de dados de failover.

      • Recomendações: mostra uma lista de recomendações na sua organização ou projeto.

    • Migração

      • Avaliação: permite planejar e revisar a migração do seu data warehouse atual para o BigQuery.

      • Tradução de SQL: permite converter suas consultas SQL do Teradata para que elas funcionem no BigQuery.

    • Outros recursos

      • Central de parceiros: oferece ferramentas e serviços de parceiros para acelerar seu fluxo de trabalho.

      • Configurações (prévia): contêm as seguintes guias:

        • Minhas configurações: permite definir configurações padrão que são aplicadas quando você inicia uma sessão no BigQuery Studio. Algumas configurações são herdadas do seu projeto ou organização, mas podem ser substituídas na página Minhas configurações.

        • Configurações: permitem que os administradores do BigQuery personalizem a experiência do BigQuery Studio para usuários no projeto ou na organização selecionada. Isso é feito mostrando ou ocultando elementos da interface do usuário, como Salvar resultados > CSV (Google Drive), Abrir no > Looker Studio e Exportar > Analisar com as Planilhas. Essas configurações não restringem o acesso aos dados e ferramentas subjacentes, mesmo que estejam ocultos no BigQuery Studio. Você precisa da permissão bigquery.config.get para fazer mudanças no nível da organização.

      • Notas da versão: contém as atualizações e os anúncios mais recentes de produtos do BigQuery.

      • É possível controlar como o menu de navegação do BigQuery é mostrado:

        • Para recolher o menu de navegação de modo que apenas os ícones fiquem visíveis, clique em Ícone de fechar menu na UI. Alternar menu de navegação do BigQuery.

        • Para expandir temporariamente o menu quando ele estiver recolhido, mantenha o ponteiro sobre o menu.

        • Para expandir o menu de modo que os rótulos permaneçam visíveis, clique em Ícone "Expandir menu" na UI. Alternar menu de navegação do BigQuery.

    Painel esquerdo

    O painel esquerdo fica visível quando você seleciona Studio no menu de navegação. Esse painel consiste em três partes: Explorador, Análises clássicas e Repositório Git.

    Para recolher o painel à esquerda, clique em Recolher painel esquerdo. Para expandir o painel esquerdo, clique em Expandir painel esquerdo.

    Painel Explorador

    O painel Explorer lista diferentes recursos de código e dados. Para abrir uma nova guia no painel de detalhes, clique em um tipo de recurso de código. Essa guia lista todos os arquivos desse tipo de recurso de código no seu projeto. Por exemplo, clique em Notebooks para abrir a guia Notebooks, que lista todos os notebooks do projeto. Você pode usar a barra de pesquisa ou os filtros para encontrar um arquivo.

    Você também pode acessar a guia "Início" ou abrir os históricos de jobs e os recursos marcados com estrela em uma nova guia.

    Abra uma lista de notebooks na guia do editor.

    Use o recurso de pesquisa no painel Explorer para encontrar recursos no BigQuery. Os resultados aparecem em uma nova guia no painel de detalhes. É possível restringir a pesquisa por projetos e tipos de recursos, como Conjunto de dados. Esse recurso de pesquisa abrange os recursos do BigQuery na sua organização, enquanto o recurso de pesquisa da barra de ferramentas do Google Cloud abrange todos os recursos doGoogle Cloud.

    Barra de pesquisa na guia "Explorer".

    Painel do Explorer clássico

    Esse painel lista os projetos atuais do Google Cloud e os projetos marcados com estrela.

    Para ver os recursos nos projetos e conjuntos de dados, faça o seguinte:

    • Para visualizar os conjuntos de dados aos quais você tem acesso em um projeto, expanda o projeto.

    • Para visualizar tabelas, visualizações e funções nesse conjunto de dados, expanda o conjunto de dados.

    Também é possível usar a caixa de pesquisa para procurar recursos por nome (conjunto de dados, tabela ou nome de visualização) ou por identificador nos projetos atuais e marcados com estrela. A pesquisa encontra os recursos que correspondem diretamente ou contêm correspondências à sua consulta de pesquisa. Talvez ela não mostre todos os recursos no nível do recurso correspondente. Para conferir todos os recursos, clique em Mostrar mais.

    Painel do repositório Git

    É possível usar repositórios para fazer o controle de versões dos arquivos usados no BigQuery. O BigQuery usa o Git para registrar mudanças e gerenciar versões de arquivos. Para mais informações, consulte Introdução aos repositórios.

    É possível usar espaços de trabalho em repositórios para editar o código armazenado no repositório. Quando você clica em um espaço de trabalho no painel Repositório Git, ele é aberto em uma guia no painel de detalhes. Para mais informações, consulte Introdução aos espaços de trabalho.

    Painel de detalhes

    O painel de detalhes mostra informações sobre os recursos do BigQuery. Quando você seleciona um conjunto de dados, tabela, visualização ou outro recurso no painel Explorador clássico, uma nova guia é exibida no painel de detalhes. Nessas guias, é possível ver informações sobre o recurso ou criar tabelas e visualizações, modificar esquemas de tabela, exportar dados e realizar outras ações.

    Arraste a guia até a borda do editor para abrir em uma nova coluna e comparar as guias. Ou arraste a guia para uma posição diferente na coluna atual ou em uma coluna adjacente. Esse recurso está na visualização.

    No editor de consultas, é possível executar uma consulta interativa e explorar os resultados no painel Resultados da consulta, que é aberto depois da execução.

    Ao navegar pelas guias, o recurso correspondente à guia em foco é selecionado no painel Análises clássicas. Se você abrir o BigQuery usando o URL do espaço de trabalho, a guia do editor de consultas do espaço de trabalho será aberta e o recurso correspondente será selecionado no painel Classic Explorer.

    Use a barra de pesquisa na barra de ferramentas Google Cloud para procurar recursos (projetos, conjuntos de dados ou tabelas), documentação e produtos (como Compute Engine e Cloud Storage) em Google Cloud. Você pode precisar de permissões, semelhantes às permissões do BigQuery, para acessar recursos em diferentes produtos.

    Caixa de diálogo "Adicionar dados"

    Na caixa de diálogo Adicionar dados, use os recursos de pesquisa e filtragem para encontrar uma fonte de dados com que você quer trabalhar. Depois de selecionar uma fonte de dados, você pode fazer o seguinte com base nos recursos disponíveis para ela.

    Para mais informações sobre como carregar dados no BigQuery, consulte Introdução ao carregamento de dados.

    Além disso, você pode acessar e consultar conjuntos de dados públicos.

    Guias "Início" e "Consultas"

    Na primeira vez que você abrir a página do BigQuery, a guia "Início" e a guia "Editor de consultas" serão exibidas. A guia "Início" está em foco. A guia "Início" contém o seguinte:

    • A seção Confira as novidades do Studio, que lista os novos recursos do BigQuery Studio. Clique em Testar para conferir os recursos. Se a seção não estiver visível, clique em Novidades no Studio para abrir a seção.
    • A seção Criar novo, que tem opções para criar uma consulta SQL, um notebook, um notebook do Apache Spark, uma tela de dados, um arquivo de preparação de dados, um pipeline ou uma tabela.

    • A seção Recente, em que é possível conferir os 10 recursos acessados mais recentemente.

    • Os seguintes guias de demonstração:

      • Executar uma consulta de amostra em um conjunto de dados público do Google Trends.

      • Execute um notebook do Colab que explica os princípios básicos dos DataFrames do BigQuery.

      • Execute um notebook do Spark que mostra os princípios básicos do Spark no BigQuery.

      • Adicionar dados ao BigQuery.

    Página inicial da consulta de demonstração.

    Você pode fechar a guia "Início". Para voltar à guia "Página inicial", clique em *Página inicial no painel Explorador.

    Para abrir um editor de consultas na guia "Início", clique em Consulta SQL. Para acessar maneiras de importar dados e pesquisar fontes de dados que funcionam com o BigQuery, clique em Adicionar dados.

    Se você abrir o BigQuery usando o URL do espaço de trabalho, a guia do editor de consultas do espaço de trabalho será aberta.

    Recursos de exibição

    O painel Explorador lista os conjuntos de dados que podem ser navegados no projeto atual ou quaisquer projetos marcados com estrela. Considere o seguinte ao mostrar recursos:

    • Para mostrar os conjuntos de dados em um projeto, clique em Alternar nó no projeto e depois em Conjuntos de dados. Uma nova guia é aberta na guia "Detalhes" com uma lista de todos os conjuntos de dados no projeto. Clique no conjunto de dados para conferir os detalhes.
    • Para exibir as tabelas, visualizações e funções em um conjunto de dados, clique em Visão geral > Tabelas. Também é possível conferir detalhes, modelos e rotinas de um conjunto de dados em outras guias.
    • Você também pode usar breadcrumbs para navegar sem problemas por diferentes guias e recursos, conforme mostrado na captura de tela a seguir:

      Breadcrumbs no painel de detalhes.

    • Para reduzir a proliferação de guias, clicar em um recurso o abre na mesma guia. Para abrir o recurso em uma guia separada, pressione Ctrl (ou Command no macOS) e clique nele. Para evitar que o conteúdo da guia atual seja substituído, clique duas vezes no nome dela. Você vai notar que o nome muda de itálico para fonte normal. Se você ainda perder o recurso, clique em tab_recent Guias recentes no painel de detalhes para encontrar o recurso.

    Marcar recursos com estrela

    Se você tiver projetos, conjuntos de dados ou tabelas importantes ou atuais, marque-os com uma estrela no painel Classic Explorer. Para marcar um recurso com estrela, mantenha o ponteiro do mouse sobre o nome do recurso que você quer marcar e clique em Marcar com estrela.

    Ver recursos marcados com estrela

    Para ver os recursos marcados com estrela, clique em Marcados com estrela no painel Explorer. Uma nova guia com uma lista de todos os recursos marcados com estrela vai aparecer.

    Se quiser ver todos os recursos como uma árvore de recursos, clique no painel Explorador clássico e desative a opção Mostrar apenas marcados com estrela.

    Remover estrela dos recursos

    Para remover um recurso, acesse o painel Classic Explorer e clique em Remover estrela ao lado do recurso.

    Ver recursos acessados recentemente

    No console do Google Cloud , é possível ver os 10 recursos acessados mais recentemente. Esses recursos incluem tabelas, consultas salvas, modelos e rotinas.

    Quando você cria ou atualiza um recurso no console ou no editor de consultas, ele é marcado como recente. Para que um recurso aberto recentemente seja marcado como recente, você precisa abri-lo na guia do espaço de trabalho. Se você executar uma consulta em um recurso, ele não será marcado como recente.

    Para conferir os recursos acessados recentemente, siga estas etapas:

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

    2. Verifique se você está na página inicial do BigQuery. Se necessário, clique em Início no painel Explorer.

      Na seção Recentes, você encontra os 10 recursos acessados recentemente.

    Como trabalhar com guias

    É possível controlar o uso das guias no painel de detalhes.

    Dividir duas guias

    Sempre que você seleciona um recurso ou clica em Escrever nova consulta no painel de detalhes, uma nova guia é aberta. Se mais de uma guia estiver aberta, será possível dividi-las em dois painéis e visualizá-las lado a lado.

    Para dividir as guias em dois painéis, siga estas etapas:

    1. Ao lado do nome da guia, clique em Abrir menu.

    2. Selecione uma das seguintes opções:

      • Para colocar a guia selecionada no painel esquerdo, selecione Dividir guia à esquerda.
      • Para colocar a guia selecionada no painel direito, selecione Dividir guia à direita.

    Para separar as guias, selecione Abrir menu em uma das guias abertas e selecione Mover guia para o painel esquerdo ou Mover guia para o painel direito.

    Para dividir as guias ao consultar tabelas, siga estas etapas:

    1. No menu Explorer, clique na tabela que você quer consultar.

    2. Clique em Consulta e, em seguida, clique em Em uma nova guia ou Na guia dividida:

      Opções para consultar uma tabela em uma guia nova ou dividida.

    3. Clique no nome do campo que você quer consultar:

      Adicione o nome do campo à consulta em uma guia dividida.

    A imagem a seguir mostra o painel de detalhes com duas guias abertas. Uma guia tem uma consulta SQL e a outra mostra detalhes sobre uma tabela.

    Painel de detalhes com duas guias abertas.

    Mover uma guia

    Para mover uma guia de um painel para o outro, siga estas etapas:

    1. Ao lado do nome da guia, clique em Abrir menu.

    2. Selecione Mover guia para o painel direito ou Mover guia para o painel esquerdo, seja qual for a opção disponível.

    Fechar uma guia

    Para fechar todas as guias, exceto uma, siga estas etapas:

    1. Ao lado do nome da guia, clique em Abrir menu.

    2. Selecione Fechar outras guias.

    Ver o histórico pessoal e do projeto

    Sempre que você carrega, exporta, consulta ou copia dados, o BigQuery cria, agenda e executa automaticamente um job que acompanha o progresso da tarefa. Para ver os históricos de jobs do projeto de faturamento atual, faça o seguinte:

    1. Acessar a página do BigQuery.

      Acessar o BigQuery

    2. No painel à esquerda, clique em Explorer:

      Botão destacado para o painel "Explorer".

    3. No painel Explorer, clique em Histórico de jobs.

      Isso abre a lista de históricos de jobs em uma nova guia:

      Guias do histórico pessoal e do histórico do projeto, além das consultas salvas.

    4. Para ver os detalhes dos seus próprios jobs, clique em Histórico pessoal.

    5. Para ver detalhes de jobs recentes no seu projeto, clique em Histórico do projeto.

    Para ver os detalhes de um job ou abrir a consulta em um editor, faça o seguinte:

    1. Na coluna Ações de um job ou uma consulta, clique em Ações.

    2. Selecione Mostrar detalhes do job ou Ver job no editor.

    Para mais informações sobre como gerenciar jobs, consulte Gerenciar jobs.

    Atalhos do teclado

    Para ver os atalhos no Google Cloud console, clique em Atalhos do BigQuery Studio. Os seguintes atalhos de teclado são compatíveis com o console do Google Cloud :

    Ação Atalho do Windows ou Linux Atalho do macOS
    Criar uma nova guia

    Ctrl+Alt+t

    Cmd+Option+t

    Fechar guia (guia selecionada)

    Delete

    ou

    Backspace

    Delete

    ou

    Backspace

    Formatar consulta

    Ctrl+Shift+f

    Cmd+Shift+f

    Conclusão e geração do código do Gemini

    Ctrl+Shift+Space

    Ctrl+Shift+Space

    Acessar uma guia específica

    Ctrl+Alt+1 through 8

    Cmd+Option+1 through 8

    Ir para a última guia

    Ctrl+Alt+9

    Cmd+Option+9

    Ir para a próxima guia aberta

    Ctrl+Alt+Tab

    ou

    Ctrl+Alt+PgDn

    Cmd+Shift+Option+Right arrow

    Ir para a guia aberta anterior

    Ctrl+Alt+Shift+Tab

    ou

    Ctrl+Alt+PgUp

    Cmd+Shift+Option+Left arrow

    Mover guia para a esquerda

    Ctrl+Alt+Shift+PgUp

    Ctrl+Shift+Option+PgUp

    Mover guia para a direita

    Ctrl+Alt+Shift+PgDn

    Ctrl+Shift+Option+PgDn

    Abrir menu da guia (guia selecionada)

    Shift+F10

    Shift+F10

    Executar consulta ou consulta em destaque

    Ctrl+Enter

    ou

    Ctrl+e

    Cmd+Enter

    ou

    Cmd+e

    Ver a lista de atalhos do editor

    F1

    F1

    Dividir ou mover a guia ativa para a esquerda

    Ctrl+Alt+[

    Cmd+Option+[

    Dividir ou mover a guia ativa para a direita

    Ctrl+Alt+]

    Cmd+Option+]

    Sugestão automática de SQL

    Tab

    ou

    Ctrl+Space

    Tab

    ou

    Ctrl+Space

    Ferramenta de geração de SQL

    Ctrl+Shift+P

    Cmd+Shift+P

    Alternar comentário da linha

    Ctrl+/

    Cmd+/

    A seguir