Faça a gestão dos produtos de dados

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA 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 documento destina-se a proprietários de produtos de dados que pretendam atualizar, eliminar e conceder acesso a produtos de dados no Dataplex Universal Catalog.

Para mais informações sobre a arquitetura e os conceitos-chave dos produtos de dados, consulte o artigo Acerca dos produtos de dados.

Antes de começar

1. Enable the Dataplex, BigQuery 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

Nota: este guia pressupõe que tem produtos de dados existentes para gerir. Para mais informações sobre como criar e configurar produtos de dados, consulte Crie produtos de dados.

Funções necessárias

Para receber as autorizações de que precisa para gerir produtos de dados, peça ao seu administrador que lhe conceda as seguintes funções de IAM no projeto:

• Autorizações completas para criar, atualizar, eliminar e gerir autorizações para produtos de dados: Administrador de produtos de dados do Dataplex (roles/dataplex.dataProductAdmin)
• Atualize e faça a gestão dos produtos de dados existentes: Editor de produtos de dados do Dataplex (roles/dataplex.dataProductEditor)
• Adicione aspetos como schema, overview e contacts: Proprietário da entrada e do EntryLink do Dataplex (roles/dataplex.entryOwner)
• Pesquise e adicione recursos: Visualizador do catálogo do Dataplex (roles/dataplex.catalogViewer)
• Editar tipos de aspetos do sistema, como a documentação e o aspeto do contrato da cadência de atualização: Editor do catálogo do Dataplex (roles/dataplex.catalogEditor)

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.

Estas funções predefinidas contêm as autorizações necessárias para gerir produtos de dados. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para gerir produtos de dados:

• Edite o overviewtipo de formato do sistema: dataplex.entryGroups.useOverviewAspect
• Edite o refresh cadencetipo de formato do sistema: dataplex.entryGroups.useRefreshCadenceAspect

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Conceda acesso a um produto de dados

Os proprietários de produtos de dados têm de tornar os respetivos produtos detetáveis e conceder as funções necessárias, o que permite aos consumidores pesquisar, ver e pedir acesso a produtos de dados.

Para conceder aos consumidores de produtos de dados as autorizações de que precisam para interagir com o produto de dados, conceda-lhes as seguintes funções do IAM no recurso do produto de dados:

• Pesquise produtos de dados e aceda aos mesmos na pesquisa do Dataplex Universal Catalog: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)
• Acesso só de leitura para ver definições e metadados de produtos de dados: Visualizador de produtos de dados do Dataplex (dataplex.dataProductViewer)
• Peça acesso a produtos de dados: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)

Quando um consumidor de um produto de dados pede acesso a um produto de dados, o proprietário do produto de dados recebe uma notificação por email.

Para conceder acesso, siga estes passos:

1. Na Google Cloud consola, aceda à página Grupos.

   Aceda à página Grupos

2. Pesquise o grupo associado ao nível de autorização pedido e selecione-o.

3. Clique em  Adicionar membros.

4. Adicione o principal.

5. Clique em Guardar.

Para mais informações, consulte o artigo Crie e faça a gestão de grupos Google na Google Cloud consola.

Atualize um produto de dados

Pode atualizar os detalhes básicos (por exemplo, o nome do produto de dados, a descrição, os detalhes do proprietário), os recursos, os grupos de acesso, as autorizações, o contrato, os aspetos e a documentação adicional de um produto de dados existente.

Atualize os detalhes básicos de um produto de dados

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados que quer atualizar.

3. Clique em Editar produto de dados.

4. Atualize o Nome do produto de dados, o Ícone, a Descrição, os Contactos do proprietário e as Etiquetas, conforme necessário.

5. Clique em Atualizar produto de dados.

REST

Para atualizar os detalhes básicos de um produto de dados, use o método dataProducts.patch.

Por exemplo, para atualizar a descrição de um produto de dados, envie o seguinte pedido PATCH:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

Substitua o seguinte:

• NEW_DESCRIPTION: uma nova descrição do produto de dados
• PROJECT_ID: o ID do seu Google Cloud projeto
• LOCATION: a região onde o produto de dados existe
• DATA_PRODUCT_ID: o ID do seu produto de dados

Atualize os recursos de um produto de dados

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados para o qual quer atualizar recursos.

3. Clique no separador Recursos.

4. Para adicionar um novo recurso, siga estes passos:

   1. Clique em +Adicionar.

   2. Pesquise e selecione os recursos que quer adicionar ao seu produto de dados. Os recursos que selecionar têm de residir na mesma região que o produto de dados.

      Se tiver as autorizações necessárias, pode ver os metadados dos recursos clicando no recurso.

   3. Para refinar os resultados da pesquisa, use os Filtros.

   4. Depois de selecionar os recursos, clique em Adicionar.

5. Para remover um recurso do produto de dados, siga estes passos:

   1. No recurso que quer remover, clique em > Remover.

   2. Para confirmar a ação, clique em Remover.

REST

Para adicionar um novo recurso de dados ao produto de dados, use o método dataAssets.create. Para ver um exemplo de código, consulte a secção Opcional: adicione recursos.

Para eliminar um recurso de dados do produto de dados, use o método dataAssets.delete. Por exemplo, envie o seguinte pedido DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

Substitua o seguinte:

• PROJECT_ID: o ID do seu Google Cloud projeto
• LOCATION: a região na qual quer criar o produto de dados
• DATA_PRODUCT_ID: um ID exclusivo para o seu produto de dados
• DATA_ASSET_ID: o ID do recurso de dados que quer remover do produto de dados

