Como usuário de um domínio de dados, você pode usar esses domínios 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 necessários e as APIs ativadas.
Ativar APIs
Ative a API Dataplex, se ela ainda não estiver ativada.
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, é possível receber essa permissão com o papel de
Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin).
Saiba como conceder papéis.
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:
-
Ver metadados de entradas de domínio para descoberta:
Leitor de entrada do domínio de dados do Dataplex (
roles/dataplex.dataDomainEntryReader) -
Ver 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 usando papéis personalizados ou outros papéis predefinidos.
Navegar pela hierarquia de domínios
Para mais informações sobre como navegar na hierarquia de domínios, consulte Ver 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
No console Google Cloud , acesse a página Knowledge Catalog > Pesquisa.
Clique em Testar a pesquisa natural para ativar o recurso.
Clique em Filtros.
No campo Escopo, selecione Domínio na lista.
No campo Selecionar domínio, escolha o domínio que você quer usar para restringir os resultados. Adicione outros filtros, se necessário.
Outra opção é usar a opção de menu Pesquisar no domínio para encontrar recursos no domínio:
No console do Google Cloud , acesse a página Domínios de dados.
Selecione Pesquisar no domínio no menu . Essa ação abre automaticamente uma janela de pesquisa com o filtro domínio aplicado.
Use o campo de pesquisa para encontrar recursos no domínio.
REST
Para pesquisar entradas no escopo de um domínio de dados, use o método projects.locations.searchEntries e forneça o caminho do domínio no parâmetro contexts.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID: o ID do seu projeto do Google Cloud .LOCATION_ID: a região da consulta de pesquisa (ouglobal).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:
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 se aplicam. 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 a função Dataplex Data Domain Entry Reader no domínio, mas não tem permissão direta para acessar o conjunto de dados no BigQuery:
- Pesquisa no domínio:o conjunto de dados aparece nos resultados da pesquisa porque as permissões do 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.