Démarrage rapide avec l'interface système HBase

Cette page explique comment utiliser l'interface système HBase pour vous connecter à une instance Cloud Bigtable, effectuer des tâches administratives basiques, ainsi que lire et écrire des données dans une table.

Si vous ne souhaitez pas utiliser l'interface système HBase, suivez plutôt le guide de démarrage rapide avec l'outil cbt.

Ce guide de démarrage rapide utilise Cloud Shell dans Google Cloud Console pour exécuter l'interface système HBase. Pour améliorer les performances, vous pouvez plutôt installer l'interface système HBase sur votre propre machine.

Avant de commencer

  1. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  2. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  3. Activer les API Cloud Bigtable and Cloud Bigtable Admin.

    Activer les API

Créer une instance Bigtable

  1. Accédez à la page "Créer une instance" dans Google Cloud Console.

    Accéder à la page "Créer une instance"

    Capture d'écran de la page "Créer une instance"

  2. Dans le champ Instance name (Nom de l'instance), saisissez Quickstart instance.

  3. Dans le champ ID d'instance, saisissez quickstart-instance.

  4. Comme Type de stockage, sélectionnez SSD.

  5. Dans le champ Cluster ID (ID de cluster), saisissez quickstart-instance-c1.

  6. Dans le champ Région, sélectionnez us-east1.

  7. Dans le champ Zone, sélectionnez us-east1-c.

  8. Cliquez sur Créer pour créer l'instance.

Se connecter à l'instance

  1. Ouvrez une fenêtre du terminal dans Cloud Shell.

    Ouvrir dans Cloud Shell

  2. Pour utiliser l'interface système HBase avec le client Cloud Bigtable HBase pour Java, vous devez installer un environnement d'exécution Java 8. Les autres versions de Java ne sont pas acceptées. Pour installer et configurer l'environnement Java 8, exécutez les commandes suivantes :

    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. Clonez le dépôt contenant les fichiers de l'interface système HBase, puis accédez à ce dépôt :

    git clone https://github.com/GoogleCloudPlatform/cloud-bigtable-examples.git
    cd cloud-bigtable-examples/quickstart
  4. Démarrez l'interface système HBase :

    ./quickstart.sh

Vous êtes maintenant connecté.

Lire et écrire des données

Bigtable enregistre les données dans des tables contenant des lignes. Chaque ligne est identifiée par une clé de ligne.

Les données d'une ligne sont organisées en familles de colonnes, qui sont des groupes de colonnes. Un qualificatif de colonne identifie une seule colonne au sein d'une famille.

Il peut exister plusieurs versions horodatées de la valeur à l'intersection d'une ligne et d'une colonne. Chaque version est appelée cellule.

  1. Créez une table my-table possédant une famille de colonnes nommée cf1 :

    create 'my-table', 'cf1'
    

    L'interface système affiche un résultat semblable à celui-ci :

    0 row(s) in 1.5210 seconds
    
    => Hbase::Table - my-table
    
  2. Répertoriez vos tables :

    list
    

    L'interface système affiche un résultat semblable à celui-ci :

    TABLE
    my-table
    1 row(s) in 1.3580 seconds
    
    => ["my-table"]
    
  3. Placez la valeur test-value dans la ligne r1 en utilisant la famille de colonnes cf1 et le qualificatif de colonne c1 :

    put 'my-table', 'r1', 'cf1:c1', 'test-value'
    
  4. Exécutez la commande scan pour analyser la table et lire les données que vous avez ajoutées :

    scan 'my-table'
    

    L'interface système affiche un résultat semblable à celui-ci :

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

    disable 'my-table'
    drop 'my-table'
    
  6. Saisissez exit, puis appuyez sur la touche Entrée pour quitter l'interface système HBase. Une série de messages du journal s'affiche ensuite, ce qui est normal.

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, suivez la procédure suivante.

  1. Ouvrez la liste des instances Bigtable dans Cloud Console.

    Ouvrir la liste des instances

  2. Cliquez sur Instance de guide de démarrage rapide.
  3. Cliquez sur Supprimer l'instance.

    Capture d'écran du volet "Delete instance" (Supprimer l'instance)

  4. Saisissez quickstart-instance, puis cliquez sur Delete (Supprimer) pour supprimer l'instance.

Étape suivante