Connect to LindormTable using Lindorm-cli - Lindorm - Centre de documentation Alibaba Cloud

Prérequis

Nous définissons l'environnement dans lequel vous exécutez lindorm-cli comme l'environnement client. Avant d'utiliser lindorm-cli pour accéder au moteur de table large Lindorm, confirmez les points suivants :

Ajoutez l'adresse IP du client à la liste d'autorisation Lindorm. Pour plus d'informations, consultez la section Configurer une liste d'autorisation.

Déterminez le type de réseau entre l'environnement client et Lindorm.

Les types de réseau suivants sont pris en charge lors de la connexion au moteur de table large avec lindorm-cli :

Type de réseau	Description
Virtual private cloud (VPC) (recommandé)	Un Virtual Private Cloud (VPC) est votre réseau privé dans le cloud. Les différents VPC sont isolés au niveau de la couche 2, ce qui offre une sécurité élevée. Lorsque vous déployez lindorm-cli sur une instance ECS, la connexion au moteur de table large Lindorm via un VPC offre une sécurité accrue et une latence réseau réduite.
Réseau public	Le réseau public désigne Internet. Lorsque vous devez tester ou gérer le moteur de table large Lindorm depuis un appareil local, déployez lindorm-cli sur l'appareil local et connectez-vous au moteur de table large Lindorm via le réseau public. Remarque La connexion via le réseau public n'entraîne pas de frais de trafic, mais présente un risque de sécurité. Nous recommandons l'utilisation d'un VPC pour une sécurité optimale. Vous devez activer le point de terminaison public dans la console. Pour plus d'informations, consultez la section Procédure.

Installation

Téléchargez le package d'installation de Lindorm-cli correspondant à votre système d'exploitation. Les liens de téléchargement sont répertoriés dans le tableau suivant.

Remarque

Les sommes de contrôle SHA256 du tableau peuvent être utilisées pour vérifier l'intégrité et l'authenticité des packages Lindorm-cli téléchargés.

Système d'exploitation	Lien de téléchargement	Somme de contrôle SHA256
Linux	lindorm-cli for linux Commande de téléchargement direct : `wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/lindorm-cli-linux-latest.tar.gz`	fdd0cdece2a3d29124dd9538edefdd66532b950653f049d6b4fd6a21cb2cd6fc
Linux-arm64	lindorm-cli for linux-arm64 Commande de téléchargement direct : `wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz`	bd602405a2e988cf77d6b3afa2aac35ce72b437038119f4b3a9d926d3ffb5be1
Mac (puce Intel)	lindorm-cli for mac	cfff2a661fe6d48e0d55dbfca149847a3b8c0ef391d59e4694a425a22a44f5be
Mac (puce Arm)	lindorm-cli for mac	1aae53cf83ad40a7386ea5711684d733e9728566c3f7463d00070a56201b79dc
Windows	lindorm-cli for windows-x64	cf2330fac41cc3d731282cd8dddfd5656ad05c1f8e1113607cf427d0614b23b6

Décompressez le package Lindorm-cli.

Utilisez la méthode de décompression standard de votre système d'exploitation pour extraire le package téléchargé.

Pour Linux, exécutez la commande suivante pour décompresser le package. Après la décompression, vous obtenez le fichier lindorm-cli. Ce fichier exécutable peut être lancé directement dans un terminal shell sans étapes d'installation supplémentaires.
```
tar zxvf lindorm-cli-linux-latest.tar.gz
```

Méthodes de connexion

Lindorm-cli prend en charge la connexion au moteur de table large Lindorm via le protocole MySQL, le protocole Avatica ou le protocole natif HBase. Nous recommandons l'utilisation du protocole MySQL.

Important

Seules les versions de lindorm-cli 2.0.0 et ultérieures prennent en charge la connexion au moteur de table large via le protocole MySQL.

Seules les versions de lindorm-cli 2.4.0 et ultérieures prennent en charge la connexion au moteur de table large via le protocole HBase.

Se connecter au moteur de table large via le protocole MySQL (recommandé)

Client déployé sur Linux ou Mac

Accédez au répertoire contenant Lindorm-cli.
```
cd <Lindorm-cli directory>
```

Exécutez la commande suivante pour vous connecter au moteur de table large.

./lindorm-cli -url <mysql url> -username <username> -password <password>

Description des paramètres

