Todos los productos
Search
Centro de documentos

DataWorks:Configuración del catálogo de datos de MaxCompute

Última actualización: Sep 04, 2026

El catálogo de datos ofrece una interfaz unificada para gestionar los metadatos de MaxCompute, incluidas tablas, vistas, tablas externas, recursos y funciones.

Límites

Para consultar datos de MaxCompute en el catálogo de datos con un usuario RAM o un rol RAM, primero debe obtener los permisos de MaxCompute correspondientes. Si el modelo de capa 3 está habilitado para la fuente de datos o el proyecto, también debe otorgar al usuario o rol RAM permiso para ver los metadatos del esquema.

Nota

Si un proyecto de MaxCompute contiene varios esquemas, otorgue permisos de metadatos para todos los esquemas a fin de visualizar la lista completa en la página de detalles del proyecto.

  • Otorgar permisos a un usuario RAM:

    GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER RAM$<Alibaba_Cloud_Account_Name>:<RAM_User_Name>;
  • Otorgar permisos a un rol RAM:

    GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER `RAM$<Alibaba_Cloud_Account_Name>:role/<RAM_Role_Name>`;
  • Después de habilitar la función de esquema para un proyecto de MaxCompute, puede manage schemas y manage object tables.

Acceso al catálogo de datos de MaxCompute

  1. Vaya a la página de Workspaces en la consola de DataWorks. En la barra de navegación superior, seleccione la región deseada. Localice el espacio de trabajo correspondiente y elija Shortcuts > Data Studio en la columna Actions.

  2. En el panel de navegación izquierdo, haga clic en el icono image. En el árbol DATA CATALOG, haga clic en MaxCompute.

Creación de un catálogo de datos de MaxCompute

Agregue proyectos existentes de MaxCompute al catálogo de datos.

  1. Haga clic en el icono image junto al catálogo de datos de MaxCompute.

  2. Agregue un proyecto de MaxCompute mediante uno de los siguientes métodos.

    Fuente destino

    Método

    Un MaxCompute data source created en el espacio de trabajo actual

    En la pestaña DataWorks Data Source, localice la fuente de datos deseada y haga clic en Add. Para agregar varias fuentes de datos simultáneamente, selecciónelas y haga clic en Batch Add.

    Un MaxCompute project creado en la consola de MaxCompute

    En la pestaña MaxCompute-Project, localice el proyecto deseado y haga clic en Add. Para agregar varios proyectos a la vez, selecciónelos y haga clic en Batch Add. También puede hacer clic en Create Project para agregar manualmente un nuevo proyecto de MaxCompute.

    Configuración de proyectos internos: MaxCompute project configuration parameters. Operaciones de proyectos externos: MaxCompute data lakehouse.
    Importante

    La sincronización de metadatos tarda entre 10 y 20 segundos. Después de crear un proyecto, espere un momento y luego actualice manualmente la lista para ver los datos más recientes.

Gestión de un catálogo de datos de MaxCompute

Agregue y gestione esquemas, tablas, vistas y otros objetos de datos en el catálogo de datos de MaxCompute.

Objeto de MaxCompute

Visualización

Creación

Schema

Supported

Supported

Table

Supported

Supported

Extenal Table

Supported

Supported

Object Table

Supported

Supported

View

Supported

Supported

Materialized View

Supported

Supported

Delta Live Materialized View

Supported

Supported

Resource

Supported

Not supported

Function

Supported

Not supported

Nota

El nivel de esquema se muestra únicamente después de habilitar la función de esquema para MaxCompute. Schema operations.

Gestión de esquemas

  1. Cree un esquema.

    Haga clic en el icono image a la derecha del proyecto de MaxCompute. En el cuadro de diálogo Create Schema, introduzca un nombre y presione Enter.

  2. Consulte un esquema.

    Después de agregar un esquema a un proyecto de MaxCompute, haga clic en el icono image a la izquierda del proyecto para visualizarlo.

  3. Elimine un esquema.

    Si ya no necesita un esquema, haga clic derecho sobre él y seleccione Delete.

    Importante
    • Esta operación no se puede deshacer. Proceda con precaución.

    • Elimine todos los objetos de datos dentro de un esquema (como tablas y vistas) antes de eliminar el esquema.

