Usar páginas conectadas

Use as páginas conectadas para analisar conjuntos de dados do BigQuery diretamente na interface conhecida do Google Planilhas. Analise seus dados com gráficos, fórmulas e tabelas dinâmicas, colabore com as partes interessadas e mantenha uma única fonte de verdade sem depender de exportações manuais de planilhas.

as páginas conectadas executa consultas do BigQuery em seu nome mediante solicitação ou por meio de uma programação definida. Os resultados dessas consultas são salvos na planilha para análise e compartilhamento.

Casos de uso de exemplo

Veja a seguir alguns casos de uso que mostram como o Páginas conectadas permite analisar grandes quantidades de dados de uma planilha sem precisar conhecer o SQL.

• Planejamento de negócios: crie e prepare conjuntos de dados e permita que outras pessoas encontrem insights a partir dos dados. Por exemplo, analise os dados de vendas para determinar quais produtos são mais vendidos em diferentes locais.

• Serviço ao cliente: descubra quais lojas têm mais reclamações por 10.000 clientes.

• Vendas: crie relatórios de finanças e vendas internos e compartilhe relatórios de receita com representantes de vendas.

Controle de acesso

O acesso direto a tabelas e conjuntos de dados do BigQuery é controlado no BigQuery. Se você quiser conceder a um usuário acesso apenas às Planilhas Google, compartilhe a planilha sem dar acesso ao BigQuery.

Um usuário com acesso somente ao Planilhas Google pode realizar análises na planilha e usar outros recursos do aplicativo, mas não poderá realizar as seguintes ações:

• Atualize manualmente os dados do BigQuery na planilha.
• Programe uma atualização dos dados na planilha.

Quando você filtra dados nas páginas conectadas, ele atualiza a consulta enviada ao BigQuery em relação ao projeto selecionado. Você pode ver a consulta executada com o filtro de registro a seguir no projeto relacionado:

resource.type="bigquery_resource"
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId != NULL_VALUE

VPC Service Controls

Use o VPC Service Controls para restringir o acesso aos recursos doGoogle Cloud . Como o VPC Service Controls não é compatível com o Planilhas, talvez você não consiga acessar os dados do BigQuery que o VPC Service Controls protege. Se você tiver as permissões de permissão necessárias e atender às restrições de acesso do VPC Service Controls, poderá configurar o perímetro do VPC Service Controls para permitir consultas emitidas pelo páginas conectadas. Para fazer isso, configure o perímetro usando o seguinte:

• Um nível de acesso ou uma regra de entrada para permitir solicitações de endereços IP, identidades e dispositivos clientes confiáveis de fora do perímetro.
• Uma regra de saída para permitir que os resultados da consulta sejam copiados para as planilhas dos usuários

Saiba mais sobre como configurar políticas de entrada e saída e configurar níveis de acesso para configurar corretamente as regras. Para configurar um perímetro para permitir a cópia de dados necessária, use o seguinte arquivo YAML:

- egressTo:
    operations:
    - serviceName: 'bigquery.googleapis.com'
      methodSelectors:
      - permission: 'bigquery.vpcsc.importData'
    resources:
    - projects/628550087766 # Sheets-owned Google Cloud project
  egressFrom:
    identityType: ANY_USER_ACCOUNT

Observação: as atualizações programadas das páginas conectadas não propagam nenhum contexto do usuário final, como endereço IP ou informações do dispositivo. Perímetros do VPC Service Controls que usam o contexto do usuário final para restringir o acesso causam falha nas atualizações programadas.

Antes de começar

Se você não tiver um projeto do Google Cloud configurado para faturamento, siga estas etapas:

1. 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.
   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

2. Verify that billing is enabled for your Google Cloud project.

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

   Ative a API BigQuery, se ainda não estiver ativada.

   Funções necessárias para ativar APIs

   Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

   Ativar a API

Para evitar o faturamento contínuo, exclua os recursos criados. Veja mais detalhes em Como fazer a limpeza.

Abrir dados do BigQuery nas páginas conectadas

É possível abrir conjuntos de dados, tabelas e consultas salvas nas páginas conectadas.

Conjuntos de dados abertos

O exemplo a seguir usa um conjunto de dados público para mostrar como se conectar ao BigQuery a partir do Google Planilhas:

1. Crie ou abra uma planilha do Planilhas Google.

2. Clique em Dados, Conectores de dados e depois Conectar ao BigQuery.

   Observação: se a opção Conectores de dados não aparecer, consulte Antes de começar.