Paramètre	Description
mysql url	Le point de terminaison compatible MySQL du moteur de table large Lindorm. Pour plus de détails sur la configuration de la connexion, consultez la section Configuration de la connexion.
username	Le nom d'utilisateur pour la connexion au moteur de table large Lindorm.
password	Le mot de passe pour la connexion au moteur de table large Lindorm. Important Si vous avez oublié votre mot de passe, vous pouvez réinitialiser le mot de passe de l'utilisateur dans le système de gestion du cluster du moteur de table large Lindorm. Après avoir réinitialisé le mot de passe, redémarrez le moteur dans la console.

Configuration de la connexion

Configurations de connexion prises en charge

Description

mysql:// en-tête de protocole

Vous pouvez faire précéder l'en-tête de protocole mysql:// à l'URL MySQL.

Exemple : mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060.

Paramètres de connexion personnalisés côté serveur

Vous pouvez ajouter des paramètres de connexion personnalisés côté serveur à l'URL MySQL au format key1=value1&key2=value2.

Le paramètre suivant est actuellement pris en charge :

operationTimeout : spécifie le délai d'expiration de la requête. Le format est <mysql url>?operationTimeout=<timeout>, où l'unité du délai d'expiration est la milliseconde (ms). Exemple : ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000.

Important

Seules les versions 2.7.7 et ultérieures du moteur de table large prennent en charge le paramètre operationTimeout. Pour savoir comment afficher ou mettre à niveau votre version actuelle, consultez le Guide des versions du moteur de table large et la rubrique Mise à jour des versions mineures.

Exemples de connexion

./lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Add mysql:// protocol header
./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Specify query timeout
./lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

Une connexion réussie renvoie le résultat suivant :

lindorm-cli version: 2.0.x

Ici, 2.0.x correspond au numéro de version de Lindorm-cli.

Client déployé sur Windows

Méthode 1

Ouvrez l'invite de commandes (CMD) et accédez au répertoire contenant lindorm-cli.exe.
```
cd <lindorm-cli.exe directory>
```

Exécutez la commande suivante dans CMD pour vous connecter au moteur de table large.

lindorm-cli -url <mysql url> -username <username> -password <password>

Description des paramètres

Paramètre	Valeur d'exemple	Comment l'obtenir
mysql url	ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060	Le point de terminaison compatible MySQL du moteur de table large Lindorm. Pour plus de détails sur la configuration de la connexion, consultez la section Configuration de la connexion.
username	user	Le nom d'utilisateur permettant de se connecter au moteur de table large Lindorm.
password	test	Le mot de passe permettant de se connecter au moteur de table large Lindorm. Important Si vous avez oublié votre mot de passe, vous pouvez réinitialiser le mot de passe de l'utilisateur dans le système de gestion du cluster du moteur de table large Lindorm. Après avoir réinitialisé le mot de passe, redémarrez le moteur dans la console.

Configuration de la connexion

Configurations de connexion prises en charge

Description

mysql:// en-tête de protocole

Vous pouvez faire précéder l'en-tête de protocole mysql:// à l'URL MySQL.

Exemple : mysql://ld-8vbn68478unu8****-proxy-sql-lindorm.lindorm.rds.aliyuncs.com:33060.

Paramètres de connexion personnalisés côté serveur

Vous pouvez ajouter des paramètres de connexion personnalisés côté serveur à l'URL MySQL au format key1=value1&key2=value2.

Les paramètres pris en charge sont les suivants :

operationTimeout : spécifie le délai d'expiration de la requête. Le format est <mysql url>?operationTimeout=<timeout>, où l'unité du délai d'expiration est la milliseconde (ms). Exemple : ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000.

Important

Seules les versions 2.7.7 et ultérieures du moteur de table large prennent en charge le paramètre operationTimeout. Pour savoir comment afficher ou mettre à niveau votre version actuelle, consultez le Guide des versions du moteur de table large et la rubrique Mise à jour des versions mineures.

Exemples de connexion

lindorm-cli -url ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Add mysql:// protocol header
lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password test

--Specify query timeout
lindorm-cli -url mysql://ld-bp187uwcx5f40****-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060?operationTimeout=120000 -username user -password test

Une connexion réussie renvoie le résultat suivant :

Connected to ld-bp187uwcx5f40****-proxy-sql-lindorm-public.lindorm.rds.aliyuncs.com:33060
lindorm-cli version: 2.0.x

Ici, 2.0.x correspond au numéro de version de Lindorm-cli.

Méthode 2

