Connect to and use LindormTable by using the MySQL command line - Lindorm

Si su aplicación ya utiliza el ecosistema de MySQL, puede conectarse a LindormTable mediante el protocolo de MySQL sin instalar controladores adicionales. Esto le permite usar clientes estándar de MySQL y Lindorm SQL para crear bases de datos, gestionar tablas, y leer y escribir datos.

Requisitos previos

Antes de empezar, asegúrese de contar con lo siguiente:

Una instancia de Lindorm que ejecute LindormTable 2.6.0 o posterior. Para comprobar o actualizar la versión, consulte Release notes of LindormTable y Upgrade the minor engine version of a Lindorm instance.
La dirección IP del cliente agregada a la lista blanca de la instancia de Lindorm. Consulte Configure whitelists.
La función de compatibilidad con MySQL habilitada en la instancia. Consulte Enable the MySQL compatibility feature.
Conocimiento sobre los requisitos de desarrollo del protocolo de MySQL. Consulte Usage notes for application development using MySQL.

Instalar un cliente de MySQL

Linux

Ejecute uno de los siguientes comandos según su administrador de paquetes:

APT (Advanced Package Tool):
```
sudo apt-get install mysql-client
```
Herramienta de administración de paquetes Yum:
```
sudo yum install mysql
```

macOS

Instale con Homebrew:

brew install mysql-client

Windows

Descargue y ejecute el instalador desde Descargas de MySQL.

Conectarse a LindormTable

Paso 1: Obtener el endpoint de conexión

La URL de MySQL corresponde al valor de Lindorm Wide Table SQL Address que se muestra en la consola de Lindorm, pero sin los dos puntos ni el número de puerto al final.

Tipo de conexión	Cuándo usarla	Cómo obtener el endpoint
VPC (recomendado)	La aplicación se ejecuta en una instancia de Elastic Compute Service (ECS).	Use directamente el endpoint de VPC. Las conexiones de nube privada virtual (VPC) ofrecen menor latencia y mayor seguridad.
Red pública	La aplicación se ejecuta fuera de Alibaba Cloud.	En la consola, vaya a Database Connections > Wide Table Engine. En la pestaña Wide Table Engine, haga clic en Enable Public Endpoint y luego use el endpoint público.

Paso 2: Ejecutar el comando de conexión

mysql --get-server-public-key -h<mysql-url> -P33060 -u<username> -p<password> -D<database>

Nota

El parámetro --get-server-public-key evita el error Authentication plugin 'caching_sha2_password' reported error: Authentication requires secure connection.

Reemplace los marcadores de posición con sus valores reales:

Parámetro	Descripción	Ejemplo
`<mysql-url>`	El valor de Lindorm Wide Table SQL Address de la consola, sin los dos puntos ni el número de puerto al final.	`ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com`
`<username>`	El nombre de usuario para LindormTable.	`test`
`<password>`	La contraseña del nombre de usuario.	`test`
`<database>`	La base de datos a la que desea conectarse. Si no se especifica, toma el valor predeterminado `default`.	`default`

Notas de compatibilidad para MySQL 8.0 y versiones anteriores

Las herramientas de línea de comandos de MySQL 8.0 y versiones anteriores presentan dos problemas de compatibilidad con Lindorm. Aplique la corrección correspondiente antes de conectarse.

Incompatibilidad de versión de TLS

MySQL 8.0 y las versiones anteriores usan TLSv1.1 de forma predeterminada para las conexiones cifradas. Lindorm es compatible con TLSv1.2, lo cual puede provocar un fallo en el handshake de TLS. Agregue --ssl-mode=DISABLED para forzar una conexión en texto plano:

mysql --ssl-mode=DISABLED --get-server-public-key -h<mysql-url> -P33060 -u<username> -p<password> -D<database>

Importante

Tenga precaución al usar conexiones en texto plano a través de Internet.

Incompatibilidad de protocolo de autenticación

MySQL 8.0 y las versiones anteriores usan mysql_native_password de forma predeterminada y no son compatibles con caching_sha2_password. La autenticación podría fallar debido a los requisitos de versión del protocolo de MySQL en LindormTable. Agregue --enable_cleartext_plugin para enviar la contraseña en texto plano:

mysql --enable_cleartext_plugin --get-server-public-key -h<mysql-url> -P33060 -u<username> -p<password> -D<database>

Importante

Tenga precaución al transmitir contraseñas en texto plano a través de Internet.

Ejecutar operaciones básicas

A continuación se muestran ejemplos con Lindorm SQL para crear una base de datos, crear una tabla, insertar datos y consultarlos.

Cree una base de datos llamada test1:
```
CREATE DATABASE test1;
```
Cambie a la base de datos test1:
```
USE test1;
```

Cree una tabla e inserte una fila:

CREATE TABLE tb (id varchar, name varchar, address varchar, PRIMARY KEY (id, name));
UPSERT INTO tb (id, name, address) VALUES ('001', 'jack', 'hz');

Consulte los datos:

SELECT * FROM tb;

Resultado esperado:

+------+------+---------+
| id   | name | address |
+------+------+---------+
| 001  | jack | hz      |
+------+------+---------+

Pasos siguientes

Usage notes for application development using MySQL: conozca la sintaxis SQL compatible y las limitaciones conocidas antes de escribir el código de su aplicación.
Release notes of LindormTable: revise las funciones más recientes y los requisitos de versión.