Como usar as páginas conectadas

As páginas conectadas trazem a escala do BigQuery para a interface familiar das Planilhas Google. Com as Planilhas Google conectadas, é possível visualizar os dados do BigQuery e usá-los em tabelas dinâmicas, fórmulas e gráficos criados com base em todo o conjunto de dados.

Além disso, você também pode conferir os tópicos a seguir:

• colaborar com parceiros, analistas ou outras partes interessadas em uma interface de planilha conhecida;

• garantir uma única fonte de informações confiáveis para análise de dados sem outras exportações de planilha;

• simplificar os fluxos de trabalho de relatórios e painéis.

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:

# Allows egress to Sheets through the Connected Sheets feature
- 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

Primeiro, verifique se você atende aos requisitos para acessar os dados do BigQuery no Planilhas, conforme descrito na seção "O que você precisa" do tópico "Espaço de trabalho do Google" Primeiros passos com os dados do BigQuery no Google Planilhas.

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

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.

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.

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

   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 evitar o faturamento contínuo, exclua os recursos que você criou. Veja mais detalhes em Como fazer a limpeza.

Abrir conjuntos de dados do BigQuery nas páginas conectadas

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

1. Crie ou abra uma planilha do Planilhas Google.

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

   Observação: se você não encontrar a opção Conectores de dados, 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 Planilhas Google. 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 é 100.000.

Você também pode extrair os dados para uma planilha Google. 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 deverá 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 Google Cloud .

Abrir tabelas no páginas conectadas

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 seu projeto, clique em Conjuntos de dados e selecione o conjunto de dados que contém a tabela que você quer abrir no Planilhas Google.

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 nas páginas conectadas

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 abrir no painel de detalhes e clique em Abrir em > Páginas conectadas.

Limpar

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

Cuidado: excluir 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. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

A seguir

• Veja mais informações no tópico Primeiros passos com os dados do BigQuery no Planilhas Google.

• Veja vídeos da playlist do Páginas conectadas no YouTube.