Double-cliquez pour ouvrir le programme Lindorm-cli.exe et exécutez la commande suivante :

connect <mysql url> <username> <password>

Exemple de connexion

connect ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:33060  user test

Une connexion réussie ne renvoie aucune sortie.

Connexion au moteur de tables larges via le protocole Avatica

Client déployé sur Linux ou Mac

Accédez au répertoire contenant Lindorm-cli.
```
cd <Lindorm-cli directory>
```

Exécutez la commande suivante pour vous connecter au moteur de tables larges.

./lindorm-cli -url <url> -username <username> -password <password>

Description des paramètres

Paramètre	Valeur d'exemple	Méthode d'obtention
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	Le endpoint SQL de table large du moteur de tables larges Lindorm.
username	user	Le nom d'utilisateur permettant de se connecter au moteur de tables larges Lindorm.
password	test	Le mot de passe permettant de se connecter au moteur de tables larges Lindorm. Important Si vous avez oublié votre mot de passe, vous pouvez réinitialiser le mot de passe utilisateur dans le système de gestion de cluster du moteur de tables larges Lindorm. Après la réinitialisation du mot de passe, redémarrez le moteur depuis la console.

Exemple de connexion

./lindorm-cli -url jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060 -username user -password test

Une connexion réussie renvoie le résultat suivant :

lindorm-cli version: 2.0.xx

Ici, 2.0.xx correspond au numéro de version de Lindorm-cli.

Client déployé sur Windows

Méthode 1

Ouvrez l'invite de commandes (CMD) et accédez au répertoire contenant lindorm-cli.exe.
```
cd <lindorm-cli.exe directory>
```

Exécutez la commande suivante dans CMD pour vous connecter au moteur de tables larges.

lindorm-cli -url <jdbc url> -username <username> -password <password>

Description des paramètres

Paramètre	Valeur d'exemple	Méthode d'obtention
jdbc url	jdbc:lindorm:table:url=http://ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060	Le endpoint SQL de table large du moteur de tables larges Lindorm.
username	user	Le nom d'utilisateur permettant de se connecter au moteur de tables larges Lindorm.
password	test	Le mot de passe permettant de se connecter au moteur de tables larges Lindorm. Important Si vous avez oublié votre mot de passe, vous pouvez réinitialiser le mot de passe utilisateur dans le système de gestion de cluster du moteur de tables larges Lindorm. Après la réinitialisation du mot de passe, redémarrez le moteur depuis la console.

Exemple de connexion

lindorm-cli -url jdbc:lindorm:table:url=http://ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:30060 -username user -password test

Une connexion réussie renvoie le résultat suivant :

Connected to jdbc:lindorm:table:url=http://ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30060
lindorm-cli version: 2.0.xx

Ici, 2.0.xx correspond au numéro de version de Lindorm-cli.

Méthode 2

Double-cliquez pour ouvrir le programme Lindorm-cli.exe et exécutez la commande suivante :

connect <jdbc url> <username> <password>

Exemple de connexion

connect jdbc:lindorm:table:url=http://ld-bp13y790c91f4****-proxy-lindorm-pub.lindorm.aliyuncs.com:30060 user test

Aucune sortie n'est affichée en cas de connexion réussie.

Connexion au moteur de tables larges via le protocole natif HBase

Important

Seules les versions de lindorm-cli 2.4.0 et ultérieures supportent la connexion au moteur de tables larges via le protocole HBase.

Quand utiliser le mode HBase

Dans la plupart des scénarios, nous recommandons d'utiliser le protocole MySQL (ou protocole Avatica) pour accéder au moteur de tables larges via SQL : SQL prend en charge l'ensemble des fonctionnalités des tables larges (index secondaires, requêtes multicolumnes, agrégation, pagination, etc.) avec un écosystème et une chaîne d'outils plus riches.

Le mode HBase est recommandé uniquement dans les scénarios suivants :

Migration de données depuis HBase open source : Vos tables et vos données étaient initialement stockées dans HBase open source et ont été migrées vers le moteur de tables larges Lindorm à l'aide d'outils tels que LTS.
Habitudes ou scripts HBase existants : Vous maîtrisez la syntaxe des commandes HBase Shell (create, put, get, scan, describe, etc.) et souhaitez utiliser ces commandes directement sans les réécrire en SQL.
Gestion des tables de style HBase : Vous devez effectuer des opérations telles que la définition des attributs de famille de colonnes ou la gestion des namespaces.

