MaxCompute:Exploration de données par l'IA

Téléchargement et installation

Présentation de la console

Le client utilise une disposition en trois colonnes :

• Barre latérale gauche : Zone de gestion des ressources, qui contient des panneaux tels que Gestion des fichiers, Parcours du catalogue, Connexions de données, Importation de données, Recherche dans la base de connaissances SQL, Historique des requêtes et Historique des versions de fichiers. Utilisez les icônes à gauche pour basculer entre ces panneaux.

• Zone centrale : Zone d'édition SQL et d'affichage des données, qui prend en charge plusieurs onglets.

• Barre latérale droite : Panneau Assistant IA, que vous pouvez développer ou réduire.

Le client prend en charge les thèmes sombre et clair, configurables dans les Paramètres.

Configurer la connexion de données

1. Dans la barre latérale gauche, cliquez sur l'icône de connexion pour ouvrir le panneau de connexion de données.

2. Cliquez sur Ajouter une connexion.

3. Saisissez les informations de connexion :

   • Nom de la connexion : Saisissez un nom descriptif pour la connexion.

   • Région : Sélectionnez la région où se trouve votre projet MaxCompute dans la liste déroulante, ou sélectionnez « Endpoint personnalisé » pour le saisir manuellement.

   • Nom du projet : Saisissez le nom de votre projet MaxCompute.

   • AccessKey ID et AccessKey Secret : Saisissez l'AccessKey ID et l'AccessKey Secret pour l'accès au projet.

4. Cliquez sur Tester la connexion pour vérifier la configuration.

5. Une fois le test réussi, cliquez sur Enregistrer.

Après la connexion, le panneau Catalogue dans la barre latérale gauche charge automatiquement la structure des tables du projet.

Exécuter une requête

1. Appuyez sur Option+N ou cliquez sur Nouveau dans le panneau de fichiers pour créer un nouveau fichier SQL.

2. Dans l'éditeur, saisissez une requête, par exemple :

   SELECT * FROM your_table_name LIMIT 10;

3. Appuyez sur Cmd+Entrée (sur macOS) pour exécuter la requête.

4. Les résultats de la requête apparaissent dans le Panneau de résultats sous l'éditeur. Pour analyser les résultats, vous pouvez basculer entre la Vue tabulaire, la Vue graphique et la Vue tableau croisé dynamique.

Configurer le service IA

1. Cliquez sur l'icône d'engrenage dans le coin supérieur droit pour ouvrir les Paramètres.

2. Accédez à l'onglet Configuration IA.

3. Saisissez les informations suivantes :

   • URL de l'API : L'endpoint pour le service IA. La valeur par défaut est l'endpoint pour Alibaba Cloud Model Studio : https://dashscope.aliyuncs.com/compatible-mode/v1/.

   • Clé API : Accédez à la console Alibaba Cloud Model Studio. Dans le coin supérieur droit de la page, sélectionnez la région China (Beijing). Accédez à la page Clé API et cliquez sur Create API Key ou copiez-en une existante.

   • Nom du modèle : La valeur par défaut est qwen3-max-2026-01-23. Vous pouvez également saisir d'autres modèles compatibles avec l'API OpenAI.

4. Cliquez sur Enregistrer.

Après l'enregistrement, le panneau Assistant IA à droite est prêt à l'emploi. Vous pouvez explorer vos données en posant des questions en langage naturel.

Exploration de données par l'IA

Après avoir terminé la configuration, essayez les opérations suivantes dans le panneau Assistant IA :

1. Saisissez « Lister les tables du projet actuel ». L'Assistant IA répertorie alors les tables.

2. Sélectionnez une table et saisissez « Afficher la structure et les 10 premières lignes de cette table ».

3. Après avoir consulté les résultats, posez une question analytique, telle que « Analyser la distribution du volume de données entre les partitions de cette table ».

L'Assistant IA planifie les étapes, génère le code SQL, exécute la requête et fournit une analyse. Vous pouvez observer l'intégralité de ce processus dans l'interface.

