Antes de poder usar Knowledge Catalog (anteriormente, Dataplex Universal Catalog), debes habilitar las APIs necesarias en tu Google Cloud proyecto. En este documento, se muestra cómo habilitar la API de Dataplex y otros servicios requeridos.
Como medida de seguridad, una organización puede controlar quién tiene permiso para habilitar las APIs. En algunos casos, habilitar las APIs inicia la facturación, por lo que las organizaciones pueden restringir el acceso para controlar los costos. Para obtener información sobre el Service Usage en Google Cloud, consulta Habilita e inhabilita servicios.
Después de habilitar las APIs, Knowledge Catalog ingiere automáticamente y mantiene metadatos actualizados de fuentes de datos Google Cloud compatibles.
Antes de comenzar
Para habilitar y inhabilitar la API de Dataplex, necesitas el rol de Propietario (
roles/owner), Editor (roles/editor) o Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Para obtener más información sobre las funciones y los permisos, consulta Administra el acceso con IAM.
Habilitar Knowledge Catalog
Puedes usar un proyecto existente con Knowledge Catalog o crear uno nuevo. Te recomendamos que crees un proyecto nuevo. Si usas un proyecto nuevo Google Cloud o un proyecto en el que está habilitada la API de BigQuery, la API de Dataplex está habilitada de forma predeterminada. Sin embargo, aún debes habilitar la API de Dataproc y la API de Dataproc Metastore.
Para mantener los recursos creados por el lake dentro de tu proyecto, separados entre sí, crea un proyecto por instancia de lake.
Para crear un proyecto y habilitar Knowledge Catalog, sigue estos pasos:
- En la Google Cloud consola de, selecciona o crea un proyecto.
- Asegúrate de tener habilitada la facturación para tu proyecto.
-
Habilita las APIs de Dataplex, Managed Service para Apache Spark y Dataproc Metastore.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.
Inhabilitar Knowledge Catalog
Si usas Knowledge Catalog en un proyecto que también usa BigQuery, ten en cuenta los efectos en el comportamiento de BigQuery cuando inhabilitas Knowledge Catalog.
Para evitar cargos adicionales, completa los siguientes pasos antes de inhabilitar Knowledge Catalog:
En la Google Cloud consola de, borra cada instancia de lake de tu proyecto. Para borrar un lake, primero debes borrar los recursos y las zonas individuales. Para obtener más información, consulta
projects.locations.lakes.delete.En la Google Cloud consola de, borra todos los grupos de entradas personalizadas de tu proyecto. Borrar un grupo de entradas quita todas las entradas que pertenecen al grupo de entradas. Para obtener más información, consulta Borra un grupo de entradas.
Selecciona el proyecto para inhabilitar la API de Dataplex.
Ve a la página APIs y servicios habilitados.
Haz clic en API de Cloud Dataplex.
Haz clic en Inhabilitar API. Confirma cuando se te solicite.
Si también habilitaste la API de Data Lineage, repite los pasos para inhabilitarla. Inhabilitar la API de Dataplex no inhabilita la API de Data Lineage ni detiene sus cargos de Premium Processing. Para obtener más información, consulta Desactiva el linaje de datos.
¿Qué sigue?
- Obtén más información para buscar recursos.
- Obtén información para medir la calidad de los datos.
- Obtén información sobre los metadatos en Knowledge Catalog.
- Sigue una guía de inicio rápido: Realiza un seguimiento del linaje de datos de una tabla de BigQuery.
- Prueba los casos de uso de Knowledge Catalog.