Todos los productos
Search
Centro de documentos

DataWorks:Recopilación de metadatos

Última actualización: Sep 04, 2026

DataWorks Data Map ofrece la función Metadata Collection, que permite consolidar y gestionar de forma centralizada los metadatos de diversos orígenes de datos de DataWorks. En Data Map, puede consultar los metadatos agregados de todos sus orígenes. Este tema describe cómo crear un crawler que recopila y consolida metadatos de varios orígenes de datos en DataWorks.

Descripción general

La recopilación de metadatos es una función fundamental para construir un Data Map de nivel empresarial y lograr una gestión unificada de activos de datos. Un crawler extrae automáticamente metadatos técnicos (como bases de datos, tablas y columnas), linaje de datos e información de particiones de orígenes de datos de DataWorks (como MaxCompute, Hologres, MySQL y CDH Hive) distribuidos en diferentes espacios de trabajo dentro de la misma región. Posteriormente, consolida esta información en DataWorks Data Map para crear una vista unificada de los datos.

La recopilación de metadatos le permite:

  • Construir una vista unificada de datos: Elimine los silos de datos mediante la gestión centralizada de metadatos provenientes de múltiples orígenes heterogéneos.

  • Habilitar el descubrimiento y la búsqueda de datos: Permita que los consumidores de datos encuentren rápida y precisamente la información que necesitan.

  • Lograr un análisis de linaje de datos de extremo a extremo: Rastree claramente el origen y el flujo de los datos para facilitar el análisis de impacto y la resolución de problemas.

  • Fortalecer la gobernanza de datos: Implemente clasificación de datos, control de acceso, monitoreo de calidad y gestión del ciclo de vida basándose en metadatos exhaustivos.

Facturación

De forma predeterminada, cada tarea de recopilación consume 0.25 CU multiplicado por el tiempo de ejecución de la tarea, lo que genera compute unit fees. Cada recopilación exitosa genera una instancia de programación, lo que implica scheduling fees.

Limitaciones

  • Si un origen de datos utiliza una lista de permitidos para el control de acceso, debe configurarla previamente. Para obtener más información, consulte Metadata collection allowlist.

  • El despliegue de DataWorks y el origen de datos deben estar en la misma región. Si necesita recopilar metadatos entre regiones, utilice un endpoint público al crear el origen de datos. Para obtener más información, consulte Create a data source.

  • La recopilación de metadatos no es compatible con orígenes de datos de AnalyticDB for MySQL que tienen SSL habilitado.

  • La nueva versión de la recopilación de metadatos solo admite los nuevos resource groups Serverless. Los resource groups heredados no son compatibles. Asegúrese de haber creado y vinculado un nuevo resource group Serverless antes de utilizar la función de recopilación de metadatos.

Punto de entrada

  1. Inicie sesión en la consola de DataWorks. En la región objetivo, haga clic en Data Governance > Data Map en el panel de navegación izquierdo. En la página que aparece, haga clic en Go to Data Map.

  2. En el panel de navegación izquierdo, haga clic en image para ir a la página de recopilación de metadatos.

Crawlers integrados

Los crawlers integrados están preconfigurados y se ejecutan automáticamente (casi en tiempo real) mediante la plataforma DataWorks. Se utilizan para recopilar metadatos principales que están profundamente integrados con DataWorks. No es necesario crearlos; solo debe gestionar el alcance de la recopilación.

Importante

Si no encuentra la tabla objetivo en Data Map, vaya a My Data > My Tools > Refresh Table Metadata y sincronice manualmente las tablas correspondientes.

Crawler predeterminado de MaxCompute

