Use o driver MySQL2 para conectar uma aplicação Node.js ao LindormTable pelo protocolo de compatibilidade MySQL. Este guia orienta a instalação do driver, a configuração da conexão e a execução da primeira consulta.
Pré-requisitos
Antes de começar, verifique se você tem:
Compatibilidade com MySQL ativada na instância Lindorm. Consulte Ative o recurso de compatibilidade com MySQL.
Endereço IP do cliente adicionado à lista de permissões da instância Lindorm. Consulte Configurar uma lista de permissões.
Node.js instalado. Baixe-o no site oficial do Node.js.
Instale o driver MySQL2
Execute o comando a seguir para instalar o driver MySQL2:
npm install mysql2
Conecte-se ao LindormTable
Etapa 1: Defina os parâmetros de conexão
Armazene as credenciais em variáveis de ambiente para evitar codificar valores sensíveis diretamente no código:
export LINDORM_HOST=<your-mysql-endpoint>
export LINDORM_USER=<your-username>
export LINDORM_PASSWORD=<your-password>
Substitua os espaços reservados pelos valores reais:
|
Espaço reservado |
Descrição |
|
|
Endpoint compatível com MySQL do LindormTable. Consulte Visualize endereços de conexão. |
|
|
Nome de usuário do LindormTable. |
|
|
Senha do LindormTable. Para redefinir uma senha esquecida, consulte Gerencie usuários. |
Escolha o endpoint adequado para sua implantação:
Instância ECS (recomendado): Use o endpoint de virtual private cloud (VPC) para obter maior segurança e menor latência de rede. Defina
LINDORM_HOSTcomo o endereço VPC compatível com MySQL.Máquina local: Ative primeiro um endpoint público. No console Lindorm, acesse Database Connections > Wide Table Engine e clique em Enable Public Endpoint. Defina
LINDORM_HOSTcomo o endereço de Internet compatível com MySQL.
Etapa 2: Crie uma conexão e execute uma consulta
O exemplo a seguir cria uma conexão com o LindormTable e executa uma 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 conexão:
|
Parâmetro |
Descrição |
Padrão |
|
|
Endpoint compatível com MySQL do LindormTable. |
— |
|
|
Porta do protocolo MySQL. Valor fixo: |
|
|
|
Nome de usuário do LindormTable. |
— |
|
|
Senha do LindormTable. |
— |
|
|
Banco de dados de destino da conexão. |
|
|
|
Tempo limite de conexão, em milissegundos. |
|
Etapa 3: Verifique a conexão
Se a conexão for bem-sucedida e a instância contiver apenas o banco de dados default, a saída será:
Connection established.
Connection closed.
[ `DATABASE` VARCHAR(0) ]
[ { DATABASE: 'default' }, { DATABASE: 'information_schema' } ]
Mesmo quando existe apenas o banco de dados default, a consulta retorna duas linhas: default e information_schema.