Usar produtos de dados

Os produtos de dados no Knowledge Catalog (antigo Dataplex Universal Catalog) permitem encontrar coleções de recursos selecionadas e solicitar acesso por fluxos de trabalho de aprovação integrados. Depois de aprovado, é possível consultar os dados subjacentes, como tabelas do BigQuery, usando suas credenciais de usuário, uma conta de serviço ou um servidor remoto do Protocolo de Contexto de Modelo (MCP).

Este documento é destinado a consumidores de produtos de dados. Para mais informações sobre a arquitetura e os principais conceitos de produtos de dados, consulte Sobre produtos de dados.

Antes de começar

  1. Ative as APIs Dataplex e BigQuery, se ainda não estiverem ativadas.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar as 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 visualizar 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 de 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 Knowledge 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 ver os detalhes. É possível analisar a descrição, os recursos, o contrato, os aspectos, os detalhes de contato e outras documentações associadas 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): outras palavras-chave ou critérios de pesquisa para restringir os resultados (por exemplo, displayName:'My Data Product' ou description:'sales')
  • PROJECT_ID: o ID do projeto do Google Cloud em que o produto de dados é criado.

Solicitar acesso a produtos de dados

Como consumidor de produtos de dados, se você não tiver permissões do IAM para acessar um produto de dados, poderá solicitar acesso usando os fluxos de trabalho de aprovação de acesso integrados.

Enviar uma solicitação de acesso

Console

  1. No console do Google Cloud , acesse a página Produtos de dados do Knowledge 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 os seguintes parâmetros:

    • Grupos de acesso: selecione o grupo de acesso funcional de que você quer participar.

    • Própria ou Conta de serviço: selecione o tipo de principal:

      • Se você estiver solicitando acesso para si, selecione Próprio.

      • Se você estiver solicitando acesso para identidade programática, selecione Conta de serviço. Essa opção só estará disponível se o produto de dados for compatível com contas de serviço.

    • Justificativa: insira uma justificativa comercial para sua solicitação.

  5. Clique em Enviar.

Uma nova solicitação de mudança é gerada para que o proprietário do produto de dados a analise. Você vai receber uma notificação por e-mail detalhando o status final assim que o pedido for aprovado ou recusado.

REST

Os consumidores de produtos de dados que têm a permissão dataplex.dataProducts.get podem solicitar acesso criando um recurso ChangeRequest. Envie uma solicitação POST ao endpoint do recurso do produto de dados usando o método personalizado :requestAccess:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
  "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
  "change_request": {
    "justification": "JUSTIFICATION_TEXT",
    "data_product_access_request": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
      "access_group_id": "DATA_PRODUCT_ACCESS_GROUP_ID"
    }
  }
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID:requestAccess"

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud

  • LOCATION: a região em que o produto de dados está (por exemplo, us-central1)

  • DATA_PRODUCT_ID: o identificador exclusivo do produto de dados de destino

  • JUSTIFICATION_TEXT: o motivo comercial que explica por que o acesso é necessário

  • DATA_PRODUCT_ACCESS_GROUP_ID: o ID do grupo de acesso específico em que você quer entrar.

Ver o status dos pedidos de acesso

Como consumidor de produtos de dados, é possível monitorar o progresso e o ciclo de vida das solicitações de acesso enviadas. O Knowledge Catalog rastreia e exibe essas solicitações usando estados de status distintos, dependendo se você está visualizando uma lista de fluxo de trabalho unificada ou um resumo de acesso de um produto específico.

Ver uma lista unificada dos seus pedidos de acesso

Para ver uma lista completa de todas as solicitações de acesso enviadas em todos os produtos de dados, siga estas etapas:

Console

  1. No console Google Cloud , acesse a página Fluxos de trabalho de governança do Knowledge Catalog.

    Acessar fluxos de trabalho de governança

  2. Clique na guia Minhas solicitações.

  3. Analise a lista unificada que mostra suas solicitações anteriores e pendentes, além dos status atuais do fluxo de trabalho:

    • Novo: a solicitação de acesso foi criada e está aguardando análise do aprovador.

    • Aprovado: a solicitação foi aprovada, mas os sistemas de back-end ainda estão provisionando o acesso.

    • Recusada: o pedido foi negado. Leia os comentários do aprovador para entender o motivo da rejeição.