Este crawler recopila metadatos de los proyectos de MaxCompute asociados a su cuenta. Puede ir a la página de detalles, hacer clic en Modify Data Scope para seleccionar los proyectos que desea recopilar y hacer clic en Permission Configurations para configurar la visibilidad de los metadatos dentro del tenant.

  1. En la sección Built-in de la página de recopilación de metadatos, localice la tarjeta MaxCompute Default Crawler y haga clic en Details.

  2. La página de detalles del MaxCompute Default Crawler contiene dos pestañas: Basic Information y Data Scope.

    • Basic Information: Muestra las propiedades básicas del crawler, como el tipo y el método de recopilación. Esta información es de solo lectura.

    • Data Scope: Gestiona desde qué proyectos de MaxCompute este crawler recopila metadatos.

  3. Modificar el alcance de la recopilación:

    1. Cambie a la pestaña Data Scope y haga clic en el botón Modify Data Scope.

    2. En el cuadro de diálogo que aparece, seleccione o desmarque los proyectos de MaxCompute de los que desea recopilar metadatos.

      Importante

      De forma predeterminada, el alcance incluye todos los proyectos de MaxCompute asociados con espacios de trabajo en la región actual bajo su tenant. Después de modificar el alcance de los datos, los objetos de metadatos recopilados en Data Map coinciden con el alcance actual. Los metadatos de los proyectos desmarcados no serán visibles.

    3. Haga clic en OK para guardar los cambios.

  4. Configurar la visibilidad de los metadatos:

    • En la lista Data Scope, busque el proyecto objetivo y haga clic en Permission Configurations en la columna Actions.

    • Seleccione una política de visibilidad según sus requisitos de gobernanza de datos:

      • Public Within Tenant: Todos los miembros del tenant pueden buscar y consultar los metadatos de este proyecto.

      • Only members in the associated workspace can search and view.: Solo los miembros de espacios de trabajo específicos pueden acceder a los metadatos de este proyecto, lo que garantiza el aislamiento de los datos.

Crawler predeterminado de DLF

Importante

Para habilitar la recopilación en tiempo real de metadatos de DLF, debe otorgar el permiso Data Reader al rol vinculado al servicio AliyunServiceRoleForDataworksOnEmr en la consola de DLF.

El DLF Default Crawler recopila metadatos de Data Lake Formation (DLF) bajo su cuenta.

  1. En la sección Built-in de la página de recopilación de metadatos, localice la tarjeta DLF Default Crawler y haga clic en Details para ver la información básica.

  2. Cambie a la pestaña Data Scope para ver la lista de catálogos de DLF incluidos en el alcance de la recopilación y la cantidad de tablas que contienen.

    De forma predeterminada, se recopilan todos los catálogos accesibles (incluidos DLF y DLF-Legacy).

Crawlers personalizados

Los crawlers personalizados le permiten gestionar metadatos de forma centralizada en distintos entornos y motores.

  • Para orígenes de datos convencionales

    Puede crear crawlers personalizados para orígenes de datos estructurados o semiestructurados tradicionales, como Hologres, StarRocks, MySQL, Oracle y CDH Hive. Al configurar tareas de recopilación, el sistema realiza un análisis profundo de las estructuras físicas de bases de datos y tablas en el origen para lograr la extracción y sincronización automatizada de metadatos, tales como atributos de columnas, índices y particiones.

  • Para orígenes de datos de tipo metadato (catálogo)

    Para metadatos nativos en formato lake autodeclarados y no gestionados por DLF, como Paimon Catalog, Apache Gravitino y otros orígenes de datos de tipo metadato, también puede crear crawlers para su recopilación directa.

