Develop and submit SQL scripts in MaxCompute Studio - MaxCompute

Rédigez et exécutez des scripts SQL dans MaxCompute Studio pour créer des tables, insérer des données et interroger les résultats.

Prérequis

Vous avez configuré une connexion à un projet MaxCompute. Gérer les connexions aux projets.
Vous avez créé un module de script MaxCompute. Créer un module de script MaxCompute.

Créer un fichier de script SQL

Dans la fenêtre d'outils Project, cliquez avec le bouton droit sur scripts et sélectionnez New > MaxCompute SQL Script.
Dans la boîte de dialogue New MaxCompute SQL Script, définissez les paramètres et cliquez sur OK.
- Script Name : nom du script.
- MaxCompute project : projet cible. Cliquez sur + pour ajouter une connexion au projet. Gérer les connexions aux projets.
Rédigez le script SQL dans l'éditeur. Pour la syntaxe, reportez-vous à : Vue d'ensemble de SQL.
Exemple de script :
```
CREATE TABLE table_5( 
col1 BIGINT,
col2 BIGINT,
col3 BIGINT,
ds DATETIME
);
INSERT INTO TABLE table_5 VALUES (1, 2, 3, DATETIME'2025-11-11 00:00:00');
SELECT * FROM table_5 WHERE ds='${bizdate}';
```
Remarque
- Le mode script prend en charge les dépendances de ressources interprojets. Par exemple, un script lié au projet A peut également accéder à table1 dans le projet B (ProjectB.table1).
- Personnalisez l'éditeur de script SQL. Vue d'ensemble.

Soumettre un script SQL

Avant de soumettre un script, configurez les paramètres suivants dans la barre d'outils située au-dessus de l'éditeur :

Mode éditeur :
- Statement mode : divise le script par ; et soumet chaque instruction individuellement.
- Script mode : soumet le script entier en une seule requête pour une optimisation globale. Ce mode est recommandé.
Système de types : détermine la compatibilité SQL.
- Legacy type system : système de types MaxCompute d'origine.
- MaxCompute type system : système de types introduit dans MaxCompute 2.0.
- Hive compatible type system : système de types compatible avec Hive dans MaxCompute 2.0.
Mode d'exécution :
- Default : mode d'exécution stable.
- MaxQA : utilise la fonctionnalité d'accélération des requêtes MaxQA.
- MaxCompute Query Acceleration : active les dernières fonctionnalités MCQA.
- Rerun When Acceleration Fails : réexécute automatiquement la tâche si l'accélération des requêtes échoue.

Cliquez sur l'icône dans la barre d'outils ou la barre latérale pour exécuter le script.

Remarque
Si le script contient une variable telle que ${bizdate}, une boîte de dialogue vous invite à saisir sa valeur. Par exemple, saisissez 2017-11-11 00:00:00 pour interroger les données de la partition cible.
Vérifiez le coût estimé dans la boîte de dialogue Confirmation, puis cliquez sur OK.
La boîte de dialogue affiche les métriques Cost Estimate : Inputs (taille des données d'entrée en octets), UDF Count (nombre d'UDF) et Complexity. Cochez Do not show this dialog again pour ne plus afficher cette boîte de dialogue à l'avenir.
Remarque
- Cliquez sur l'icône dans la barre d'outils pour actualiser les métadonnées (tables et UDF). Utilisez cette option si MaxCompute Studio signale qu'une table ou une fonction n'existe pas alors qu'elle existe bien sur le serveur.
- Le script est compilé localement à partir des métadonnées du projet dans la fenêtre Project Explorer. Si la compilation réussit, le script est soumis au serveur.
- Les journaux d'exécution s'affichent pendant l'exécution. Lorsque la tâche démarre sur le serveur, l'onglet des détails de la tâche s'ouvre automatiquement.
- Pour afficher le coût estimé, cochez la case Show SQL cost confirm dialog when script submitted dans Options de configuration MaxCompute SQL.
Consultez les résultats d'exécution dans l'onglet Result de la console.

En mode instruction, le résultat de chaque instruction s'affiche séparément.

L'onglet Result présente la sortie de chaque instruction (par exemple INSERT INTO TABLE... et SELECT * FROM...) dans des sections distinctes, accompagnées du code SQL correspondant et des données renvoyées.