Usar apps de dados do Colab no BigQuery e no Data Studio

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Observação: para enviar feedback ou fazer perguntas, entre em contato com [e-mail].

Com os apps de dados do Colab, você transforma suas análises de dados de notebooks do Colab em aplicativos interativos e refinados. Em vez de compartilhar código ou relatórios estáticos, agora você pode criar experiências compartilháveis que incluem visualizações interativas, tabelas de dados e inferências de aprendizado de máquina.

Os apps de dados do Colab oferecem o seguinte:

• Insights de autoatendimento: os usuários comerciais podem ajustar parâmetros como períodos ou filtros para ver os dados de que precisam sem editar o código.
• Nenhuma configuração para pessoas que visualizam o app: os consumidores acessam seu app usando um URL. Eles não precisam navegar pelo console Google Cloud nem executar notebooks.
• Flexibilidade: integre qualquer biblioteca ou widget de visualização do Python para criar apps de dados personalizados e complexos com facilidade. Para economizar tempo, use o agente integrado para gerar o código.
• Ciclo de vida gerenciado: os administradores e autores mantêm o controle sobre compartilhamento, versões e uso de recursos.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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

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

Verify that billing is enabled for your Google Cloud project.

1. Ative as APIs BigQuery e Dataform.

   Funções necessárias para ativar APIs

   Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

   Ativar as APIs

   Para novos projetos, a API BigQuery é ativada automaticamente.

Funções exigidas

Para receber as permissões necessárias e criar apps de dados, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Usuário de sessão de leitura do BigQuery (roles/bigquery.readSessionUser)
• Usuário do BigQuery Studio (roles/bigquery.studioUser)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Se você não conhece o Colab Enterprise no BigQuery, consulte as permissões necessárias na página Criar notebooks.

Limitações

Os apps de dados do Colab estão sujeitos às seguintes limitações:

• A primeira vez que você abre um app, ele pode levar de dois a cinco minutos para carregar, dependendo da complexidade.

• As sessões de interatividade duram 30 minutos. Depois de 30 minutos, os apps perdem a conexão com o kernel e ficam estáticos. Para iniciar uma nova sessão de 30 minutos, atualize a página ou os dados.

• Independente de quais células estão visíveis no app, todas são executadas em ordem, da primeira à última. Se as células não visíveis estiverem em execução e consumindo recursos do kernel, o app poderá parecer não responder até que esses recursos sejam liberados.

• Não é possível usar uma conta de serviço ou credenciais de usuário final (EUC, na sigla em inglês) para acessar dados ou visualizar apps de dados.

Componentes dos apps de dados

Os componentes que podem ser adicionados aos seus apps de dados são derivados do notebook subjacente. Se você estiver trabalhando com um notebook, qualquer uma das células atuais poderá ser adicionada aos seus apps de dados.

Qualquer tipo de célula compatível que você pode criar em um notebook do Colab pode ser adicionado aos apps de dados, incluindo células de SQL, código, texto e visualização. Você pode criar tipos de células manualmente ou usar o agente de ciência de dados do Colab ou o Gemini para gerar células.

Para informações sobre como adicionar diferentes tipos de células aos notebooks, consulte os seguintes tutoriais:

• Visualizar resultados da consulta
• Testar os BigQuery DataFrames

Criar controles usando bibliotecas de terceiros

Os apps de dados são compatíveis com controles criados usando bibliotecas de widgets de terceiros. Exemplo:

• Você pode usar iPywidgets ou AnyWidget para adicionar controles interativos ao seu notebook. Os widgets podem ser gerados usando o Agente de Ciência de Dados do Colab.
• No nível do notebook, é possível encadear células de widget. Você define um widget no início do notebook, e a saída dele pode ser consumida por outras células, como as de visualização. Assim, você pode configurar um filtro global para seus apps de dados.

Criar e publicar apps de dados

É possível criar apps de dados do Colab usando um notebook atual ou criando um novo. No exemplo a seguir, você usa o modelo Introdução aos notebooks para usuários de Python para gerar um notebook e criar um app de dados com base nele.

Depois de criar os Apps de dados, publique-os no Data Studio para transformar suas análises de dados em experiências interativas e compartilháveis.

Observação: os apps de dados não exigem o Data Studio Pro.

Ao publicar apps de dados, é possível conectá-los a um ambiente de execução do Colab ou criar um novo usando um modelo. Com os modelos, é possível dimensionar o ambiente de execução de acordo com suas cargas de trabalho e definir o tempo de desligamento ocioso para equilibrar custos e tempo de inicialização do app.

Para criar e publicar apps de dados, siga estas etapas:

