Usar domínios de dados

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas 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 suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Como usuário de um domínio de dados, você pode usar domínios de dados para restringir os resultados da pesquisa a contextos de negócios específicos, pesquisar conjuntos de dados, tabelas e produtos de dados do BigQuery e descobrir metadados dentro de limites de domínio específicos.

Antes de começar

Antes de fazer uma pesquisa por domínio, verifique se você tem os papéis e as APIs necessários ativados.

Ativar APIs

Ativar a API Dataplex.

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 com o papel de proprietário (roles/owner). Caso contrário, você pode receber essa permissão com o papel de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

Ativar a API

Funções exigidas

Para receber as permissões necessárias para pesquisar e descobrir metadados usando domínios de dados, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto ou domínio de dados:

• Visualizar metadados de entradas de domínio para descoberta: Leitor de entrada do domínio de dados do Dataplex (roles/dataplex.dataDomainEntryReader)
• Visualizar configurações e vinculações de domínio: leitor de configuração de domínio de dados do Dataplex (roles/dataplex.dataDomainViewer)

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 com papéis personalizados ou outros papéis predefinidos.

Navegar pela hierarquia de domínios

Para mais informações sobre como navegar pela hierarquia de domínios, consulte Visualizar domínios e subdomínios de dados em um local.

Encontrar recursos em um domínio de dados

Para pesquisar recursos com um domínio, siga estas etapas:

Console

1. No Google Cloud console, acesse a página Knowledge Catalog > Pesquisar.

   Acesse Pesquisar

2. Clique em Testar a pesquisa natural para ativar o recurso de pesquisa natural.

3. Clique em Filtros.

4. No campo Escopo, selecione Domínio na lista.

5. No campo Selecionar domínio, escolha o domínio que você quer restringir os resultados. Adicione outros filtros, se necessário.

Como alternativa, você pode usar a opção de menu Pesquisar no domínio para encontrar recursos no domínio:

1. No Google Cloud console, acesse a página Domínios de dados.

   Acessar domínios de dados

2. Selecione Pesquisar no domínio no menu more_vert. Essa ação abre automaticamente uma janela de pesquisa com o filtro domínio aplicado.

3. Use o campo de pesquisa para encontrar recursos no domínio.

REST

Para pesquisar entradas com escopo em um domínio de dados, use o método projects.locations.searchEntries e forneça o caminho do domínio no parâmetro contexts.

Observação: o local no caminho para searchEntries pode ser global (para distribuição completa) ou uma região específica, dependendo da configuração do back-end de pesquisa.

Antes de usar os dados da solicitação abaixo, faça estas substituições:

• PROJECT_ID: o ID do Google Cloud projeto.
• LOCATION_ID: a região da consulta de pesquisa (ou global).
• QUERY: a string de consulta de pesquisa.
• DOMAIN_ID: o identificador exclusivo do domínio de dados que define o contexto do escopo de pesquisa.

Método HTTP e URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

Corpo JSON da solicitação:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.

Limitações

Quando você pesquisa recursos fora do contexto do domínio, por exemplo, ao usar uma pesquisa global, as permissões de capacidade de descoberta do domínio não são aplicadas. Você só vê os recursos a que tem acesso no sistema subjacente, como o BigQuery.

Suponha que um conjunto de dados do BigQuery esteja incluído em um domínio de dados. Você tem o papel de Dataplex Data Domain Entry Reader para o domínio, mas não tem permissão direta para visualizar o conjunto de dados no BigQuery:

• Pesquisar no domínio:você vê o conjunto de dados nos resultados da pesquisa porque as permissões de domínio são aplicadas.
• Pesquisar fora do domínio:o conjunto de dados não aparece nos resultados da pesquisa. Em uma pesquisa geral, as permissões de domínio não são aplicadas e você não tem acesso direto no BigQuery.

A seguir

• Saiba mais sobre domínios de dados.
• Saiba como criar domínios de dados.
• Saiba como gerenciar recursos de domínio de dados.