Créer une nouvelle connexion

1. Dans la barre latérale gauche, cliquez sur l'icône Connexions pour ouvrir le panneau des connexions de données.

2. Cliquez sur Ajouter une connexion.

3. Configurez les paramètres suivants :

   Paramètre	Description
   Nom de la connexion	Un nom personnalisé pour identifier la connexion.
   Région	Sélectionnez la région où se trouve votre projet MaxCompute. Le client renseigne automatiquement l'endpoint correspondant.
   Nom du projet	Le nom de votre projet MaxCompute.
   AccessKey ID	L'AccessKey ID de votre compte Alibaba Cloud.
   AccessKey Secret	L'AccessKey Secret de votre compte Alibaba Cloud.

4. Cliquez sur Tester la connexion pour vérifier la connexion.

5. Cliquez sur Enregistrer pour créer la connexion.

Tester et dépanner les connexions

Lorsque vous cliquez sur Tester la connexion, le client se connecte au service MaxCompute et récupère les informations du projet. Si le test échoue, vérifiez les points suivants :

• Assurez-vous que l'endpoint correspond à la région du projet.

• Vérifiez que votre AccessKey est correcte et n'a pas expiré.

• Confirmez que votre environnement réseau actuel peut accéder au service MaxCompute dans la région spécifiée.

• Vérifiez que le compte Alibaba Cloud associé à votre AccessKey peut accéder au projet.

Gérer plusieurs connexions

Le panneau des connexions de données répertorie toutes vos connexions enregistrées. À partir d'ici, vous pouvez :

• Basculer entre les connexions :

  Cliquez sur une connexion pour l'activer. Les opérations telles que l'exécution SQL, le parcours du catalogue et l'importation de données utilisent la connexion active.

• Supprimer une connexion :

  Cliquez sur l'icône de suppression d'une connexion pour la supprimer. Pour modifier une connexion, supprimez la connexion existante et créez-en une nouvelle.

Enregistrez plusieurs connexions pour différentes régions ou projets afin de basculer rapidement entre les environnements de production, de test et autres.

Éditeur SQL

Le client inclut un éditeur SQL intégré basé sur Monaco pour une expérience similaire à celle d'un IDE.

• Mise en surbrillance de la syntaxe et saisie semi-automatique intelligente

  L'éditeur met en surbrillance la syntaxe pour MaxCompute SQL et fournit une saisie semi-automatique intelligente contextuelle pendant que vous tapez. Les suggestions incluent les mots-clés SQL, les fonctions intégrées MaxCompute et les noms de tables et de colonnes de la connexion actuelle. La liste de saisie semi-automatique se filtre automatiquement en fonction de la position du curseur. La saisie d'un nom de table suivi d'un . suggère automatiquement les noms de colonnes pour cette table.

• Édition de code

  L'éditeur inclut le pliage de code, la colorisation des paires de parenthèses, le retour à la ligne automatique et une mini-carte du code. Appuyez sur Maj+Option+F pour mettre automatiquement en forme le script SQL actuel.

Gestion des scripts SQL

Le panneau Fichiers dans la barre latérale gauche affiche les fichiers SQL de votre système de fichiers local.

• Nouveau fichier

  Appuyez sur Option+N (macOS) pour créer un nouveau fichier SQL.

• Ouvrir un fichier

  Dans le panneau Fichiers, cliquez sur un fichier SQL existant pour l'ouvrir dans l'éditeur.

• Enregistrer un fichier

  Appuyez sur Option+S (macOS) pour enregistrer vos modifications actuelles.

• Opérations multi-onglets

  Vous pouvez ouvrir plusieurs fichiers SQL à la fois et basculer entre eux à l'aide des onglets.

Gestion des versions de fichiers SQL

Le client conserve un historique des versions pour chaque fichier SQL. Cliquez sur l'icône Historique des versions dans la barre latérale gauche pour afficher une liste des versions historiques du fichier actuel.

