Antes de usar o Knowledge Catalog (antigo Dataplex Universal Catalog), ative as APIs necessárias no projeto Google Cloud . Este documento mostra como ativar a API Dataplex e outros serviços necessários.
Como medida de segurança, uma organização pode controlar quem tem permissão para ativar APIs. Em alguns casos, a ativação de APIs inicia o faturamento. Por isso, as organizações podem restringir o acesso para controlar os custos. Para informações sobre o Service Usage no Google Cloud, consulte Como ativar e desativar serviços.
Depois de ativar as APIs, o Knowledge Catalog ingere e mantém automaticamente metadados atualizados de fontes de dados Google Cloud compatíveis.
Antes de começar
Para ativar e desativar a API Dataplex, você precisa ter o papel de Proprietário (
roles/owner), Editor (roles/editor) ou Administrador do uso do serviço (roles/serviceusage.serviceUsageAdmin). Para mais informações sobre papéis e permissões, consulte Gerenciar o acesso com o IAM.
Ativar o Knowledge Catalog
Você pode usar um projeto atual com o Knowledge Catalog ou criar um novo. Recomendamos que você crie um novo projeto. Se você estiver usando um novo projeto do Google Cloud ou um projeto em que a API BigQuery está ativada, a API Dataplex será ativada por padrão. No entanto, ainda é necessário ativar a API Dataproc e Dataproc Metastore.
Para manter os recursos criados pelo lake separados uns dos outros dentro do seu projeto, crie um projeto por instância do lake.
Para criar um projeto e ativar o Knowledge Catalog, siga estas etapas:
- No console do Google Cloud , selecione ou crie um projeto.
- Verifique se o faturamento foi ativado para o projeto.
-
Ative as APIs Dataplex, Serviço Gerenciado para Apache Spark e Dataproc Metastore, se alguma delas 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.
Desativar o Knowledge Catalog
Se você usa o Knowledge Catalog em um projeto que também usa o BigQuery, saiba dos efeitos no comportamento do BigQuery ao desativar o Knowledge Catalog.
Para evitar cobranças extras, siga estas etapas antes de desativar o Knowledge Catalog:
No console Google Cloud , exclua cada instância de lake no seu projeto. Para excluir um lake, primeiro é preciso excluir os recursos e as zonas individuais. Para mais informações, consulte
projects.locations.lakes.delete.No console Google Cloud , exclua todos os grupos de entradas personalizadas no seu projeto. A exclusão de um grupo de entradas remove todas as entradas que pertencem a ele. Para mais informações, consulte Excluir um grupo de entradas.
Selecione o projeto em que você quer desativar a API Dataplex.
Acesse a página APIs e serviços ativados.
Clique em API Cloud Dataplex.
Clique em Desativar API. Confirme quando solicitado.
Se você também ativou a API Data Lineage, repita as etapas para desativá-la. Desativar a API Dataplex não desativa a API Data Lineage nem interrompe as cobranças de tratamento premium. Para mais informações, consulte Desativar a linhagem de dados.
A seguir
- Saiba como pesquisar recursos.
- Saiba como medir a qualidade de dados.
- Saiba mais sobre os metadados no Knowledge Catalog.
- Siga um guia de início rápido: Rastrear a linhagem de dados de uma tabela do BigQuery.
- Confira os casos de uso do Knowledge Catalog.