Gestión de tablas

Crear una tabla

  1. A la derecha del esquema, haga clic en image > Create Table para ir a la página Create Table.

  2. Puede crear una tabla de las siguientes maneras.

    • Crear una tabla con Copilot:

      1. En la barra de herramientas, haga clic en Use Copilot to Create Table para abrir la interfaz de chat de Copilot.

      2. Introduzca una instrucción para crear una tabla. Por ejemplo, Create a daily aggregate table for product sales.

      3. Haga clic en Generate and Replace. El sistema genera un nombre de tabla e información de campos basada en su instrucción.

      4. Si el nombre de la tabla y los campos cumplen con sus expectativas, haga clic en Accept.

        Nota

        Puede hacer clic en Accept y luego editar manualmente la información generada de la tabla.

    • Crear una tabla manualmente:

      Cree una tabla utilizando los siguientes parámetros.

      Parámetro

      Descripción

      Información básica

      Especifique un Table Name personalizado, Lifecycle y otra información.

      Información de campos

      Edite la información de campos y anotaciones.

      • Edición manual: Haga clic en Insert encima de la lista de campos. Especifique el número de filas y luego edite la información de campos y anotaciones.

      • Edición inteligente con Copilot: Haga clic en Generate Fields o Generate Field Descriptions encima de la lista de campos. El sistema genera campos y comentarios basados en el nombre y la descripción de la tabla.

      Configuración avanzada

      El Table Type se establece como Internal Table de forma predeterminada. Puede configurar las Cluster Properties.

  3. Una vez completada la configuración, haga clic en Publish en la barra de herramientas superior y complete el proceso de publicación para crear la tabla.

Gestionar una tabla

  1. Consulte una tabla.

    Después de crear una tabla, haga clic en el icono image a la izquierda del proyecto y haga clic en Table para ver la información básica. Haga clic en el nombre de una tabla para ver detalles como Fields y DDL.

  2. Realice operaciones sobre la tabla.

    1. Haga clic derecho en una tabla interna. Puede seleccionar Generate SQL Query Statement, Import Data, Request Permission s, Metadata Mapping to Hologres o Data Synchronization to Hologres.

    2. Haga doble clic en una tabla interna para abrir su página de detalles. Haga clic en Edit en la esquina superior derecha. En la página de edición, modifique el Lifecycle y la Table Description, o bien agregue, modifique o elimine campos.

      Importante
      • Antes de modificar el nombre de un campo, eliminar un campo o cambiar su tipo, ejecute el siguiente comando en un MaxCompute SQL node para habilitar la evolución de esquemas: setproject odps.schema.evolution.enable=true.

      • Para eliminar un campo, seleccione la fila correspondiente, haga clic derecho y seleccione Delete.

      • Después de actualizar la tabla, haga clic nuevamente en Publish para que los cambios surtan efecto.

  3. Elimine una tabla.

    Haga clic derecho en la tabla que desea eliminar y seleccione Delete.

    Importante

    Esta operación no se puede deshacer. Proceda con precaución.

Gestión de tablas externas****

Crear una tabla externa

  1. A la derecha del esquema, haga clic en image > Create External Table para ir a la página Create External Table.

  2. Cree una tabla externa mediante uno de los siguientes métodos.

    • Crear una tabla con Copilot:

      1. En la barra de herramientas, haga clic en Use Copilot to Create Table para abrir la interfaz de chat de Copilot.

      2. Introduzca una instrucción para crear una tabla. Por ejemplo, Create a daily aggregate table for product sales.

      3. Haga clic en Generate And Replace. El sistema genera un nombre de tabla e información de campos basada en su instrucción.

      4. Si el nombre de la tabla y los campos cumplen con sus expectativas, haga clic en Accept.

        Nota

        Puede hacer clic en Accept y luego editar manualmente la información generada de la tabla.

    • Crear una tabla manualmente:

      Cree una tabla externa utilizando los siguientes parámetros.

      Parámetro

      Descripción

      Información básica

      Especifique un Table Name personalizado, Lifecycle y otra información.

      Información de campos

      Edite la información de campos y anotaciones.

      • Edición manual: Haga clic en Insert encima de la lista de campos. Especifique el número de filas y luego edite la información de campos y anotaciones.

      • Edición inteligente con Copilot: Haga clic en Generate Fields o Generate Field Descriptions encima de la lista de campos. El sistema genera campos y comentarios basados en el nombre y la descripción de la tabla.

      Configuración avanzada

      El Table Type se establece como Externa Table de forma predeterminada. Configure la Storage Location y el Storage Format de OSS.

      • Storage Location: oss://<OSS_Bucket_Name>/

        Nota

        Puede obtener el nombre del bucket de OSS desde Bucket overview.

      • Storage Format: Se admiten varios formatos, como CSV, ORC y TEXTFILE.

  3. Haga clic en Publish en la barra de herramientas para crear la tabla.