Chaque enregistrement de version comprend un numéro de version, une heure d'enregistrement et un type de version. Les types de version sont les enregistrements manuels (créés lorsque vous enregistrez explicitement un fichier) et les instantanés pré-exécution (créés automatiquement avant l'exécution d'une requête SQL).

Opérations disponibles sur une version :

• Comparer les différences : Double-cliquez sur une version pour ouvrir une vue de comparaison qui affiche les modifications entre cette version et le contenu actuel.

• Restaurer la version : Restaurez le contenu du fichier à une version spécifique.

• Supprimer la version : Supprimez les versions historiques dont vous n'avez plus besoin.

Exécution SQL

Il existe trois façons d'exécuter du code SQL :

• Tout exécuter : Appuyez sur Cmd+Entrée pour exécuter toutes les instructions SQL dans l'éditeur.

• Exécuter la sélection : Sélectionnez une partie du texte SQL et appuyez sur Maj+Entrée pour exécuter uniquement la sélection.

• Exécution d'une seule instruction : L'éditeur affiche un bouton Exécuter entre chaque instruction SQL. Cliquez dessus pour exécuter cette instruction spécifique.

Si un fichier SQL contient des instructions SET, telles que SET odps.sql.type.system.odps2=true;, le client fusionne automatiquement cette configuration avec les instructions SQL suivantes et les exécute ensemble.

Pendant l'exécution, l'éditeur affiche une barre de progression et l'état d'exécution ci-dessous. Une fois terminé, les résultats de la requête apparaissent dans un tableau, tandis qu'un état d'exécution apparaît pour les instructions DDL/DML.

Analyse des résultats de requête

Après le retour des résultats d'une requête, les vues suivantes sont disponibles pour l'analyse.

Historique des requêtes

Cliquez sur l'icône Historique dans la barre latérale gauche pour parcourir votre historique des requêtes. Chaque enregistrement affiche l'heure d'exécution, la durée (en millisecondes), un aperçu du code SQL, l'état (succès ou échec) et le nombre de lignes. Cliquez sur un enregistrement pour charger cette instruction SQL dans l'éditeur.

L'historique des requêtes prend en charge la pagination pour parcourir les requêtes passées.

Parcourir le Catalog

Dans la barre latérale gauche, cliquez sur l'icône Catalog pour afficher toutes les tables du projet actuel sous forme d'arborescence. Développez n'importe quelle table pour consulter ses définitions de colonnes, y compris le nom de la colonne, le type de données et le commentaire.

Cliquez avec le bouton droit sur un nom de table pour effectuer les actions suivantes :

• Aperçu des données : affichez les premières lignes de données de la table.

• Afficher le schéma de la table : consultez les informations complètes sur les colonnes, la clé de partition et les propriétés de la table.

• Afficher les informations de la table : visualisez les métadonnées telles que la taille de la table, le nombre d'enregistrements, l'heure de la dernière modification et les permissions.

Lorsque plusieurs connexions sont enregistrées, le Catalog affiche les schémas de table pour tous les projets connectés.

Aperçu des données

Sélectionnez une table dans le Catalog pour prévisualiser ses données. Le client exécute une requête LIMIT et affiche les résultats dans le volet central.

Gestion des partitions

Vous pouvez consulter la liste des partitions existantes dans le Catalog et ajouter de nouvelles partitions à une table partitionnée.

Importation de données

Le client permet d'importer des fichiers locaux vers des tables MaxCompute. Pour ouvrir le panneau d'importation, cliquez sur l'icône Data Import dans la barre latérale gauche.

Exportation de données

Vous pouvez exporter les résultats de requête aux formats suivants :

• CSV : un fichier texte séparé par des virgules compatible avec des outils comme Excel.

• JSON : données au format JSON.

• Parquet : un format de stockage columnar adapté au traitement ultérieur dans les scénarios de big data.

