Tous les produits
Search
Centre de documentation

DataWorks:Configurer le catalogue de données MaxCompute

Dernière mise à jour :Aug 21, 2026

Le catalogue de données offre une interface unifiée pour gérer les métadonnées MaxCompute, notamment les tables, les vues, les tables externes, les ressources et les fonctions.

Limites

Pour afficher les données MaxCompute dans le catalogue de données avec un utilisateur ou un rôle RAM, obtenez d'abord les autorisations MaxCompute requises. Si le modèle à trois niveaux est activé pour la source de données ou le projet, accordez également à l'utilisateur ou au rôle RAM l'autorisation d'afficher les métadonnées du schéma.

Remarque

Si un projet MaxCompute contient plusieurs schémas, accordez des autorisations de métadonnées pour tous les schémas afin d'afficher la liste complète des schémas sur la page des détails du projet.

  • Accorder des autorisations à un utilisateur RAM :

    GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER RAM$<Alibaba_Cloud_Account_Name>:<RAM_User_Name>;
  • Accorder des autorisations à un rôle RAM :

    GRANT DESCRIBE ON SCHEMA <Schema_Name> TO USER `RAM$<Alibaba_Cloud_Account_Name>:role/<RAM_Role_Name>`;
  • Une fois la fonctionnalité de schéma activée pour un projet MaxCompute, vous pouvez gérer les schémas et gérer les tables d'objets.

Accéder au catalogue de données MaxCompute

  1. Accédez à la page Workspaces dans la console DataWorks. Dans la barre de navigation supérieure, sélectionnez la région souhaitée. Localisez l'espace de travail cible et choisissez Shortcuts > Data Studio dans la colonne Actions.

  2. Dans le volet de navigation de gauche, cliquez sur l'icône image. Dans l'arborescence DATA CATALOG, cliquez sur MaxCompute.

Créer un catalogue de données MaxCompute

Ajoutez des projets MaxCompute existants au catalogue de données.

  1. Cliquez sur l'icône image située à côté du catalogue de données MaxCompute.

  2. Ajoutez un projet MaxCompute en utilisant l'une des méthodes suivantes.

    Source cible

    Méthode

    Source de données MaxCompute créée dans l'espace de travail actuel

    Dans l'onglet DataWorks Data Source, localisez la source de données cible et cliquez sur Add. Pour ajouter plusieurs sources de données simultanément, sélectionnez-les et cliquez sur Batch Add.

    Projet MaxCompute créé dans la console MaxCompute

    Dans l'onglet MaxCompute-Project, localisez le projet cible et cliquez sur Add. Pour ajouter plusieurs projets simultanément, sélectionnez-les et cliquez sur Batch Add. Vous pouvez également cliquer sur Create Project pour ajouter manuellement un nouveau projet MaxCompute.

    Paramètres du projet interne : Paramètres de configuration du projet MaxCompute. Opérations sur les projets externes : Data lakehouse MaxCompute.
    Important

    La synchronisation des métadonnées prend entre 10 et 20 secondes. Après la création d'un projet, patientez quelques instants puis actualisez manuellement la liste pour afficher les dernières données.

Gérer un catalogue de données MaxCompute

Ajoutez et gérez des schémas, des tables, des vues et d'autres objets de données dans le catalogue de données MaxCompute.

Objet MaxCompute

Afficher

Créer

Schéma

Pris en charge

Pris en charge

Table

Pris en charge

Pris en charge

Table externe

Pris en charge

Pris en charge

Table d'objets

Pris en charge

Pris en charge

Vue

Pris en charge

Pris en charge

Vue matérialisée

Pris en charge

Pris en charge

Vue matérialisée Delta Live

Pris en charge

Pris en charge

Ressource

Pris en charge

Non pris en charge

Fonction

Pris en charge

Non pris en charge

Remarque

Le niveau du schéma s'affiche uniquement après l'activation de la fonctionnalité de schéma pour MaxCompute. Opérations sur les schémas.

Gérer les schémas

  1. Créer un schéma.

    Cliquez sur l'icône image située à droite du projet MaxCompute. Dans la boîte de dialogue Create Schema, saisissez un nom et appuyez sur Entrée.

  2. Afficher un schéma.

    Après avoir ajouté un schéma à un projet MaxCompute, cliquez sur l'icône image située à gauche du projet pour l'afficher.

  3. Supprimer un schéma.

    Si vous n'avez plus besoin d'un schéma, faites un clic droit dessus et sélectionnez Delete.

    Important
    • Cette opération est irréversible. Procédez avec prudence.

    • Supprimez tous les objets de données contenus dans le schéma (tels que les tables et les vues) avant de supprimer le schéma lui-même.

