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 :
-
É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.
-
É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
Démarrez DataGrip.
Dans le main menu
, sélectionnez .Dans la boîte de dialogue New Project, saisissez un nom de projet, par exemple MaxCompute_test.
Dans la fenêtre du nouveau projet, cliquez sur Create
> Driver dans le coin supérieur gauche.Dans la boîte de dialogue Data Sources and Drivers, accédez à l'onglet Drivers. Cliquez sur l'icône
et sélectionnez User Driver. Nommez le pilote, par exemple MaxCompute.-
Dans la section Driver Files, cliquez sur l'icône
|
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.
| Accédez à l'onglet Data Source. Cliquez sur l'icône
et sélectionnez le pilote que vous avez créé, par exemple MaxCompute.-
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.
-
Cliquez sur Test Connection pour vérifier la configuration.
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 , 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 , 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.