Gerenciar produtos de dados

Pré-lançamento

Este produto ou 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 produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Este documento é destinado a proprietários de produtos de dados que querem atualizar, excluir e conceder acesso a produtos de dados no Dataplex Universal Catalog.

Para mais informações sobre a arquitetura e os conceitos principais dos produtos de dados, consulte Sobre 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

Observação: este guia pressupõe que você já tenha produtos de dados para gerenciar. Para mais informações sobre como criar e configurar produtos de dados, consulte Criar produtos de dados.

Funções exigidas

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

• Permissões completas para criar, atualizar, excluir e gerenciar permissões para produtos de dados: Administrador de produtos de dados do Dataplex (roles/dataplex.dataProductsAdmin)
• Atualizar e gerenciar produtos de dados atuais: Editor de produtos de dados do Dataplex (roles/dataplex.dataProductsEditor)
• Adicione aspectos como schema, overview e contacts: Proprietário de entradas e links de entradas do Dataplex (roles/dataplex.entryOwner)
• Pesquisar e adicionar recursos: Leitor do Dataplex Catalog (roles/dataplex.catalogViewer)
• Edite tipos de aspectos do sistema, como documentação e aspecto de contrato da cadência de atualização: Editor do Dataplex Catalog (roles/dataplex.catalogEditor)

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

Esses papéis predefinidos contêm as permissões necessárias para gerenciar produtos de dados. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para gerenciar produtos de dados:

• Edite o tipo de aspecto do sistema overview: dataplex.entryGroups.useOverviewAspect
• Edite o tipo de aspecto do sistema refresh cadence: dataplex.entryGroups.useRefreshCadenceAspect

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Conceder acesso a um produto de dados

Os proprietários de produtos de dados precisam tornar os produtos detectáveis e conceder as funções necessárias, permitindo que os consumidores pesquisem, visualizem e solicitem acesso a eles.

Para conceder aos consumidores de produtos de dados as permissões necessárias para interagir com o produto, conceda a eles os seguintes papéis do IAM no recurso do produto de dados:

• Pesquise e acesse produtos de dados na pesquisa do Dataplex Universal Catalog: Consumidor de produtos de dados do Dataplex (dataplex.dataProductsConsumer)
• Acesso somente leitura para visualizar definições e metadados de produtos de dados: Leitor de produtos de dados do Dataplex (dataplex.dataProductsViewer)
• Solicitar acesso a produtos de dados: consumidor de produtos de dados do Dataplex (dataplex.dataProductsConsumer)

Quando um consumidor de produto de dados solicita acesso a um produto de dados, o proprietário dele recebe uma notificação por e-mail.

Para conceder acesso, siga estas etapas:

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

   Acessar a página "Grupos"

2. Pesquise e selecione o grupo associado ao nível de permissão solicitado.

3. Clique em  Adicionar participantes.

4. Adicione o principal.

5. Clique em Salvar.

Para mais informações, consulte Criar e gerenciar Grupos do Google no console do Google Cloud .

Atualizar um produto de dados

É possível atualizar os detalhes básicos (por exemplo, nome, descrição e detalhes do proprietário do produto de dados), recursos, grupos de acesso, permissões, contrato, aspectos e documentação adicional de um produto de dados.

Atualizar os detalhes básicos de um produto de dados

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

2. Clique no produto de dados que você quer atualizar.

3. Clique em Editar produto de dados.

4. Atualize o Nome do produto de dados, o Ícone, a Descrição, os Contatos do proprietário e os Rótulos 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 a seguinte solicitação 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:

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

Atualizar recursos de um produto de dados

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

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

3. Clique na guia Recursos.

4. Para adicionar um novo recurso, siga estas etapas:

   1. Clique em +Add.

   2. Pesquise e selecione os recursos que você quer adicionar ao produto de dados. Os recursos selecionados precisam estar na mesma região do produto de dados.

      Se você tiver as permissões necessárias, clique no recurso para ver os metadados dele.

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

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

5. Para remover um recurso do produto de dados, siga estas etapas:

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

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

