Todos los productos
Search
Centro de documentos

DataWorks:Atributos personalizados

Última actualización: Sep 04, 2026

Los atributos personalizados en DataWorks Data Map permiten extender los metadatos de negocio para espacios de trabajo, conjuntos de datos y tablas. Mediante la herencia de atributos, los objetos secundarios reciben automáticamente los valores del objeto principal, lo que reduce la configuración repetitiva.

Descripción general

En la gobernanza de datos empresariales a gran escala, los metadatos técnicos tradicionales (como esquemas de tablas, linaje de datos e información de particiones) suelen ser insuficientes para describir por completo el contexto de negocio de un activo. Los atributos personalizados permiten extender los metadatos de negocio para espacios de trabajo, conjuntos de datos y tablas; además, el mecanismo de herencia facilita el mantenimiento masivo en las jerarquías de objetos.

Importante

Actualmente es posible configurar atributos personalizados para espacios de trabajo, conjuntos de datos y tablas. Objetos como código y API aún no admiten atributos personalizados. Si requiere esta funcionalidad, envíe un ticket para ponerse en contacto con el soporte técnico.

Los atributos personalizados ayudan a resolver los siguientes problemas:

  • Falta de contexto de negocio: Los metadatos técnicos no pueden responder preguntas clave del negocio, como "¿Quién es el propietario del negocio?" o "¿Cómo se define esta métrica?".

  • Configuración ineficiente: Cuando miles de tablas o conjuntos de datos deben cumplir los mismos estándares de gobernanza (por ejemplo, un enlace de aprobación unificado), configurar cada elemento manualmente resulta costoso y difícil de mantener.

Las capacidades principales de los atributos personalizados incluyen:

  • Declaración de atributos personalizados: Los administradores pueden definir el nombre, el identificador y el tipo de un atributo (como texto o valor de enumeración), y vincularlo a tipos de entidad específicos.

  • Configuración de valores de atributos: Los usuarios pueden consultar y editar los valores de los atributos personalizados en las entidades a las que están vinculados.

  • Herencia de atributos: Los objetos secundarios heredan automáticamente los valores de los atributos a través de las jerarquías de objetos, lo que reduce la configuración repetitiva.

Casos de uso:

  • Etiquetar un conjunto de datos con información de negocio, como su dominio de negocio y el propietario de los datos, para facilitar la búsqueda y gestión en Data Map.

  • Configurar un enlace de aprobación de datos unificado para un espacio de trabajo. Todos los conjuntos de datos dentro de ese espacio heredan automáticamente este enlace, lo que elimina la necesidad de configuraciones individuales.

Limitaciones

  • El nombre de un atributo personalizado debe ser único dentro de un inquilino.

  • El identificador de un atributo personalizado debe ser único dentro de un inquilino y no se puede modificar después de su creación.

  • El tipo de un atributo personalizado no se puede modificar después de su creación.

Permisos

La siguiente tabla describe los permisos necesarios para las operaciones de atributos personalizados. Una cuenta de Alibaba Cloud tiene todos los permisos de forma predeterminada. Esta tabla aplica únicamente a usuarios RAM y roles RAM.

Acciones

Descripción

Crear y gestionar atributos personalizados

Requiere uno de los siguientes roles o permisos:

  • Tenant Owner

  • Tenant Administrator

  • Tenant Data Governance Administrator

  • Un usuario RAM con el permiso DataWorksFullAccess

Configurar atributos personalizados para un espacio de trabajo

Requiere uno de los siguientes roles:

Nivel de inquilino: Tenant Owner, Tenant Administrator o Tenant Data Governance Administrator

Nivel de espacio de trabajo: Workspace Owner o Workspace Administrator

Configurar atributos personalizados para un conjunto de datos

Requiere uno de los siguientes roles:

Nivel de inquilino: Tenant Owner, Tenant Administrator o Tenant Data Governance Administrator

Nivel de espacio de trabajo: Workspace Owner, Workspace Administrator o Workspace Developer

Configurar atributos personalizados para una tabla

Para tablas de MaxCompute: Debe ser el propietario de la tabla o un Project Administrator.

