Aplicar etiquetas a objetos protegibles del Unity Catalog

2025-06-09

En esta página se muestra cómo aplicar etiquetas a objetos protegibles del catálogo de Unity.

Las etiquetas son atributos que incluyen claves y valores opcionales que puede usar para organizar y clasificar objetos protegibles en Unity Catalog. El uso de etiquetas también simplifica la búsqueda y detección de tablas y vistas mediante la funcionalidad de búsqueda del área de trabajo.

Los datos de etiqueta se pueden replicar globalmente. No use nombres de etiqueta ni valores que puedan poner en peligro la seguridad de los recursos. Por ejemplo, no use nombres de etiqueta que contengan información personal o confidencial.

Objetos protegibles admitidos

El etiquetado de objetos protegibles se admite actualmente en catálogos, esquemas, tablas, columnas de tabla, volúmenes, vistas, modelos registrados y versiones de modelos. Para obtener más información sobre los objetos protegibles, vea Objetos protegibles en Unity Catalog.

Etiquetas reguladas por una directiva

Importante

Esta característica se encuentra en su versión beta.

Las etiquetas reguladas son etiquetas administradas y aplicadas por una directiva de etiquetas. Las directivas de etiquetas permiten a los administradores definir qué claves de etiqueta se rigen, especificar los valores permitidos para esas etiquetas y controlar quién puede asignarlas o modificarlas. Esto proporciona a las organizaciones un control centralizado sobre el uso de etiquetas, la compatibilidad con la clasificación de datos coherente, el cumplimiento y los estándares operativos.

Cuando una etiqueta se rige por una directiva de etiquetas:

Solo los usuarios o grupos con los permisos adecuados pueden asignar o modificar la etiqueta regulada.
Solo se pueden usar los valores permitidos especificados en la directiva de etiquetas para esa clave de etiqueta.
Se muestra un junto a la etiqueta.

Si se elimina una directiva de etiquetas, las etiquetas que se regían previamente por esa directiva quedan sin gobernar. Las propias etiquetas no se quitan de los objetos, pero cualquier persona puede asignar o modificar etiquetas con el mismo nombre sin necesidad de permisos especiales.

Las etiquetas reguladas ayudan a garantizar que los metadatos importantes, como la clasificación de datos, el estado normativo o el centro de costos, se aplican de forma coherente y según los requisitos de gobernanza de la organización. Todos los usuarios con privilegios adecuados pueden crear y asignar etiquetas que no se rigen por directivas de etiquetas. Las directivas de etiqueta solo se aplican a las etiquetas que se rigen explícitamente.

Para obtener más información, consulte Directivas de etiquetas.

Nota:

Si está inscrito en la Versión preliminar privada de etiquetas de panel, cualquier etiqueta asignada a un panel que coincida con el nombre de una etiqueta regulada estará automáticamente sujeta a la política de esa etiqueta.

Etiquetas del sistema

Las etiquetas del sistema son un tipo especial de etiqueta regulada predefinida por Azure Databricks y cuya aplicación se rige por las directivas de etiquetas. Las etiquetas del sistema tienen algunas características distintas:

Azure Databricks predefini las definiciones de etiquetas del sistema (claves y valores).
Los usuarios no pueden modificar ni eliminar claves o valores de etiqueta del sistema.
Los usuarios pueden controlar quién puede asignar o desasignar etiquetas del sistema mediante la configuración de permisos de directiva de etiquetas.
Se muestra un icono de llave a la etiqueta .

Las etiquetas del sistema están diseñadas para admitir el etiquetado estandarizado entre organizaciones, especialmente para casos de uso como la clasificación de datos, la propiedad o el seguimiento del ciclo de vida. Mediante el uso de definiciones de etiquetas reguladas predefinidas, las etiquetas del sistema ayudan a aplicar la coherencia sin necesidad de que los usuarios definan o administren manualmente las estructuras de etiquetas.

Requisitos

Para agregar etiquetas a objetos protegibles de Unity Catalog, debe poseer el objeto o tener todos los privilegios siguientes:

