Connect and use LindormTable via Lindorm-cqlsh - Lindorm - Centre de documentation Alibaba Cloud

Lindorm-cqlsh est un outil en ligne de commande fourni par l'équipe Lindorm. Il s'agit d'une version modifiée de Cassandra cqlsh, disponible pour les systèmes d'exploitation Windows et Unix. Installez Lindorm-cqlsh sur une machine locale ou une instance ECS pour accéder à LindormTable.

Prérequis

Ajoutez l'adresse IP du client à la liste d'autorisation de votre instance Lindorm.
[KV化][2026-02-10] 原界面词"CQL连接"(uicontrol)替换为美杜莎conref引用

Récupérez l'adresse de CQL Connection pour le moteur LindormTable de Lindorm. Pour plus d'informations, consultez la rubrique Afficher les chaînes de connexion. Sur la page Détails de l'instance dans la console Lindorm, sélectionnez l'onglet LindormTable, développez la section Cassandra-compatible Addresses et récupérez l'adresse de connexion VPC ou publique pour la connexion CQL. Le nom d'utilisateur et le mot de passe par défaut sont tous deux root.
Téléchargez et extrayez Lindorm-cqlsh.
Si votre application est déployée sur une instance ECS, assurez-vous que l'instance Lindorm et l'instance ECS répondent aux conditions suivantes pour garantir la connectivité réseau. Pour consulter les informations de l'instance ECS, reportez-vous à la rubrique Afficher les informations de l'instance.
- L'instance Lindorm et l'instance ECS sont déployées dans la même région. Nous vous recommandons de les déployer dans la même zone afin de réduire la latence réseau.
- Le type de réseau de l'instance Lindorm est identique à celui de l'instance ECS.

Commandes courantes

Une fois connecté à LindormTable via Lindorm-cqlsh, exécutez les commandes suivantes :

Documented shell commands:===========================
CAPTURE  COPY  DESCRIBE  LOGIN   DESC  EXIT  HELP PAGING  SHOW
CQL help topics:================
CREATE_KEYSPACE        TEXT                ALTER_KEYSPACE           TIME       CREATE_ROLE
DROP_USER              TIMESTAMP           ALTER_TABLE              CREATE_TABLE
GRANT                  ALTER_USER          INSERT                   UPDATE   
CREATE_USER            INSERT_JSON         USE                      ASCII
DATE                   INT                 UUID                     BATCH
DELETE                 JSON                BEGIN                    KEYWORDS        
BLOB                   DROP_COLUMNFAMILY   LIST_PERMISSIONSBOOLEAN  LIST_ROLES      
COUNTER                DROP_INDEX          LIST_USERS               DROP_KEYSPACE   
PERMISSIONS            CREATE_COLUMNFAMILY REVOKE                   DROP_ROLE                 
SELECT                 CREATE_INDEX        DROP_TABLE                SELECT_JSON

Procédure

Exécutez la commande suivante pour vous connecter à Lindorm.
```
bin/cqlsh <host> <port> -u <username> -p <password>
```
Remarque
- Définissez la version Python du chemin contenant bin/cqlsh sur 2.7.x.
- [KV化][2026-02-10] 原界面词"CQL连接"(uicontrol)替换为美杜莎conref引用
  
  <host> : adresse de CQL Connection pour LindormTable, obtenue depuis la console Lindorm. Exemple : ld-bp17j28j2y7pm****-proxy-lindorm.lindorm.rds.aliyuncs.com.
- [KV化][2026-02-10] 原界面词"CQL连接"(uicontrol)替换为美杜莎conref引用
  
  <port> : numéro de port de la CQL Connection du moteur LindormTable de Lindorm. La valeur par défaut est 9042.
- <username> : nom d'utilisateur pour la connexion à LindormTable. Valeur par défaut : root.
- <password> : mot de passe associé au nom d'utilisateur spécifié. Si vous avez oublié votre mot de passe, réinitialisez-le via le système de gestion du cluster.
- Lindorm prend en charge diverses commandes d'accès Lindorm-cqlsh. Pour plus d'informations, exécutez la commande bin/cqlsh -help.
Créez un keyspace avec Lindorm-cqlsh. Le concept de keyspace dans Lindorm est similaire à celui d'une base de données dans un système de base de données relationnelle. Un keyspace peut contenir une ou plusieurs tables ou familles de colonnes.
```
CREATE KEYSPACE test_keyspace WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 1};
```
Une fois le keyspace créé, exécutez la commande suivante pour le consulter :
```
DESCRIBE KEYSPACE test_keyspace;
```
Exécutez la commande USE pour basculer vers le keyspace.
```
USE test_keyspace;
```
Le système renvoie les informations suivantes :
```
cqlsh:test_keyspace>
```
Une fois connecté à LindormTable via Lindorm-cqlsh, exécutez les commandes prises en charge selon vos besoins métier. Les exemples suivants illustrent l'exécution de commandes courantes :
- Créez une table nommée test_user avec Lindorm-cqlsh. La table contient deux colonnes de type TEXT : first_name et last_name. Le champ first_name est la clé primaire de la table.
```
CREATE TABLE test_user(first_name text, last_name text, PRIMARY KEY (first_name));
```
  Remarque
  Si vous n'avez pas exécuté la commande USE test_keyspace; avant de créer la table, exécutez la commande suivante :
  CREATE TABLE test_keyspace.test_user(first_name text, last_name text, PRIMARY KEY (first_name));
- Consultez les informations relatives à la table test_user.
```
DESCRIBE TABLE test_user;
```
  Le système renvoie les informations suivantes :
