Administración de catálogos

En este artículo se muestra cómo ver, actualizar y eliminar catálogos en Unity Catalog. Un catálogo contiene esquemas (bases de datos) y un esquema contiene tablas, vistas, volúmenes, modelos y funciones.

Para más información sobre los catálogos, consulte ¿Qué son los catálogos en Azure Databricks? y Creación de catálogos. Para aprender a conceder y revocar el acceso a cualquier catálogo, consulte Objetos protegibles y privilegios de Unity Catalog.

Para aprender a administrar cualquier catálogo externo, un objeto de Unity Catalog que refleja una base de datos en un sistema de datos externo, consulte Administración y uso de catálogos externos.

Requisitos

Para ver, actualizar o eliminar un catálogo:

• Es preciso tener un metastore de Unity Catalog vinculado al área de trabajo en el que se realiza la tarea.

• El clúster que se usa para ejecutar un cuaderno para administrar un catálogo debe usar un modo de acceso compatible con Unity Catalog. Consulte Modos de acceso.

  Los almacenes de SQL siempre admiten Unity Catalog.

Los permisos necesarios difieren en función de la tarea y se proporcionan en cada sección que se indica a continuación.

Ver detalles de catálogo

Permiso necesario: los usuarios pueden ver los metadatos de todos los catálogos que poseen o en los que se les han asignado los permisos USE CATALOG o BROWSE.

Para ver información sobre un catálogo, puede usar Explorador de catálogo o bien un comando de SQL.

Explorador de catálogo

1. Inicie sesión en un área de trabajo vinculada al metastore.

2. Haga clic en Catálogo.

3. En el panel de Catálogo, busque el catálogo y haga clic en su nombre.

   Algunos detalles se muestran en la parte superior de la página. Otros se pueden ver en las pestañas Esquemas, Detalles, Permisos y Áreas de trabajo.

SQL

Ejecute SHOW CATALOGS en un cuaderno o en el editor de consultas SQL para enumerar todos los catálogos de un metastore o aquellos que coincidan con una expresión regular.

Para más información sobre un catálogo, ejecute el siguiente comando SQL. Los elementos entre corchetes son opcionales. Reemplace el marcador de posición <catalog-name>.

DESCRIBE CATALOG <catalog-name>;

Use CATALOG EXTENDED para obtener detalles completos.

Para más información, consulte DESCRIBE CATALOG.

Actualización de un catálogo

Para eliminar (o modificar) un catálogo, puede usar Explorador de catálogos o bien un comando de SQL.

Permisos necesarios: los permisos necesarios para actualizar un catálogo dependen de la actualización:

• Para cambiar el propietario, es preciso ser el propietario.
• Para cambiar el nombre del catálogo, es preciso ser el propietario.
• Para agregar o actualizar comentarios o etiquetas, es preciso ser el propietario o tener los permisos MODIFY y USE CATALOG en el catálogo.
• Para conceder y revocar permisos en el catálogo, es preciso ser el propietario del catálogo o un administrador de metastore.

Explorador de catálogo

1. Inicie sesión en un área de trabajo vinculada al metastore de Unity Catalog.
2. Haga clic en Catálogo.
3. En el panel Catálogo, a la izquierda, haga clic en el catálogo que desea actualizar.
4. Use los siguientes elementos de la página de detalles del catálogo para actualizar el catálogo:
   • Pestaña Información general: actualice el propietario, agregue o actualice etiquetas, y agregue o actualice comentarios. Consulte Administración de la propiedad de objetos de Unity Catalog, Aplicación de etiquetas a objetos protegibles de Unity Catalog y Adición de comentarios a recursos de datos e inteligencia artificial.
   • Pestaña Permisos: conceda y revoque privilegios en el catálogo. Consulte Administración de privilegios en Unity Catalog.
   • El menú kebab : cambie el nombre del catálogo.
   • Botón Crear esquema: agregue un esquema al catálogo. Consulte Creación de esquemas.

SQL

• Para cambiar el propietario, agregar o actualizar etiquetas y administrar la optimización predictiva en las tablas de un esquema, ejecute el comando ALTER CATALOG en un cuaderno o en el editor de consultas SQL. Consulte ALTER CATALOG.
• Para conceder o revocar privilegios, use los comandos GRANT o REVOKE. Consulte GRANT y REVOKE.
• Para agregar esquemas al catálogo, consulte ¿Qué son los esquemas en Azure Databricks?.
• Para cambiar el nombre de un catálogo mediante SQL, debe crear un catálogo y mover a él todos los recursos.

Eliminación de un catálogo

Para eliminar (o anular) un catálogo, puede usar Explorador de catálogo o bien un comando de SQL.

Permiso necesario: propietario del catálogo.

Explorador de catálogo

Debe eliminar todos los esquemas del catálogo excepto information_schema para poder eliminar un catálogo. Esto incluye el esquema default creado automáticamente.

1. Inicie sesión en un área de trabajo vinculada al metastore.
2. Haga clic en Catálogo.
3. En el panel Catálogo, a la izquierda, haga clic en el catálogo que desea eliminar.
4. En el panel de detalles, haga clic en el menú kebab situado a la izquierda del botón Crear base de datos y seleccione Eliminar.
5. En el cuadro de diálogo Eliminar catálogo, haga clic en Eliminar.

SQL

Ejecute el siguiente comando SQL en un cuaderno o en el editor de Databricks SQL. Los elementos entre corchetes son opcionales. Reemplace el marcador de posición <catalog-name>.

Para descripciones de parámetro, consulte DROP CATALOG.

Si usa DROP CATALOG sin la opción CASCADE, debe eliminar todos los esquemas del catálogo excepto information_schema para poder eliminarlo. Esto incluye el esquema default creado automáticamente.

DROP CATALOG [ IF EXISTS ] <catalog-name> [ RESTRICT | CASCADE ]

Por ejemplo, para eliminar un catálogo denominado vaccine y sus esquemas:

DROP CATALOG vaccine CASCADE