Create Custom Crawler

  1. En la sección de lista de crawlers personalizados de la página de recopilación de metadatos, haga clic en Create Metadata Crawler.

  2. Seleccione un tipo de recopilación: En la página de selección de tipos, seleccione el tipo de origen de datos objetivo que desea recopilar, como Hologres o StarRocks.

  3. Configure los ajustes básicos y el resource group:

    • Basic Configurations:

      • Seleccione un espacio de trabajo: Seleccione el espacio de trabajo que contiene el origen de datos.

      • Select Data Source: Seleccione un origen de datos objetivo creado previamente en la lista desplegable. Una vez realizada la selección, el sistema muestra automáticamente los detalles del origen de datos.

      • Name: Asigne un nombre al crawler para identificarlo fácilmente más adelante. De forma predeterminada, el nombre coincide con el del origen de datos.

    • Resource Group Configuration:

      • Resource Group: Seleccione un resource group Serverless para ejecutar la tarea de recopilación.

      • Test Network Connectivity: Este paso es crítico. Haga clic en Test Network Connectivity para asegurarse de que el resource group pueda acceder al origen de datos.

        Importante
        • Compruebe si el origen de datos tiene habilitadas restricciones de lista de permitidos. Si necesita recopilar metadatos de un origen de datos con control de acceso basado en lista de permitidos, consulte Add resource group IP addresses to the allowlist y Configure an allowlist for a data source para configurar los permisos correspondientes.

        • Si el origen de datos no tiene habilitadas restricciones de lista de permitidos, consulte Configure network connectivity for a data source para establecer la conectividad de red del origen de datos.

        • Si la prueba de conectividad devuelve el error Backend service call failed: test connectivity failed.not support data type, póngase en contacto con el soporte técnico para actualizar el resource group.

  4. Configure la recopilación de metadatos:

    • Collection Scope: Defina las bases de datos (database/schema) que desea recopilar. Si el origen de datos está a nivel de base de datos, la base de datos correspondiente al origen de datos se selecciona de forma predeterminada. Puede seleccionar bases de datos adicionales además de la del origen de datos.

      Importante
      • Cada base de datos solo puede configurarse en un único crawler. Si una base de datos aparece atenuada, significa que ya está siendo recopilada por otro crawler.

      • Después de reducir el alcance de la recopilación, los metadatos fuera de dicho alcance dejarán de ser buscables en Data Map.

  5. Configure la mejora inteligente y el plan de recopilación:

    • Mejora inteligente (Beta):

      • Descripciones generadas por IA: Cuando esta opción está habilitada, el sistema utiliza capacidades de modelos de lenguaje grandes para generar automáticamente descripciones comerciales para sus tablas y columnas después de recopilar los metadatos, lo que mejora significativamente la legibilidad y usabilidad de los metadatos. Una vez completada la recopilación, puede consultar la información generada por IA (como descripciones de tablas y columnas) en la página de detalles de un objeto de tabla en Data Map.

    • Collection Plan:

      • Trigger Mode: Seleccione manual o periódico.

        • Manual: El crawler se ejecuta solo cuando usted lo activa manualmente. Esta opción es adecuada para recopilaciones únicas o bajo demanda.

        • Periódico: Configure una tarea programada (por ejemplo, mensual, diaria, semanal u horaria) y el sistema actualizará automáticamente los metadatos de forma periódica.

          Para configurar una tarea programada a nivel de minutos, seleccione el ciclo de recopilación por hora y marque todas las granularidades a nivel de minuto para implementar una tarea programada que se ejecute cada 5 minutos.
          Importante

          Solo los orígenes de datos en el entorno de producción admiten la recopilación periódica.

  6. Guarde la configuración: Haga clic en Save o Save and Run para completar la creación del crawler.

Gestión de crawlers personalizados

