Guía de inicio rápido para usar la shell de HBase

En esta página, se explica cómo usar la shell de HBase para conectarse con una instancia de Cloud Bigtable, realizar tareas administrativas básicas y leer y escribir datos en una tabla.

Nota: Puedes realizar operaciones de Cloud Bigtable en la línea de comandos con el comandoShell de HBase o elcbt herramienta para crear el adjunto de VLAN de supervisión. Usa la shell de HBase si estás acostumbrado a usarla y prefieres usarla. De lo contrario, te recomendamos usar la herramienta cbt, que tiene menos dependencias y pasos de instalación. La herramienta de cbt es un componente del SDK de Google Cloud.

Si no quieres usar el shell de HBase, sigue la guía de inicio rápido con la herramienta de cbt.

En esta guía de inicio rápido, se usa Cloud Shell en Google Cloud Console para ejecutar el shell de HBase. Si deseas obtener un mejor rendimiento, puedes instalar el shell de HBase en tu propia máquina.

Antes de comenzar

1. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir a la página del selector de proyectos

   Importante: El nombre que uses debe tener entre 4 y 30 caracteres. Cuando escribas el nombre, el formulario sugerirá un ID del proyecto que puedes editar. El ID del proyecto que uses debe tener entre 6 y 30 caracteres y debe comenzar con una letra minúscula. Puedes usar un guion, una letra minúscula o un número para los caracteres restantes, pero el último carácter no puede ser un guion. Debes tener en cuenta que algunos identificadores de recursos (como los ID de proyectos) podrían conservarse más allá de la duración del proyecto. Por esta razón, evita almacenar información sensible en identificadores de recursos.
   …consulta los lineamientos para asignar nombres

2. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

3. Habilita las API de Cloud Bigtable and Cloud Bigtable Admin.

   Habilita las API

Crea una instancia de Cloud Bigtable

1. Abre la página Crear instancia en Google Cloud Console.

   Abrir la página Crear una instancia

   

2. En Nombre de la instancia (Instance name), ingresa Quickstart instance.

3. En ID de instancia (Instance ID), ingresa quickstart-instance.

4. En Tipo de almacenamiento (Storage type), selecciona SSD.

5. En ID de clúster (Cluster ID), ingresa quickstart-instance-c1.

6. En Region, selecciona us-east1.

7. En Zone (Zona), selecciona us-east1-c.

8. Haz clic en Create (Crear) para crear la instancia.

Conéctate a tu instancia

1. Abre una ventana de la terminal en Cloud Shell.

   Abrir en Cloud Shell

2. A fin de usar la shell de HBase con el cliente de HBase de Cloud Bigtable para Java, debes instalar el entorno de ejecución de Java 8. No se admiten otras versiones de Java. Instala y configura el entorno de Java 8 mediante la ejecución de los siguientes comandos:

   sudo apt-get update
   sudo apt-get install openjdk-8-jdk-headless
   export JAVA_HOME=$(update-alternatives --list java | tail -1 | sed -E 's/\/bin\/java//')

3. Clona el repositorio que contiene los archivos de la shell de HBase y, luego, modifica el directorio de esta:

   git clone https://github.com/GoogleCloudPlatform/cloud-bigtable-examples.git
   cd cloud-bigtable-examples/quickstart

   Nota: Antes de ejecutar ./quickstart.sh, asegúrate de que no tengas un archivo hbase-site.xml configurado.

4. Inicia la shell de HBase:

   ./quickstart.sh

   Nota: Si se te solicita un ID de instancia, escribe el número junto a quickstart-instance y presiona Intro.

Ya estás conectado.

Lee y escribe datos

Cloud Bigtable almacena datos en tablas, las cuales contienen filas. Cada fila se identifica con una clave de fila.

Los datos de una fila se organizan en familias de columnas, que son grupos de columnas. Un calificador de columna identifica una columna individual dentro de una familia.

Puede haber varias versiones del valor con marca de tiempo en la intersección de una fila y una columna. Cada versión se denomina celda.

1. Crea una tabla llamada my-table con una familia de columna llamada cf1:

   create 'my-table', 'cf1'
   

   La shell muestra un resultado similar al siguiente:

   0 row(s) in 1.5210 seconds
   
   => Hbase::Table - my-table
   

2. Genera una lista de tus tablas:

   list
   

   La shell muestra un resultado similar al siguiente:

   TABLE
   my-table
   1 row(s) in 1.3580 seconds
   
   => ["my-table"]
   

3. Coloca el valor test-value en la fila r1, mediante la familia de columnas cf1 y el calificador de columnas c1:

   put 'my-table', 'r1', 'cf1:c1', 'test-value'
   

4. Usa el comando scan para analizar la tabla y leer los datos que agregaste:

   scan 'my-table'
   

   La shell muestra un resultado similar al siguiente:

   ROW      COLUMN+CELL
    r1      column=cf1:c1, timestamp=1430687836046, value=test-value
   1 row(s) in 0.6260 seconds
   

5. Borra la tabla my-table:

   disable 'my-table'
   drop 'my-table'
   

6. Escribe exit y presiona Intro para salir de la shell de HBase. Verás una serie de mensajes de registro después de salir, lo cual es normal.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

1. Abre la lista de instancias de Cloud Bigtable en Cloud Console.

   Abrir la lista de instancias

2. Haz clic en Quickstart instance.
3. Haz clic en Borrar instancia.

   

4. Escribe quickstart-instance y, luego, haz clic en Borrar (Delete) para borrar la instancia.

¿Qué sigue?

• Lee una descripción general de Cloud Bigtable.
• Trabaja con un codelab de Cloud Bigtable.
• Mira las muestras de código.
• Aprende a diseñar tu esquema.
• Instala el shell de HBase en tu propia máquina.