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

Si votre application utilise déjà l'écosystème MySQL, vous pouvez vous connecter à LindormTable via le protocole MySQL sans installer de pilotes supplémentaires. Cela vous permet d'utiliser des clients MySQL standards et Lindorm SQL pour créer des bases de données, gérer des tables et lire ou écrire des données.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Une instance Lindorm exécutant LindormTable version 2.6.0 ou ultérieure. Pour vérifier ou mettre à niveau la version, consultez les Notes de version de LindormTable et la procédure de Mise à niveau de la version du moteur mineur d'une instance Lindorm.
L'adresse IP du client ajoutée à la liste d'autorisation de l'instance Lindorm. Consultez la section Configuration des listes d'autorisation.
La fonctionnalité de compatibilité MySQL activée pour l'instance. Consultez la section Activation de la fonctionnalité de compatibilité MySQL.
Une bonne connaissance des exigences de développement liées au protocole MySQL. Consultez les Remarques sur le développement d'applications utilisant MySQL.

Installer un client MySQL

Linux

Exécutez l'une des commandes suivantes selon votre gestionnaire de packages :

APT (Advanced Package Tool) :
```
sudo apt-get install mysql-client
```
Outil de gestion de packages Yum :
```
sudo yum install mysql
```

macOS

Installez-le avec Homebrew :

brew install mysql-client

Windows

Téléchargez et exécutez le programme d'installation disponible sur la page MySQL Downloads.

Se connecter à LindormTable

Étape 1 : Obtenir le point de terminaison de connexion

L'URL MySQL correspond à l'adresse SQL de la table large Lindorm affichée dans la console Lindorm, sans les deux-points ni le numéro de port finaux.

Type de connexion	Cas d'utilisation	Comment obtenir le point de terminaison
VPC (recommandé)	Application s'exécutant sur une instance Elastic Compute Service (ECS)	Utilisez directement le point de terminaison VPC. Les connexions via un réseau privé virtuel (VPC) offrent une latence plus faible et une sécurité accrue.
Réseau public	Application s'exécutant en dehors d'Alibaba Cloud	Dans la console, accédez à Database Connections > Wide Table Engine. Sous l'onglet Wide Table Engine, cliquez sur Enable Public Endpoint, puis utilisez le point de terminaison public.

Étape 2 : Exécuter la commande de connexion

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

Remarque

Le paramètre --get-server-public-key permet d'éviter l'erreur suivante : Authentication plugin 'caching_sha2_password' reported error: Authentication requires secure connection.

Remplacez les espaces réservés par vos valeurs réelles :

Paramètre	Description	Exemple
`<mysql-url>`	L'adresse SQL de la table large Lindorm obtenue depuis la console, sans les deux-points ni le numéro de port finaux	`ld-uf6k8yqb741t3****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com`
`<username>`	Le nom d'utilisateur pour LindormTable	`test`
`<password>`	Le mot de passe associé au nom d'utilisateur	`test`
`<database>`	La base de données à laquelle se connecter. La valeur par défaut est `default` si aucun paramètre n'est spécifié	`default`

Remarques sur la compatibilité avec MySQL 8.0 et versions antérieures

Les outils en ligne de commande MySQL version 8.0 et antérieures présentent deux problèmes de compatibilité avec Lindorm. Appliquez la correction appropriée avant de vous connecter.

Incompatibilité de version TLS

MySQL 8.0 et les versions antérieures utilisent TLSv1.1 par défaut pour les connexions chiffrées. Lindorm prend en charge TLSv1.2, ce qui peut entraîner un échec de la négociation TLS. Ajoutez --ssl-mode=DISABLED pour forcer une connexion en texte clair :

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

Important

Utilisez les connexions en texte clair sur Internet avec prudence.

Incompatibilité de protocole d'authentification

MySQL 8.0 et les versions antérieures utilisent mysql_native_password par défaut et ne prennent pas en charge caching_sha2_password. L'authentification peut échouer en raison des exigences de version de LindormTable pour le protocole MySQL. Ajoutez --enable_cleartext_plugin pour transmettre le mot de passe en texte clair :

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

Important

Utilisez la transmission de mots de passe en texte clair sur Internet avec prudence.

Exécuter des opérations de base

Les exemples suivants utilisent Lindorm SQL pour créer une base de données, créer une table, insérer des données et interroger des données.

Créez une base de données nommée test1 :
```
CREATE DATABASE test1;
```
Basculez vers la base de données test1 :
```
USE test1;
```

Créez une table et insérez une ligne :

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

Interrogez les données :

SELECT * FROM tb;

Sortie attendue :

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

Étapes suivantes

Consultez les Remarques sur le développement d'applications utilisant MySQL pour en savoir plus sur la syntaxe SQL prise en charge et les limitations connues avant d'écrire le code de votre application.
Consultez les Notes de version de LindormTable pour vérifier les dernières fonctionnalités et les exigences de version.