Méthode de connexion

Le mode HBase utilise le format d'URL dédié hbase://<host>:<port> :

./lindorm-cli -url "hbase://<host>:30020" -username <username>

Le préfixe hbase:// est obligatoire. Contrairement au protocole MySQL où le préfixe mysql:// est facultatif, l'omission du préfixe hbase:// entraîne l'interprétation de la connexion comme étant du protocole MySQL au lieu du mode HBase.

Le mot de passe est facultatif en mode HBase. Si l'authentification est requise, transmettez-le via le paramètre -password ou la variable d'environnement LINDORM_PASSWORD.

Après une connexion réussie, vous pouvez saisir directement les commandes HBase Shell dans l'interface interactive. Les commandes HBase ne se terminent pas par un point-virgule (;). Appuyez sur Entrée pour exécuter chaque commande.

Utilisation

Lindorm-cli prend en charge les modes interactif et non interactif pour l'exécution d'instructions SQL sur le moteur de table large.

Exécuter des instructions SQL en mode interactif

Dans la plupart des cas, vous démarrez lindorm-cli en mode interactif pour utiliser le moteur de table large. Le flux de travail est le suivant :

Démarrer lindorm-cliAprès vous être connecté au moteur de table large Lindorm à l'aide de n'importe quel protocole décrit dans la section précédente, votre terminal accède à l'interface interactive de lindorm-cli et attend d'autres commandes.

Remarque
Sous Windows, un double-clic sur lindorm-cli.exe ouvre une fenêtre de terminal CMD. Cette action démarre l'interface interactive de lindorm-cli, mais n'établit pas de connexion au moteur de table large Lindorm. Vous devez utiliser la sous-commande connect pour établir une connexion avant d'exécuter des instructions SQL. Pour plus d'informations, consultez Client déployé sous Windows et Méthode 2.
Saisir des instructions SQL pour accéder au moteur de table largeUne fois la connexion établie et l'interface interactive ouverte, saisissez des instructions SQL pour accéder au moteur de table large. Pour connaître la syntaxe SQL prise en charge, consultez la rubrique Référence SQL.
Quitter lindorm-cliUne fois vos opérations terminées dans l'interface interactive, quittez lindorm-cli en exécutant la sous-commande exit ou en utilisant le raccourci clavier ctrl+d.

Remarque

Après avoir démarré lindorm-cli en mode interactif et établi avec succès une connexion au moteur de table large, le client maintient une session avec le moteur jusqu'à ce que vous quittiez. Toutes les opérations SQL effectuées durant cette période s'exécutent au sein de la même session. Notez que si la session reste inactive trop longtemps, le système interrompt automatiquement la connexion afin de libérer les ressources.

Exécuter des instructions SQL en mode non interactif

Lors de la rédaction de scripts d'exploitation et de maintenance, vous pouvez utiliser le mode non interactif de lindorm-cli pour travailler avec LindormTable sans passer par la ligne de commande interactive. Ce mode exécute directement les instructions SQL via des paramètres de commande et renvoie les résultats, ce qui le rend adapté aux tâches automatisées telles que les requêtes ou les opérations statistiques.

Pour exécuter une instruction SQL en mode non interactif depuis un terminal shell, ajoutez le paramètre -execute suivi de l'instruction SQL entre guillemets simples ou doubles aux paramètres de connexion (tels que l'adresse hôte et le port) décrits dans la section Méthodes de connexion. Cela permet d'établir rapidement une connexion éphémère et d'exécuter la commande. Exemple :

lindorm-cli -url mysql://ld-xxxxxx-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password XXXX -execute "CREATE TABLE tb (id VARCHAR, name VARCHAR, address VARCHAR,  PRIMARY KEY(id, name));"

Vous pouvez également exporter les résultats des requêtes du moteur de table large vers un fichier CSV en utilisant le mode non interactif.

Important

L'exportation vers un fichier CSV nécessite une version de lindorm-cli égale ou supérieure à 2.2.0. Pour vérifier votre version actuelle :

Exécutez lindorm-cli -version dans la ligne de commande.
Vérifiez la version affichée dans le message de bienvenue lors de l'accès au mode interactif.

lindorm-cli -url mysql://ld-xxxxxx-proxy-lindorm-vpc.lindorm.aliyuncs.com:33060 -username user -password XXXX -format csv -output ~/result.csv -execute "SELECT * FROM tb;"

Remarque

