Connect and use LindormTable via Lindorm-cqlsh - Lindorm - Centro de documentación de Alibaba Cloud

Lindorm-cqlsh es una herramienta de shell proporcionada por el equipo de Lindorm. Se trata de una versión modificada de Cassandra cqlsh que está disponible para sistemas operativos Windows y tipo Unix. Instale Lindorm-cqlsh en una computadora local o en una instancia ECS para acceder a LindormTable.

Requisitos previos

Agregó la dirección IP del cliente a la whitelist de su instancia de Lindorm.
[Transformación a clave-valor][2026-02-10] El término de interfaz original "CQL Connection" (uicontrol) se reemplazó por una referencia conref de Medusa.

Obtuvo la dirección CQL Connection del motor LindormTable de Lindorm. Para obtener más información, consulte View connection strings. En la página Instance Details de la consola de Lindorm, seleccione la pestaña LindormTable, expanda la sección Cassandra-compatible Addresses y obtenga la dirección de conexión VPC o de red pública para la CQL connection. La contraseña y el nombre de usuario predeterminados son root.
Descargó y extrajo Lindorm-cqlsh.
Si su aplicación se despliega en una instancia ECS, asegúrese de que la instancia de Lindorm y la instancia ECS cumplan las siguientes condiciones para garantizar la conectividad de red. Para obtener más información sobre cómo consultar la información de una instancia ECS, consulte View instance information.
- La instancia de Lindorm y la instancia ECS se despliegan en la misma región. Se recomienda desplegar ambas instancias en la misma zona para reducir la latencia de red.
- El tipo de red de la instancia de Lindorm es igual al de la instancia ECS.

Comandos comunes

Después de usar Lindorm-cqlsh para conectarse a LindormTable, ejecute los siguientes comandos:

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

Procedimiento

Ejecute el siguiente comando para conectarse a Lindorm.
```
bin/cqlsh <host> <port> -u <username> -p <password>
```
Nota
- Se recomienda establecer la versión de Python de la ruta donde se ubica bin/cqlsh en 2.7.x.
- [Transformación a clave-valor][2026-02-10] El término de interfaz original "CQL Connection" (uicontrol) se reemplazó por una referencia conref de Medusa.
  
  <host>: la dirección CQL Connection de LindormTable, obtenida desde la consola de Lindorm. Ejemplo: ld-bp17j28j2y7pm****-proxy-lindorm.lindorm.rds.aliyuncs.com.
- [Transformación a clave-valor][2026-02-10] El término de interfaz original "CQL Connection" (uicontrol) se reemplazó por una referencia conref de Medusa.
  
  <port>: especifica el número de puerto de CQL Connection del motor LindormTable de Lindorm. El valor predeterminado es 9042.
- <username>: el nombre de usuario que desea utilizar para conectarse a LindormTable. Valor predeterminado: root.
- <password>: la contraseña del nombre de usuario especificado. Si olvidó su contraseña, puede reset password mediante el sistema de administración del clúster.
- Lindorm admite diversos comandos de acceso de Lindorm-cqlsh. Para obtener más información, ejecute el comando bin/cqlsh -help.
Use Lindorm-cqlsh para crear un keyspace. El concepto de keyspace en Lindorm es similar al de base de datos en un sistema de bases de datos relacionales. Un keyspace puede contener una o más tablas o familias de columnas.
```
CREATE KEYSPACE test_keyspace WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 1};
```
Una vez creado el keyspace, ejecute el siguiente comando para consultarlo:
```
DESCRIBE KEYSPACE test_keyspace;
```
Ejecute el comando USE para cambiar al keyspace.
```
USE test_keyspace;
```
Se devuelve la siguiente información:
```
cqlsh:test_keyspace>
```
Después de usar Lindorm-cqlsh para conectarse a LindormTable, ejecute los comandos compatibles según sus necesidades de negocio. A continuación se muestran ejemplos de ejecución de comandos comunes:
- Use Lindorm-cqlsh para crear una tabla llamada test_user. Esta tabla contiene dos columnas de tipo de dato TEXT: first_name y last_name. El campo first_name es la clave principal de la tabla.
```
CREATE TABLE test_user(first_name text, last_name text, PRIMARY KEY (first_name));
```
  Nota
  Si no ejecutó el comando USE test_keyspace; antes de crear la tabla, ejecute el siguiente comando para crearla.
  CREATE TABLE test_keyspace.test_user(first_name text, last_name text, PRIMARY KEY (first_name));
- Consulte la información de la tabla test_user.
```
DESCRIBE TABLE test_user;
```
  Se devuelve la siguiente información:
```
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';
```
  Nota
  Ejecute la instrucción DESCRIBE TABLE para consultar la instrucción que utilizó para crear la tabla. La información devuelta muestra la configuración personalizada y la predeterminada en un formato estructurado. Lindorm no es totalmente compatible con todos los atributos de tabla que admite Cassandra. Si Lindorm no admite un atributo de tabla, el sistema lo devuelve de todas formas con el valor predeterminado correspondiente en Cassandra.
  - Los siguientes atributos de tabla no tienen un significado práctico para las tablas de Lindorm: crc_check_chance, gc_grace_seconds, read_repair_chance, speculative_retry, dclocal_read_repair_chance.
  - Los siguientes atributos son totalmente compatibles: compression, default_time_to_live.
- Inserte datos en la tabla 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');
```
- Compruebe si los datos se insertaron correctamente. Se recomienda no ejecutar el siguiente comando en escenarios donde se inserte un gran volumen de datos:
```
SELECT COUNT(*) FROM test_user; 
```
  Se devuelve la siguiente información:
```
  count
-------     
    3
(1 rows)
```
  Ejecute el siguiente comando para consultar los detalles de los datos insertados:
```
SELECT * FROM test_user;
```
  Se devuelve la siguiente información:
```
first_name | last_name
------------+-----------
       test |    LINDORM
         Wu |      null
      Zhang |       San
(3 rows)
```
- Elimine un valor de la columna last_name en una fila de datos específica y consulte dicha fila.
```
DELETE last_name FROM test_user WHERE first_name='test';
SELECT * FROM test_user WHERE first_name='test';
```
  Se devuelve la siguiente información:
```
first_name | last_name
------------+-----------
       test |    null
```
- Elimine los datos de una fila específica y consulte dicha fila.
```
DELETE FROM test_user WHERE first_name='test';
SELECT * FROM test_user WHERE first_name='test';
```
  Se devuelve la siguiente información:
```
first_name | last_name
------------+-----------
(0 rows)
```
- Vacíe o elimine una tabla. Solo un superusuario puede ejecutar los comandos TRUNCATE, DROP TABLE, and DROP KEYSPACE.
```
TRUNCATE test_user;
DROP TABLE test_user;
```
- Use un índice de búsqueda en Lindorm.
  Utilice CQL para crear un índice de búsqueda para una tabla en LindormTable. Antes de crear el índice de búsqueda, asegúrese de que las propiedades de la tabla cumplan con los requisitos. Para obtener más información sobre estos requisitos, envíe 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';
```
  Nota
  El código anterior crea un índice llamado tbidx para la tabla tb, escribe datos en ella y luego realiza una búsqueda difusa.
- Use un índice secundario en Lindorm.
  Ejecute comandos CQL de Lindorm para crear un índice secundario para una tabla ancha en LindormTable. Antes de crearlo, compruebe que los atributos de la tabla cumplan con los requisitos correspondientes. Para obtener información sobre dichos requisitos, consulte Secondary index.
```
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';
```