Mit dem Emulator testen

Die Google Cloud CLI stellt einen lokalen Emulator im Speicher für Bigtable zur Verfügung. Mit ihm können Sie Ihre Anwendung testen. Da der Emulator die Daten nur zwischenspeichert, behält er keine Daten über die verschiedenen Testläufe bei. Es soll Sie dabei unterstützen, Bigtable für lokale Entwicklungsaufgaben und Tests einzusetzen, und ist nicht für Produktionsbereitstellungen bestimmt.

Sie können den Emulator mit allen Cloud Bigtable-Clientbibliotheken verwenden.

Der Emulator stellt keine Admin-API zur Verfügung, um Instanzen und Cluster zu erstellen oder zu verwalten. Nach dem Start des Emulators können Sie sich mit jedem Instanz- oder Projektnamen mit ihm verbinden, um Tabellen zu erstellen und Daten zu lesen oder zu schreiben. Der Emulator unterstützt keine sichere Verbindung.

Emulator installieren und ausführen

Die zwei gängigsten Methoden zum Ausführen des Emulators sind die gcloud CLI und Docker. Wählen Sie die für Ihre Anwendungsentwicklung und Ihren Workflow geeignete Methode.

Authentifizierung einrichten

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

gcloud CLI

Aktualisieren Sie die Installation der gcloud CLI, um die neuesten Features zu erhalten:
```
gcloud components update beta
```
Verwenden Sie den folgenden Befehl, um den Emulator zu starten:
```
gcloud beta emulators bigtable start
```
Wenn der Emulator noch nicht installiert ist, werden Sie zum Herunterladen und zur Installation des ausführbaren Programms weitergeleitet.

Der Emulator gibt den Host und die Portnummer aus, wenn er ausgeführt wird.

Standardmäßig wählt der Emulator localhost:8086 aus. Binden Sie den Emulator mit dem optionalen --host-port Flag an einen bestimmten Host und Port. Ersetzen Sie dabei HOST und PORT mit Ihren Werten:
```
gcloud beta emulators bigtable start --host-port=HOST:PORT
```
Hier ein Beispiel:
```
gcloud beta emulators bigtable start --host-port=localhost:8086
```
Hinweis: Wenn Sie mehrere Emulatoren ausführen möchten, müssen Sie beim Starten des Emulators den Host und den Port explizit angeben.
Geben Sie Control-C ein, um den Emulator anzuhalten.

Docker

Prüfen Sie, ob Docker auf Ihrem System installiert und im Systempfad verfügbar ist.
Starten Sie den Emulator:
```
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
```
Der Befehl führt den Emulator aus und ordnet die Ports im Container den entsprechenden Ports auf Ihrem lokalen Host zu.

Sie können den Emulator auch als Teil Ihrer vorhandenen Docker Compose-Konfigurationsdatei (.yaml) verwenden. Weitere Informationen zu Docker Compose finden Sie in der Docker Compose-Übersicht.

Clientbibliotheken mit dem Emulator verwenden

Legen Sie die Umgebungsvariable BIGTABLE_EMULATOR_HOST fest, um die Clientbibliotheken mit dem Emulator zu verwenden:

Linux / macOS

  export BIGTABLE_EMULATOR_HOST=localhost:8086

Windows

  set BIGTABLE_EMULATOR_HOST=localhost:8086

Wenn Ihre Anwendung gestartet wird, sucht die Clientbibliothek automatisch nach BIGTABLE_EMULATOR_HOST und stellt eine Verbindung zum Emulator her, wenn er ausgeführt wird.

Sobald BIGTABLE_EMULATOR_HOST festgelegt ist, können Sie den Emulator mit den Beispielen für „Hallo Welt“ testen.

Um den Emulator zu beenden, geben Sie Control-C ein und deaktivieren Sie dann BIGTABLE_EMULATOR_HOST mit dem folgenden Befehl:

    unset BIGTABLE_EMULATOR_HOST

Java-Wrapper für den Emulator

Der Java-Wrapper bündelt den integrierten Bigtable-Emulator und bietet eine Java-Schnittstelle zum Schreiben von Tests.

Weitere Informationen zur Verwendung des Java-Wrappers finden Sie im GitHub-Repository.

In der folgenden Dokumentation finden Sie weitere Informationen zu den Java-Paketen des Emulators:

Filter

Der Emulator unterstützt alle Filter mit Ausnahme des Sink begrenzenden Filters.

Probleme mit dem Bigtable-Emulator werden im google-cloud-go GitHub-Repository erfasst. Dort können Sie Fehler berichte und Feature Requests einreichen oder vorhandene Probleme kommentieren.