```
CREATE TABLE test_keyspace.test_user (
    first_name text PRIMARY KEY,
    last_name text
) WITH bloom_filter_fp_chance = 0.01    
    AND caching = {'keys': 'ALL', 'rows_per_partition': 'NONE'}    
    AND comment = ''    
    AND compaction = {'class': 'org.apache.cassandra.db.compaction.SizeTieredCompactionStrategy', 'max_threshold': '32', 'min_threshold': '4'}    
    AND compression = {'chunk_length_in_kb': '64', 'class': 'org.apache.cassandra.io.compress.LZ4Compressor'}    
    AND crc_check_chance = 1.0    
    AND dclocal_read_repair_chance = 0.1    
    AND default_time_to_live = 0    
    AND gc_grace_seconds = 864000    
    AND max_index_interval = 2048    
    AND memtable_flush_period_in_ms = 0    
    AND min_index_interval = 128    
    AND read_repair_chance = 0.0    
    AND speculative_retry = '99PERCENTILE';
```
  Remarque
  Exécutez l'instruction DESCRIBE TABLE pour consulter l'instruction utilisée lors de la création de la table. Les informations renvoyées affichent de manière formatée les paramètres personnalisés et les paramètres par défaut. Lindorm n'est pas entièrement compatible avec les attributs de table pris en charge par Cassandra. Si un attribut de table n'est pas pris en charge par Lindorm, le système renvoie tout de même l'attribut. La valeur renvoyée correspond à la valeur d'attribut par défaut dans Cassandra.
  - Les attributs de table suivants n'ont aucune signification pratique pour les tables Lindorm : crc_check_chance, gc_grace_seconds, read_repair_chance, speculative_retry, dclocal_read_repair_chance.
  - Les attributs suivants sont entièrement compatibles : compression, default_time_to_live.
- Insérez des données dans la table test_user.
```
INSERT INTO test_user (first_name, last_name) VALUES ('test', 'LINDORM');
INSERT INTO test_user (first_name, last_name) VALUES ('Zhang', 'San');
INSERT INTO test_user (first_name) VALUES ('Wu');
```
- Vérifiez si les données ont été insérées comme prévu. Évitez d'exécuter la commande suivante lors de l'insertion d'un grand volume de données :
```
SELECT COUNT(*) FROM test_user; 
```
  Le système renvoie les informations suivantes :
```
  count
-------     
    3
(1 rows)
```
  Exécutez la commande suivante pour interroger les détails des données insérées :
```
SELECT * FROM test_user;
```
  Le système renvoie les informations suivantes :
```
first_name | last_name
------------+-----------
       test |    LINDORM
         Wu |      null
      Zhang |       San
(3 rows)
```
- Supprimez une valeur de la colonne last_name d'une ligne de données spécifique, puis interrogez cette ligne.
```
DELETE last_name FROM test_user WHERE first_name='test';
SELECT * FROM test_user WHERE first_name='test';
```
  Le système renvoie les informations suivantes :
```
first_name | last_name
------------+-----------
       test |    null
```
- Supprimez les données d'une ligne spécifique, puis interrogez cette ligne.
```
DELETE FROM test_user WHERE first_name='test';
SELECT * FROM test_user WHERE first_name='test';
```
  Le système renvoie les informations suivantes :
```
first_name | last_name
------------+-----------
(0 rows)
```
- Tronquez ou supprimez une table. Seul un superutilisateur peut exécuter les commandes TRUNCATE, DROP TABLE, and DROP KEYSPACE.
```
TRUNCATE test_user;
DROP TABLE test_user;
```
- Utilisez un index de recherche dans Lindorm.
  Vous pouvez utiliser CQL pour créer un index de recherche pour une table dans LindormTable. Avant de créer l'index de recherche, assurez-vous que les propriétés de la table répondent aux exigences. Pour plus d'informations sur ces exigences, soumettez un ticket.
```
CREATE TABLE test_keyspace.tb (cn1 text PRIMARY KEY, cn2 text, cn3 text) WITH extensions = {'CONSISTENCY_TYPE':'strong', 'MUTABILITY':'MUTABLE_LATEST'};
CREATE SEARCH INDEX tbidx ON test_keyspace.tb WITH COLUMNS (cn2, cn3);
REBUILD SEARCH INDEX ON test_keyspace.tb ;
INSERT INTO test_keyspace.tb (cn1, cn2, cn3) VALUES ('v11', 'v12', 'v13');
SELECT * FROM test_keyspace.tb WHERE cn2 like '%v1';
```
  Remarque
  Le code précédent crée un index nommé tbidx pour la table tb, écrit des données dans la table, puis effectue une recherche floue.
- Utilisez un index secondaire dans Lindorm.
  Exécutez les commandes Lindorm CQL pour créer un index secondaire pour une table large dans LindormTable. Avant de créer un index secondaire pour une table large, assurez-vous que les attributs de la table répondent aux exigences correspondantes. Pour plus d'informations sur ces exigences, consultez la rubrique Index secondaire.
```
CREATE TABLE test_keyspace.tb (cn1 text PRIMARY KEY, cn2 text, cn3 text) WITH extensions = {'CONSISTENCY_TYPE':'strong', 'MUTABILITY':'MUTABLE_LATEST'};
CREATE INDEX tbidx ON test_keyspace.tb (cn2);
INSERT INTO test_keyspace.tb (cn1, cn2, cn3) VALUES ('v11', 'v12', 'v13');
SELECT * FROM test_keyspace.tb WHERE cn2 = 'v12';
```