Connexions éphémères : en mode non interactif, lindorm-cli établit une nouvelle connexion pour chaque instruction SQL et la ferme immédiatement après l'exécution.
Contrôle de la sortie : par défaut, les résultats sont affichés sur l'écran du terminal (stdout). Pour rediriger la sortie vers un fichier, utilisez le paramètre -output.

Utiliser lindorm-cli avec un agent IA

Outre les modes interactif et non interactif, lindorm-cli peut également être invoqué par des agents IA. Lorsque vous souhaitez utiliser le langage naturel pour permettre à un agent IA d'effectuer automatiquement des requêtes de données Lindorm, d'analyser les résultats ou de générer des scripts d'exploitation et de maintenance, vous pouvez combiner Lindorm Agent Skill avec lindorm-cli.

Remarque

Les fonctionnalités orientées agent IA décrites ci-dessous nécessitent une version de lindorm-cli égale ou supérieure à 2.3.0.

Scénarios

L'utilisation de lindorm-cli via un agent IA convient aux scénarios suivants :

Requêtes de données en langage naturel : décrivez votre intention de requête en langage naturel. L'agent génère et exécute les instructions SQL, puis renvoie des résultats structurés.
Génération de scripts d'exploitation et de maintenance par lots : laissez l'agent générer des scripts appelant lindorm-cli en fonction de vos besoins pour les tâches planifiées ou le traitement de données par lots.
Exportation de résultats structurés : utilisez l'agent pour exporter les résultats des requêtes directement dans des formats analysables par machine, tels que JSON ou JSONL, pour un traitement en aval.

Installer Lindorm Agent Skill

Lindorm Agent Skill fournit aux agents IA le contexte nécessaire pour appeler lindorm-cli. Il guide l'agent afin qu'il détecte automatiquement l'installation locale de lindorm-cli, sélectionne les paramètres appropriés et construise les commandes.

Vous pouvez télécharger Lindorm Agent Skill à l'adresse suivante : alibabacloud-lindorm-agent-skill

Après l'installation, l'agent peut appeler lindorm-cli pour accéder directement au moteur de table large Lindorm lors des conversations. La compétence Skill intègre les fonctionnalités et les paramètres CLI décrits ci-dessous, de sorte que vous n'avez généralement pas besoin de saisir ces paramètres manuellement.

Utilisation de l'agent

Après avoir installé Lindorm Agent Skill, il vous suffit de décrire vos besoins en langage naturel. L'agent effectue automatiquement la détection, les requêtes, les contrôles de sécurité et l'injection des identifiants sous la direction de la compétence Skill.

Détection automatique des capacités de lindorm-cli par l'agent

Avant le premier appel, l'agent détecte la version de lindorm-cli, les protocoles pris en charge, les formats de sortie et les définitions des codes de sortie dans l'environnement actuel. Cela permet à l'agent de choisir la méthode d'appel correcte en fonction de l'environnement réel, plutôt que de s'appuyer sur des hypothèses codées en dur.

Remarque

Ce comportement est intégré à Lindorm Agent Skill et correspond au paramètre --capabilities de lindorm-cli.

Restitution des résultats par l'agent au format structuré

Lorsque l'agent exécute une requête, il exige que lindorm-cli produise les résultats au format JSON ou JSONL. Seules les données résultant de la requête sont envoyées vers stdout ; les messages d'état et les avertissements sont dirigés vers stderr. Les deux flux sont isolés pour faciliter l'analyse par l'agent.

Pour les grands ensembles de résultats, l'agent utilise le format JSONL pour consommer les résultats ligne par ligne, évitant ainsi de charger toutes les données en une seule fois.

Remarque

Ce comportement est intégré à Lindorm Agent Skill et correspond aux paramètres -format json et -format jsonl de lindorm-cli.

Activation des garde-fous de sécurité par l'agent

Lindorm Agent Skill active le mode sécurisé par défaut, interceptant côté client les opérations d'écriture à haut risque telles que DROP TABLE, TRUNCATE TABLE et DELETE FROM, afin d'empêcher l'agent d'exécuter accidentellement des instructions SQL destructrices. La compétence Skill limite également le nombre maximal de lignes renvoyées par requête pour éviter que de grands ensembles de résultats n'épuisent la fenêtre de contexte de l'agent.

Remarque

Ce comportement est intégré à Lindorm Agent Skill et correspond aux paramètres --safe-mode et --max-rows de lindorm-cli.

