MaxCompute SQL analysis - edit and run SQL online - MaxCompute

Utilisez la fonctionnalité d'analyse SQL dans la console MaxCompute pour modifier, exécuter et analyser des instructions SQL en ligne.

Important

Alibaba Cloud a amélioré la fonctionnalité d'analyse SQL dans la console MaxCompute avec une prise en charge pour toutes les régions. Découvrez les nouvelles capacités et activez-les via Connect using SQL analysis (new version).

L'ancien point d'entrée pour l'analyse SQL sera désactivé le 31 mars 2026 (UTC+8). Avant cette date, déplacez vos fichiers locaux depuis votre espace de travail hérité vers votre répertoire personnel dans la nouvelle interface d'analyse SQL.

Présentation des fonctionnalités

Modifiez et exécutez des instructions SQL en ligne, et visualisez les résultats des requêtes.
Des démonstrations basées sur des jeux de données publics intégrés vous permettent de tester immédiatement les fonctionnalités de MaxCompute.

Scénarios d'utilisation

Exploration rapide : utilisez des jeux de données publics pour découvrir les fonctionnalités principales de MaxCompute.
Tests ad hoc : exécutez des commandes SQL temporaires, par exemple pour afficher les données d'une table.

Interface d'analyse SQL

Zone de l'éditeur

Module	Description
Barre d'onglets	Les onglets de fichier vous permettent d'ouvrir plusieurs fichiers simultanément. Double-cliquez sur une zone vide de la barre d'onglets pour créer un nouveau fichier `.sql`. Faites un clic droit sur une zone vide de la barre d'onglets et sélectionnez Create File.
Barre d'outils	Run : Exécute le script SQL. Sélectionnez un segment pour l'exécuter seul ; sinon, l'intégralité du fichier s'exécute. Stop : Apparaît après avoir cliqué sur Run. Cliquez sur Stop pour arrêter le script en cours d'exécution. Save : Enregistre les fichiers localement en tant que fichiers `.sql`. Le stockage cloud n'est pas pris en charge dans l'aperçu public actuel. Format : Met en forme le code SQL du fichier actuel. Run Result : Affiche le volet des résultats s'il est masqué après l'exécution d'un script SQL. Cost Analysis : Exécute une instruction COST SQL pour estimer l'utilisation des ressources et obtenir le volume de données analysées ainsi que la complexité de la requête.
Éditeur	La première ligne du script doit contenir du code exécutable. Si un fichier `.sql` contient plusieurs scripts SQL, placez tous les indicateurs (instructions SET) en haut. Les indicateurs s'appliquent à tous les scripts SQL du fichier. Prend en charge le mode plein écran pour la saisie, l'exécution et la visualisation des résultats.

Volet de configuration des paramètres d'exécution

Cliquez sur Run Parameters dans le coin supérieur droit de l'éditeur SQL pour développer le panneau de configuration.

Module	Description
Project	Sélectionnez le projet dans lequel exécuter le code SQL. Obligatoire. Le projet sélectionné doit accorder à votre compte l'autorisation `create instance`. Requis lors de la première exécution. Le système met en cache votre dernière sélection, que vous pouvez modifier à tout moment. La sélection s'applique à tous les onglets de fichiers ouverts.
Computing Quota	Sélectionnez un quota de calcul. Facultatif. Si vous sélectionnez un quota, celui-ci doit accorder à votre compte l'autorisation `usage`. Si vous ne sélectionnez pas de quota, le système utilise le quota de calcul par défaut du projet. La sélection s'applique à tous les onglets de fichiers ouverts.

Volet des résultats

Module	Description
Issue	Valide automatiquement la syntaxe et le formatage de tous les fichiers ouverts avant l'exécution du script.
MetaData	Sélectionnez un objet (table, ressource ou fonction) dans Table Data ou DataSet Manage pour afficher les métadonnées : informations de base, colonnes, DDL et aperçu des données. Nécessite les autorisations de données appropriées pour l'objet.
Result	Affiche les résultats de l'exécution du script : Liste d'exécution : chaque exécution SQL crée un enregistrement horodaté. Cliquez sur un enregistrement pour afficher ses détails. Journaux : journaux d'exécution pour chaque exécution. SQL : le code SQL exact exécuté. Liste de résultats : affiche les résultats de la requête s'ils sont disponibles. Analyse : effectue une analyse simple basée sur des graphiques des résultats si disponible.
Cost Analysis	Affiche les résultats de l'instruction COST SQL exécutée lors de l'Cost Analysis, y compris les journaux d'exécution et la sortie.

Gestionnaire de ressources

Faites un clic droit sur une zone vide du gestionnaire de ressources pour configurer les modules visibles, par exemple pour masquer Timeline.