Una vez creado un crawler, este aparece en la lista de crawlers personalizados. Puede realizar las siguientes operaciones de gestión:

  • Operaciones en la lista: En la lista, puede directamente Run, Stop o Delete un crawler. Utilice las funciones Filter y Search en la parte superior para localizar rápidamente el crawler objetivo.

    Importante

    Después de eliminar un crawler de metadatos, los objetos de metadatos recopilados por este crawler en Data Map quedan invalidados. Ya no podrá buscar ni consultar objetos ni sus detalles provenientes de este crawler. Proceda con precaución.

  • Operaciones por lotes: Seleccione varios crawlers en la lista de crawlers y utilice Batch Run o Batch Stop en la parte inferior de la lista para activar o finalizar varias tareas de recopilación a la vez, mejorando así la eficiencia de la gestión.

  • Estado del crawler: La lista de crawlers muestra el estado actual de cada crawler. Los estados comunes incluyen Not Run, Waiting, Running, Successful, Failed y Manually Terminated.

    Nota

    Si el origen de datos asociado a un crawler se ha desvinculado o ha dejado de ser válido, el crawler entra en estado frozen. Un crawler congelado no se puede ejecutar y solo se puede eliminar.

  • Consulte detalles y registros: Haga clic en el nombre del crawler objetivo para ir a su página de detalles.

    • Basic Information: Consulte todos los elementos de configuración del crawler.

    • Data Scope: Consulte o Modify Data Scope.

      Si no se ha realizado ninguna recopilación, el recuento de tablas y la hora de la última actualización estarán vacíos.
      Los siguientes orígenes de datos no admiten la modificación del alcance: EMR Hive, CDH Hive, Lindorm, ElasticSearch, OTS, MongoDB y AnalyticDB for Spark en AnalyticDB MySQL.
    • Run Logs: Rastree el historial de ejecución de cada tarea de recopilación. Puede consultar la hora de inicio, la duración, el estado y el volumen de datos recopilados para cada tarea. Cuando una tarea falla, hacer clic en View Logs es el punto de entrada clave para localizar y resolver problemas.

  • Active manualmente la recopilación: En la esquina superior derecha de la página de detalles, haga clic en el botón Collect Metadata para activar inmediatamente una tarea de recopilación. Esto resulta útil cuando desea ver una tabla recién creada en Data Map de inmediato.

Siguientes pasos

Una vez recopilados correctamente los metadatos, puede aprovechar al máximo las diversas capacidades de Data Map:

  • Busque sus tablas recopiladas en Data Map y consulte sus detalles, información de columnas, particiones y vista previa de datos. Para obtener más información, consulte View table details.

  • Analice el linaje ascendente y descendente de una tabla para comprender el flujo de procesamiento de datos de extremo a extremo. Para obtener más información, consulte Data lineage.

  • Agregue activos a una colección de datos para organizar y gestionar sus datos desde una perspectiva comercial. Para obtener más información, consulte Create a Data Collection.

Preguntas frecuentes

Apéndice: Alcance y puntualidad de la recopilación

Origen de datos

Data Source Type

Collection Mode

Granularidad de la recopilación

Puntualidad de actualización de metadatos

Tabla/Columna

Partition

Linaje

MaxCompute

El sistema los recopila automáticamente de forma predeterminada

Instancia

Proyectos regulares: En tiempo real

Proyectos externos: T+1

Regiones de China continental: En tiempo real

Regiones internacionales: T+1

En tiempo real

Data Lake Formation (DLF)

Instancia

En tiempo real

Importante

Para habilitar la recopilación en tiempo real, debe otorgar el permiso Data Reader al rol vinculado al servicio AliyunServiceRoleForDataworksOnEmr en la consola de DLF. Para obtener más información, consulte la sección DLF default crawler anterior.

En tiempo real

El linaje es compatible con los metadatos de DLF de los motores Serverless Spark, Serverless StarRocks, Serverless Flink y EMR Impala. Otros motores no son compatibles.

Importante

Para los clústeres de EMR, debe habilitar EMR_HOOK.

Para mostrar el linaje de las tareas de EMR Impala, debe habilitar el registro de linaje en la configuración de Impala del clúster de EMR. Esta función solo es compatible con clústeres EMR DataLake y actualmente se encuentra en fase de lanzamiento gradual. Póngase en contacto con el soporte técnico de Alibaba Cloud para habilitar esta función antes de usarla. Para obtener detalles sobre la configuración, consulte Data lineage.

Hologres

Cree un crawler manualmente

Base de datos

Depende del ciclo de recopilación

Not supported

En tiempo real

EMR Hive

Instancia

Depende del ciclo de recopilación

Depende del ciclo de recopilación

En tiempo real

Importante

Debe habilitar EMR_HOOK para el clúster.

Para mostrar el linaje de las tareas de EMR Impala, debe habilitar el registro de linaje en la configuración de Impala del clúster de EMR. Esta función solo es compatible con clústeres EMR DataLake y actualmente se encuentra en fase de lanzamiento gradual. Póngase en contacto con el soporte técnico de Alibaba Cloud para habilitar esta función antes de usarla. Para obtener detalles sobre la configuración, consulte Data lineage.

CDH Hive

