Faça a gestão dos notebooks

Este documento descreve como gerir os blocos de notas do Colab Enterprise no BigQuery, incluindo como ver, comparar, restaurar e eliminar blocos de notas.

Este documento também descreve como ver e gerir metadados de blocos de notas no Dataplex Universal Catalog.

Os blocos de notas são recursos de código do BigQuery Studio com tecnologia Dataform.

Antes de começar

  1. Crie um notebook.
  2. Para gerir metadados de blocos de notas no catálogo universal do Dataplex, certifique-se de que a API Dataplex está ativada no seu Trusted Cloud projeto.

Autorizações necessárias

Para partilhar notebooks, precisa das seguintes funções de gestão de identidade e de acesso (IAM):

Para guardar e eliminar blocos de notas, precisa das seguintes funções do IAM:

Para trabalhar com revisões de blocos de notas, precisa das seguintes funções do IAM:

Para mais informações sobre o IAM do BigQuery, consulte o artigo Controlo de acesso com o IAM.

Para gerir os metadados dos blocos de notas no catálogo universal do Dataplex, certifique-se de que tem as funções do catálogo universal do Dataplex necessárias.

Conceda acesso a notebooks

Para conceder a outros utilizadores acesso a um notebook, adicione esses utilizadores a uma função do IAM adequada.

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, a pasta Shared notebooks. Encontre o bloco de notas ao qual quer conceder acesso.

  3. Clique em Ver ações junto ao bloco de notas e, de seguida, clique em Partilhar > Gerir autorizações.

  4. No painel Gerir autorizações, clique em Adicionar utilizador/grupo.

  5. No campo Novos membros, introduza um membro.

  6. Na lista Função, selecione uma das seguintes funções:

  7. Opcional: para ver uma lista completa de funções e definições de partilha avançadas, clique em Partilha avançada.

  8. Clique em Guardar.

  9. Para voltar à página de informações do bloco de notas, clique em Fechar.

Partilhe notebooks

Para partilhar um notebook com outros utilizadores, pode gerar e partilhar um link para o notebook. Para que outros utilizadores vejam o notebook que partilha, tem de conceder acesso ao notebook.

Para executar um notebook, os utilizadores têm de ter acesso aos dados aos quais o notebook acede. Para mais informações, consulte o artigo Conceda acesso a um conjunto de dados.

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, expanda a pasta Shared notebooks. Encontre o bloco de notas que quer partilhar.

  3. Clique em Ver ações junto ao bloco de notas e, de seguida, clique em Partilhar > Copiar link.

  4. Partilhe o link com outros utilizadores.

Ver todos os notebooks

Para ver uma lista de todos os blocos de notas no seu projeto, faça o seguinte:

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel Explorador, clique em Ver ações junto a Blocos de notas e, de seguida, faça uma das seguintes ações:

  • Para abrir a lista no separador atual, clique em Mostrar tudo.
  • Para abrir a lista num novo separador, clique em Mostrar tudo em > Novo separador.
  • Para abrir a lista num separador dividido, clique em Mostrar tudo em > Separador dividido.

Veja os metadados do bloco de notas

Para ver os metadados do bloco de notas, siga estes passos:

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, a pasta Shared notebooks. Clique no nome do bloco de notas para o qual quer ver os metadados.

  3. Consulte o painel Resumo para ver informações sobre o bloco de notas, como a região que usa para os dados e a data da última modificação.

Trabalhe com versões de blocos de notas

Pode optar por criar um bloco de notas dentro ou fora de um repositório. O controlo de versões dos blocos de notas é processado de forma diferente consoante a localização do bloco de notas.

Controlo de versões de blocos de notas em repositórios

Os repositórios são repositórios Git que residem no BigQuery ou num fornecedor de terceiros. Pode usar espaços de trabalho em repositórios para fazer o controlo de versões em blocos de notas. Para mais informações, consulte o artigo Use o controlo de versões com um ficheiro.

Controlo de versões de blocos de notas fora dos repositórios

Use as secções seguintes para saber como ver, comparar e restaurar versões de um bloco de notas.

Veja as versões do bloco de notas

Para ver as versões do bloco de notas, siga estes passos:

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, a pasta Shared notebooks. Clique no nome do bloco de notas cujo histórico de versões quer ver.

  3. Para ver uma lista das versões do bloco de notas por ordem descendente de data, clique em Histórico de versões.

Compare versões de notebooks

Para comparar versões de blocos de notas, siga estes passos:

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, a pasta Shared notebooks. Clique no nome do notebook para o qual quer comparar as informações da versão.

  3. Clique em Histórico de versões.

  4. Clique em Ver ações junto a uma versão do bloco de notas e, de seguida, clique em Comparar. O painel de comparação é aberto, comparando a versão do bloco de notas que selecionou com a versão atual do bloco de notas.

  5. Opcional: para comparar as versões inline em vez de em painéis separados, clique em Comparar e, de seguida, clique em Inline.

  6. Opcional: para comparar o código fonte das versões, clique em Comparar e, de seguida, clique em Mostrar origem não processada.

  7. Opcional: para ocultar o resultado do comando no bloco de notas, clique em Comparar e, em seguida, desmarque a opção Mostrar resultado.

