Lindorm Shell es una herramienta de línea de comandos compatible con HBase proporcionada por Lindorm. Permite conectarse a LindormTable mediante la API de Java de HBase para realizar operaciones de datos como crear tablas, insertar información y ejecutar consultas. Este tema explica cómo descargar Lindorm Shell y establecer la conexión con LindormTable.
Requisitos previos
Tener instalado Java Development Kit (JDK) 1.8 o posterior.
Agregar la dirección IP del cliente a la lista de permitidos de la instancia de Lindorm. Para obtener más información, consulte Configure a whitelist.
Notas de uso
Al conectarse a LindormTable mediante Lindorm Shell, solo es posible ejecutar operaciones básicas de lenguaje de definición de datos (DDL) y lenguaje de manipulación de datos (DML). Para consultar las operaciones no compatibles, revise HBase API usage limits.
Evite utilizar la API de HBase para acceder a tablas anchas creadas con SQL, ya que esto podría devolver caracteres ilegibles.
-
Se recomienda utilizar Lindorm Shell en sistemas operativos Linux o macOS.
ImportanteSi utiliza Lindorm Shell en Windows, podrían presentarse errores o mensajes sobre bibliotecas faltantes. En tal caso, deberá agregar la biblioteca requerida al sistema operativo según lo indique el mensaje de error.
Procedimiento
-
Descargue Lindorm Shell.
En la esquina superior izquierda de la consola de Lindorm, seleccione la región de su instancia. En la página de Instances, haga clic en el ID de la instancia deseada.
En el panel de navegación izquierdo, haga clic en Database Connections y luego en la pestaña Wide Table Engine.
Haga clic en Lindorm Shell Download.
-
Ejecute el siguiente comando para descomprimir el paquete de Lindorm Shell. Este ejemplo descomprime el paquete en el directorio
alihbase-2.0.18.tar zxvf hbaseue-shell.tar.gz -
Configure los parámetros de conexión.
-
Vaya al directorio
alihbase-2.0.18/confy abra el archivohbase-site.xml.vi hbase-site.xml -
Configure el endpoint de conexión, el nombre de usuario y la contraseña para LindormTable.
<configuration> <property> <name>hbase.zookeeper.quorum</name> <value>ld-bp17j28j2y7pm****-proxy-lindorm-pub.lindorm.rds.aliyuncs.com:30020</value> </property> <property> <name>hbase.client.username</name> <value>testuser</value> </property> <property> <name>hbase.client.password</name> <value>password</value> </property> </configuration>Parámetros:
-
hbase.zookeeper.quorum: Endpoint de conexión para LindormTable. Puede encontrar este endpoint en la sección Access by Using HBase Java API de la consola.
Endpoint de VPC: Utilice este endpoint si Lindorm Shell se encuentra en una instancia de ECS dentro de la misma VPC que su instancia de Lindorm.
Endpoint público: Utilice este endpoint si Lindorm Shell se ejecuta en una máquina local o en una instancia de ECS fuera de la VPC de su instancia de Lindorm.
hbase.client.username y hbase.client.password: Nombre de usuario y contraseña para acceder a LindormTable. Si olvidó su contraseña, puede cambiarla en el Cluster Management System de LindormTable. Para obtener más información, consulte Change the password of a user.
-
-
-
Conéctese a LindormTable mediante Lindorm Shell.
Vaya al directorio
alihbase-2.0.18/biny ejecute el siguiente comando../hbase shellLa siguiente salida indica que la conexión se estableció correctamente.
Version 2.0.18, r08b8d58a9d6ce89765d5ebe2ddff425aed644c16, Mon Feb 1 12:46:39 CST 2021 Took 0.0034 secondsNotaPara obtener más información sobre cómo usar el shell, consulte Lindorm Shell reference.
Referencia de Lindorm Shell
Referencia de comandos
Para obtener más información sobre los comandos del shell, consulte The Apache HBase Shell.
Lenguaje de definición de datos (DDL)
create: Crea una tabla.
list: Enumera todas las tablas.
disable: Deshabilita una tabla.
is_disabled: Comprueba si una tabla está deshabilitada.
enable: Habilita una tabla.
is_enabled: Comprueba si una tabla está habilitada.
describe: Muestra los detalles de una tabla, incluidas sus propiedades y esquema.
alter: Modifica una tabla.
exists: Verifica si existe una tabla.
drop: Elimina una tabla específica.
Lenguaje de manipulación de datos (DML)
put: Actualiza el valor de una celda específica.
get: Recupera el contenido de una fila o celda especificada.
delete: Elimina el valor de una celda en una tabla.
deleteall: Elimina todas las celdas de una fila determinada.
scan: Explora y devuelve datos de la tabla.
count: Cuenta y devuelve el número de filas en una tabla.
truncate_preserve: Trunca una tabla. Esta operación deshabilita, elimina y vuelve a crear la tabla especificada. La nueva tabla conserva las mismas divisiones de región que la tabla original.
Entrada y salida del shell
-
Ingrese al entorno de Shell.
bin/hbase shell -
Salga del entorno de Shell.
quit
Ejemplos
Creación e inserción de datos
-
Cree una tabla. Debe especificar un nombre para la tabla y como mínimo una familia de columnas.
create 'table_name', 'column_family_name'Ejemplo:
// Create a table named test with a column family named cf. create 'test', 'cf' -
Inserte datos.
put 'table_name', 'row_key', 'column_family:column_name', 'value'Ejemplo:
put 'test', 'row1', 'cf:a', 'value1' put 'test', 'row2', 'cf:b', 'value2' put 'test', 'row3', 'cf:c', 'value3'Notarow1es la clave de fila de la tablatest,cf:aespecifica la familia de columnas y el nombre de la columna, yvalue1es el valor.
Consulta de datos
-
Consulte información sobre todas las tablas. Es posible utilizar expresiones regulares para filtrar tablas.
list list 'abc.*' list 'test' -
Consulte datos en una tabla específica.
El comando
scanofrece una forma flexible de acceder a los datos de HBase. Puede usar el comandoscanpara explorar una tabla completa o consultar datos dentro de un rango específico. Una operación de exploración es ligeramente más lenta que una consulta de fila única mediante el comandoget. Ejecute el siguiente comando para consultar datos en la tabla de prueba.scan 'table_name'Ejemplo:
scan 'test'Se devuelve el siguiente resultado:
ROW COLUMN+CELL row1 column=cf:a, timestamp=1421762485768, value=value1 row2 column=cf:b, timestamp=1421762491785, value=value2 row3 column=cf:c, timestamp=1421762496210, value=value3 3 row(s) in 0.0230 seconds -
Consulte una sola fila de datos de una tabla.
get 'table_name', 'row_key'Ejemplo:
get 'test', 'row1'Se devuelve el siguiente resultado:
COLUMN CELL cf:a timestamp=1421762485768, value=value1 1 row(s) in 0.0350 seconds
Deshabilitar y habilitar tablas
Deshabilite o habilite una tabla. Antes de eliminar una tabla, modificar su configuración o realizar otras operaciones de gestión, primero debe deshabilitarla con el comando disable. Una vez completada la operación, utilice el comando enable para volver a habilitarla.
disable 'table_name'
enable 'table_name'
Eliminación de tablas
Elimine una tabla específica.
drop 'table_name'