Gestionar una tabla externa

  1. Consulte una tabla externa.

    Después de crear una tabla externa, haga clic en el icono image a la izquierda del proyecto y haga clic en Externa Table para ver su información básica. Haga clic en el nombre de una tabla para ver detalles como Fields y DDL.

  2. Operaciones en tablas externas.

    Haga doble clic en la tabla externa para abrir su página de detalles. Haga clic en Edit en la esquina superior derecha. En la página de edición, modifique el Lifecycle y la Table Description, o bien agregue, modifique o elimine campos.

    Importante
    • Antes de modificar el nombre de un campo, eliminar un campo o cambiar su tipo, ejecute el siguiente comando en un MaxCompute SQL node para habilitar la evolución de esquemas: setproject odps.schema.evolution.enable=true.

    • Para eliminar un campo, seleccione la fila correspondiente, haga clic derecho y seleccione Delete.

    • Después de actualizar la tabla, haga clic nuevamente en Publish para que los cambios surtan efecto.

  3. Elimine una tabla externa.

    Haga clic derecho en la tabla externa que desea eliminar y seleccione Delete.

Gestión de tablas de objetos

Gestione tablas de objetos únicamente en proyectos de MaxCompute con schema feature enabled.

Gestionar una tabla de objetos

  1. Consulte una tabla de objetos.

    Después de crear una OBJECT TABLE en un proyecto de MaxCompute, haga clic en el icono image a la izquierda del proyecto y haga clic en Object Table para ver la información básica. Haga clic en el nombre de una tabla para ver detalles como Fields y DDL.

  2. Realice operaciones en una tabla de objetos.

    Haga clic derecho en una tabla de objetos. Puede seleccionar Generate SQL Query Statement, Request Permissions, map MaxCompute metadata to a Hologres foreign table o sync MaxCompute data to a Hologres internal table.

  3. Elimine una tabla de objetos.

    Haga clic derecho en la tabla de objetos que desea eliminar y seleccione Delete.

    Importante

    Esta operación no se puede deshacer. Proceda con precaución.

Gestión de vistas

Crear una vista

  1. A la derecha del esquema, haga clic en image > Create View para abrir la página Create View.

  2. Modifique el comando como se describe en Create or update a view. Cambie view_name por el nombre de la vista que desea crear. Después de la palabra clave AS, agregue la sentencia de consulta para la fuente de datos de la vista.

  3. Haga clic en Publish en la parte superior de la página para crear la vista.

Gestionar una vista

  1. Consulte los detalles de una vista

    Después de crear una vista, haga clic en el icono image a la izquierda del proyecto y haga clic en View para mostrar la información básica. Haga clic en el nombre de una vista para ver detalles como Fields y DDL.

  2. Operaciones sobre vistas

    Haga doble clic en la vista para abrir su página de detalles. Haga clic en Edit en la esquina superior derecha. Modifique la vista cambiando la sentencia de consulta de la fuente de datos después de la palabra clave AS.

  3. Elimine una vista

    Haga clic derecho en la vista que desea eliminar y seleccione Delete.

Gestión de vistas materializadas

Crear una vista materializada

  1. A la derecha del esquema, haga clic en image > Create Materialized View para abrir la página Create Materialized View.

  2. Modifique el comando como se describe en Create a materialized view. Reemplace view_name con el nombre de la vista materializada que desea crear. Después de la sentencia AS, agregue la sentencia de consulta para la fuente de datos de la vista materializada.

  3. Haga clic en Publish en la parte superior de la página para crear la vista materializada.