Para otras tablas (incluidos tipos de tabla extendidos): Requiere uno de los siguientes roles o permisos:

  • Tenant Owner

  • Tenant Administrator

  • Tenant Data Governance Administrator

  • Un usuario RAM con el permiso DataWorksFullAccess

Consultar atributos personalizados, detalles del espacio de trabajo, detalles del conjunto de datos y detalles de la tabla

Ninguna.

Crear un atributo personalizado

Para crear un atributo personalizado, realice los siguientes pasos.

  1. Inicie sesión en DataWorks console. En el panel de navegación izquierdo, haga clic en Data Map.

  2. En el panel de navegación izquierdo, pase el cursor sobre el icono de Configuration Management y seleccione Custom Property Configuration.

  3. En la página de gestión de atributos personalizados, haga clic en Add.

  4. En el cuadro de diálogo Create Custom Property, configure los siguientes parámetros:

    Categoría

    Parámetro

    Descripción

    Attribute Configuration

    ID

    Identificador único (clave) del atributo, utilizado para llamadas a la API. El identificador solo puede contener letras, dígitos y guiones bajos (_) y no se puede modificar después de la creación.

    Name

    Nombre para mostrar del atributo personalizado. Debe ser único dentro del inquilino y puede tener hasta 128 caracteres de longitud.

    Type

    Tipo de dato del valor del atributo, el cual no se puede modificar después de la creación. Tipos compatibles:

    • Enum Value: El valor se selecciona de una lista predefinida de opciones.

    • Text: El valor es una cadena de texto libre.

    • Link: El valor es un enlace que incluye un Link Title y una URL.

    Enum Value

    Si establece el tipo de atributo en Enum Value, debe definir las opciones disponibles.

    Description

    Descripción del atributo personalizado.

    Effective Scope

    Applicable Entity Type

    Tipos de entidad a los que aplica este atributo personalizado. Los tipos compatibles incluyen tablas (como MySQL, MaxCompute, EMR Hive, Hologres, Data Lake Formation, AnalyticDB for PostgreSQL y Tablestore), espacios de trabajo y conjuntos de datos.

    Inherit

    Disponible únicamente para el tipo workspace.

    Cuando se habilita, los conjuntos de datos dentro del espacio de trabajo heredan automáticamente el valor de este atributo.

    Por ejemplo, si establece el atributo "Environment Type" en "Production" para un espacio de trabajo, sus conjuntos de datos asociados reciben automáticamente el mismo valor de atributo. Cuando se actualiza el valor del atributo principal, el valor heredado también se actualiza.

    Allow Overwrite

    Permite que los objetos secundarios sobrescriban el valor heredado. Una vez sobrescrito, el atributo se convierte en un valor local y deja de actualizarse cuando cambia el valor principal.

    Enable as a Filter

    Permite usar este atributo como filtro de búsqueda. Disponible únicamente para el tipo Enum Value.

    Show on Details Page

    Indica si se debe mostrar este atributo personalizado en la página de detalles de un objeto de datos.

  5. Haga clic en Confirm. El atributo personalizado aparecerá entonces en la lista de gestión, donde podrá editarlo o eliminarlo.

Nota
  • Editar un atributo: Puede modificar el nombre, la descripción, los valores de enumeración, los objetos vinculados y las reglas de herencia de un atributo. El identificador y el tipo del atributo no se pueden modificar.

  • Eliminar un atributo: Al eliminar un atributo personalizado vinculado a un objeto de datos, también se borra el valor correspondiente del atributo en dicho objeto. Esta acción no se puede deshacer.

Configurar y consultar valores de atributos personalizados

Después de crear atributos personalizados, configure los valores de los atributos para espacios de trabajo, conjuntos de datos y tablas.

Configurar atributos personalizados para un espacio de trabajo

  1. En la página de Data Map, haga clic en el icono image del panel de navegación izquierdo para ir a la página de Data Catalog.

  2. Expanda Dataset. La lista de espacios de trabajo aparecerá a la derecha.

  3. Busque el espacio de trabajo deseado y edite sus valores de atributos personalizados.

  4. Una vez completada la configuración, también puede consultar los valores de los atributos personalizados en la página workspace details.