Gérer les tables

Créer une table

  1. À droite du schéma, cliquez sur image > Create Table pour accéder à la page Create Table.

  2. Vous pouvez créer une table de l'une des manières suivantes.

    • Créer une table à l'aide de Copilot :

      1. Dans la barre d'outils, cliquez sur Use Copilot to Create Table pour ouvrir l'interface de discussion Copilot.

      2. Saisissez une instruction pour créer une table. Par exemple, Create a daily aggregate table for product sales.

      3. Cliquez sur Generate and Replace. Le système génère un nom de table et des informations sur les champs en fonction de votre instruction.

      4. Si le nom de la table et les champs correspondent à vos attentes, cliquez sur Accept.

        Remarque

        Vous pouvez cliquer sur Accept, puis modifier manuellement les informations de table générées.

    • Créer une table manuellement :

      Créez une table en utilisant les paramètres suivants.

      Paramètre

      Description

      Informations de base

      Spécifiez un Table Name personnalisé, un Lifecycle et d'autres informations.

      Informations sur les champs

      Modifiez les informations relatives aux champs et aux annotations.

      • Modification manuelle : Cliquez sur Insert au-dessus de la liste des champs. Spécifiez le nombre de lignes, puis modifiez les informations relatives aux champs et aux annotations.

      • Modification intelligente avec Copilot : Cliquez sur Generate Fields ou Generate Field Descriptions au-dessus de la liste des champs. Le système génère les champs et les commentaires en fonction du nom et de la description de la table.

      Paramètres avancés

      Le Table Type est défini par défaut sur Internal Table. Vous pouvez configurer les Cluster Properties.

  3. Une fois la configuration terminée, cliquez sur Publish dans la barre d'outils supérieure et suivez la procédure de publication pour créer la table.

Gérer une table

  1. Afficher une table.

    Après avoir créé une table, cliquez sur l'icône image située à gauche du projet, puis cliquez sur Table pour afficher les informations de base. Cliquez sur un nom de table pour afficher les détails tels que Fields et DDL.

  2. Effectuer des opérations sur la table.

    1. Faites un clic droit sur une table interne. Vous pouvez sélectionner Generate SQL Query Statement, Import Data, Request Permission s, Mappage des métadonnées vers Hologres ou Synchronisation des données vers Hologres.

    2. Double-cliquez sur une table interne pour ouvrir sa page de détails. Cliquez sur Edit dans le coin supérieur droit. Sur la page de modification, modifiez le Lifecycle et la Table Description, ou ajoutez, modifiez ou supprimez des champs.

      Important
      • Avant de modifier le nom d'un champ, de supprimer un champ ou de changer le type d'un champ, exécutez la commande suivante dans un nœud MaxCompute SQL pour activer l'évolution du schéma : setproject odps.schema.evolution.enable=true.

      • Pour supprimer un champ, sélectionnez la ligne correspondante, faites un clic droit et sélectionnez Delete.

      • Après avoir mis à jour la table, cliquez à nouveau sur Publish pour que les modifications prennent effet.

  3. Supprimer une table.

    Faites un clic droit sur la table que vous souhaitez supprimer et sélectionnez Delete.

    Important

    Cette opération est irréversible. Procédez avec prudence.

Gérer les tables externes

Créer une table externe

  1. À droite du schéma, cliquez sur image > Create External Table pour accéder à la page de création de table External.

  2. Créez une table externe en utilisant l'une des méthodes suivantes.

    • Créer une table à l'aide de Copilot :

      1. Dans la barre d'outils, cliquez sur Use Copilot to Create Table pour ouvrir l'interface de discussion Copilot.

      2. Saisissez une instruction pour créer une table. Par exemple, Create a daily aggregate table for product sales.

      3. Cliquez sur Generate And Replace. Le système génère un nom de table et des informations sur les champs en fonction de votre instruction.

      4. Si le nom de la table et les champs correspondent à vos attentes, cliquez sur Accept.

        Remarque

        Vous pouvez cliquer sur Accept, puis modifier manuellement les informations de table générées.

    • Créer une table manuellement :

      Créez une table externe en utilisant les paramètres suivants.

      Paramètre

      Description

      Informations de base

      Spécifiez un Table Name personnalisé, un Lifecycle et d'autres informations.

      Informations sur les champs

      Modifiez les informations relatives aux champs et aux annotations.

      • Modification manuelle : Cliquez sur Insert au-dessus de la liste des champs. Spécifiez le nombre de lignes, puis modifiez les informations relatives aux champs et aux annotations.

      • Modification intelligente avec Copilot : Cliquez sur Generate Fields ou Generate Field Descriptions au-dessus de la liste des champs. Le système génère les champs et les commentaires en fonction du nom et de la description de la table.

      Paramètres avancés

      Le Table Type est défini par défaut sur Externa Table. Configurez l'Storage Location OSS et le Storage Format.

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

        Remarque

        Vous pouvez obtenir le nom du bucket OSS depuis l'aperçu du bucket.

      • Storage Format : Plusieurs formats sont pris en charge, tels que CSV, ORC et TEXTFILE.

  3. Cliquez sur Publish dans la barre d'outils pour créer la table.

