Teste com o emulador
A Google Cloud CLI oferece um emulador local na memória para o Bigtable, que pode usar para testar a sua aplicação. Uma vez que o emulador armazena dados apenas na memória, não mantém os dados entre execuções. Destina-se a ajudar a usar o Bigtable para desenvolvimento e testes locais, não para implementações de produção.
Pode usar o emulador com todas as bibliotecas de cliente do Cloud Bigtable.
O emulador não fornece APIs administrativas para criar nem gerir instâncias e clusters. Depois de o emulador ser iniciado, pode estabelecer ligação ao mesmo através de qualquer nome de projeto e instância para criar tabelas e ler ou escrever dados. O emulador não suporta uma ligação segura.
Instale e execute o emulador
As duas formas mais comuns de executar o emulador são através da CLI gcloud e do Docker. Escolha a forma adequada ao seu desenvolvimento de aplicações e fluxo de trabalho de teste.
Configure a autenticação
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
CLI gcloud
Atualize a instalação da CLI gcloud para receber as funcionalidades mais recentes:
gcloud components update beta
Execute o seguinte comando para iniciar o emulador:
gcloud beta emulators bigtable start
Se o emulador ainda não estiver instalado, é-lhe pedido que transfira e instale o ficheiro binário do emulador.
O emulador imprime o anfitrião e o número da porta onde está a ser executado.
Por predefinição, o emulador escolhe
localhost:8086
. Para associar o emulador a um anfitrião e uma porta específicos, use a flag--host-port
opcional, substituindo HOST e PORT:gcloud beta emulators bigtable start --host-port=HOST:PORT
Segue-se um exemplo:
gcloud beta emulators bigtable start --host-port=localhost:8086
Escreva Control-C para parar o emulador.
Docker
Certifique-se de que o Docker está instalado no seu sistema e disponível no caminho do sistema.
Inicie o emulador:
docker run -p 127.0.0.1:8086:8086 --rm -ti google/cloud-sdk gcloud beta emulators bigtable start --host-port=0.0.0.0:8086
Este comando executa o emulador e mapeia as portas no contentor para as mesmas portas no seu anfitrião local.
Também pode usar o emulador como parte do seu ficheiro de configuração do Docker Compose existente (.yaml
).
Para mais informações sobre o Docker Compose, consulte o artigo Vista geral do Docker Compose.
Use as bibliotecas cliente com o emulador
Defina a variável de ambiente BIGTABLE_EMULATOR_HOST
para usar as bibliotecas de cliente com o emulador:
Linux / macOS
export BIGTABLE_EMULATOR_HOST=localhost:8086
Windows
set BIGTABLE_EMULATOR_HOST=localhost:8086
Quando a aplicação é iniciada, a biblioteca de cliente verifica automaticamente
BIGTABLE_EMULATOR_HOST
e liga-se ao emulador se este estiver em execução.
Depois de definir BIGTABLE_EMULATOR_HOST
, pode testar o emulador seguindo os
exemplos de Olá, mundo!.
Para parar o emulador, escreva Control-C e, de seguida, anule a definição de BIGTABLE_EMULATOR_HOST
com o seguinte comando:
unset BIGTABLE_EMULATOR_HOST
Wrapper Java para o emulador
O wrapper Java agrupa o emulador Bigtable incorporado e fornece uma interface Java para escrever testes.
Para mais informações sobre a utilização do wrapper Java, consulte o repositório do GitHub.
A seguinte documentação fornece mais informações sobre os pacotes Java do emulador:
Filtros
O emulador suporta todos os filtros, exceto o filtro de limitação Sink
.
Os problemas relacionados com o emulador do Bigtable são acompanhados no repositório do GitHub google-cloud-go, onde pode apresentar relatórios de erros e pedidos de funcionalidades, ou comentar problemas existentes.