3. Selecione um projeto do Google Cloud com o faturamento ativado.

4. Clique em Conjuntos de dados públicos.

5. Na caixa de pesquisa, digite chicago e selecione o conjunto de dados chicago_taxi_trips.

6. Selecione a tabela taxi_trips e clique em Conectar.

   

   A planilha deve ser semelhante a esta:

   

Comece a usar a planilha. Você pode criar tabelas dinâmicas, fórmulas, gráficos, colunas calculadas e consultas programadas usando técnicas conhecidas do Google Planilhas. Para mais informações, consulte o tutorial do Páginas conectadas.

Embora a planilha mostre uma visualização de apenas 500 linhas, qualquer tabela dinâmica, fórmula e gráfico usam todo o conjunto de dados. O número máximo de linhas para resultados retornados para tabelas dinâmicas é 200.000.

Você também pode extrair os dados para o Google Planilhas. O número máximo de linhas e células para resultados retornados para extrações de dados depende das seguintes condições:

• Se o número de linhas for menor ou igual a 50.000, não haverá limite de células.
• Se o número de linhas for maior que 50.000, mas menor ou igual a 500.000, o número de células precisará ser menor ou igual a 5 milhões.
• Se o número de linhas for maior que 500.000, a extração de dados não será aceita.

Quando você usa as páginas conectadas para criar um gráfico, uma tabela dinâmica, uma fórmula ou outra célula calculada com base nos seus dados, as páginas conectadas executam uma consulta no BigQuery em seu nome. Para ver essa consulta, faça o seguinte:

1. Selecione a célula ou o gráfico que você criou.
2. Mantenha o ponteiro sobre Atualizar.
3. Opcional: para atualizar os resultados da consulta nas páginas conectadas, clique em Atualizar.

4. Para ver a consulta no BigQuery, clique em Detalhes da consulta no BigQuery.

   A consulta é aberta no console do Google Cloud .

Abrir tabelas

Para abrir uma tabela nas páginas conectadas, siga estas etapas:

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Explorer:

   

   Se o painel esquerdo não aparecer, clique em Expandir painel esquerdo para abrir.

3. No painel Explorer, expanda o projeto, clique em Conjuntos de dados e clique no conjunto de dados que contém a tabela que você quer abrir no Google Planilhas.

4. Clique em Visão geral > Tabelas e, ao lado do nome da tabela, clique em Ver ações e selecione Abrir em > Páginas Conectadas.

Abrir consultas salvas

Verifique se você tem uma consulta salva. Para mais informações, consulte Criar consultas salvas.

Para abrir uma consulta salva nas páginas conectadas, siga estas etapas:

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

   Acessar o BigQuery

2. No painel à esquerda, clique em Explorer:

   

3. No painel Explorer, expanda o projeto e clique em Consultas. Encontre a consulta salva que você quer abrir nas páginas conectadas.

4. Clique em Abrir ações ao lado da consulta salva e em Abrir em > Páginas Conectadas.

   Como alternativa, clique no nome da consulta salva para abri-la no painel de detalhes e, em seguida, clique em Abrir em > Páginas Conectadas.

Usar a análise de conversas nas páginas conectadas

Use a análise de conversação nas Páginas Conectadas para fazer perguntas e analisar seus dados do BigQuery usando linguagem natural. O Gemini traduz suas perguntas em consultas SQL otimizadas, as executa e resume as principais tendências, além de permitir que você solte objetos de banco de dados atualizáveis em tempo real diretamente na sua planilha.

Para analisar dados e criar objetos de banco de dados nas Páginas Conectadas, siga estas etapas:

1. Abra o painel lateral do Gemini.

   Na primeira vez que você usar a análise de conversação, talvez apareça uma solicitação para autorizar o acesso ao BigQuery. Para continuar, clique em Conectar.

2. No campo de texto, digite sua pergunta. É possível manter o contexto em várias perguntas.

3. Peça ao Gemini para criar objetos dinâmicos e atualizáveis.

4. Para adicionar os resultados diretamente à planilha, clique em Inserir. É possível atualizar os objetos manualmente a qualquer momento ou programar uma atualização.

Preparar seus dados para análise

É possível classificar e filtrar bilhões de linhas de dados do BigQuery diretamente no Google Planilhas para facilitar o trabalho. Clique no ícone Filtrar na parte de cima de uma coluna para classificar os dados ou aplicar filtros por condição e valor. Para mais informações, consulte Classificar e filtrar os dados do BigQuery no Google Planilhas.