Gérer une table externe

  1. Afficher une table externe.

    Après avoir créé une table externe, cliquez sur l'icône image située à gauche du projet, puis cliquez sur Externa Table pour afficher ses informations de base. Cliquez sur un nom de table pour afficher les détails tels que Fields et DDL.

  2. Opérations sur les tables externes.

    Double-cliquez sur la table externe pour ouvrir sa page de détails. Cliquez sur Edit dans le coin supérieur droit. Sur la page de modification, modifiez le Lifecycle et la Table Description, ou ajoutez, modifiez ou supprimez des champs.

    Important
    • Avant de modifier le nom d'un champ, de supprimer un champ ou de changer le type d'un champ, exécutez la commande suivante dans un nœud MaxCompute SQL pour activer l'évolution du schéma : setproject odps.schema.evolution.enable=true.

    • Pour supprimer un champ, sélectionnez la ligne correspondante, faites un clic droit et sélectionnez Delete.

    • Après avoir mis à jour la table, cliquez à nouveau sur Publish pour que les modifications prennent effet.

  3. Supprimer une table externe.

    Faites un clic droit sur la table externe que vous souhaitez supprimer et sélectionnez Delete.

Gérer les tables d'objets

Gérez les tables d'objets uniquement dans les projets MaxCompute pour lesquels la fonctionnalité de schéma est activée.

Gérer une table d'objets

  1. Afficher une table d'objets.

    Après avoir créé une OBJECT TABLE dans un projet MaxCompute, cliquez sur l'icône image située à gauche du projet, puis cliquez sur Object Table pour afficher les informations de base. Cliquez sur un nom de table pour afficher les détails tels que Fields et DDL.

  2. Effectuer des opérations sur une table d'objets.

    Faites un clic droit sur une table d'objets. Vous pouvez sélectionner Generate SQL Query Statement, Request Permissions, mapper les métadonnées MaxCompute vers une table externe Hologres ou synchroniser les données MaxCompute vers une table interne Hologres.

  3. Supprimer une table d'objets.

    Faites un clic droit sur la table d'objets que vous souhaitez supprimer et sélectionnez Delete.

    Important

    Cette opération est irréversible. Procédez avec prudence.

Gérer les vues

Créer une vue

  1. À droite du schéma, cliquez sur image > Create View pour ouvrir la page Create View.

  2. Modifiez la commande comme décrit dans la section Créer ou mettre à jour une vue. Remplacez view_name par le nom de la vue que vous souhaitez créer. Après le mot-clé AS, ajoutez l'instruction de requête pour la source de données de la vue.

  3. Cliquez sur Publish en haut de la page pour créer la vue.

Gérer une vue

  1. Afficher les détails d'une vue

    Après avoir créé une vue, cliquez sur l'icône image située à gauche du projet, puis cliquez sur View pour afficher les informations de base. Cliquez sur un nom de vue pour afficher les détails tels que Fields et DDL.

  2. Opérations sur la vue

    Double-cliquez sur la vue pour ouvrir sa page de détails. Cliquez sur Edit dans le coin supérieur droit. Modifiez la vue en changeant l'instruction de requête de la source de données après le mot-clé AS.

  3. Supprimer une vue

    Faites un clic droit sur la vue que vous souhaitez supprimer et sélectionnez Delete.

Gérer les vues matérialisées

Créer une vue matérialisée

  1. À droite du schéma, cliquez sur image > Create Materialized View pour ouvrir la page Create Materialized View.

  2. Modifiez la commande comme décrit dans la section Créer une vue matérialisée. Remplacez view_name par le nom de la vue matérialisée que vous souhaitez créer. Après l'instruction AS, ajoutez l'instruction de requête pour la source de données de la vue matérialisée.

  3. Cliquez sur Publish en haut de la page pour créer la vue matérialisée.

