Instalar el shell de HBase para Cloud Bigtable

El shell de HBase es una herramienta de línea de comandos que ejecuta tareas administrativas, como crear y borrar tablas. El cliente de HBase de Cloud Bigtable para Java permite usar el shell de HBase a fin de conectarse a Cloud 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 Google Cloud Shell. Si deseas obtener instrucciones, consulta Inicio rápido para usar el shell de HBase.

Antes de comenzar

Antes de comenzar, debes completar las siguientes tareas:

Cómo instalar 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.

Cómo instalar Maven

Para ejecutar el 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.

Cómo obtener credenciales

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

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.

Cómo configurar el shell de HBase

Descargar los archivos requeridos

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 clonó en el directorio cloud-bigtable-examples.

Cómo configurar la variable del entorno JAVA_HOME

La variable del entorno JAVA_HOME de tu 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, significa que 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, sería el siguiente: /usr/lib/jvm/java-8-openjdk-amd64/jre.

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

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

Un valor típico en macOS sería el siguiente: /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

Cómo conectarse a una instancia de Cloud Bigtable

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

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

cd quickstart
./quickstart.sh

Si tu proyecto tiene solo una instancia de Cloud Bigtable, el shell de HBase se conectará a ella automáticamente. Si el proyecto tiene varias instancias de Cloud Bigtable, el shell de HBase mostrará una lista de sus ID; escribe el numero que aparece al costado del 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 el shell de HBase, intenta ejecutar los siguientes comandos:

  • Para enumerar tus tablas, escribe list y presiona Intro. Si aún no creas tablas, el shell de HBase 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:

    create 'my-table', 'cf1'
    

    El shell 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, usa la familia de columnas cf1 y el calificador de columna c1 para colocar el valor test-value en la fila r1:

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

    Luego, puedes usar el comando scan para escanear la tabla y leer los datos que agregaste:

    scan 'my-table'
    

    El 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
    
  • A fin de quitar una tabla, usa el comando disable para inhabilitarla y, luego, el comando drop. Por ejemplo, para quitar la tabla my-table:

    disable 'my-table'
    drop 'my-table'
    
  • Para salir del shell de HBase, escribe exit y presiona Intro.

Mientras el shell de HBase está en ejecución, puedes escribir help para obtener las instrucciones de uso. Consulta la documentación de HBase a fin de obtener más información.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Cloud Bigtable