Dans le panneau des résultats de requête, cliquez sur le bouton Export et sélectionnez un format.

Mode Chat et mode Agent

L'assistant IA propose deux modes de fonctionnement :

Le mode Chat est idéal pour les questions-réponses rapides et les opérations légères, telles que l'explication d'une instruction SQL, l'optimisation du code SQL ou la suggestion d'informations basées sur les résultats de requête. L'IA répond directement sans processus en plusieurs étapes.

Le mode Agent gère les tâches d'analyse de données en plusieurs étapes. L'IA crée un plan d'exécution et, après votre approbation, exécute chaque étape séquentiellement. Les étapes peuvent inclure l'interrogation des métadonnées, la génération de SQL, l'exécution de requêtes et l'analyse des résultats.

Mode Chat

Saisissez une question dans la zone de saisie du panneau IA pour utiliser le mode Chat. Les cas d'utilisation courants incluent :

• Génération de SQL : décrivez vos besoins en matière de requête et l'IA génère le SQL MaxCompute correspondant.

• Optimisation SQL : ouvrez un script SQL dans l'éditeur et demandez à l'IA des suggestions d'optimisation. Vous pouvez ensuite insérer le SQL optimisé dans l'éditeur en un seul clic.

• Explication SQL : sélectionnez une instruction SQL complexe et demandez à l'IA d'expliquer sa logique section par section.

• Informations sur les résultats : après l'exécution d'une requête, demandez à l'IA des informations sur les résultats, telles que l'analyse des tendances ou la détection d'anomalies.

Mode Agent

Lorsque vous posez une question analytique impliquant plusieurs étapes, l'IA passe automatiquement en mode Agent.

Espace de travail IA

L'espace de travail IA est un répertoire local persistant qui stocke la sortie du mode Agent. Les résultats intermédiaires et finaux de chaque tâche d'analyse sont enregistrés automatiquement.

Cas d'utilisation

Base de connaissances d'extraits SQL

La sql snippet knowledge base stocke des modèles SQL réutilisables pour la récupération périodique de données. La maintenance de SQL métier standardisé dans la knowledge base vous permet d'utiliser la réécriture de dates de l'IA pour récupérer rapidement les données de rapport pour différentes périodes. Lorsque vous importez des fichiers SQL fréquemment utilisés dans la knowledge base, le système extrait automatiquement les sql snippets individuels. Pour chaque extrait, il extrait ensuite les noms de table, les mots-clés, les champs de partition et les littéraux de date pour construire un index en texte intégral.

Cliquez sur l'icône de recherche dans la barre latérale gauche pour rechercher des sql snippets par mot-clé dans la knowledge base. Après avoir trouvé un extrait, vous pouvez l'insérer dans l'éditeur pour l'exécuter. Vous pouvez également utiliser la fonction « Execute SQL Snippet » de l'assistant IA pour faire correspondre automatiquement un extrait, réécrire sa date et l'exécuter.

Couche sémantique

La semantic layer distingue le client MaxCompute des outils IA généralistes en mappant les tables et colonnes de la base de données à des termes, métriques et relations conviviaux pour l'entreprise. Lors de la génération de SQL, l'IA consulte la semantic layer pour produire des requêtes plus précises.

La semantic layer se compose des éléments suivants :

• Terme métier : définit un terme spécialisé dans votre domaine métier, tel que « DAU » pour « Utilisateurs Actifs Quotidiens ».

• Définition d'entité : décrit les objets métier principaux et leurs tables et champs clés correspondants.

• Définition de métrique : définit les formules de calcul et la portée des métriques métier, telles que Conversion Rate = Number of users who placed an order / Number of visiting users.

• Relation de table : décrit les relations JOIN et les clés de jointure entre les tables.

• Requête validée : un modèle de requête standard et validé que l'IA peut réutiliser pour des questions similaires.

• Playbook d'analyse : un modèle prédéfini pour les scénarios et étapes d'analyse qui guide l'IA pour compléter une analyse selon un flux de travail standard.

