Änderungsstreams konfigurieren
Wenn Sie Datenänderungen an einer Bigtable-Tabelle verfolgen möchten, können Sie einen Änderungsstream für die Tabelle aktivieren und dann mit einer Anwendung wie Dataflow lesen. Bevor Sie dieses Dokument lesen, sollten Sie die Übersicht über Änderungsstreams lesen. Sie müssen sich insbesondere über die Kosten informieren, die bei Streamingänderungen anfallen.
Auf dieser Seite wird beschrieben, wie Sie die Aufbewahrungsdauer für einen Änderungsstream aktivieren, deaktivieren und ändern.
Eine Anleitung zum Erstellen einer neuen Tabelle mit aktiviertem Änderungsstream finden Sie unter Tabelle erstellen.
Erforderliche Rolle
Bitten Sie Ihren Administrator, Ihnen die folgende IAM-Rolle zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Aktivieren, Deaktivieren oder Ändern eines Bigtable-Änderungsstreams benötigen.
- Bigtable-Administrator (
roles/bigtable.admin
) für die Bigtable-Instanz, die die Tabelle enthält, aus der Sie Änderungen streamen möchten
Änderungsstream aktivieren
So aktivieren Sie einen Änderungsstream für eine vorhandene Tabelle:
Console
Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.
Klicken Sie auf die Instanz mit der Tabelle, für die Sie einen Änderungsstream aktivieren möchten.
Klicken Sie im linken Bereich auf Tabellen.
Die Seite "Tabellen" enthält eine Liste der in der Instanz vorhandenen Tabellen.
Klicken Sie für die Tabelle, für die Sie einen Änderungsstream aktivieren möchten, auf Bearbeiten.
Klicken Sie auf Änderungsstream aktivieren.
Geben Sie im Feld Ablaufzeit eine Zahl zwischen 1 und 7 ein, um die Anzahl der Tage zu konfigurieren, für die Datenstream-Einträge aufbewahrt werden sollen.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud bigtable instances
tables update
, um einen Änderungsstream für eine Tabelle zu aktivieren.
gcloud bigtable instances tables update TABLE_ID \
--instance=INSTANCE_ID \
--project=PROJECT_ID \
--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD
Ersetzen Sie Folgendes:
TABLE_ID
: die ID der Tabelle, deren Änderungen Sie streamen möchtenINSTANCE_ID
: die Instanz, die die Tabelle enthältPROJECT_ID
: das Projekt, das die Instanz enthältCHANGE_STREAM_RETENTION_PERIOD
: Der Zeitraum, über den die Änderungsstreamdaten für die Tabelle in Bigtable beibehalten werden sollen. Darf nicht weniger als ein und höchstens sieben Tage betragen, angegeben als Zahl und Buchstabe für die Einheit. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s). Beispiel:5d
Änderungsstream deaktivieren
Sie können den Änderungsstream einer Tabelle jederzeit deaktivieren. Datenstream-Einträge, die vor dem Deaktivieren des Änderungsstreams erstellt wurden, verbrauchen weiterhin Speicher bis zur nächsten Verdichtung. Dieser Speicher wird Ihnen jedoch nicht mehr in Rechnung gestellt. Sie können einen Änderungsstream nach dem Deaktivieren nicht mehr lesen. Dies gilt auch für Änderungen, die vor dem Deaktivieren des Streams aufgezeichnet wurden.
Console
Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.
Klicken Sie auf die Instanz, deren Tabellen Sie abrufen möchten.
Klicken Sie im linken Bereich auf Tabellen.
Die Seite "Tabellen" enthält eine Liste der in der Instanz vorhandenen Tabellen.
Klicken Sie bei der Tabelle, deren Änderungsstreamkonfiguration Sie deaktivieren möchten, auf Bearbeiten.
Entfernen Sie das Häkchen neben Änderungsstream aktivieren.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud bigtable instances
tables update
, um einen Änderungsstream für eine Tabelle zu deaktivieren.
gcloud bigtable instances tables update TABLE_ID \
--instance=INSTANCE_ID \
--project=PROJECT_ID \
--clear-change-stream-retention-period
Ersetzen Sie Folgendes:
TABLE_ID
: die ID der Tabelle, deren Änderungen Sie streamen möchtenINSTANCE_ID
: die Instanz, die die Tabelle enthältPROJECT_ID
: das Projekt, das die Instanz enthält
Aufbewahrungsdauer eines Änderungsstreams ändern
Sie können die Anzahl der Tage ändern, die Bigtable Ihre Änderungsstreameinträge speichert. Wenn Sie die Anzahl der Tage reduzieren, verbrauchen Datensätze, die vor der Konfigurationsänderung gestreamt wurden, bis zur nächsten Verdichtung weiterhin Speicherplatz. Nach der Konfigurationsänderung können Sie nur Änderungen aus dem neuen Zeitraum streamen.
Wenn Sie die Aufbewahrungsdauer verlängern, gilt das nicht rückwirkend. Änderungsstreams werden für die zusätzliche Anzahl von Tagen ab der Änderung der Konfiguration beibehalten.
Console
Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.
Klicken Sie auf die Instanz, deren Tabellen Sie abrufen möchten.
Klicken Sie im linken Bereich auf Tabellen.
Die Seite "Tabellen" enthält eine Liste der in der Instanz vorhandenen Tabellen.
Klicken Sie bei der Tabelle, deren Änderungsstreamkonfiguration Sie ändern möchten, auf Bearbeiten.
Geben Sie im Feld „Ablaufzeit“ eine Zahl zwischen 1 und 7 für die Anzahl der Tage ein, die Datenstream-Einträge aufbewahrt werden sollen.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud
bigtable instances tables
update
, um die Aufbewahrungsdauer für den Änderungsstream einer Tabelle zu ändern.
gcloud bigtable instances tables update TABLE_ID \
--instance=INSTANCE_ID \
--project=PROJECT_ID \
--change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD
Ersetzen Sie Folgendes:
TABLE_ID
: die ID der Tabelle, deren Änderungen Sie streamen möchtenINSTANCE_ID
: die Instanz, die die Tabelle enthältPROJECT_ID
: das Projekt, das die Instanz enthältCHANGE_STREAM_RETENTION_PERIOD
: Der Zeitraum, über den die Änderungsstreamdaten für die Tabelle in Bigtable beibehalten werden sollen. Muss zwischen einem und sieben Tagen liegen, ausgedrückt als Zahl und Buchstabe für die Einheit. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s). Beispiel:5d
Nächste Schritte
- Änderungsstream mit Dataflow lesen.
- Bigtable-Preise
- In dieser Kurzanleitung erfahren Sie, wie Sie einen Änderungsstream aktivieren und Änderungen aufrufen.
- Änderungsstreams mit der Cloud Bigtable-Clientbibliothek für Java lesen
- Anleitung zum Verarbeiten eines Änderungsstreams durcharbeiten