Configurar atributos personalizados para un conjunto de datos

  1. En la página de Data Map, haga clic en el icono image del panel de navegación izquierdo para ir a la página de Data Catalog.

  2. Siga estos pasos para configurar atributos personalizados para un conjunto de datos:

    1. Para un nuevo conjunto de datos:

      Puede configurar los valores de los atributos personalizados durante el proceso de creación del conjunto de datos.

    2. Para un conjunto de datos existente:

      1. En la página Data Catalog, expanda Dataset, seleccione el espacio de trabajo deseado y luego haga clic en el conjunto de datos correspondiente dentro de ese espacio.

      2. En la página de detalles del conjunto de datos, edite sus valores de atributos personalizados.

  3. En la página de detalles del conjunto de datos, puede consultar los valores configurados de los atributos personalizados.

Configurar atributos personalizados para una tabla

  1. En la página de Data Map, haga clic en el icono image para ir a la página de Data Catalog.

  2. Haga clic en el tipo de tabla que desea configurar, como MaxCompute. En la página de detalles de la tabla, puede consultar y editar los valores de los atributos personalizados correspondientes.

Filtrar por atributo personalizado

Para los atributos personalizados de tipo Enum Value con la opción Enable as a Filter habilitada, puede utilizar el atributo para filtrar rápidamente espacios de trabajo o conjuntos de datos durante la búsqueda.

Filtrar espacios de trabajo

Puede filtrar espacios de trabajo por atributo personalizado de una de las siguientes dos maneras:

Método 1: En el panel de navegación izquierdo, haga clic en el icono de búsqueda image para ir a la página de búsqueda avanzada. Seleccione Workspace como tipo y establezca las condiciones de filtro para los atributos personalizados. Para más información, consulte Multi-dimensional filtering and browsing.

Método 2: En el panel de navegación izquierdo, haga clic en el icono image para ir a la página de Data Catalog. Expanda Dataset, seleccione el espacio de trabajo deseado y filtre por los valores de enumeración del atributo personalizado.

Filtrar conjuntos de datos

Puede filtrar conjuntos de datos por atributo personalizado de una de las siguientes dos maneras:

Método 1: En el panel de navegación izquierdo, haga clic en el icono de búsqueda image para ir a la página de búsqueda avanzada. Seleccione Dataset como tipo y establezca las condiciones de filtro para el atributo personalizado. Para más información, consulte Multi-dimensional filtering and browsing.

Método 2: En el panel de navegación izquierdo, haga clic en el icono image para ir a la página de Data Catalog. Expanda Dataset para ver la lista de espacios de trabajo, haga clic en Dataset y filtre los resultados según los valores de enumeración de un atributo personalizado.

Herencia de atributos

Los atributos personalizados admiten herencia a través de jerarquías de objetos. Los objetos secundarios reciben automáticamente los valores de atributos de su objeto principal.

  • Cadena de herencia: La herencia de atributos personalizados sigue esta jerarquía: Workspace > Dataset.

    Por ejemplo, cuando configura un valor de atributo personalizado a nivel de espacio de trabajo, todos los conjuntos de datos dentro de ese espacio heredan automáticamente dicho valor.

  • Política de herencia: Al crear un atributo personalizado, puede seleccionar la opción Allow Overwrite.

    • Allow Overwrite: Los objetos secundarios (conjuntos de datos) heredan el valor del atributo del objeto principal (espacio de trabajo) de forma predeterminada, pero usted puede sobrescribir el valor en el objeto secundario. Por ejemplo, un espacio de trabajo puede configurarse con un enlace de aprobación estándar que hereda la mayoría de sus conjuntos de datos. Para un conjunto de datos específico que contiene información sensible, puede sobrescribir este enlace con uno que requiera un proceso de aprobación más estricto.

    • Disallow Overwrite: Los objetos secundarios deben heredar el valor del atributo del objeto principal y no pueden modificarlo.

  • Cambio de valor principal: Cuando cambia el valor de un atributo del objeto principal, el nuevo valor se propaga a todos los objetos secundarios que lo heredan. Los objetos secundarios con valores sobrescritos no se ven afectados.

  • Indicador de herencia: En la página de detalles del conjunto de datos, aparece un icono indicador junto a los atributos personalizados heredados de un espacio de trabajo. Puede pasar el cursor sobre el icono para ver el origen de la herencia y la política de sobrescritura.

Documentación relacionada