Atualize grupos de acesso e autorizações de recursos

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados para o qual quer atualizar os grupos de acesso e as autorizações.

3. Clique no separador Grupos de acesso e autorizações.

4. Para atualizar um grupo de acesso, siga estes passos:

   1. Clique em Editar.

   2. Atualize o nome, a descrição e o identificador do grupo de acesso conforme necessário.

   3. Para adicionar um novo grupo de acesso, clique em Adicionar grupo de acesso e siga estes passos:

      1. No campo Nome do grupo de acesso, introduza um nome para o novo grupo de acesso. Por exemplo, Analyst.

      2. No campo Descrição do grupo de acesso, introduza uma descrição para o grupo de acesso.

      3. No campo Identificador do grupo de acesso, introduza o endereço de email de um grupo Google que quer atribuir a este grupo de acesso. Os consumidores de produtos de dados que pedem acesso a este grupo de acesso podem ser adicionados como membros ao grupo Google mapeado.

         Pode adicionar um máximo de três grupos de acesso por produto de dados.

   4. Clique em Adicionar.

5. Para remover um grupo de acesso, siga estes passos:

   1. Para o grupo de acesso que quer remover, clique em > Remover.

   2. Para confirmar a ação, clique em Remover.

6. Se não estiverem configurados grupos de acesso para o produto de dados selecionado, pode adicionar um novo grupo de acesso clicando em Adicionar grupo de acesso.

7. Para atualizar as autorizações de recursos, siga estes passos:

   1. Para o recurso cujas autorizações quer atualizar, clique em > Autorizações.

   2. Atualize os grupos de acesso e as funções de IAM necessários.

   3. Clique em Configurar.

REST

Para atualizar os grupos de acesso associados a um produto de dados, use o método dataProducts.patch. Para ver um exemplo de código, consulte o artigo Configure grupos de acesso.

Para atualizar as autorizações de recursos, use o método dataAssets.patch. Para ver um exemplo de código, consulte o artigo Configure as autorizações de recursos.

Atualize o contrato do produto de dados

Nota: não é possível editar a cadência de atualização depois de a adicionar ao contrato. Se tentar modificar este valor, é apresentado o seguinte erro: You don't have permission to change contract values.

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados para o qual quer atualizar o contrato.

3. Clique no separador Contrato.

4. Para atualizar o contrato existente, siga estes passos:

   1. Clique em Editar.

   2. Atualize os campos necessários.

   3. Clique em Guardar.

5. Se não existir nenhum contrato anexado ao produto de dados selecionado, pode adicionar um clicando em Adicionar contrato.

REST

Para atualizar um contrato, use o método entries.patch. Para ver um exemplo de código, consulte o artigo Adicione um contrato.

Atualize aspetos de um produto de dados

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados para o qual quer atualizar os aspetos.

3. Clique no separador Aspetos.

4. Para atualizar um aspeto, siga estes passos:

   1. Clique no aspeto que quer atualizar.

   2. Clique em Editar.

   3. Atualize o Tipo de aspeto, o País e a Região, conforme necessário.

   4. Clique em Guardar.

5. Para adicionar um novo aspeto ao produto de dados, siga estes passos:

   1. Clique em + Adicionar aspeto.

   2. No campo Selecionar tipo de aspeto, pesquise e selecione um tipo de aspeto na lista. Por exemplo, Geo context.

   3. No campo País, selecione o país ao qual o recurso pertence.

   4. No campo Região, selecione a região empresarial à qual o recurso pertence.

   5. Clique em Guardar.

6. Para eliminar um aspeto, siga estes passos:

   1. Clique no aspeto que quer eliminar.

   2. Clique em .

   3. Para confirmar a ação, clique em Confirmar.

REST

Para atualizar qualquer aspeto na entrada de dados do produto, use o método entries.patch.

Atualize a documentação do produto de dados

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados para o qual quer atualizar a documentação.

3. Clique no separador Vista geral.

4. Clique em Editar junto a Documentação.

5. Atualize o guia do utilizador, as consultas de exemplo e outra documentação, conforme necessário.

6. Clique em Guardar.

REST

A documentação faz parte do aspeto overview. Para atualizar a documentação do produto de dados, use o método entries.patch.

Elimine um produto de dados

Para eliminar um produto de dados, tem de remover primeiro todos os recursos do produto de dados.

Consola

1. Na Google Cloud consola, aceda à página Produtos de dados do Dataplex Universal Catalog.

   Aceda a Produtos de dados

2. Clique no produto de dados que quer eliminar.

3. Clique no separador Recursos.

4. Para cada recurso apresentado, clique em > Remover. Confirme a ação clicando em Remover.

5. Depois de remover todos os recursos, elimine o produto de dados clicando em Eliminar.

6. Na caixa de diálogo de confirmação, introduza delete e clique em Eliminar.

REST

Para eliminar um produto de dados, use o método dataProducts.delete.

Por exemplo, envie o seguinte pedido DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

Substitua o seguinte:

• PROJECT_ID: o ID do seu Google Cloud projeto
• LOCATION: a região onde o produto de dados existe
• DATA_PRODUCT_ID: o ID do produto de dados que quer eliminar

O que se segue?

• Saiba como pesquisar produtos de dados.
• Saiba como pedir acesso a produtos de dados.