Module	Description
Liste de fichiers	Lors du premier accès, affiche No folder opened. Cliquez sur Open Folder pour sélectionner un dossier local. Une boîte de dialogue de confirmation des autorisations apparaît lors de la première utilisation. Important Vous devez accorder des autorisations d'accès à tous les fichiers chaque fois qu'un dossier local est ouvert. Aucun contenu de dossier n'est stocké sur le serveur.
CommonDataSet Demo	Les requêtes de démonstration basées sur des jeux de données publics intégrés peuvent être exécutées ou modifiées temporairement. Les fichiers de démonstration en ligne ne peuvent pas être modifiés de manière permanente ; actualiser la page les réinitialise. Enregistrez tous les fichiers modifiés sur votre machine locale. Les requêtes de démonstration utilisent des jeux de données publics avec des schémas. Les scripts incluent `set odps.namespace.schema=true;` pour activer la syntaxe de schéma par défaut. Chaque fichier de démonstration contient plusieurs scripts SQL. Le nombre précédant `-query` dans le nom du fichier indique le nombre de requêtes. Les démonstrations TPC-DS contiennent 99 requêtes par fichier avec différents volumes de données et consomment d'importantes ressources de calcul ; procédez avec prudence.
Timeline	Enregistre les journaux d'opérations pour les fichiers ouverts dans l'éditeur. Les journaux sont stockés dans le cache du navigateur et effacés lorsque vous videz le cache.

Recherche

Cliquez sur l'icône Search dans la barre latérale. La zone de recherche prend en charge Match Case (Aa), Whole Words (ab) et Regular Expression (*). La zone de remplacement prend en charge Preserve Case (AB).

Module	Description
Search	Recherche dans tous les fichiers du gestionnaire de ressources — par exemple, trouver les fichiers contenant "FROM table_test1". Cliquez sur un résultat pour ouvrir le fichier et accéder à la correspondance.
Replacement	Remplace les mots-clés trouvés par un nouveau texte. Exemple : pour remplacer `FROM table_test1` par `FROM table_test2` dans tous les fichiers, saisissez `FROM table_test1` dans la zone Search, saisissez `FROM table_test2` dans la zone Replacement, puis cliquez sur .

Données de table

Répertorie tous les objets de tous les projets du locataire et de la région actuels : schémas, tables, vues, ressources et fonctions.

Portée de visibilité : les comptes Alibaba Cloud peuvent afficher tous les projets. Les utilisateurs RAM doivent être ajoutés à un projet pour afficher son contenu.
Projet SYSTEM_CATALOG : SYSTEM_CATALOG est un projet créé par le système pour le schéma d'information au niveau du locataire. Les vues INFORMATION_SCHEMA résident sous le schéma "INFORMATION_SCHEMA" dans ce projet et sont directement accessibles.
Autorisations d'affichage : l'affichage de la liste des objets d'un projet nécessite l'autorisation List.

Les tables disposant de l'autorisation SELECT affichent une icône verte .
Hiérarchie des schémas : développez un projet pour voir ses schémas (si activés) ou directement les catégories d'objets. Développez une catégorie pour afficher ses objets.
Cliquez sur un objet pour afficher ses détails de métadonnées dans l'onglet MetaData du volet des résultats.

Jeux de données publics

Dans l'éditeur SQL, cliquez sur l'icône de base de données en bas du volet de navigation gauche. L'entrée Public Datasets apparaît en haut du panneau gauche. Développez BIGDATA_PUBLIC_DATASET pour parcourir les tables disponibles.

Affiche les métadonnées des tables des jeux de données publics fournis par le système.

Utilisation de l'analyse SQL

Les jobs SQL nécessitent un projet. Créez-en un après l'activation de MaxCompute.

Connectez-vous à la console MaxCompute et sélectionnez une région dans le coin supérieur gauche.
Créer un projet MaxCompute

Les jobs SQL nécessitent un projet. Créez-en un après l'activation de MaxCompute.
Dans le volet de navigation de gauche, choisissez Data Exploration > SQL Analysis.
Sur la page Data Exploration > SQL Analysis, créez un fichier SQL.
1. Lorsque vous ouvrez la page SQL Analysis pour la première fois, un fichier SQL nommé untitled_x est créé et ouvert par défaut. Vous pouvez modifier ce fichier directement.
2. Double-cliquez sur une zone vide de la barre d'onglets de fichiers dans l'éditeur pour créer un fichier SQL.
3. Faites un clic droit sur la barre d'onglets de fichiers dans l'éditeur et sélectionnez New File.
Après avoir saisi du SQL dans l'éditeur SQL, cliquez sur Run Configurations à droite et configurez le Project et le Computing Quota.
- Project : Obligatoire. Le projet dans lequel exécuter les instructions SQL. Vous devez disposer de l'autorisation CREATE instance pour ce projet.
- Computing Quota : Facultatif. Ce paramètre spécifie le quota de ressources de calcul pour le job. Si vous spécifiez un quota, votre compte doit disposer de l'autorisation USAGE pour celui-ci. Si vous ne spécifiez pas de quota, les instructions SQL s'exécutent en utilisant le quota de ressources de calcul par défaut configuré pour le projet.
Cliquez sur Run et attendez la fin de la requête. Dans les résultats d'exécution, vous pouvez cliquer sur l'icône pour effectuer une analyse visuelle simple.

L'interface d'analyse SQL ne prend pas en charge le téléchargement des résultats. Utilisez l'une de ces méthodes :
- Exécutez le job SQL dans le client MaxCompute (odpscmd), puis utilisez la commande Tunnel pour télécharger les résultats. Télécharger les données d'instance.
- Exécutez le job SQL dans un nœud ODPS SQL dans DataWorks Data Development, puis utilisez le bouton Export. Exporter, partager et télécharger des classeurs.
Cliquez sur Save pour enregistrer le fichier SQL actuel sur votre ordinateur local.