Utiliser l'émulateur

Le SDK Cloud fournit un émulateur local en mémoire pour Cloud Bigtable, utilisable pour tester votre application. Étant donné que l'émulateur stocke les données uniquement en mémoire, il ne les conserve pas lors des exécutions. Il est destiné à vous aider à utiliser Bigtable pour le développement et les tests locaux, et non pour les déploiements en production.

Vous pouvez utiliser l'émulateur avec toutes les bibliothèques clientes Bigtable.

L'émulateur ne fournit pas d'API d'administration pour créer ou gérer des instances et des clusters. Une fois que l'émulateur est lancé, vous pouvez vous connecter à lui en utilisant n'importe quel nom de projet ou d'instance pour créer des tables et lire ou écrire des données.

Installer l'émulateur

Pour installer l'émulateur Bigtable :

  1. Installez le SDK Cloud.

  2. Mettez à jour votre outil de ligne de commande gcloud pour bénéficier des dernières fonctionnalités :

    gcloud components update beta
    
  3. Exécutez la commande suivante pour démarrer l'émulateur :

    gcloud beta emulators bigtable start
    

    Si l'émulateur n'est pas déjà installé, vous serez invité à télécharger et installer le fichier binaire de l'émulateur.

  4. Tapez Ctrl+C pour arrêter l'émulateur.

Utiliser l'émulateur

Pour utiliser l'émulateur Bigtable :

  1. Exécutez la commande suivante pour démarrer l'émulateur Bigtable :

    gcloud beta emulators bigtable start
    

    L'émulateur imprime l'hôte et le numéro de port sur lequel il s'exécute.

    Par défaut, l'émulateur choisit la paire hôte/port localhost:8086. Pour lier l'émulateur à un hôte et à un port spécifiques, utilisez l'option facultative --host-port, en remplaçant [HOST] et [PORT] par les éléments appropriés :

    gcloud beta emulators bigtable start --host-port=[HOST]:[PORT]
    
  2. Dans l'environnement de votre application, définissez la variable d'environnement BIGTABLE_EMULATOR_HOST sur l'hôte et le port sur lesquels l'émulateur Bigtable s'exécute (par exemple, myhost.example.com:8010).

    Si vous exécutez l'émulateur sur le même ordinateur que votre application, vous pouvez utiliser la commande suivante pour définir cette variable d'environnement automatiquement :

    $(gcloud beta emulators bigtable env-init)
    

    La définition de cette variable d'environnement entraîne l'exécution de l'application dans l'émulateur, sans qu'aucune action supplémentaire ne soit requise. Le client utilise automatiquement la variable si elle est définie, au lieu de se connecter au service Bigtable.

  3. Une fois que vous avez fini d'utiliser l'émulateur, appuyez sur Ctrl+C pour l'arrêter, puis retirez la définition de BIGTABLE_EMULATOR_HOST à l'aide de la commande suivante :

    unset BIGTABLE_EMULATOR_HOST
    

Filtres

Le tableau suivant indique les filtres actuellement compatibles.

Compatible Compatible, avec des limitations Non disponible
apply_label_transformer
block_all
cells_per_column_limit
cells_per_row_limit_filter
cells_per_row_offset_filter
chain
column_range
condition
interleave
pass_all
row_sample
strip_value_transformer
timestamp_range
value_range_filter
column_qualifier_regex
family_name_regex
row_key_regex
value_regex
sink

Les problèmes liés à l'émulateur Bigtable sont suivis dans le dépôt GitHub google-cloud-go, où vous pouvez créer des rapports de bugs et des demandes de fonctionnalités, ou commenter des problèmes existants.