Restaure uma versão de um bloco de notas

A restauração de uma versão do bloco de notas a partir do painel de comparação permite-lhe comparar as versões atual e anterior do bloco de notas antes de optar por restaurar a versão anterior. A restauração de um bloco de notas cria uma nova versão de um bloco de notas em vez de substituir a versão atual. Não se perde nenhum histórico de versões.

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, expanda a pasta Notebooks partilhados. Clique no nome do bloco de notas do qual quer restaurar uma versão anterior.

  3. Clique em Histórico de versões.

  4. Clique em Ver ações junto à versão e, de seguida, clique em Comparar. O painel de comparação é aberto, comparando a versão do bloco de notas que selecionou com a versão mais recente do bloco de notas.

  5. Se quiser restaurar a versão anterior do bloco de notas após a comparação, clique em Restaurar.

  6. Clique em Confirm.

Transfira um notebook

Para transferir um bloco de notas, siga estes passos:

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, a pasta Shared notebooks. Clique no nome do bloco de notas que quer transferir.

  3. Clique em Transferir.

Elimine notebooks

Para eliminar um bloco de notas, siga estes passos:

  1. Na Trusted Cloud consola, aceda à página BigQuery.

    Aceda ao BigQuery

  2. No painel do Explorador, expanda o projeto e a pasta Notebooks e, se necessário, expanda a pasta Shared notebooks. Encontre o bloco de notas que quer eliminar.

  3. Clique em Ver ações junto ao bloco de notas e, de seguida, clique em Eliminar.

  4. Para confirmar a eliminação, escreva delete na caixa de diálogo.

  5. Clique em Eliminar.

Faça a gestão de metadados no catálogo universal do Dataplex

O Catálogo universal do Dataplex permite-lhe armazenar e gerir metadados para blocos de notas. Os blocos de notas estão disponíveis no catálogo universal do Dataplex por predefinição, sem configuração adicional.

Pode usar o catálogo universal do Dataplex para gerir blocos de notas em todas as localizações do BigQuery. A gestão de blocos de notas no catálogo universal do Dataplex está sujeita a quotas e limites do catálogo universal do Dataplex e preços do catálogo universal do Dataplex.

O catálogo universal do Dataplex obtém automaticamente os seguintes metadados dos blocos de notas:

  • Nome do recurso de dados
  • Recurso de dados principal
  • Localização do recurso de dados
  • Tipo de recurso de dados
  • Projeto Trusted Cloud correspondente

O catálogo universal do Dataplex regista os blocos de notas como entradas com os seguintes valores de entrada:

Grupo de entradas do sistema
O grupo de entradas do sistema para blocos de notas é @dataform. Para ver os detalhes das entradas do bloco de notas no catálogo universal do Dataplex, tem de ver o grupo de entradas do sistema dataform. Para ver instruções sobre como ver uma lista de todas as entradas num grupo de entradas, consulte o artigo Ver detalhes de um grupo de entradas na documentação do catálogo universal do Dataplex.
Tipo de entrada do sistema
O tipo de entrada do sistema para blocos de notas é dataform-code-asset. Para ver os detalhes dos blocos de notas, tem de ver o dataform-code-asset tipo de entrada do sistema, filtrar os resultados com um filtro baseado em aspetos, e definir o campo type no aspeto dataform-code-asset como NOTEBOOK. Em seguida, selecione uma entrada do bloco de notas selecionado. Para ver instruções sobre como ver os detalhes de um tipo de entrada selecionado, consulte o artigo Ver detalhes de um tipo de entrada na documentação do catálogo universal do Dataplex. Para ver instruções sobre como ver os detalhes de uma entrada selecionada, consulte o artigo Ver detalhes de uma entrada na documentação do catálogo universal do Dataplex.
Tipo de aspeto do sistema
O tipo de aspeto do sistema para portáteis é dataform-code-asset. Para fornecer contexto adicional aos blocos de notas no catálogo universal do Dataplex anotando as entradas dos blocos de notas com aspetos, veja o tipo de aspeto dataform-code-asset, filtre os resultados com um filtro baseado em aspetos e defina o campo type no aspeto dataform-code-asset como NOTEBOOK. Para ver instruções sobre como anotar entradas com aspetos, consulte o artigo Gerir aspetos e enriquecer metadados na documentação do catálogo universal do Dataplex.
Tipo
O tipo de telas de dados é NOTEBOOK. Este tipo permite-lhe filtrar blocos de notas no dataform-code-assettipo de entrada do sistema e no tipo de aspeto dataform-code-asset usando a consulta num filtro baseado em aspetos.aspect:dataplex-types.global.dataform-code-asset.type=NOTEBOOK

Para obter instruções sobre como pesquisar recursos no catálogo universal do Dataplex, consulte o artigo Pesquise recursos de dados no catálogo universal do Dataplex na documentação do catálogo universal do Dataplex.

Resolução de problemas

Para mais informações, consulte o artigo Resolva problemas do Colab Enterprise.

O que se segue?