Usar produtos de dados

Este documento é destinado a consumidores de produtos de dados que querem descobrir e usar produtos de dados para os casos de uso deles.

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

Funções exigidas

Para receber as permissões necessárias para pesquisar, acessar e usar produtos de dados, peça ao administrador para conceder a você os seguintes papéis do IAM no produto de dados ou 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 papéis personalizados ou outros papéis predefinidos.

Como consumidor de produtos de dados, para ver os metadados de um recurso, você precisa ter a permissão viewer para acessar o recurso correspondente no sistema de origem. Por exemplo, para pesquisar metadados de um conjunto de dados ou uma tabela em um produto de dados, é necessário ter o papel de Leitor de metadados do BigQuery (roles/bigquery.metadataViewer). Para mais informações, consulte Papéis necessários para acessar os resultados da pesquisa.

Console

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

    Acesse Pesquisar

  2. Pesquise usando palavras-chave ou linguagem natural. Para mais informações, consulte Pesquisar recursos.

  3. Nos resultados da pesquisa, clique no produto de dados para acessar os detalhes. Você pode analisar a descrição, os recursos, o contrato, os aspectos e outra documentação associada ao produto de dados.

REST

Para pesquisar um produto de dados, use o método searchEntries.

Por exemplo, envie a seguinte solicitação POST:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
  '{
  "query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
  "pageSize": 10
  }' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"

Substitua:

  • ADDITIONAL_KEYWORDS (opcional): palavras-chave ou critérios de pesquisa adicionais para restringir os resultados (por exemplo, displayName:'My Data Product' ou description:'sales')
  • PROJECT_ID: o ID do seu projeto Google Cloud em que o produto de dados é criado

Solicitar acesso a produtos de dados

Como consumidor de um produto de dados, se você não tiver acesso a um produto de dados, poderá solicitar acesso seguindo estas etapas:

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

  3. Clique em Solicitar acesso.

  4. No painel Detalhes da solicitação, especifique o seguinte:

    • Tipo de acesso: selecione o acesso que você procura.
    • Mensagem: informe uma justificativa para o pedido de acesso.

  5. Clique em Enviar. Um novo rascunho de e-mail é aberto automaticamente no seu aplicativo de e-mail padrão (como Gmail ou Outlook) com o endereço do destinatário e uma linha de assunto e corpo da mensagem pré-preenchidos.

  6. Revise o conteúdo do e-mail gerado automaticamente, que contém os detalhes da sua solicitação.

    Para enviar o pedido de acesso ao proprietário do produto de dados para aprovação, clique em Enviar.

    O proprietário do produto de dados recebe seu e-mail e analisa sua solicitação. Aguarde uma notificação por e-mail confirmando se o pedido de acesso foi aprovado ou negado.

    Após a aprovação, você terá acesso ao produto de dados e poderá começar a usá-lo no Dataplex Universal Catalog.

Consumir produtos de dados

Para usar um produto de dados, confira se você tem as permissões necessárias. Consulte Solicitar acesso aos produtos de dados.

Depois que o proprietário do produto de dados conceder permissão, você poderá acessar o produto e os recursos dele. Por exemplo, se você tiver permissão para acessar uma tabela do BigQuery, poderá consultá-la diretamente no BigQuery para gerar insights.

Para acessar e usar um produto de dados, siga estas etapas:

  1. Pesquise o produto de dados.
  2. Nos resultados da pesquisa, clique no produto de dados que você quer usar.
  3. Clique na guia Recursos.
  4. Clique no recurso para ver os detalhes. A página de detalhes da entrada vai ser aberta. Você pode acessar detalhes como esquema, insights e linhagem. Se o recurso for uma tabela ou visualização do BigQuery, clique em Abrir no BigQuery para acessar o BigQuery Studio e consultar os resultados.

A seguir