Você pode acessar, analisar, visualizar e compartilhar bilhões de linhas de dados da sua planilha com as páginas conectadas, o conector de dados das Planilhas. Também é possível usar esse recurso para:
- Colabore com parceiros, analistas ou outras partes interessadas em uma interface de planilha que você já conhece.
- permitir que os usuários deleguem o acesso aos colaboradores;
- garantir uma única fonte de análise de dados confiável sem exportações extras de CSV.
- Analise dados em um perímetro que restringe o acesso com base em atributos, como o endereço IP do usuário e as informações do dispositivo.
Você pode fazer consultas nas páginas conectadas no BigQuery ou no Looker manualmente ou seguindo uma programação. As páginas salvam os resultados dessas consultas na sua planilha para que você os analise e compartilhe. Assista a estes tutoriais em vídeo para saber mais sobre como usar páginas conectadas com o BigQuery.
Você pode conferir os eventos de consulta das páginas conectadas em Eventos de registro do Drive.
Configurar o BigQuery para analisar dados
Etapa 1: ativar o Google CloudVerifique se o Google Cloud está ativado para sua organização. Consulte as instruções em Ver quais apps estão ativados para um usuário, um grupo ou uma unidade organizacional. Se você precisar ativar o Google Cloud, acesse Ativar ou desativar o Google Cloud para os usuários.
Confira instruções sobre como usar as páginas conectadas com o BigQuery em Primeiras etapas com os dados do BigQuery nas Planilhas Google.
Você usa as funções do IAM (gerenciamento de identidade e acesso) para atribuir permissões sobre quais dados os usuários podem acessar. Para adicionar ou usar um projeto do BigQuery nas Planilhas, o papel de IAM de um usuário no BigQuery precisa ser bigquery.user ou bigquery.jobUser e bigquery.dataViewer.
Saiba mais sobre esses papéis em Papéis predefinidos do IAM do BigQuery.
As ações que os usuários podem realizar dependem da função do IAM e das permissões da planilha, não das permissões do proprietário da planilha. Pessoas fora da sua organização só poderão interagir com o Planilhas se você permitir.
| Ações no Planilhas | Papel de IAM obrigatório no BigQuery | Permissões necessárias no Planilhas |
|---|---|---|
| Criar gráficos, tabelas dinâmicas, fórmulas ou extrações usando tabelas ou visualizações do BigQuery |
bigquery.user oubigquery.jobUser e bigquery.dataViewer |
Editor |
| Ver gráficos, tabelas dinâmicas, fórmulas, extrações ou visualizações criadas com base nos dados do BigQuery | Nenhum | Editor ou leitor |
| Criar ou editar uma consulta personalizada do BigQuery |
bigquery.user ou bigquery.jobUser e bigquery.dataViewer |
Editor |
| Ver uma consulta personalizada do BigQuery | Nenhum | Editor ou leitor |
| Atualizar dados do BigQuery |
bigquery.user ou bigquery.jobUser e bigquery.dataViewer |
Editor |
Você atribui funções do IAM aos conjuntos de dados no console do BigQuery. Confira mais detalhes em Controlar o acesso a recursos com o IAM.
Além de usar o IAM para autorizar quais usuários podem acessar os dados do BigQuery, você pode usar o VPC Service Controls para criar um perímetro de serviço que restringe o acesso com base em atributos, como o endereço IP do usuário e as informações do dispositivo. Os usuários só poderão usar planilhas conectadas para acessar os dados do BigQuery protegidos pelo VPC Service Controls se você configurar o perímetro para permitir que o Planilhas copie os resultados da consulta para as planilhas dos usuários. Veja mais detalhes em Controle de acesso.
Configurar o Looker para analisar dados
Para usar as páginas conectadas com o Looker, ative o acesso aos serviços que não são controlados individualmente no Google Admin Console. Confira mais informações em Gerenciar acesso a serviços que não são controlados individualmente. Além disso, um administrador do Looker precisa ativar as páginas conectadas na interface do administrador do Looker. Confira instruções mais detalhadas em Usar páginas conectadas para o Looker.
Permitir que os usuários deleguem o acesso às páginas conectadas para o BigQuery
Você pode permitir que os usuários deleguem o acesso ao recurso páginas conectadas para o BigQuery para fazer colaborações com outros usuários para analisar dados e fazer consultas.
Para delegar o acesso, os usuários precisam compartilhar a página com o outro usuário. No entanto, não é possível delegar o acesso a uma página compartilhada publicamente com um link. É possível analisar o usuário que delega o acesso e o usuário que executa uma consulta em Eventos de registro do Drive ou Registros de auditoria do Cloud.
Ativar ou desativar o acesso delegado
-
-
No Admin Console, acesse Menu
Apps
Google Workspace
- Em Acesso delegado às páginas conectadas, clique em Editar
.
- Para aplicar a configuração a todos, deixe a unidade organizacional mãe selecionada. Caso contrário, selecione uma unidade organizacional filha ou um grupo de configuração.
- Em Configurações de delegação, marque ou desmarque Permitir que os usuários com acesso para editar uma planilha ativem a delegação para acessar o recurso páginas conectadas.
- Se você estiver configurando uma unidade organizacional ou um grupo, selecione Somente usuários em uma unidade organizacional ou um grupo específico podem usar a delegação.
- Se você quiser permitir que qualquer usuário com acesso à planilha delegue o acesso, selecione Qualquer usuário pode usar a delegação.
Essa opção inclui usuários fora da sua organização se eles tiverem acesso à página.
-
Clique em Salvar. Se você tiver configurado uma unidade organizacional ou um grupo, talvez seja possível usar as opções Herdar ou Modificar em uma unidade organizacional mãe ou a opção Cancelar configuração em um grupo.
Se você ativar a delegação, diga aos usuários que eles podem seguir estas etapas para delegar acesso a uma página.
Acessar os eventos de registro das páginas conectadas
Quando as páginas conectadas acessam dados do BigQuery e do Looker, as entradas são gravadas nos eventos de registro do Drive. As entradas também são gravadas em Registros de auditoria do Cloud para acesso ao BigQuery e em Explorar o histórico de atividades do sistema para acesso ao Looker. Eles mostram quem acessou os dados e quando.
Analisar eventos de registro do Drive usando a API ReportsSaiba como analisar eventos de registro do Drive no Google Admin Console em Acessar dados de eventos de registro do Drive.
Com a API Reports, você pode conferir os eventos de consulta das páginas conectadas. O exemplo a seguir recupera todos os eventos do Drive pelo tipo de evento de consulta das páginas conectadas:
Acesse https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/drive?eventName=connected_sheets_query
A resposta JSON completa para esta chamada de API é mostrada na seção "Resposta JSON completa" abaixo, nesta página.
O usuário que iniciou a consulta é exibido como o ator.
"actor": {
"email": "collaborator@example.com",
"profileId": "ID de perfil exclusivo do Google Workspace do usuário"
}
O app Planilhas oferece mais informações sobre a consulta executada como parâmetros.
"parameters": [
{
"name": "execution_trigger",
"value": "sheets_ui"
},
{
"name": "query_type",
"value": "big_query"
},
{
"name": "data_connection_id",
"value": "The Cloud project ID"
},
{
"name": "execution_id",
"multiValue": [
"jobs/big_query_job_id"
]
},
{
"name": "delegating_principal",
"value": "trix01@scary.docsplustesting.com"
},
O campo execution_trigger é definido com base na forma como a consulta é invocada nas Planilhas:
| Rótulo | Como a consulta é executada |
|---|---|
| sheets_ui | Manualmente: na IU do Planilhas |
| schedule | No recurso de atualização programada do Planilhas |
| api | Na API Sheets |
| apps-script | Com o Apps Script |
O campo
query_type é definido com base no conector de dados.| Rótulo | Conector de dados |
|---|---|
| big_query | BigQuery |
| looker | Looker |
O campo data_connection_id é definido com base no ID da conexão de dados. No BigQuery, esse é o ID do projeto de faturamento. No Looker, esse é o URL da instância.
O execution_id é definido com base no ID da consulta executada.
| Estrutura de valor | Entidade de consulta |
|---|---|
| jobs/<JOB_ID> | Job do BigQuery |
| datasets/<DATASET_NAME>/tables/<TABLE_NAME> | Tabela do BigQuery |
| query_tasks/<QUERY_TASK_ID> | Consulta do Looker |
O endereço de e-mail do usuário com as credenciais usadas está disponível nos registros como o campo delegating_principal.
Resposta JSON completa
{
"kind": "admin#reports#activity",
"id": {
"time": "2022-10-26T17:33:51.929Z",
"uniqueQualifier": "report’s unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"email": "collaborator@example.com",
"profileId": "user’s unique Google Workspace profile ID"
},
"events": [
{
"type": "access",
"name": "connected_sheets_query",
"parameters": [
{
"name": "execution_trigger",
"value": "sheets_ui"
},
{
"name": "query_type",
"value": "big_query"
},
{
"name": "data_connection_id",
"value": "The Cloud project ID"
},
{
"name": "execution_id",
"multiValue": [
"jobs/big_query_job_id"
]
},
{
"name": "doc_id",
"value": "aBC-123-xYz"
},
{
"name": "doc_type",
"value": "spreadsheet"
},
{
"name": "is_encrypted",
"boolValue": false
},
{
"name": "doc_title",
"value": "Document title"
},
{
"name": "visibility",
"value": "shared_internally"
},
{
"name": "actor_is_collaborator_account",
"boolValue": false
},
{
"name": "delegating_principal",
"value": "owner@example.com"
},
{
"name": "owner",
"value": "owner@example.com"
},
{
"name": "owner_is_shared_drive",
"boolValue": false
},
{
"name": "owner_is_team_drive",
"boolValue": false
}
]
}
]
}
Cada planilha tem um ID exclusivo encontrado no URL da planilha. As entradas de registro no formato BigQueryAuditMetadata contêm o ID da planilha da qual a solicitação de acesso aos dados do BigQuery foi enviada.
É possível criar consultas para recuperar e analisar registros usando o Explorador de registros no console do Google Cloud. No Explorador de registros, digite o seguinte:
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId
!= NULL_VALUE
Isso mostra as entradas com um ID de planilha não vazio, como neste exemplo:
metadata: {
@type: "type.googleapis.com/google.cloud.audit.BigQueryAuditMetadata"
firstPartyAppMetadata: {
sheetsMetadata: {
docId: "aBC-123_xYz"
}
}
As Planilhas adicionam informações aos jobs de consulta usando marcadores de job. Eles podem fornecer mais dados para você analisar, como mostrado neste exemplo:
jobInsertion: {
job: {
jobConfig: {
labels: {
sheets_access_type: "normal"
sheets_connector: "connected_sheets"
sheets_trigger: "user"
}
O valor do campo "sheets_trigger" é definido com base na forma como a consulta é invocada do Planilhas:
| Rótulo | Como a consulta é executada |
|---|---|
| user | Manualmente: na IU do Planilhas |
| schedule | No recurso de atualização programada do Planilhas |
| api | Na API Sheets |
| apps-script | Com o Apps Script |
Por exemplo, para encontrar entradas correspondentes a atualizações programadas das páginas conectadas, use a seguinte consulta no Explorador de registros:
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId
!= NULL_VALUE
protoPayload.metadata.jobInsertion.job.jobConfig.labels.sheets_trigger
= "schedule"
Se o acesso delegado tiver sido ativado, você encontrará o endereço de e-mail do usuário com as credenciais que foram usadas para executar a consulta nos registros. Também é possível encontrar o endereço de e-mail do usuário que acionou a consulta, conforme mostrado neste exemplo:
"authenticationInfo": {
"principalEmail": "proprietário@exemplo.com",
"serviceAccountDelegationInfo": [
{
"firstPartyPrincipal": {
"principalEmail": "colaborador@exemplo.com",
"serviceMetadata": {
"service": "sheets"
}
}
}
]
}
Observação: o campo serviceAccountDelegationInfo só estará presente se o acesso delegado tiver sido usado para a consulta. Nesse caso, a pessoa listada em principalEmail é a que delegou acesso.
Confira informações mais detalhadas em Como usar o Explorador de registros e Criar consultas no Explorador de registros.
Saiba mais sobre os registros de auditoria do BigQuery, os IDs de planilha, o formato BigQueryAuditMetadata, o SheetsMetadata, o compartilhamento de planilhas e a API Google Sheets.
- Na instância do Looker, à esquerda, clique em Explorar
- Em Localizar um campo, insira Nome do cliente da API e clique em Filtrar
para adicionar esse campo ao conjunto de dados.
- Em Filtros, selecione é igual a e, no campo ao lado, digite páginas conectadas.
- Em Localizar um campo, insira o ID das planilhas das páginas conectadas para adicionar esse campo ao conjunto de dados.
- Em Localizar um campo, digite acionador das páginas conectadas para adicionar esse campo ao conjunto de dados.
- Em Localizar um campo, digite Slug do histórico para adicionar esse campo ao conjunto de dados.
- O Slug do histórico é equivalente ao QUERY_TASK_ID registrado nos eventos de registro do Drive. Se você quiser encontrar uma consulta específica no registro do Drive, adicione um filtro nesse campo.
- (Opcional) Para adicionar outros campos ao conjunto de dados, como Nome de usuário e Data de criação do histórico, selecione-os.
- (Opcional) Para adicionar filtros, selecione-os.
Por exemplo, você pode filtrar Data de criação do histórico para nos últimos sete dias ou filtrar por um ID de planilha específico para conferir somente as consultas do Looker iniciadas em um ID de planilha específico. - Clique em Executar.
Resolver problemas
Se o app Planilhas falharNa parte de cima da página, clique em Enviar feedback.
Nos arquivos do Planilhas, clique em Atualizar para atualizar os dados do BigQuery no páginas conectadas. Para atualizar todos os itens no páginas conectadas, clique em DadosConectores de dados
Atualizar dados
Atualizar tudo.
Se você tiver definido permissões em arquivos das Planilhas na sua organização, como a restrição do acesso de usuários externos, esses usuários não poderão abrir os arquivos das páginas conectadas. Veja como alterar as permissões em Definir as permissões de compartilhamento dos usuários do Drive.
Se você ainda estiver com problemas, consulte Corrigir problemas com dados do BigQuery nas Planilhas Google e Solução de problemas de páginas conectadas para o Looker.
Temas relacionados
- Primeiros passos com os dados do BigQuery no Planilhas Google
- Classificar e filtrar os dados do BigQuery no Planilhas Google
- Analisar e atualizar os dados do BigQuery no app Planilhas Google com as páginas conectadas
- Criar e editar uma consulta
- Documentação do BigQuery
- Planos de suporte do Google Cloud
