Usar apps de dados no BigQuery e no Data Studio

Os apps de dados do Colab permitem transformar suas análises de dados de notebooks do Colaboratory em aplicativos interativos e refinados. Em vez de compartilhar código ou relatórios estáticos, agora é possível 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 oferecem o seguinte:

  • Insights de autoatendimento. Os usuários empresariais podem ajustar parâmetros, como intervalos de datas ou filtros, para conferir os dados de que precisam sem editar o código.
  • Nenhuma configuração para leitores de apps. Os consumidores acessam seu app usando um URL. Eles não precisam navegar pelo Google Cloud console ou 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. Administradores e autores mantêm o controle sobre o compartilhamento, as versões e o uso de recursos.

Antes de começar

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

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

    Go to project selector

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

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

    Go to project selector

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

  6. 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 para criar apps de dados, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

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 personalizados papéis ou outros predefinidos papéis.

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 estão sujeitos às seguintes limitações:

  • Na 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. Após esse período, os apps perdem a conexão com o kernel e se tornam estáticos. Para iniciar uma nova sessão de 30 minutos, recarregue a página ou atualize os dados.

  • Independentemente 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 os recursos do kernel 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 acesso a dados ou para visualizar apps de dados.

Componentes de apps de dados

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

É possível adicionar aos apps de dados qualquer tipo de célula compatível que você possa criar em um notebook do Colab, incluindo células SQL, de código , de texto e de visualização. Você pode criar tipos de células manualmente, ou usar o Agente de Ciência de Dados do Colab ou Gemini para gerar células.

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

Controles criados usando bibliotecas de terceiros

Os apps de dados oferecem suporte a controles criados usando bibliotecas de widgets de terceiros. Exemplo:

  • É possível usar o pacote ipywidgets ou a biblioteca anywidget para adicionar controles interativos ao 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. Essa configuração permite configurar um filtro global para seus apps de dados.

Criar e publicar apps de dados

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

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

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

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

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

    Acessar Studio

  2. Para abrir a galeria de modelos, faça o seguinte:

    • No painel esquerdo, clique em Explorador, expanda seu projeto e selecione Notebook > Ver ações > Criar notebook > Todos os modelos.

      Botão destacado para o painel "Explorer".

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

    • Na página Studio, clique em Ver galeria de notebooks:

      O link "Ver galeria de notebooks" na página do BigQuery Studio.

  3. Clique no card Introdução aos notebooks para usuários do Python ou pesquise por ele na galeria.

  4. Depois que o modelo for aberto, clique em Usar este modelo para convertê-lo em um notebook executável.

  5. Clique em dashboard App de dados.

  6. Opcional: no painel Componentes, adicione e remova células do app usando as caixas de seleção:

    O painel de componentes, onde é possível adicionar e remover células do app.

  7. Para criar novos componentes, faça o seguinte:

    1. Para voltar ao notebook, clique em arrow_back Notebook.
    2. Para adicionar novas células, clique na seta suspensa ao lado de Código ou Texto.
    3. Clique em Salvar.
    4. Para retornar ao app, clique em dashboard App de dados.

  8. Quando estiver satisfeito com o layout do app, clique em Publicar.

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

    1. No campo Nome, insira um nome para o app. O nome do app não precisa ser o mesmo do notebook usado para criá-lo.

    2. Na seção Ambiente de execução, escolha Conectar a um ambiente de execução, e selecione o ambiente de execução na lista Ambiente de execução ou escolha Criar novo ambiente de execução, e selecione o modelo apropriado na lista Modelo de ambiente de execução.

      Se você escolher Conectar a um ambiente de execução, será necessário conectar o notebook a um ambiente de execução antes de publicar o app.

      A página "Publicar" do seu app.

    3. Clique em Publicar.

    4. Se você receber uma solicitação para conceder acesso do Data Studio à sua Conta do Google, clique em Permitir.

  10. Se você fizer alterações nos notebooks de origem e no app, clique em Publicar alterações para atualizar o app.

    Como alternativa, no Data Studio, é possível editar o app clicando em more_vert Mais opções > Editar.

    O notebook de origem é aberto no BigQuery Studio.

Visualizar e compartilhar apps de dados

Use o Data Studio para visualizar seus apps de dados do Colab e compartilhar seus apps com outras pessoas.

Ao visualizar um app, a interatividade depende dos 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.

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

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

  1. Para visualizar seu app no Data Studio, clique em Visualizar app de dados.

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

  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 dos usuários e grupos especificados:

      • Editor: os usuários podem editar o app, criar e editar programações e alertas e compartilhar o app com outras pessoas.
      • Leitor: os usuários podem acessar o app, mas não podem editar ou compartilhar com outros.

    3. Clique em Enviar.

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

    • Convidar pessoas
    • Gerar link do relatório
    • Fazer o download do relatório

    O menu de compartilhamento no Data Studio.

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

Reconectar e atualizar apps de dados

As sessões de interatividade duram 30 minutos. Após esse período, os apps perdem a conexão com o kernel e se tornam estáticos. Para iniciar uma nova sessão de 30 minutos, recarregue a página ou atualize os dados.

Para atualizar os dados no Data Studio, faça o seguinte:

  • Com o app aberto, clique em more_vert Mais ações do relatório > Atualizar dados.

Credenciais usadas para executar células em apps de dados

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

Excluir apps de dados

É possível excluir apps de dados usando o Data Studio. A exclusão do 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 Recentes, localize seu app.

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

    O menu "Mais opções" que você usa para excluir um app.

Preços

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