Use produtos de dados

Este documento destina-se a consumidores de produtos de dados que pretendam descobrir e usar produtos de dados para os seus exemplos de utilização.

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

Funções necessárias

Para receber as autorizações de que precisa para pesquisar, aceder e usar produtos de dados, peça ao seu administrador que lhe conceda as seguintes funções de IAM no produto de dados ou no projeto:

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.

Enquanto consumidor de produtos de dados, para ver os metadados de um recurso, tem de ter a autorização viewer para aceder ao recurso correspondente no sistema de origem. Por exemplo, para pesquisar metadados de um conjunto de dados ou uma tabela num produto de dados, precisa da função Leitor de metadados do BigQuery (roles/bigquery.metadataViewer). Para mais informações, consulte Funções necessárias para aceder aos resultados da pesquisa.

Consola

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

    Aceda à pesquisa

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

  3. Nos resultados da pesquisa, clique no produto de dados cujos detalhes quer ver. Pode rever a descrição, os recursos, o contrato, os aspetos e outra documentação associada ao produto de dados.

REST

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

Por exemplo, envie o seguinte pedido 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 o seguinte:

  • ADDITIONAL_KEYWORDS (opcional): quaisquer 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 Google Cloud projeto no qual o produto de dados é criado

Peça acesso a produtos de dados

Como consumidor de um produto de dados, se não tiver acesso a um produto de dados, pode pedir acesso através dos seguintes passos:

  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 ao qual quer aceder.

  3. Clique em Pedir acesso.

  4. No painel Detalhes do pedido, especifique o seguinte:

    • Tipo de acesso: selecione o acesso que procura.
    • Mensagem: indique uma justificação para o pedido de acesso.

  5. Clique em Enviar. É aberta automaticamente uma nova versão de email na sua aplicação de email predefinida (como o Gmail ou o Outlook) com o endereço do destinatário e uma linha de assunto e um corpo da mensagem pré-preenchidos.

  6. Reveja o conteúdo do email gerado automaticamente, que contém os detalhes do seu pedido.

    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 o seu email e revê o seu pedido. Aguarde uma notificação por email a confirmar que o seu pedido de acesso foi aprovado ou recusado.

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

Consuma produtos de dados

Para usar um produto de dados, certifique-se de que lhe são concedidas as autorizações necessárias. Consulte o artigo Peça acesso a produtos de dados.

Depois de o proprietário do produto de dados lhe conceder autorização, pode aceder ao produto de dados e aos respetivos recursos. Por exemplo, se lhe forem concedidas autorizações para aceder a uma tabela do BigQuery, pode consultá-la diretamente no BigQuery para gerar estatísticas.

Para aceder e usar um produto de dados, siga estes passos:

  1. Pesquise o produto de dados.
  2. Nos resultados da pesquisa, clique no produto de dados que quer usar.
  3. Clique no separador Recursos.
  4. Clique no recurso cujos detalhes quer ver. É apresentada a página de detalhes da entrada. Pode aceder a detalhes como o esquema, as estatísticas e a linhagem. Se o recurso for uma tabela ou uma vista do BigQuery, pode clicar em Abrir no BigQuery para navegar para o estúdio do BigQuery e consultar os resultados.

O que se segue?