Tous les produits
Search
Centre de documentation

MaxCompute:Connecter DataGrip à MaxCompute

Dernière mise à jour :Aug 10, 2026

Cette rubrique explique comment connecter DataGrip à un projet MaxCompute à l'aide du pilote JDBC MaxCompute.

Contexte

DataGrip, un environnement de gestion de base de données destiné aux développeurs, simplifie l'interrogation, la création et la gestion des bases de données. Il prend en charge les bases de données locales, hébergées sur serveur et cloud. Pour plus d'informations, consultez DataGrip.

Prérequis

Assurez-vous de remplir les conditions suivantes :

  • Vous avez créé un projet MaxCompute.

    Pour plus d'informations, consultez Créer un projet MaxCompute.

  • Vous disposez d'un ID AccessKey et d'un AccessKey Secret disposant des permissions nécessaires pour accéder au projet MaxCompute.

    Accédez à la page AccessKey Management pour obtenir un ID AccessKey et un AccessKey Secret.

  • Vous avez téléchargé le package JAR du pilote JDBC MaxCompute avec toutes les dépendances (jar-with-dependencies).

    Téléchargez le pilote en cliquant sur odps-jdbc-3.9.0.jar, ou obtenez la dernière version depuis GitHub ou le dépôt Maven. Cette rubrique utilise le pilote JDBC MaxCompute v3.9.0 à titre d'exemple.

  • Vous avez téléchargé et installé DataGrip.

    Pour plus d'informations, consultez Install DataGrip.

    Cette rubrique utilise DataGrip 2024.3.3 à titre d'exemple.

Procédure

Pour connecter DataGrip à MaxCompute, suivez les étapes ci-dessous :

  1. Étape 1 : Ajouter un pilote et configurer une source de données

    Ajoutez le pilote JDBC MaxCompute à DataGrip et configurez les paramètres de connexion pour votre projet MaxCompute.

  2. Étape 2 : Utiliser DataGrip pour gérer le projet MaxCompute

    Utilisez la connexion créée dans DataGrip pour gérer votre projet MaxCompute.

Étape 1 : Configurer le pilote et la source de données

  1. Démarrez DataGrip.

  2. Dans le main menuimage, sélectionnez File > Create > Project.

  3. Dans la boîte de dialogue New Project, saisissez un nom de projet, par exemple MaxCompute_test.

  4. Dans la fenêtre du nouveau projet, cliquez sur Createimage > Driver dans le coin supérieur gauche.

  5. Dans la boîte de dialogue Data Sources and Drivers, accédez à l'onglet Drivers. Cliquez sur l'icône image et sélectionnez User Driver. Nommez le pilote, par exemple MaxCompute.

  6. Dans la section Driver Files, cliquez sur l'icône image et sélectionnez Custom JARs. Depuis votre machine locale, sélectionnez le fichier JAR du pilote JDBC MaxCompute téléchargé, tel que odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar.

    |
    **Parameter**
    |
    **Description**
    | | --- | --- | |
    **Name**
    |
    Un nom pour le nouveau pilote, par exemple MaxCompute.
    | |
    **Class**
    |
    Après avoir téléchargé le fichier JAR du pilote JDBC MaxCompute, sélectionnez **com.aliyun.odps.jdbc.OdpsDriver** dans la liste déroulante.
    |











  7. Accédez à l'onglet Data Source. Cliquez sur l'icône image et sélectionnez le pilote que vous avez créé, par exemple MaxCompute.

  8. Dans l'onglet General, configurez les paramètres suivants.

    Parameter

    Description

    Name

    Par défaut, il s'agit du nom du pilote. Vous pouvez spécifier un nom personnalisé.

    Authentication

    Sélectionnez User & Password.

    User

    L'ID AccessKey disposant des permissions nécessaires pour accéder au projet MaxCompute.

    Vous pouvez accéder à la page AccessKey Management pour obtenir l'ID AccessKey.

    Password

    Le AccessKey Secret correspondant à l'ID AccessKey.

    URL

    L'URL de connexion pour le projet MaxCompute. Le format est jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]. N'incluez pas les crochets angulaires (<>) dans l'URL. Le tableau suivant décrit les paramètres.

    • <MaxCompute_endpoint> : Obligatoire. L'endpoint de la région où se trouve votre projet MaxCompute.

      Pour obtenir la liste des endpoints, consultez Endpoints.

    • <MaxCompute_project_name> : Obligatoire. Le nom du projet MaxCompute cible.

      Il s'agit du nom de votre projet MaxCompute, et non d'un espace de travail. Connectez-vous à la console MaxCompute, changez de région dans le coin supérieur gauche et recherchez le nom du projet sur la page Projects.

    • interactiveMode : Facultatif. Indique si la fonctionnalité Query Acceleration doit être activée.

      Pour activer Query Acceleration, ajoutez &interactiveMode=true à l'URL. Pour plus d'informations, consultez Query Acceleration.

    • useProjectTimeZone : Facultatif. Ce paramètre synchronise le fuseau horaire entre DataGrip et l'instance de serveur MaxCompute. Pour utiliser le même fuseau horaire, ajoutez &useProjectTimeZone=true à l'URL.

  9. Cliquez sur Test Connection pour vérifier la configuration.

  10. Cliquez sur OK pour enregistrer la configuration.

Étape 2 : Gérer le projet

Une fois la connexion établie, la nouvelle connexion MaxCompute apparaît dans le panneau de gauche. Vous pouvez écrire et exécuter des scripts SQL pour gérer votre projet MaxCompute. Pour plus d'informations, consultez DataGrip Help.

  • Afficher toutes les tables

    Vous pouvez afficher les informations relatives à toutes les tables sous votre connexion MaxCompute.

    Dans le panneau Database Explorer situé à gauche, développez Connexion MaxCompute > nom du projet > default > tables pour afficher toutes les tables du schéma.

  • Afficher le schéma d'une table

    Faites un clic droit sur la table cible, sélectionnez Create > Query Console, puis écrivez et exécutez un script SQL dans l'éditeur SQL situé à droite pour afficher le schéma de la table.

    Par exemple, exécutez la commande DESC sale_detail. La sortie répertorie les Native Columns, qui incluent shop_name(STRING), customer_id(STRING) et total_price(DOUBLE), ainsi que les Partition Columns, qui incluent sale_date(STRING) et region(STRING).

  • Afficher les données d'une table

    Faites un clic droit sur la table cible, sélectionnez Create > Query Console, puis écrivez et exécutez un script SQL dans l'éditeur SQL situé à droite pour afficher les données de la table.

    Par exemple, pour interroger la table pyodps_iris, exécutez la commande SELECT * FROM pyodps_iris;. Cliquez sur l'icône verte Run en forme de triangle dans la barre d'outils pour afficher les données de la table dans le panneau Result en bas.