REST

Envie uma solicitação GET usando o método de coleção personalizada :listMine:

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

Ver o resumo de acesso de um produto de dados específico

Além da lista global de fluxos de trabalho, é possível verificar sua postura de acesso para um produto de dados individual. Isso permite verificar se você já tem acesso herdado a um grupo de recursos sem precisar enviar uma nova solicitação.

Para conferir o resumo de acesso de um produto de dados, siga estas etapas:

Console

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

    Acessar produtos de dados

  2. Clique no produto de dados específico que você quer inspecionar.

  3. Clique na guia Resumo do acesso. Analise seu status em todos os grupos de acesso ilimitado desse produto de dados.

    A guia Resumo de acesso usa os seguintes estados de status:

    Status Descrição
    Sem acesso Você não tem acesso ao grupo de acesso e ainda não solicitou acesso.
    Em análise Você enviou uma solicitação de acesso, e ela está aguardando a análise de um aprovador.
    Approved Seu pedido de acesso foi aprovado, mas a propagação da associação ao Grupo do Google ainda está em processamento.
    Acesso concedido O acesso está totalmente ativo. Você é membro do grupo de acesso e pode interagir com os recursos do produto de dados.
    Rejeitada Sua solicitação para este grupo de acesso foi rejeitada.

REST

Envie uma solicitação GET usando o ID exclusivo retornado quando a solicitação foi criada originalmente:

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

Substitua:

  • PROJECT_ID: ID do projeto do Google Cloud

  • LOCATION: a região em que o produto de dados está (por exemplo, us-central1)

  • CHANGE_REQUEST_ID: o ID exclusivo da solicitação de alteração enviada.

Excluir uma solicitação de acesso

  1. No console Google Cloud , acesse a página Fluxos de trabalho de governança do Knowledge Catalog.

    Acessar fluxos de trabalho de governança

  2. Clique na guia Minhas solicitações.

  3. Localize a linha que contém a solicitação do produto de dados de destino. Se necessário, aplique um filtro para isolar a entrada.

  4. Clique em Ações e em Excluir.

Consumir produtos de dados

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

Depois que o proprietário do produto de dados conceder permissão, você poderá acessar o produto de dados 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.

Acessar recursos usando credenciais de usuário

Se a solicitação de acesso foi aprovada para suas credenciais de usuário, siga estas etapas para acessar os recursos:

  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 que você quer analisar. A página de detalhes da entrada será aberta.

    É possível 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.

Acessar recursos usando uma conta de serviço

Se a solicitação de acesso foi aprovada para uma conta de serviço, você recebe o papel do IAM de Criador de token da conta de serviço (roles/iam.serviceAccountTokenCreator) na conta de serviço do produtor de dados. Isso permite criar uma cadeia de representação para acessar os recursos subjacentes.

Para acessar recursos usando uma conta de serviço, siga estas etapas:

  1. Identifique as contas de serviço configuradas para o produto de dados acessando a guia Recursos de dados da página de detalhes do produto de dados.

  2. Para personificar a conta de serviço do produtor de dados, crie uma cadeia de personificação para sua conta de serviço usando o seguinte comando da Google Cloud CLI:

    gcloud config set auth/impersonate_service_account CONSUMER_SERVICE_ACCOUNT,PRODUCER_SERVICE_ACCOUNT

    Substitua:

    • CONSUMER_SERVICE_ACCOUNT: o endereço de e-mail totalmente qualificado da conta de serviço que pertence ao consumidor do produto de dados.

    • PRODUCER_SERVICE_ACCOUNT: o endereço de e-mail totalmente qualificado da conta de serviço mapeada para o grupo de acesso ao produto de dados.

    Para mais informações, consulte Usar a identidade temporária de conta de serviço.

Acessar produtos de dados usando o servidor MCP remoto

Para aplicativos cliente e ferramentas para desenvolvedores que interagem com seus produtos de dados fora do ecossistema do Google Cloud , use um servidor remoto do Protocolo de Contexto de Modelo (MCP). Esse padrão arquitetônico permite que clientes desenvolvedores externos consultem e descubram com segurança recursos de dados catalogados, mantendo limites de governança unificados.

Para saber como implantar e se conectar a um servidor externo, consulte Usar o servidor MCP remoto do Knowledge Catalog.

A seguir