Connect to SQL Workbench/J and manage data - MaxCompute - Centre de documentation Alibaba Cloud

MaxCompute vous permet d'utiliser l'outil de gestion de base de données SQL Workbench/J pour accéder à votre projet MaxCompute et gérer vos données. Cette rubrique explique comment connecter SQL Workbench/J à un projet MaxCompute à l'aide du pilote JDBC MaxCompute.

Informations générales

SQL Workbench/J est un outil gratuit et multiplateforme d'exécution de requêtes SQL, indépendant de tout système de gestion de base de données (SGBD). Écrit en Java, il s'exécute sur tout système d'exploitation disposant d'un environnement d'exécution Java.

Prérequis

Avant de commencer, assurez-vous de remplir les conditions suivantes :

Vous avez créé un projet MaxCompute.

Pour plus d'informations, consultez la rubrique Création d'un projet MaxCompute.
Vous disposez d'un AccessKey ID et d'un AccessKey secret autorisés à accéder au projet MaxCompute.

Vous pouvez obtenir vos identifiants depuis la page Gestion des clés d'accès.
Vous avez téléchargé le pilote JDBC MaxCompute (version 3.0.1 ou ultérieure) incluant le package JAR complet avec les dépendances jar-with-dependencies.

L'exemple de cette rubrique utilise la version 3.2.9 du pilote JDBC MaxCompute.
Vous avez téléchargé et installé SQL Workbench/J.

L'exemple de cette rubrique utilise SQL Workbench/J Build 127, publié le 22 août 2020.
Vous avez installé Java 8 ou une version ultérieure.

Procédure

Suivez les étapes ci-dessous pour connecter SQL Workbench/J à MaxCompute :

Étape 1 : Créer un pilote

Importez le fichier JAR du pilote JDBC MaxCompute dans SQL Workbench/J pour permettre l'accès à votre projet MaxCompute via ce pilote.
Étape 2 : Connecter SQL Workbench/J à MaxCompute

Configurez les paramètres de connexion pour lier SQL Workbench/J à votre projet MaxCompute.
Étape 3 : Gérer votre projet MaxCompute avec SQL Workbench/J

Utilisez la connexion établie dans SQL Workbench/J pour gérer votre projet MaxCompute.

Étape 1 : Créer un pilote

Démarrez SQL Workbench et ouvrez l'interface.

La boîte de dialogue Select Connection Profile s'affiche automatiquement à l'ouverture de l'interface.
Dans le coin inférieur gauche de la boîte de dialogue Select Connection Profile, cliquez sur Manage Drivers. Créez un nouveau pilote, saisissez un nom personnalisé, importez le fichier JAR du pilote JDBC MaxCompute, puis cliquez sur OK pour finaliser la configuration.

Après l'importation du pilote JDBC MaxCompute, le champ Classname se définit automatiquement sur com.aliyun.odps.jdbc.OdpsDriver.

Étape 2 : Connecter SQL Workbench/J à MaxCompute

Dans le volet de configuration du profil, à droite de la boîte de dialogue Select Connection Profile, saisissez un nom de connexion (par exemple, MCtoSQL) et configurez les paramètres du tableau suivant.

Paramètre	Description
Driver	Le pilote utilisé pour se connecter à votre projet MaxCompute, à savoir le pilote MaxCompute (com.aliyun.odps.jdbc.OdpsDriver) créé à l'étape 1.
URL	L'URL de connexion à votre projet MaxCompute. Utilisez le format `jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true\|false}]`. Supprimez les symboles `<>` lors de la configuration. Les paramètres sont décrits ci-dessous : <MaxCompute_endpoint> : Obligatoire. Endpoint de la région où se trouve votre projet MaxCompute. Pour consulter la liste des endpoints, reportez-vous à la rubrique Endpoints. <MaxCompute_project_name> : Obligatoire. 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 repérez le nom du projet sur la page Projects. interactiveMode : Facultatif. Indique si la fonctionnalité d'accélération des requêtes (Query Acceleration) doit être activée. Pour activer l'accélération des requêtes, ajoutez `&interactiveMode=true` à l'URL. Pour plus d'informations, consultez la rubrique Accélération des requêtes.
Username	L'AccessKey ID disposant des privilèges d'accès au projet MaxCompute cible. Vous pouvez obtenir votre AccessKey ID depuis la page Gestion des clés d'accès.
Password	L'AccessKey secret correspondant à l'AccessKey ID. Vous pouvez obtenir votre AccessKey secret depuis la page Gestion des clés d'accès.

Cliquez sur Test. Une fois la connexion établie, cliquez sur OK pour créer la connexion de données entre SQL Workbench/J et MaxCompute.

Étape 3 : Gérer votre projet MaxCompute avec SQL Workbench/J

Dans l'interface SQL Workbench/J, utilisez la nouvelle connexion de données pour gérer votre projet MaxCompute en exécutant des commandes SQL MaxCompute.

Afficher toutes les tables

Après la création de la connexion, SQL Workbench/J bascule automatiquement vers l'interface d'exécution SQL. Exécutez la commande show tables; pour lister toutes les tables.

Saisissez votre instruction SQL dans la zone Statement et cliquez sur le bouton Run (▶) de la barre d'outils. Les résultats apparaissent dans l'onglet Result ci-dessous.
Afficher le schéma d'une table

Une fois la connexion établie, SQL Workbench/J passe automatiquement à l'interface d'exécution SQL. Exécutez la commande desc <table_name>; pour afficher le schéma de la table.
Afficher les données d'une table

Après avoir créé la connexion, SQL Workbench/J bascule automatiquement vers l'interface d'exécution SQL. Exécutez une requête SELECT pour afficher les données de la table.

Saisissez une instruction SQL dans la zone Statement, par exemple select * from bank_data_pt where age=35;, puis cliquez sur le bouton Execute de la barre d'outils. Les résultats de la requête s'affichent sous forme de tableau dans l'onglet Result ci-dessous.