Package sémantique intégré

Le client inclut un built-in semantic package pour Information Schema couvrant les scénarios d'analyse courants de meta-warehouse au niveau du tenant MaxCompute : diagnostic de la pression de stockage, diagnostic de la pression des coûts, analyse des performances des jobs, analyse de la hausse des échecs de tâches, audit des rôles utilisateur, audit de l'exposition des permissions, observation des tables chaudes et surveillance des quotas de ressources.

Après avoir activé ce semantic package, vous pouvez poser directement à l'IA des questions d'analyse meta-warehouse, telles que « Analyser les 10 tables les plus volumineuses en termes de stockage dans le projet actuel ». L'IA utilise alors les définitions de métriques et les requêtes de référence du semantic package pour générer un SQL d'analyse précis.

Package sémantique personnalisé

Créez un custom semantic package pour vos scénarios métier. Dans le panneau de gestion de la couche sémantique, sélectionnez un domaine cible et modifiez les business terms, les entity definitions, les metric definitions, les table relationships, les validated queries et les analysis playbooks. Vous pouvez également utiliser l'assistance IA pour générer une ébauche de semantic package à partir de la structure de table de la connexion actuelle, puis l'affiner manuellement.

Navigateur de fichiers Blob

MaxCompute stocke les données de fichiers binaires dans des colonnes de type blob. Le client fournit un navigateur de fichiers blob qui fonctionne comme un gestionnaire de fichiers pour parcourir les tables blob. Pour utiliser cette fonctionnalité, activez l'interrupteur Beta du navigateur de fichiers.

Le navigateur de fichiers blob prend en charge le basculement entre la vue grille et la vue liste, la navigation par fil d'Ariane, la création de dossiers et le téléchargement/téléversement de fichiers.

Importation de fichiers Blob

Dans le panneau Data Import, passez en mode d'importation blob pour téléverser des fichiers en masse vers une table blob MaxCompute par glisser-déposer. Le client extrait les métadonnées (chemin du fichier, nom et type) et les écrit dans les colonnes de table correspondantes.

Si la table cible n'existe pas, le client aide à générer une instruction de création de table qui inclut une colonne de type blob.

Aperçu de fichiers multimodaux

Le client fournit un aperçu intégré de fichiers multimodaux pour les formats suivants :

Le client fait correspondre automatiquement la méthode d'aperçu en fonction du type MIME du fichier, mais vous pouvez également la changer manuellement.

Montage WebDAV

Le client inclut un service WebDAV intégré pour monter une table blob MaxCompute en tant que dossier local. Après le montage, prévisualisez et téléchargez les fichiers directement dans Finder sans utiliser l'interface du client.

Comment monter sur macOS :

Dans Finder, appuyez sur Cmd+K et saisissez http://localhost:8899/dav/ pour parcourir les fichiers de la table blob comme un dossier réseau.

Sous-agent OpenClaw

Le client MaxCompute s'intègre en tant que sous-agent OpenClaw et prend en charge les tâches d'analyse de données déléguées par OpenClaw.

OpenClaw contrôle et orchestre les tâches, tandis que le client MaxCompute gère l'analyse des données. Cette approche offre plusieurs avantages :

• Isolation de la sécurité : les identifiants de connexion MaxCompute sont gérés localement sur le client. Vous n'avez pas besoin de configurer un AccessKey dans OpenClaw.

• Piste d'audit complète : OpenClaw conserve une expérience conversationnelle simple, tandis que le client stocke le processus d'exécution détaillé, y compris le plan, le code SQL, les résultats intermédiaires et les informations de diagnostic, à des fins de suivi et de révision.

• Analyse approfondie : vous pouvez analyser et exporter davantage les résultats depuis OpenClaw en utilisant le mode Studio du client.

# Install the MaxCompute plugin
openclaw plugins install @maxcompute/openclaw-maxquery --pin