Instancia

Depende del ciclo de recopilación

En tiempo real

En tiempo real

StarRocks

Base de datos

  • Modo de instancia: En tiempo real.

  • Modo de cadena de conexión: Depende del ciclo de recopilación.

Not supported

En tiempo real

Importante

Solo el modo de instancia admite la recopilación de linaje. El modo de cadena de conexión no admite la recopilación de linaje.

AnalyticDB for MySQL

Base de datos

Depende del ciclo de recopilación

Not supported

En tiempo real

Nota

Debe submit a ticket para habilitar la función de linaje de datos en la instancia de AnalyticDB for MySQL.

AnalyticDB for Spark

Instancia

En tiempo real

Not supported

En tiempo real

AnalyticDB for PostgreSQL

Base de datos

Depende del ciclo de recopilación

Not supported

En tiempo real

Lindorm

Instancia

Depende del ciclo de recopilación

Not supported

En tiempo real

OTS

Instancia

Depende del ciclo de recopilación

Not supported

Not supported

MongoDB

Instancia

Depende del ciclo de recopilación

Not supported

Not supported

ElasticSearch

Instancia

Depende del ciclo de recopilación

Not supported

Actualización T+1

Paimon Catalog

Catálogo

Depende del ciclo de recopilación

Depende del ciclo de recopilación

Not supported

Apache Gravitino

Catálogo

Depende del ciclo de recopilación

Depende del ciclo de recopilación

Not supported

Otros tipos de orígenes de datos (MySQL, PostgreSQL, SQL Server, Oracle, ClickHouse, SelectDB, OceanBase, etc.)

Base de datos

Depende del ciclo de recopilación

Not supported

Not supported

Nota
  • La frase "Depende del ciclo de recopilación" en la tabla indica que los metadatos se actualizan periódicamente según el plan de recopilación que configuró para el crawler (por ejemplo, mensual, diario, semanal o por hora).

  • AnalyticDB for Spark y AnalyticDB for MySQL comparten el mismo punto de entrada para la recopilación de metadatos.

Código de tarea

Data Map permite buscar código de tareas y navegar rápidamente. A continuación se describe el alcance del código que se puede buscar.

Fuente del código

Alcance de la recopilación

Método de activación de la recopilación

Data Studio

Data Studio - Cree un nodo y edite el código

Recopilación automática

Legacy Data Studio

Legacy Data Studio - Cree un nodo y edite el código

Data Analysis

Data Analysis - Cree una consulta SQL y edite el código

Data Service

Data Service - Cree un servicio API Data Push

Activos de API

Data Map permite ver los metadatos de las API de Data Service, como se describe a continuación:

API Type

Alcance de la recopilación

Método de activación de la recopilación

Generación de API (modo asistente)

Data Service - Cree una API en modo asistente

Recopilación automática

Generación de API (modo script)

Data Service - Cree una API en modo script

Registrar API

Data Service - Registre una API

Orquestación de API

Data Service - Cree una orquestación de API

Activos de IA

Data Map permite ver y gestionar activos de IA, y proporciona linaje de activos de IA para rastrear el origen, el uso y la evolución de los datos y modelos. A continuación se describe la compatibilidad con cada tipo de activo de IA.

Tipo de activo

Alcance de la recopilación

Método de activación de la recopilación

Conjunto de datos

  • PAI - Cree un conjunto de datos/Registre un conjunto de datos

  • DataWorks - Cree un conjunto de datos

Recopilación automática

Modelo de IA

PAI - Tarea de entrenamiento de modelo/Registre un modelo/Despliegue un servicio de modelo

Tarea de algoritmo

PAI - Tarea de entrenamiento/Tarea de flujo de trabajo/Tarea de entrenamiento distribuido

Servicio de modelo

PAI - Despliegue un servicio de modelo (despliegue de EAS)

Workspace

Data Map permite ver los metadatos del espacio de trabajo, como se describe a continuación:

Proyecto

Collection Mode

Método de activación de la recopilación

Espacio de trabajo

DataWorks - Cree un espacio de trabajo

Recopilación automática