Aplicar etiquetas a objetos protegibles del Unity Catalog

En este artículo se muestra cómo aplicar etiquetas a objetos protegibles de Unity Catalog.

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.

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

Restricciones

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

• 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 o valores de etiqueta:

  . , - = / :

• 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:

1. Haga clic en Catálogo en la barra lateral.

2. Seleccione un objeto protegible.

3. En el objeto de la página Información general, agregue o actualice una etiqueta:

   • 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 privilegio BROWSE en el objeto (o en el catálogo y esquema primarios del objeto) para devolver 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 para 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:

• INFORMATION_SCHEMA.CATALOG_TAGS
• INFORMATION_SCHEMA.COLUMN_TAGS
• INFORMATION_SCHEMA.SCHEMA_TAGS
• INFORMATION_SCHEMA.TABLE_TAGS
• INFORMATION_SCHEMA.VOLUME_TAGS

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