REST

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

Para excluir um recurso de dados do produto de dados, use o método dataAssets.delete. Por exemplo, envie a seguinte solicitação 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:

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

Atualizar grupos de acesso e permissões de recursos

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

2. Clique no produto de dados para o qual você quer atualizar os grupos de acesso e permissões.

3. Clique na guia Grupos de acesso e permissões.

4. Para atualizar um grupo de acesso, siga estas etapas:

   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 grupo de acesso, clique em Adicionar grupo de acesso e siga estas etapas:

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

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

      3. No campo Identificador do grupo de acesso, insira o endereço de e-mail de um grupo do Google que você quer atribuir a esse grupo de acesso. Os consumidores de produtos de dados que solicitarem acesso a esse grupo podem ser adicionados como membros ao grupo do Google mapeado.

         É possível adicionar no máximo três grupos de acesso por produto de dados.

   4. Clique em Adicionar.

5. Para remover um grupo de acesso, siga estas etapas:

   1. No grupo de acesso que você quer remover, clique em > Remover.

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

6. Se nenhum grupo de acesso estiver configurado para o produto de dados selecionado, clique em Adicionar grupo de acesso.

7. Para atualizar as permissões de recursos, siga estas etapas:

   1. No recurso para o qual você quer atualizar as permissões, clique em > Permissões.

   2. Atualize os grupos de acesso e papéis do 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 um exemplo de código, consulte Configurar grupos de acesso.

Para atualizar as permissões do recurso, use o método dataAssets.patch. Para um exemplo de código, consulte Configurar permissões de recursos.

Atualizar o contrato do produto de dados

Observação: não é possível editar a cadência de atualização depois de adicioná-la ao contrato. Se você tentar modificar esse valor, o seguinte erro vai aparecer: You don't have permission to change contract values.

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

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

3. Clique na guia Contrato.

4. Para atualizar o contrato atual, siga estas etapas:

   1. Clique em Editar.

   2. Atualize os campos necessários.

   3. Clique em Salvar.

5. Se nenhum contrato estiver anexado ao produto de dados selecionado, clique em Adicionar contrato.

REST

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

Atualizar aspectos de um produto de dados

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

2. Clique no produto de dados para o qual você quer atualizar os aspectos.

3. Clique na guia Aspectos.

4. Para atualizar um aspecto, siga estas etapas:

   1. Clique no aspecto que você quer atualizar.

   2. Clique em Editar.

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

   4. Clique em Salvar.

5. Para adicionar um novo aspecto ao produto de dados, siga estas etapas:

   1. Clique em + Adicionar aspecto.

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

   3. No campo País, selecione o país do recurso.

   4. No campo Região, selecione a região comercial a que o recurso pertence.

   5. Clique em Salvar.

6. Para excluir um aspecto, siga estas etapas:

   1. Clique no aspecto que você quer excluir.

   2. Clique em .

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

REST

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

Atualizar a documentação do produto de dados

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

2. Clique no produto de dados cuja documentação você quer atualizar.

3. Clique na guia Visão geral.

4. Clique em Editar em Documentação.

5. Atualize o guia do usuário, exemplos de consultas e outras documentações conforme necessário.

6. Clique em Salvar.

REST

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

Excluir um produto de dados

Para excluir um produto de dados, primeiro remova todos os recursos dele.

Console

1. No console Google Cloud , acesse a página Produtos de dados do Dataplex Universal Catalog.

   Acessar Produtos de dados

2. Clique no produto de dados que você quer excluir.

3. Clique na guia Recursos.

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

5. Depois de remover todos os recursos, exclua o produto de dados clicando em Excluir.

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

REST

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

Por exemplo, envie a seguinte solicitação 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:

• PROJECT_ID: o ID do seu projeto Google Cloud
• LOCATION: a região em que o produto de dados existe
• DATA_PRODUCT_ID: o ID do produto de dados que você quer excluir.

A seguir

• Saiba como pesquisar produtos de dados.
• Saiba como solicitar acesso aos produtos de dados.