Gestionar una vista materializada

  1. Consulte una vista materializada.

    Después de crear una vista materializada, haga clic en el icono image a la izquierda del proyecto y haga clic en Materialized View. Haga clic en el nombre de una vista materializada para ver detalles como Fields y DDL.

  2. Elimine una vista materializada.

    Haga clic derecho en la vista materializada que desea eliminar y seleccione Delete.

Gestión de vistas materializadas delta live

Crear una vista materializada dinámica

  1. A la derecha del esquema, haga clic en image > Create Delta Live Vaterialized View para abrir la página Create Delta Live Vaterialized View. Parámetros clave de configuración:

    Parámetro

    Descripción

    Data Generation SQL

    Introduzca el Data Generation SQL basado en el comando en Dynamic materialized view. Haga clic en Precompile para comprobar la sintaxis SQL.

    Importante

    Una tabla sin particiones debe tener una clave primaria.

    Field Details

    Detalles de campos analizados tras una precompilación exitosa.

    Primary Key Field Information

    Tras la precompilación, el sistema lee los campos de clave primaria elegibles y los muestra en la lista desplegable. Seleccione uno o más campos de clave primaria.

    Partition Field Information

    Tras la precompilación, el sistema lee los campos de partición elegibles y los muestra en la lista desplegable. Seleccione campos de partición para dividir la vista materializada dinámica. Se admiten varios campos de partición.

    Tuning Parameters

    Configure pares clave-valor de parámetros para generarlos en las TBLPROPERTIES del DDL.

    Data Refresh Policy

    • Configuración de actualización de vista materializada Delta Live sin particiones: Se crea una vista materializada dinámica sin particiones si no especifica un campo de partición.

      • Para vistas materializadas dinámicas en MaxCompute, el modo de actualización se establece como incremental de forma predeterminada. La propiedad de la tabla es TBLPROPERTIES("refresh_mode"="incremental").

      • Los métodos de programación de actualización compatibles son MaxCompute Auto Refresh y DataWorks Scheduled Refresh.

    • Configuración de actualización de vista materializada Delta Live con particiones: Se crea una vista materializada dinámica con particiones si especifica un campo de partición.

      • Actualización de particiones: Configure ajustes como el método de programación de actualización, si se deben actualizar automáticamente los datos, la época de programación y la duración de la actualización.

      • Actualizar datos históricos de particiones: Configure si se deben actualizar los datos en particiones que han completado su ciclo de actualización.

  2. Haga clic en Publish en la parte superior de la página para crear la vista materializada dinámica.

Gestionar una vista materializada dinámica

  1. Publique en un entorno de desarrollo o producción. En un espacio de trabajo de modo estándar, publique objetos en diferentes entornos.

  2. Consulte una vista materializada dinámica.

    Después de crear una vista materializada dinámica, haga clic en el icono image a la izquierda del proyecto y haga clic en Delta Live Materialized View para ver la información básica. Haga clic en el nombre de una vista para ver detalles como Fields y la sentencia DDL.

  3. Elimine una vista materializada dinámica.

    Haga clic derecho en la vista materializada dinámica que desea eliminar y seleccione Delete.

Gestión de objetos de datos de recursos

Gestionar recursos

Después de create a resource en DataWorks Resource Management, haga clic en el icono image a la izquierda del proyecto de MaxCompute y haga clic en Resource para ver la información básica. Haga clic en el nombre de un recurso para ver detalles como el tamaño de almacenamiento.

Gestionar funciones

Después de create a function en DataWorks Resource Management, haga clic en el icono image a la izquierda del proyecto de MaxCompute y haga clic en Function para ver la información básica. Haga clic en el nombre de una función para ver detalles como el tamaño de almacenamiento.

Consulta y eliminación de un catálogo de datos de MaxCompute

Consulte o elimine un catálogo de datos de MaxCompute cuando ya no sea necesario.

  1. Consulte un proyecto.

    1. Después de agregar un proyecto al catálogo de datos, haga clic en el icono image a la izquierda del catálogo para visualizarlo.

    2. Pase el cursor sobre el proyecto de MaxCompute para ver su uso de almacenamiento e información relacionada.

  2. Elimine un proyecto.

    Para eliminar un proyecto de MaxCompute, haga clic derecho sobre él y seleccione Remove.