Gérer une vue matérialisée

  1. Afficher une vue matérialisée.

    Après avoir créé une vue matérialisée, cliquez sur l'icône image située à gauche du projet, puis cliquez sur Materialized View. Cliquez sur un nom de vue matérialisée pour afficher les détails tels que Fields et DDL.

  2. Supprimer une vue matérialisée.

    Faites un clic droit sur la vue matérialisée que vous souhaitez supprimer et sélectionnez Delete.

Gérer les vues matérialisées Delta Live

Créer une vue matérialisée dynamique

  1. À droite du schéma, cliquez sur image > Create Delta Live Vaterialized View pour ouvrir la page Create Delta Live Vaterialized View. Paramètres de configuration clés :

    Paramètre

    Description

    Data Generation SQL

    Saisissez le Data Generation SQL en vous basant sur la commande décrite dans la section Vue matérialisée dynamique. Cliquez sur Precompile pour vérifier la syntaxe SQL.

    Important

    Une table non partitionnée doit posséder une clé primaire.

    Détails des champs

    Détails des champs analysés après une précompilation réussie.

    Informations sur le champ de clé primaire

    Après la précompilation, le système lit les champs de clé primaire éligibles et les affiche dans la liste déroulante. Sélectionnez un ou plusieurs champs de clé primaire.

    Informations sur le champ de partition

    Après la précompilation, le système lit les champs de partition éligibles et les affiche dans la liste déroulante. Sélectionnez les champs de partition pour partitionner la vue matérialisée dynamique. Plusieurs champs de partition sont pris en charge.

    Paramètres d'optimisation

    Configurez les paires clé-valeur des paramètres à générer dans les TBLPROPERTIES du DDL.

    Politique d'actualisation des données

    • Configuration d'actualisation de la vue matérialisée Delta Live non partitionnée : Une vue matérialisée dynamique non partitionnée est créée si vous ne spécifiez pas de champ de partition.

      • Pour les vues matérialisées dynamiques dans MaxCompute, le mode d'actualisation est défini par défaut sur l'actualisation incrémentielle. La propriété de table est TBLPROPERTIES("refresh_mode"="incremental").

      • Les méthodes de planification d'actualisation prises en charge sont MaxCompute Auto Refresh et DataWorks Scheduled Refresh.

    • Configuration d'actualisation de la vue matérialisée Delta Live partitionnée : Une vue matérialisée dynamique partitionnée est créée si vous spécifiez un champ de partition.

      • Actualisation de la partition : Configurez les paramètres tels que la méthode de planification d'actualisation, l'activation ou non de l'actualisation automatique des données, l'époque de planification et la durée d'actualisation.

      • Actualiser les données historiques des partitions : Configurez l'actualisation ou non des données dans les partitions dont le cycle d'actualisation est terminé.

  2. Cliquez sur Publish en haut de la page pour créer la vue matérialisée dynamique.

Gérer une vue matérialisée dynamique

  1. Publier dans un environnement de développement ou de production. Dans un espace de travail en mode standard, publiez les objets dans différents environnements.

  2. Afficher une vue matérialisée dynamique.

    Après avoir créé une vue matérialisée dynamique, cliquez sur l'icône image située à gauche du projet, puis cliquez sur Delta Live Materialized View pour afficher les informations de base. Cliquez sur un nom de vue pour afficher les détails tels que Fields et l'instruction DDL.

  3. Supprimer une vue matérialisée dynamique.

    Faites un clic droit sur la vue matérialisée dynamique que vous souhaitez supprimer et sélectionnez Delete.

Gérer les objets de données de ressource

Gérer les ressources

Après avoir créé une ressource dans la gestion des ressources DataWorks, cliquez sur l'icône image située à gauche du projet MaxCompute, puis cliquez sur Resource pour afficher les informations de base. Cliquez sur un nom de ressource pour afficher les détails tels que la taille de stockage.

Gérer les fonctions

Après avoir créé une fonction dans la gestion des ressources DataWorks, cliquez sur l'icône image située à gauche du projet MaxCompute, puis cliquez sur Function pour afficher les informations de base. Cliquez sur un nom de fonction pour afficher les détails tels que la taille de stockage.

Afficher et supprimer un catalogue de données MaxCompute

Consultez ou supprimez un catalogue de données MaxCompute lorsqu'il n'est plus nécessaire.

  1. Afficher un projet.

    1. Après avoir ajouté un projet au catalogue de données, cliquez sur l'icône image située à gauche du catalogue pour l'afficher.

    2. Survolez le projet MaxCompute pour afficher son utilisation du stockage et les informations connexes.

  2. Supprimer un projet.

    Pour supprimer un projet MaxCompute, faites un clic droit dessus et sélectionnez Remove.