Use células de visualização

Use células de visualização

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Este guia descreve como usar células de visualização para visualizar dados de um bloco de notas do Colab Enterprise.

As células de visualização podem gerar visualizações interativas e editáveis com base nos dados de um DataFrame no seu bloco de notas. Pode configurar uma célula de visualização para ajudar a explorar dados e descobrir estatísticas. As opções de configuração da célula de visualização incluem o seguinte:

• Especifique os campos usados na visualização.
• Selecione um tipo de gráfico, como um gráfico de dispersão ou um gráfico de barras.
• Especifique como os dados são agregados.
• Altere as cores, as etiquetas e o título da visualização.

Limitações

Considere as seguintes limitações quando planear o seu projeto:

• A nova execução de uma célula de visualização repõe a configuração de visualização existente.
• A opção Visualizar em Passos seguintes nem sempre aparece quando trabalha com DataFrames pandas.
• O Gemini no Colab Enterprise não pode interagir com células de visualização. Isto significa que o Gemini não pode ler nem sugerir alterações às células de visualização e pode não conseguir explicar nem ajudar a corrigir erros gerados pelas células de visualização.

Antes de começar

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.

Enable the BigQuery, Compute Engine, Dataform, and Vertex AI APIs.

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 APIs

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.

Enable the BigQuery, Compute Engine, Dataform, and Vertex AI APIs.

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 APIs

Funções necessárias

Para obter as autorizações de que precisa para criar um bloco de notas do Colab Enterprise, executar o código do bloco de notas num tempo de execução e usar dados do BigQuery no bloco de notas, peça ao seu administrador para lhe conceder as seguintes funções de IAM no projeto:

• Utilizador do BigQuery (roles/bigquery.user)
• Utilizador do Colab Enterprise (roles/aiplatform.colabEnterpriseUser)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Crie um DataFrame

Para usar uma célula de visualização, precisa de dados armazenados num DataFrame no seu bloco de notas. Para criar um DataFrame, pode executar uma consulta SQL numa célula SQL. Para mais informações sobre as células SQL, consulte o artigo Use células SQL.

Para executar uma consulta SQL e criar um DataFrame, faça o seguinte:

1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

   Aceda a Os meus notebooks

2. No menu Região, selecione a região que contém o seu bloco de notas.

3. Clique no bloco de notas que quer abrir. Se ainda não criou um bloco de notas, crie um bloco de notas.

4. Na barra de ferramentas, para adicionar uma célula SQL, clique no menu  Opções de inserção de células de código e selecione Adicionar célula SQL.

   

   A célula SQL é adicionada ao seu bloco de notas.

5. Na célula SQL, introduza uma consulta SQL. Por exemplo, para consultar dados do conjunto de dados público do BigQuery sobre pinguins, pode introduzir o seguinte:

   SELECT * FROM `bigquery-public-data.ml_datasets.penguins`;
       

6. Mantenha o ponteiro sobre a célula SQL e, de seguida, clique no botão  Executar célula.

O resultado da consulta é guardado automaticamente num DataFrame denominado df.

Crie uma visualização

Para criar uma visualização a partir de um DataFrame no seu bloco de notas, pode adicionar uma célula de visualização e, em seguida, configurá-la para usar um DataFrame específico. Em alternativa, se for apresentada uma secção Passos seguintes abaixo de um DataFrame gerado, pode clicar no botão Visualizar com DATAFRAME_NAME.

Adicione uma célula de visualização

1. Use um dos seguintes métodos para adicionar uma célula de visualização ao seu bloco de notas:

   • Na barra de ferramentas, para adicionar uma célula de visualização, clique no menu  Opções de inserção de células de código e selecione Adicionar célula de visualização.

     

   • Mantenha o ponteiro entre duas células no bloco de notas para indicar onde quer adicionar a célula de visualização e clique no botão  Visualização.

     

   É adicionada uma célula de visualização ao seu bloco de notas.

2. Na célula de visualização, para selecionar o DataFrame a visualizar, clique no menu Escolher um DataFrame e, de seguida, selecione df.

3. Mantenha o ponteiro sobre a célula de visualização e, de seguida, clique no botão  Executar célula.

   O Colab Enterprise gera uma visualização predefinida. Para alterar a visualização, consulte a secção seguinte.

Visualize com o DataFrame

1. Se existir uma secção Passos seguintes abaixo de um DataFrame gerado, clique no botão Visualizar com DATAFRAME_NAME.

   É adicionada uma célula de visualização ao seu bloco de notas. O DataFrame da célula anterior é definido automaticamente como a origem de dados desta célula de visualização.

2. Mantenha o ponteiro sobre a célula de visualização e, de seguida, clique no botão  Executar célula.

   O Colab Enterprise gera uma visualização predefinida. Para alterar a visualização, consulte a secção seguinte.

Configure a visualização

Uma célula de visualização gera uma visualização predefinida que pode configurar através do painel lateral da célula. As opções de configuração variam consoante os dados que está a usar e o tipo de gráfico da visualização.

Para ver as definições de configuração de uma célula de visualização, faça o seguinte:

1. Na célula de visualização, clique no botão Dados para ver os dados subjacentes usados na visualização.

2. Clique no botão Gráfico para voltar ao modo de gráfico e ver a visualização.

3. Para mostrar ou ocultar as definições de configuração, clique no botão  Ativar/desativar definições.

4. No painel de definições de configuração, para selecionar um tipo de gráfico diferente, clique no menu do tipo de gráfico  e selecione o tipo de gráfico pretendido. Alguns tipos de gráficos usam apenas um subconjunto de campos do DataFrame disponível.

5. No separador Configuração, altere os campos usados na visualização selecionando diferentes dimensões e métricas. Geralmente, as dimensões são campos de categoria nos seus dados e as métricas são valores numéricos.

6. Para alterar a agregação de uma métrica, clique na definição de agregação à esquerda do nome da métrica e, de seguida, selecione uma agregação diferente.

7. Para alterar a métrica usada para a ordenação, clique na métrica Ordenar e selecione uma métrica diferente. Também pode alterar a agregação e se quer ordenar os valores por ordem descendente ou ascendente.

8. No separador Estilo, pode fazer alterações ao texto e ao aspeto da visualização, incluindo o seguinte:

   • Se o título e as etiquetas são apresentados ou ocultados
   • Texto do título
   • Texto da etiqueta do eixo
   • Tipo de letra, tamanho e cor do texto
   • Cores das métricas visualizadas

Filtre os dados na visualização

Pode filtrar os dados na visualização com base no valor de um campo. Para filtrar os dados, faça o seguinte:

1. Na parte superior da célula de visualização, clique em Adicionar filtro.

2. Selecione um campo para filtrar os dados.

3. Para concluir a caixa de diálogo do filtro, faça uma das seguintes ações com base no tipo de dados que está a filtrar:

   • Para dimensões ou dados categóricos, selecione as categorias que quer incluir na visualização.
   • Para métricas ou dados numéricos, ajuste os controlos de deslize para os valores mais baixos e mais altos que quer incluir na visualização.

4. Clique em Aplicar.

O que se segue?

• Saiba mais acerca dos DataFrames do BigQuery.

• Use células SQL num bloco de notas do Colab Enterprise.

• Use o Gemini para explicar e corrigir erros.

• Use o Data Science Agent.