Apache Superset est une plateforme gratuite et open source d'exploration et de visualisation des données. Elle prend en charge les moteurs de base de données compatibles avec MySQL, PostgreSQL et Java Database Connectivity (JDBC). Cette rubrique explique comment connecter Superset à un cluster AnalyticDB for MySQL et exécuter votre première requête dans SQL Lab.
Prérequis
Avant de commencer, assurez-vous de disposer des éléments suivants :
Superset version 4.1.1 ou ultérieure installé. Consultez la section Quickstart pour les instructions d'installation.
L'adresse IP du serveur Superset ajoutée à la liste d'autorisation d'adresses IP de votre cluster AnalyticDB for MySQL. Consultez la rubrique Listes d'autorisation d'adresses IP.
Connecter Superset à AnalyticDB for MySQL
Étape 1 : Rassembler les détails de connexion
Recueillez les informations suivantes avant de configurer la connexion dans Superset :
| Paramètre | Description |
|---|---|
| HOST | L'endpoint de votre cluster AnalyticDB for MySQL. Utilisez l'endpoint interne si Superset s'exécute sur une instance Elastic Compute Service (ECS) dans le même virtual private cloud (VPC) que le cluster. Utilisez l'endpoint public si Superset s'exécute sur un serveur local. |
| PORT | 3306 |
| DATABASE NAME | Le nom de la base de données dans le cluster |
| USERNAME | Le nom du compte de base de données |
| PASSWORD | Le mot de passe du compte de base de données |
| DISPLAY NAME | Un nom d'affichage pour cette connexion dans Superset |
Étape 2 : Installer le pilote MySQL (installations Python uniquement)
Ignorez cette étape si vous avez installé Superset avec Docker, car le pilote MySQL est déjà inclus dans l'image Docker.
Si vous avez installé Superset avec Python, installez manuellement le pilote MySQL. Pour connaître les options de pilotes et les commandes d'installation, consultez la section Connecting to Databases.
Étape 3 : Ajouter la connexion à la base de données
Ouvrez l'interface web de Superset. Dans le coin supérieur droit, choisissez SQL > Database Connections.
Sur la page Databases, cliquez sur +DATABASE dans le coin supérieur droit.
Dans la boîte de dialogue Connect a database, sélectionnez MySQL comme source de données.
Saisissez les détails de connexion recueillis à l'étape 1, puis cliquez sur CONNECT.
Étape 4 : Activer les autorisations SQL Lab
Dans la colonne Actions, cliquez sur l'icône
située à côté de votre nouvelle connexion.Accédez à l'onglet ADVANCED et cliquez sur SQL Lab.
Sélectionnez les opérations de base de données à autoriser. Pour cet exemple, sélectionnez Allow DDL and DML, puis cliquez sur FINISH.
Étape 5 : Exécuter une requête dans SQL Lab
Dans la barre de navigation supérieure, choisissez SQL > SQL Labs.
-
Dans le volet de gauche, configurez les paramètres suivants :
Paramètre Description DATABASE La connexion créée à l'étape 3 SCHEMA La base de données dans laquelle vous souhaitez exécuter SQL SEE TABLE SCHEMA La table que vous souhaitez interroger Dans l'éditeur de code à droite, saisissez et exécutez votre instruction SQL.
Une fois la requête exécutée, les résultats s'affichent sous l'éditeur. Votre cluster AnalyticDB for MySQL est désormais connecté et prêt à être utilisé avec Superset.