APPLY TAG en el objeto
USE SCHEMA en el esquema primario del objeto
USE CATALOG en el catálogo primario del objeto

Para agregar una etiqueta regulada a objetos securizables de Unity Catalog, también debe tener el permiso ASSIGN en la política de etiquetas. Consulte Administración de permisos de directiva de etiquetas.

Restricciones

A continuación se muestra una lista de restricciones de etiqueta:

Las claves de etiqueta distinguen mayúsculas de minúsculas. Por ejemplo, Sales y sales son dos etiquetas distintas.
Puede asignar un máximo de 50 etiquetas a un único objeto protegible.
La longitud máxima de una clave de etiqueta es de 255 caracteres.
La longitud máxima del valor de una etiqueta es de 1000 caracteres.
No se permiten los siguientes caracteres en las claves de etiqueta:

. , - = / :
No se permiten espacios finales ni iniciales en las claves ni en los valores de las etiquetas.
La búsqueda de etiquetas con la interfaz de usuario de búsqueda del área de trabajo solo se admite para tablas, vistas y columnas de tabla.
La búsqueda de etiquetas requiere coincidencia exacta de términos.

Agregar y actualizar etiquetas mediante el Explorador de catálogos

Para agregar y actualizar etiquetas de objeto protegibles mediante el Explorador de catálogos:

Haga clic en Catálogo en la barra lateral.
Seleccione un objeto protegible.
En el objeto de la página Información general, agregue o actualice una etiqueta:
- Las etiquetas que se rigen por una política de etiquetas se encuentran en el encabezado de la sección Regidas y tienen un icono de bloqueo
- Si no hay etiquetas, haga clic en el botón Agregar etiquetas.
- Si hay etiquetas, haga clic en el icono Agregar o editar etiquetas.
Puede usar cuadro de diálogo Agregar o editar etiquetas para agregar y eliminar varias etiquetas.

Se requieren claves de etiqueta. Los valores de etiqueta son opcionales.

Para agregar o editar etiquetas de columna de tabla, haga clic en el icono Agregar etiqueta.

Agregar y actualizar etiquetas mediante comandos SQL

Nota:

Esta característica está disponible en las versiones 13.3 y posteriores de Databricks Runtime.

Puede usar el comando SQL ALTER <object> para etiquetar catálogos, esquemas, tablas (incluyendo vistas, vistas materializadas, tablas de streaming), volúmenes y columnas de tabla. Por ejemplo, puede usar las cláusulas SET TAGS y UNSET TAGS con ALTER TABLE para administrar etiquetas en una tabla. Consulte Instrucciones DDL para obtener una lista de los comandos disponibles del lenguaje de definición de datos (DDL) y su sintaxis.

Para los modelos registrados, debe usar el Explorador de catálogos o el ClientAPI de MLflow. Consulta Uso de etiquetas en modelos.

Uso de etiquetas para buscar tablas

Puede usar la barra de búsqueda del área de trabajo de Azure Databricks para buscar tablas, vistas y columnas de tabla mediante claves de etiqueta y valores de etiqueta. Puede usar etiquetas de tabla y etiquetas de columna de tabla. No puede usar etiquetas para buscar otros objetos etiquetados, como catálogos, esquemas o volúmenes.

Solo las tablas y las vistas que tiene permiso para ver aparecen en los resultados de búsqueda. Esto significa que debe tener al menos el BROWSE privilegio en el objeto (o en el catálogo y esquema padre del objeto) para incluir el objeto en los resultados de búsqueda.

Para obtener más información, vea Uso de etiquetas para buscar tablas.

Recuperación de información de etiquetas de tablas de esquema de información

Cada catálogo creado en Unity Catalog incluye un INFORMATION_SCHEMA. Este esquema incluye tablas que describen los objetos conocidos en el catálogo del esquema. Debe tener los privilegios adecuados para ver la información del esquema.

Puede consultar lo siguiente para recuperar información de etiquetas:

Para más información, consulte Información del esquema.