Use el controlador MySQL2 para conectar una aplicación de Node.js a LindormTable mediante el protocolo de compatibilidad con MySQL. Esta guía le muestra cómo instalar el controlador, configurar la conexión y ejecutar su primera consulta.
Requisitos previos
Antes de empezar, asegúrese de contar con lo siguiente:
La compatibilidad con MySQL habilitada en su instancia de Lindorm. Consulte Habilitar la función de compatibilidad con MySQL.
Su dirección IP de cliente agregada a la lista blanca de la instancia de Lindorm. Consulte Configurar una lista blanca.
Node.js instalado. Descárguelo desde el sitio oficial de Node.js.
Instalación del controlador MySQL2
Ejecute el siguiente comando para instalar el controlador MySQL2:
npm install mysql2
Conexión a LindormTable
Paso 1: Establecer los parámetros de conexión
Almacene sus credenciales en variables de entorno para evitar codificar valores sensibles directamente en el código:
export LINDORM_HOST=<your-mysql-endpoint>
export LINDORM_USER=<your-username>
export LINDORM_PASSWORD=<your-password>
Reemplace los marcadores de posición con sus valores reales:
|
Marcador de posición |
Descripción |
|
|
El endpoint compatible con MySQL para LindormTable. Consulte View connection addresses. |
|
|
Su nombre de usuario de LindormTable. |
|
|
Su contraseña de LindormTable. Para restablecer una contraseña olvidada, consulte Manage users. |
Elija el endpoint adecuado para su despliegue:
Instancia de ECS (recomendado): Use el endpoint de la red privada virtual (VPC) para obtener mayor seguridad y menor latencia de red. Establezca
LINDORM_HOSTcon la dirección VPC compatible con MySQL.Computadora local: Habilite primero un endpoint público. En la consola de Lindorm, vaya a Database Connections > Wide Table Engine y luego haga clic en Enable Public Endpoint. Establezca
LINDORM_HOSTcon la dirección de Internet compatible con MySQL.
Paso 2: Crear una conexión y ejecutar una consulta
El siguiente ejemplo crea una conexión a LindormTable y ejecuta la consulta 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.");
});
});
Parámetros de conexión:
|
Parámetro |
Descripción |
Valor predeterminado |
|
|
El endpoint compatible con MySQL para LindormTable. |
— |
|
|
El puerto para el protocolo MySQL. Valor fijo: |
|
|
|
Su nombre de usuario de LindormTable. |
— |
|
|
Su contraseña de LindormTable. |
— |
|
|
La base de datos a la que se conecta. |
|
|
|
El tiempo de espera de la conexión, en milisegundos. |
|
Paso 3: Comprobar la conexión
Si la conexión es exitosa y su instancia solo contiene la base de datos default, la salida es a continuación:
Connection established.
Connection closed.
[ `DATABASE` VARCHAR(0) ]
[ { DATABASE: 'default' }, { DATABASE: 'information_schema' } ]
Incluso cuando solo existe la base de datos default, la consulta devuelve dos filas: default e information_schema.