1. Acesse a página do Studio.

   Acessar Studio

2. Clique no menu suspenso e escolha Notebook > Todos os modelos.

3. Ou, na página inicial do BigQuery Studio, clique em Ver galeria de notebooks.

   

4. Clique no card Como começar a usar notebooks para usuários do Python ou pesquise na galeria.

5. Depois que o modelo abrir, clique em Usar este modelo para converter o modelo em um notebook executável.

6. Clique em painel App de dados.

7. No painel Componentes, é possível adicionar e remover células do app usando as caixas de seleção.

   

8. Para criar novos componentes, clique em keyboard_backspace Notebook para voltar ao notebook e adicione novas células.

9. Quando estiver tudo certo com o layout do app, clique em Publicar.

10. Na página Publicar, insira o seguinte:

    1. No campo Nome, insira um nome para o app. Ele não precisa ser o mesmo do notebook usado para criar o app.

    2. No campo Ambiente de execução, escolha Conectar a um ambiente de execução e selecione o ambiente, ou escolha Criar novo ambiente de execução e selecione o modelo adequado.

       Se você escolher Conectar a um ambiente de execução, o notebook precisará estar conectado a um ambiente de execução antes de publicar o app.

       

    3. Clique em Publicar.

    4. Se for solicitado que você conceda ao Data Studio acesso à sua Conta do Google, clique em Permitir.

11. Se você fizer mudanças nos notebooks de origem e no app, clique em Publicar mudanças para atualizar o app.

12. Outra opção é editar o app no Data Studio. Para isso, clique em more_vert Mais opções > Editar.

    Isso abre o notebook de origem no BigQuery Studio.

Acessar e compartilhar apps de dados

Você usa o Data Studio para ver seus apps de dados do Colab e compartilhar seus apps com outras pessoas.

Quando você visualiza um app, a interatividade é baseada nos componentes incluídos. Por exemplo, um gráfico do Matplotlib é estático, e um gráfico criado usando células de visualização do Colab ou bibliotecas como o Plotly é interativo.

Você pode interagir com widgets definidos no seu código e usá-los para tarefas como filtrar ou mudar a saída. Essas interações são específicas do usuário.

Para acessar e compartilhar seu app no Data Studio, siga estas etapas:

1. Para ver seu app no Data Studio, clique em Ver app de dados.

2. Para compartilhar seu app, clique em person_add Compartilhar no Data Studio.

3. Na página Compartilhar com pessoas e grupos, faça o seguinte:

   1. No campo Adicionar pessoas e grupos, insira os grupos e indivíduos a quem você está concedendo acesso.

   2. Selecione a permissão de acesso para os usuários e grupos especificados:

      • Editor: os usuários podem editar o app, criar e editar programações e alertas, além de compartilhar o app com outras pessoas.
      • Leitor: os usuários podem ver o app, mas não podem editar nem compartilhar com outras pessoas.

   3. Clique em Enviar.

4. Para convidar outras pessoas, gerar um link do relatório ou compartilhar ou baixar o app, clique em arrow_drop_down ao lado da opção Compartilhar e escolha uma das seguintes opções:

   • Convidar pessoas
   • Gerar link do relatório
   • Faça o download do relatório

   

Para mais informações sobre como compartilhar recursos no Data Studio, consulte Convidar outras pessoas para seus relatórios.

Como se reconectar e atualizar os apps de dados

As sessões de interatividade duram 30 minutos. Depois de 30 minutos, os apps perdem a conexão com o kernel e ficam estáticos. Para iniciar uma nova sessão de 30 minutos, atualize a página ou os dados.

Para atualizar os dados:

1. Abra o app no Data Studio. Com o app aberto, clique em Ver app de dados.

2. No Data Studio, clique em more_vert Mais ações do relatório > Atualizar dados.

Credenciais usadas para executar células nos apps de dados

Por padrão, os apps de dados usam as credenciais do criador do app para acesso a dados e renderização de visualizações. Todos os leitores veem os apps de dados renderizados com base no acesso do autor. Considere isso antes de compartilhar apps de dados que têm acesso a dados sensíveis.

Excluir apps de dados

É possível excluir apps de dados usando o Data Studio. Excluir o notebook usado para criar o app não exclui o app nem impede que ele funcione.

Para excluir apps de dados no Data Studio, siga estas etapas:

1. Faça login no Data Studio.

2. Na página Recente, localize seu app.

3. No final da linha, clique em more_vert Mais opções > Remover.

   

Preços

Você paga pela execução do código no ambiente de execução do notebook e por todos os slots do BigQuery usados. Para mais informações, consulte Preços do Colab Enterprise.