Para facilitar a leitura dos dados sem modificar o esquema do BigQuery, atribua nomes personalizados (aliases) aos cabeçalhos das colunas. Para configurar um alias, faça o seguinte:

1. Na parte de cima da coluna que você quer renomear, clique na seta para baixo.
2. Selecione Renomear coluna com alias.
3. Insira o novo nome.
4. Clique em Salvar.

Não é possível atribuir um alias a colunas calculadas, e qualquer alias criado só persiste em uma única conexão do BigQuery em uma única pasta de trabalho. Para mais informações, consulte Primeiros passos com dados do BigQuery no Google Planilhas.

Analisar dados nas páginas conectadas

É possível realizar análises detalhadas dos dados do BigQuery usando as ferramentas conhecidas do Google Planilhas. É possível criar gráficos, tabelas dinâmicas que aceitam até 100.000 resultados e aplicar funções de planilha compatíveis para resumir o conjunto de dados. Também é possível extrair até 500.000 linhas ou 10 MB de dados do BigQuery para análise off-line.

Para mais informações, consulte Analisar e atualizar dados do BigQuery no Google Planilhas.

Escrever uma consulta personalizada nas Páginas Conectadas

Para fazer análises mais complexas, como mesclar dados de várias tabelas do BigQuery, escreva consultas personalizadas do GoogleSQL diretamente nas páginas conectadas.

Para escrever uma consulta, faça o seguinte:

1. Clique em Consultas salvas > Editor de consultas.
2. Digite sua consulta. É possível configurar parâmetros para usar o valor de células específicas da planilha na consulta.
3. Clique em Inserir resultados.

Para mais informações e exemplos de consultas, consulte Escrever e editar uma consulta.

Monitorar o uso do BigQuery nas páginas conectadas

Como administrador do BigQuery, é possível monitorar e auditar o consumo de recursos das páginas conectadas para entender os padrões de uso, gerenciar custos e identificar relatórios usados com frequência. As seções a seguir fornecem exemplos de consultas SQL para ajudar a monitorar esse uso nos níveis da organização e do projeto. Para mais informações, consulte Visualização JOBS.

Todas as consultas originadas das Páginas Conectadas recebem um prefixo de ID da tarefa exclusivo: sheets_dataconnector. Use esse prefixo para filtrar jobs nas visualizações INFORMATION_SCHEMA.JOBS.

Agrupar o uso das páginas conectadas por usuário no nível da organização

A consulta a seguir fornece um resumo dos principais usuários das páginas conectadas na sua organização nos últimos 30 dias, classificados pelo total de dados faturados. A consulta agrega o número total de consultas, o total de bytes faturados e o total de milissegundos de slot para cada usuário. Essas informações são úteis para entender a adoção e identificar os principais consumidores de recursos.

SELECT
  user_email,
  COUNT(*) AS total_queries,
  SUM(total_bytes_billed) AS total_bytes_billed,
  SUM(total_slot_ms) AS total_slot_ms