Injection sécurisée des identifiants par l'agent

Lorsque l'agent appelle lindorm-cli, la compétence Skill privilégie l'injection des noms d'utilisateur et des mots de passe via des variables d'environnement ou l'entrée standard, empêchant ainsi les identifiants d'apparaître dans les arguments de la ligne de commande, l'historique Shell ou les listes de processus.

Remarque

Ce comportement est intégré à Lindorm Agent Skill et correspond à l'injection d'identifiants via des variables d'environnement ainsi qu'au paramètre --password-stdin de lindorm-cli.

Paramètres et sous-commandes de la ligne de commande

Paramètres de la ligne de commande

Lors du démarrage de lindorm-cli dans un terminal, vous pouvez spécifier les paramètres de ligne de commande suivants :

Nom du paramètre	Valeur requise	Valeur	Description
url	Oui	Nom du protocole + chaîne de connexion SQL (incluant le port) pour le moteur de table large Lindorm	Spécifie le protocole et la chaîne de connexion permettant à lindorm-cli de se connecter au moteur de table large. Lors de l'utilisation du protocole MySQL, spécifiez le endpoint compatible MySQL du moteur de table large. Lors de l'utilisation du protocole Avatica, spécifiez l'endpoint SQL de table large du moteur de table large.
username	Oui	Nom d'utilisateur pour la connexion	Le nom d'utilisateur spécifié doit être un utilisateur Lindorm déjà créé dans le moteur de table large.
password	Oui	Mot de passe associé au nom d'utilisateur	-
database	Oui	Nom de la base de données à laquelle se connecter	Si ce paramètre n'est pas spécifié, la base de données par défaut est utilisée. S'il est spécifié, la base de données doit déjà exister dans le moteur de table large.
execute	Oui	Instruction SQL à exécuter	Lorsque le paramètre execute est spécifié, lindorm-cli s'exécute en mode non interactif. Placez l'instruction SQL entre guillemets simples ou doubles. Remarque Lors de l'utilisation de guillemets doubles pour entourer l'instruction SQL, échappez les guillemets doubles internes avec une barre oblique inverse `\`. Les guillemets simples ne prennent pas en charge l'échappement.
output	Oui	Emplacement de sortie des résultats d'exécution SQL en mode non interactif	En mode non interactif, si output n'est pas spécifié, les résultats sont affichés sur la sortie standard. S'il est spécifié, les résultats sont écrits dans le fichier situé au chemin indiqué. Si le fichier n'existe pas, il sera créé.
format	Oui	L'une des valeurs suivantes : horizontal, vertical, csv, json, column	Modifie le format des résultats d'exécution SQL renvoyés par le moteur de table large. Le format par défaut est column. column : Affiche les résultats dans un format de tableau standard. horizontal : Affiche les données horizontalement par colonne. vertical : Affiche les données verticalement par ligne, similaire au format `\G` de la ligne de commande MySQL. csv : Affiche les résultats au format CSV sans bordures de tableau. json : Affiche les résultats au format JSON.
pretty	Non	-	À utiliser avec le format défini sur JSON. Lorsqu'il est activé, les résultats sont affichés au format JSON indenté. Par défaut, les résultats sont affichés au format JSON compact.
csvNoHeader	Non	-	À utiliser avec le format défini sur CSV. Lorsqu'il est activé, les résultats sont affichés au format CSV sans en-têtes de colonne.
nullString	Oui	Chaîne de caractères pour remplacer les valeurs NULL	À utiliser avec le format défini sur CSV. Lorsqu'il est spécifié, les valeurs NULL dans les résultats de requête sont remplacées par la chaîne donnée. Si nullString n'est pas spécifié, les valeurs NULL sont affichées comme suit : Lors de la connexion via le protocole MySQL, les valeurs NULL sont représentées par `\N`. Lors de la connexion via le protocole Avatica, les valeurs NULL sont représentées par des chaînes vides.
version	Non	-	Affiche les informations de version de lindorm-cli. Lindorm-cli ne démarre pas et n'entre pas en mode interactif lorsque ce paramètre est utilisé.
format	Oui	L'une des valeurs suivantes : horizontal, vertical, csv, json, jsonl, column	Modifie le format des résultats d'exécution SQL renvoyés par le moteur de table large. La valeur par défaut est column. column : Affiche les résultats dans un format de tableau standard. horizontal : Affiche les données horizontalement par colonne. vertical : Affiche les données verticalement par ligne. csv : Affiche les résultats au format CSV sans bordures de tableau. json : Affiche les résultats au format JSON pour l'analyse par l'Agent. jsonl : Un objet JSON indépendant par ligne, adapté aux Agents pour consommer de grands ensembles de résultats en streaming.
capabilities	Non	-	Affiche une déclaration de capacité JSON de lindorm-cli, incluant les moteurs pris en charge, les formats, les codes de sortie et les paramètres. Dans les scénarios d'Agent IA, cette fonction est appelée automatiquement par Lindorm Agent Skill.
safe-mode	Non	-	Lorsqu'il est activé, le client intercepte les opérations d'écriture à haut risque telles que DROP TABLE, TRUNCATE TABLE et DELETE FROM. Dans les scénarios d'Agent IA, cette option est activée par défaut par Lindorm Agent Skill.
max-rows	Oui	Entier positif	Limite le nombre maximal de lignes renvoyées par le client. Les lignes excédentaires sont tronquées. Dans les scénarios d'Agent IA, cette valeur est définie par défaut par Lindorm Agent Skill pour empêcher les grands ensembles de résultats de saturer la fenêtre de contexte de l'Agent.
password-stdin	Non	-	Lit le mot de passe depuis l'entrée standard pour éviter qu'il n'apparaisse dans les arguments de la ligne de commande. Dans les scénarios d'Agent IA, Lindorm Agent Skill privilégie cette option par rapport au paramètre `-password` en clair.

Remarque

Tous les paramètres de ligne de commande de lindorm-cli doivent être préfixés par un trait d'union -.

Sous-commandes courantes

Après avoir démarré lindorm-cli en mode interactif, vous pouvez exécuter des sous-commandes lindorm-cli dans l'interface interactive pour contrôler son comportement, en plus d'envoyer des instructions SQL au moteur de table large Lindorm. Les sous-commandes courantes sont répertoriées ci-dessous :

Sous-commande

Paramètres

Description

connect

Lorsque lindorm-cli est démarré en mode interactif sans connexion, utilisez la sous-commande connect pour établir une connexion au moteur de table large Lindorm.

Les paramètres url, username et password ont la même signification que les paramètres de ligne de commande url, username et password.

format

L'une des valeurs suivantes :

horizontal, vertical, csv, json

Identique au paramètre format.

help

Aucun

Affiche la liste des sous-commandes courantes.

history

Aucun

Affiche les instructions SQL ou sous-commandes récemment exécutées.

exit ou quit

Aucun

Quitte lindorm-cli et se déconnecte du moteur de table large Lindorm.

FAQ

Pourquoi des délais d'attente ou des échecs de connexion se produisent-ils ?

Les délais d'attente ou les échecs de connexion génèrent des erreurs telles que Failed to connect to <wide table endpoint> connection check failed ou connection timeout.

Veuillez consulter ci-dessous les causes possibles et les solutions associées. Vérifiez-les dans l'ordre indiqué :

Cause	Solution
Utilisation d'une connexion via le réseau public sans avoir ajouté l'adresse IP publique à la liste d'autorisation.	Ajoutez l'adresse IP publique du client à la liste d'autorisation de Lindorm. Pour identifier l'adresse IP publique de votre client, exécutez `curl ipinfo.io/ip` ou `curl ifconfig.me` dans l'invite de commandes Windows (CMD).
L'adresse IP publique figure dans la liste d'autorisation, mais les délais d'attente persistent.	Une instabilité du réseau peut en être la cause. Nous vous recommandons de basculer vers une connexion VPC.
Accès depuis une instance ECS sans avoir ajouté l'adresse IP de l'ECS à la liste d'autorisation de Lindorm.	Récupérez l'adresse IP de l'ECS et ajoutez-la à la liste d'autorisation de Lindorm.
Utilisation d'un endpoint incorrect.	Les endpoints Lindorm diffèrent selon que vous utilisez une connexion VPC ou un réseau public. Utilisez l'endpoint approprié en fonction de votre environnement réseau.

Si aucune de ces solutions ne résout votre problème, contactez le support technique Lindorm (ID DingTalk : s0s3eg3).

Références

Pour plus d'informations sur la syntaxe SQL des tables larges Lindorm, consultez la section Référence SQL.
Autres méthodes de connexion : Connexion et utilisation du moteur de table large avec la ligne de commande MySQL, Utilisation du protocole MySQL (recommandé).