Esta página foi traduzida pela API Cloud Translation.

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.

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
```
Nota: se quiser executar vários emuladores, certifique-se de que, quando iniciar o emulador, especifica o anfitrião e a porta explicitamente.
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.