Se usó la API de Cloud Translation para traducir esta página.

Instala la shell de HBase

La shell de HBase es una herramienta de línea de comandos que realiza tareas administrativas, como crear y borrar tablas. El cliente de Cloud Bigtable HBase para Java es una biblioteca cliente que permite usar la shell de HBase a fin de conectarse a Bigtable.

En esta página, se describe cómo instalar el shell de HBase junto con el cliente de HBase de Cloud Bigtable para Java en una instancia de Compute Engine o en tu propia máquina. No es necesario que instales otras dependencias de HBase, como Apache ZooKeeper. El cliente HBase de Cloud Bigtable para Java no requiere estas dependencias adicionales.

También puedes ejecutar el shell de HBase en Cloud Shell. Si deseas obtener instrucciones, consulta la Guía de inicio rápido para usar la shell de HBase.

Antes de comenzar

Antes de comenzar, necesitarás realizar las siguientes tareas:

Crear una instancia de Bigtable. Asegúrate de anotar los ID del proyecto y de la instancia.
Instala Google Cloud CLI. Consulta las instrucciones de configuración de Google Cloud CLI para obtener más información.
Si instalas la shell de HBase en una instancia de Compute Engine, crea una instancia que tenga los permisos correctos para Bigtable.

Instala Java

A fin de usar el 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.

En Debian GNU/Linux o Ubuntu, puedes ejecutar los siguientes comandos para instalar Java JDK 8:

sudo apt-get update
sudo apt-get install openjdk-8-jdk-headless

En otros sistemas operativos, puedes descargar y, luego, instalar Java JDK.

Instala Maven

Para ejecutar la shell de HBase, debes instalar Apache Maven. El shell de HBase usa Maven para descargar las dependencias necesarias.

En Debian GNU/Linux o Ubuntu, puedes ejecutar los siguientes comandos para instalar Maven:

sudo apt-get update
sudo apt-get install maven

En macOS, puedes instalar Maven con Homebrew:

brew install maven

Para otros sistemas operativos, consulta las instrucciones en el sitio web de Maven.

Obtén credenciales

Cuando instalas la shell de HBase en tu máquina, debes obtener credenciales de acceso a tus recursos de Google Cloud.

Para obtener las credenciales, ejecuta el siguiente comando:

gcloud auth application-default login

Con este comando se abrirá tu navegador web. Si se te solicita, selecciona tu Cuenta de Google y haz clic en Permitir para autorizar el acceso a tu cuenta.

Configura la shell de HBase

Descargue los archivos necesarios

En la línea de comandos, clona el repositorio de GitHub que contiene la guía de inicio rápido del shell de HBase:

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

El repositorio se clona en el directorio cloud-bigtable-examples.

Establece la variable de entorno JAVA_HOME

La variable de entorno JAVA_HOME de la shell debe configurarse en la misma ubicación del entorno de ejecución de Java.

Para buscar el valor actual de JAVA_HOME, ejecuta el siguiente comando:

echo ${JAVA_HOME}

Si con este comando no se generan resultados, la variable no está configurada.

Para configurar el valor en Debian GNU/Linux o Ubuntu, ejecuta el siguiente comando:

export JAVA_HOME=$(update-alternatives --list java | tail -1 | sed -E 's/\/bin\/java//')

Un valor típico en Debian GNU/Linux o Ubuntu es /usr/lib/jvm/java-8-openjdk-amd64/jre.

Para configurar el valor en macOS (requiere las herramientas de línea de comandos de Xcode), usa el siguiente comando:

export JAVA_HOME=$(/usr/libexec/java_home)

Un valor típico en macOS es /Library/Java/JavaVirtualMachines/jdk1.8.0_131.jdk/Contents/Home.

Tras configurar el valor de JAVA_HOME, ejecuta el siguiente comando para asegurarte de que este haga referencia a la versión adecuada de Java:

${JAVA_HOME}/bin/java -version

Conéctate a una instancia de Bigtable

Puedes usar la shell de HBase para conectarte a tu instancia de Bigtable, obtener información sobre las tablas existentes y crear tablas nuevas.

Para iniciar la shell de HBase, ejecuta los siguientes comandos en el directorio en el que clonaste el repositorio de GitHub cloud-bigtable-examples:

cd quickstart
./quickstart.sh

Si el proyecto tiene solo una instancia de Bigtable, la shell de HBase se conectará a ella de forma automática. Si el proyecto tiene varias instancias de Bigtable, la shell de HBase mostrará una lista de sus ID; escribe el numero que aparece junto al ID de tu instancia y presiona Intro.

Cuando el shell de HBase se conecte a tu instancia, aparecerá una serie de mensajes, lo que es normal. Luego, aparece la ventana del shell:

hbase(main):001:0>

Ahora que iniciaste la shell de HBase, ejecuta los siguientes comandos:

Para enumerar las tablas, escribe list y presiona Intro. Si aún no creaste tablas, en la shell de HBase, se mostrará un mensaje similar al siguiente:
```
TABLE
0 row(s) in 1.3580 seconds

=> []
```
Para crear una tabla, usa el comando create. Por ejemplo, para crear una tabla llamada my-table, con una familia de columnas llamada cf1, usa lo siguiente:
```
create 'my-table', 'cf1'
```
En la shell, se muestra un mensaje similar al siguiente:
```
0 row(s) in 1.5210 seconds

=> Hbase::Table - my-table
```
Para agregar datos a una tabla, usa el comando put. Por ejemplo, para colocar el valor test-value en la fila r1, usa la familia de columnas cf1 y el calificador de columnas c1:
```
put 'my-table', 'r1', 'cf1:c1', 'test-value'
```
Luego, puedes usar el comando scan para analizar la tabla y leer los datos que agregaste:
```
scan 'my-table'
```
En la shell, se muestra un resultado similar a este:
```
ROW      COLUMN+CELL
 r1      column=cf1:c1, timestamp=1430687836046, value=test-value
1 row(s) in 0.6260 seconds
```
Si quieres descartar una tabla, usa el comando disable para inhabilitarla y, luego, el comando drop. Por ejemplo, para descartar la tabla my-table, ejecuta lo siguiente:
```
disable 'my-table'
drop 'my-table'
```
Para salir de la shell de HBase, escribe exit y presiona Intro.

Mientras se ejecuta la shell de HBase, puedes escribir help para obtener instrucciones de uso. Consulta la documentación de HBase para obtener más información.