FROM
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`
WHERE
  -- Filter for jobs created in the last 30 days
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  -- Filter for jobs originating from Connected Sheets
  AND job_id LIKE 'sheets_dataconnector%'
  -- Filter for completed jobs
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
GROUP BY
  1
ORDER BY
  total_bytes_billed DESC;

Substitua REGION_NAME pela região do seu projeto. Por exemplo, region-us.

Observação : é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

O resultado será semelhante a este:

+---------------------+---------------+--------------------+-----------------+
| user_email          | total_queries | total_bytes_billed | total_slot_ms   |
+---------------------+---------------+--------------------+-----------------+
| [e-mail]   | 152           | 12000000000        | 3500000         |
| [e-mail]     | 45            | 8500000000         | 2100000         |
| [e-mail] | 210           | 1100000000         | 1800000         |
+---------------------+---------------+--------------------+-----------------+

Encontrar registros de jobs de consultas das páginas conectadas no nível da organização

A consulta a seguir fornece um registro detalhado de cada job individual executado pelas Páginas Conectadas. Essas informações são úteis para auditar e identificar consultas específicas de alto custo.

SELECT
  job_id,
  creation_time,
  user_email,
  project_id,
  total_bytes_billed,
  total_slot_ms
FROM
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND job_id LIKE 'sheets_dataconnector%'
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
ORDER BY
  creation_time DESC;

Substitua REGION_NAME pela região do seu projeto. Por exemplo, region-us.

Observação : é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

O resultado será semelhante a este:

+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+
| job_id                          | creation_time                   | user_email      | project_id | total_bytes_billed | total_slot_ms |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+
| sheets_dataconnector_bquxjob_1  | 2025-11-06 00:26:53.077000 UTC  | [e-mail] | my_project | 12000000000        | 3500000       |
| sheets_dataconnector_bquxjob_2  | 2025-11-06 00:24:04.294000 UTC  | [e-mail] | my_project | 8500000000         | 2100000       |
| sheets_dataconnector_bquxjob_3  | 2025-11-03 23:17:25.975000 UTC  | [e-mail] | my_project | 1100000000         | 1800000       |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+

### Agregar o uso das páginas conectadas por usuário no nível do projeto

Se você não tiver permissões no nível da organização ou só precisar monitorar um projeto específico, execute a consulta a seguir para identificar os principais usuários das Páginas Conectadas em um projeto nos últimos 30 dias. A consulta agrega o número total de consultas, o total de bytes faturados e o total de milissegundos de slot para cada usuário. Essas informações são úteis para entender a adoção e identificar os principais consumidores de recursos.

SELECT
  user_email,
  COUNT(*) AS total_queries,
  SUM(total_bytes_billed) AS total_bytes_billed,
  SUM(total_slot_ms) AS total_slot_ms
FROM
  -- This view queries the project you are currently running the query in.
  `region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_PROJECT
WHERE
  -- Filter for jobs created in the last 30 days
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  -- Filter for jobs originating from Connected Sheets
  AND job_id LIKE 'sheets_dataconnector%'
  -- Filter for completed jobs
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
GROUP BY
  user_email
ORDER BY
  total_bytes_billed DESC
LIMIT
  10;

Substitua REGION_NAME pela região do seu projeto. Por exemplo, region-us.

Observação : é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

O resultado será semelhante a este:

+---------------------+---------------+--------------------+-----------------+
| user_email          | total_queries | total_bytes_billed | total_slot_ms   |
+---------------------+---------------+--------------------+-----------------+
| [e-mail]   | 152           | 12000000000        | 3500000         |
| [e-mail]     | 45            | 8500000000         | 2100000         |
| [e-mail] | 210           | 1100000000         | 1800000         |
+---------------------+---------------+--------------------+-----------------+

### Encontrar registros de jobs de consultas das páginas conectadas no nível do projeto

Se você não tiver permissões no nível da organização ou só precisar monitorar um projeto específico, execute a consulta a seguir para ver um registro detalhado de todas as consultas das Páginas Conectadas para o projeto atual:

SELECT
  job_id,
  creation_time,
  user_email,
  total_bytes_billed,
  total_slot_ms,
  query
FROM
  -- This view queries the project you are currently running the query in.
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_PROJECT`
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND job_id LIKE 'sheets_dataconnector%'
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
ORDER BY
  creation_time DESC;

Substitua REGION_NAME pela região do seu projeto. Por exemplo, region-us.

Observação : é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

O resultado será semelhante a este:

+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+
| job_id                          | creation_time                   | user_email       | total_bytes_billed | total_slot_ms   |  query                          |
+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+
| sheets_dataconnector_bquxjob_1  | 2025-11-06 00:26:53.077000 UTC  | [e-mail]  | 12000000000        | 3500000         |  SELECT ... FROM dataset.table1 |
| sheets_dataconnector_bquxjob_2  | 2025-11-06 00:24:04.294000 UTC  | [e-mail]  | 8500000000         | 2100000         |  SELECT ... FROM dataset.table2 |
| sheets_dataconnector_bquxjob_3  | 2025-11-03 23:17:25.975000 UTC  | [e-mail]  | 1100000000         | 1800000         |  SELECT ... FROM dataset.table3 |
+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial:

Cuidado: a exclusão de um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto atual para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos nele.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja explorar várias arquiteturas, tutoriais e guias de início rápido, a reutilização de projetos pode evitar que você exceda limites da cota.

1. No console Google Cloud , acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir

• Como usar os dados do BigQuery no Google Planilhas.
• Assista aos vídeos da playlist sobre como usar as páginas conectadas.
• Conclua o laboratório Páginas conectadas: Qwik Start.
• Conclua o laboratório Como analisar dados de faturamento do BigQuery no Google Planilhas.
• Ganhe o selo de habilidade "Análise de dados do BigQuery nas páginas conectadas".