Utilisez le pilote MySQL2 pour connecter une application Node.js à LindormTable via le protocole de compatibilité MySQL. Ce guide vous explique comment installer le pilote, configurer la connexion et exécuter votre première requête.
Prérequis
Avant de commencer, vérifiez les points suivants :
La compatibilité MySQL est activée pour votre instance Lindorm. Consultez la rubrique Activer la fonctionnalité de compatibilité MySQL.
L'adresse IP de votre client figure dans la liste d'autorisation de l'instance Lindorm. Consultez la rubrique Configurer une liste d'autorisation.
Node.js est installé. Téléchargez-le depuis le site officiel de Node.js.
Installer le pilote MySQL2
Exécutez la commande suivante pour installer le pilote MySQL2 :
npm install mysql2
Se connecter à LindormTable
Étape 1 : Définir les paramètres de connexion
Stockez vos identifiants dans des variables d'environnement pour éviter d'intégrer des valeurs sensibles directement dans votre code :
export LINDORM_HOST=<your-mysql-endpoint>
export LINDORM_USER=<your-username>
export LINDORM_PASSWORD=<your-password>
Remplacez les espaces réservés par vos valeurs réelles :
| Espace réservé | Description |
|---|---|
<your-mysql-endpoint> |
L'endpoint compatible MySQL pour LindormTable. Consultez la rubrique Afficher les adresses de connexion. |
<your-username> |
Votre nom d'utilisateur LindormTable. |
<your-password> |
Votre mot de passe LindormTable. Pour réinitialiser un mot de passe oublié, consultez la rubrique Gérer les utilisateurs. |
Choisissez l'endpoint adapté à votre déploiement :
Instance ECS (recommandé) : Utilisez l'endpoint VPC (Virtual Private Cloud) pour une sécurité accrue et une latence réseau réduite. Définissez
LINDORM_HOSTsur l'adresse VPC compatible MySQL.Machine locale : Activez d'abord un endpoint public. Dans la console Lindorm, accédez à Database Connections > Wide Table Engine, puis cliquez sur Enable Public Endpoint. Définissez
LINDORM_HOSTsur l'adresse Internet compatible MySQL.
Étape 2 : Créer une connexion et exécuter une requête
L'exemple suivant établit une connexion à LindormTable et exécute une requête SHOW DATABASES :
var mysql = require('mysql2');
var connection = mysql.createConnection({
// The MySQL-compatible endpoint for LindormTable
host: process.env.LINDORM_HOST,
// The port for the MySQL protocol. Fixed value: 33060.
port: 33060,
// Your LindormTable username
user: process.env.LINDORM_USER,
// Your LindormTable password
password: process.env.LINDORM_PASSWORD,
// The database to connect to. Default: 'default'
database: 'default',
// Connection timeout in milliseconds. Default: 10000.
connectTimeout: 10000
});
connection.connect(function(err) {
if (err) {
throw err;
}
console.log("Connection established.");
connection.query('show databases', function(err1, results, fields) {
if (err1) {
throw err1;
}
console.log(fields);
console.log(results);
});
connection.end(function(err2) {
if (err2) {
throw err2;
}
console.log("Connection closed.");
});
});
Paramètres de connexion :
| Paramètre | Description | Valeur par défaut |
|---|---|---|
host |
L'endpoint compatible MySQL pour LindormTable. | — |
port |
Le port pour le protocole MySQL. Valeur fixe : 33060. |
33060 |
user |
Votre nom d'utilisateur LindormTable. | — |
password |
Votre mot de passe LindormTable. | — |
database |
La base de données à laquelle se connecter. | default |
connectTimeout |
Le délai d'expiration de la connexion, en millisecondes. | 10000 |
Étape 3 : Vérifier la connexion
Si la connexion aboutit et que votre instance ne contient que la base de données default, le résultat est le suivant :
Connection established.
Connection closed.
[ `DATABASE` VARCHAR(0) ]
[ { DATABASE: 'default' }, { DATABASE: 'information_schema' } ]
Même lorsque seule la base de données default existe, la requête renvoie deux lignes : default et information_schema.