Crie consultas com o explorador de tabelas

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Para pedir apoio técnico ou enviar feedback sobre esta funcionalidade, envie um email para [e-mail].

Este documento mostra como usar o explorador de tabelas para examinar os dados das tabelas e criar consultas de exploração de dados.

Acerca do explorador de tabelas

O explorador de tabelas oferece uma forma automática de explorar visualmente os dados das tabelas e criar consultas com base na sua seleção de campos de tabelas.

No explorador de tabelas, seleciona os campos da tabela a examinar. Pode selecionar até 10 campos de tabela de cada vez.

O explorador de tabelas apresenta os campos selecionados como cartões interativos com a lista de até 10 valores mais comuns para cada campo, ordenados pela coluna count. Pode interagir com os cartões selecionando campos e valores distintos que quer analisar mais detalhadamente. O explorador de tabelas cria uma consulta de exploração de dados com base na sua seleção.

Pode copiar esta consulta para uma nova consulta no editor de consultas ou aplicar a consulta no explorador de tabelas. Quando aplica a consulta, o explorador de tabelas executa-a e atualiza os cartões apresentados com os resultados da consulta. Para continuar a explorar os dados das tabelas, selecione mais campos ou valores nos cartões atualizados.

Limitações

• O explorador de tabelas está disponível para tabelas do BigQuery, tabelas do BigLake, tabelas externas e vistas.
• O Explorador de tabelas permite-lhe explorar uma única tabela de cada vez. A funcionalidade não suporta a exploração simultânea de várias tabelas nem a geração de operações entre tabelas, por exemplo, operações JOIN.
• O explorador de tabelas cria consultas SQL que refletem diretamente a sua seleção de campos de tabelas e valores distintos. Pode executar consultas criadas pelo explorador de tabelas ou editá-las manualmente no editor de consultas. O explorador de tabelas não oferece assistência com tecnologia de IA para gerar, concluir ou explicar consultas SQL.
• Para explorar dados de tabelas e gerar consultas para tabelas com controlo de acesso ao nível da coluna (ACLs) ou autorizações de utilizador restritas, tem de ter acesso de leitura para todos os campos selecionados. Para executar as consultas geradas, tem de ter autorizações suficientes.

Preços

O explorador de tabelas executa consultas com base na sua seleção de campos de tabelas e valores distintos para apresentar os resultados da exploração de tabelas. Estas consultas incorrem em cobranças de preços de computação. O explorador de tabelas apresenta a quantidade de dados que vão ser processados para cada consulta antes de confirmar a seleção dos campos da tabela, acionando a execução da consulta.

Também pode incorrer em custos de computação se executar uma consulta gerada pelo explorador de tabelas.

Para mais informações acerca dos preços de computação do BigQuery, consulte a secção Preços.

Antes de começar

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.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Funções e autorizações necessárias

Para receber as autorizações de que precisa para ver os dados das tabelas e gerar consultas com o explorador de tabelas, peça ao seu administrador que lhe conceda as seguintes funções do IAM:

• Utilizador de tarefas do BigQuery (roles/bigquery.jobUser) no projeto.
• Visualizador de dados do BigQuery (roles/bigquery.dataViewer) em todas as tabelas e vistas que quer explorar.

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para ver dados de tabelas e gerar consultas com o explorador de tabelas. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para ver os dados das tabelas e gerar consultas com o explorador de tabelas:

• bigquery.jobs.create no projeto a partir do qual a consulta está a ser executada, independentemente de onde os dados estão armazenados.
• bigquery.tables.getData em todas as tabelas e vistas que quer explorar.

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Para mais informações sobre o Identity and Access Management (IAM) do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Explore dados numa tabela para criar uma consulta

Para explorar os dados de tabelas e criar uma consulta com base na sua seleção de campos e valores de tabelas, siga estes passos:

1. Na Google Cloud consola, aceda ao BigQuery Studio.

   Aceda ao BigQuery Studio

2. No painel Explorador, selecione a tabela para a qual quer criar uma consulta.

3. Clique no separador Explorador de tabelas e, de seguida, clique em Selecionar campos.

4. No painel Selecionar campos, selecione até 10 campos de tabela para explorar.

5. Para uma tabela particionada, na secção Filtro de partição, defina um filtro de partição personalizado. Os filtros de partição podem reduzir o cálculo faturável quando explora tabelas.

   1. Selecione Aplicar filtro de partição personalizado.

   2. Nos campos de definições apresentados, configure o filtro de partição.

   A apresentação das definições de filtro depende do tipo de partição da tabela: hora, dia, mês, ano ou intervalo.

6. Clique em Guardar.

   Quando clica em Guardar, o BigQuery executa uma consulta para apresentar valores comuns para os campos selecionados, o que acarreta custos. Pode ver a quantidade de dados que vão ser processados na parte superior do painel Selecionar campos.

   O explorador de tabelas apresenta os campos selecionados como cartões numa lista de até dez valores mais comuns ordenados pela coluna Count. Na secção Consulta gerada, pode ver uma consulta que pode executar para mostrar os mesmos dados.

7. Opcional: para modificar os resultados, pode experimentar o seguinte:

   1. Nos cartões de campos selecionados apresentados, selecione valores distintos para filtrar ainda mais os dados.
   2. Para reverter todas as alterações, clique em Repor.
   3. Na secção Consulta gerada, clique em Copiar para consulta para copiar o código gerado para uma nova consulta sem título no editor de consultas. No separador de consulta criado recentemente, pode editar, executar e gerir a consulta.

8. Para executar a consulta gerada, clique em Aplicar.

   O BigQuery executa a consulta gerada e atualiza os cartões apresentados com os resultados da consulta.

9. Para continuar a exploração da tabela, selecione novos campos ou valores distintos nos cartões apresentados atualizados.

Resolução de problemas

Access Denied: Project [project_id]: User does not have bigquery.jobs.create
permission in project [project_id].

Este erro ocorre quando um principal não tem autorização para criar tarefas de consulta no projeto.

Resolução: um administrador tem de lhe conceder a autorização bigquery.jobs.create no projeto que está a consultar. Esta autorização é necessária além de qualquer autorização necessária para aceder aos dados consultados.

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

O que se segue?

• Saiba como explorar os seus dados gerando estatísticas de dados.
• Saiba como escrever consultas com a ajuda do Gemini no BigQuery.
• Saiba como iterar os resultados das consultas com perguntas em linguagem natural através da tela de dados.