# Enable the plugin and configure the connection address
openclaw plugins enable maxquery
openclaw config set plugins.entries.maxquery.enabled true
openclaw config set plugins.entries.maxquery.config.baseUrl http://127.0.0.1:8899

Paramètres de l'éditeur

Paramètres IA

Paramètres IA avancés

Paramètres du thème

Basculez entre les thèmes sombre et clair.

Mise à jour de version

L'application recherche automatiquement les mises à jour et vous invite à installer les nouvelles versions lorsqu'elles sont disponibles.

Erreur de vérification de l'installation sur macOS

Cette erreur est causée par la fonctionnalité de sécurité Gatekeeper de macOS. Pour la résoudre, ouvrez Terminal, exécutez la commande suivante, puis redémarrez l'application :

sudo xattr -rd com.apple.quarantine "/Applications/MaxCompute.app"

Problèmes de connexion

• Échec du test de connexion

  Vérifiez les éléments suivants dans l'ordre :

  1. Assurez-vous que l'endpoint correspond à la region de votre project MaxCompute. Vous pouvez vérifier la region correcte sur la page des détails du project dans la console MaxCompute.

  2. Vérifiez que l'AccessKey ID et l'AccessKey Secret sont corrects et n'ont pas été désactivés ou expirés.

  3. Confirmez que votre réseau peut accéder à l'public endpoint MaxCompute pour la region spécifiée. Si vous utilisez un VPN ou un proxy, assurez-vous que votre politique réseau autorise les connexions sortantes.

  4. Assurez-vous que le compte associé à l'AccessKey ID est autorisé à accéder au project cible.

• Expiration du délai de connexion

  Des problèmes réseau provoquent généralement cette expiration du délai. Une latence élevée, en particulier lors de la connexion à une region transfrontalière, comme l'accès à une region à l'étranger depuis la Chine continentale, peut entraîner des délais d'attente. Vérifiez votre connectivité réseau ou contactez votre administrateur réseau.

Problèmes d'exécution SQL

• L'exécution SQL renvoie une erreur de syntaxe

  Le langage SQL MaxCompute diffère du SQL standard. Le client réécrit automatiquement certaines syntaxes avant l'exécution (par exemple, en convertissant NOW() en GETDATE()), mais tous les cas ne sont pas couverts. Reportez-vous à la documentation officielle du langage SQL MaxCompute pour connaître la syntaxe correcte.

• La requête renvoie un grand volume de données

  Par défaut, le client limite le nombre de lignes renvoyées afin de garantir la réactivité. Pour récupérer davantage de données, ajoutez une clause LIMIT à votre instruction SQL ou utilisez la fonctionnalité d'exportation de données pour obtenir l'ensemble complet des résultats.

Problèmes de configuration IA

• L'assistant IA ne fonctionne pas

  Assurez-vous que l'URL de l'API, l'API key et le nom du modèle sont correctement configurés dans les paramètres. La configuration par défaut utilise Model Studio (DashScope) ; pour l'utiliser, créez d'abord une API key dans la console Model Studio.

• Les réponses IA sont lentes

  La charge du service de modèle et les conditions réseau affectent la vitesse de réponse. Pour obtenir des réponses plus rapides, basculez le niveau de service d'inférence (inference service tier) sur fast dans les paramètres IA avancés ou choisissez un modèle plus réactif.

Problèmes d'importation et d'exportation

• Types de colonnes incorrects après l'importation d'un fichier Excel

  Le client déduit automatiquement les types de colonnes lors de l'analyse d'un fichier Excel. Si les types déduits sont incorrects, modifiez manuellement les définitions de type de colonne dans le DDL en mode Créer une nouvelle table, ou utilisez la fonctionnalité Générer un DDL par IA pour une inférence de type plus précise.

• Impossible d'ouvrir un fichier Parquet exporté

  Les fichiers Parquet file exportés respectent le format Apache Parquet et peuvent être lus par des outils compatibles avec Parquet, tels que Python (pandas/pyarrow) et Spark.