Ä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

  1. Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz mit der Tabelle, für die Sie einen Änderungsstream aktivieren möchten.

  3. Klicken Sie im linken Bereich auf Tabellen.

    Die Seite "Tabellen" enthält eine Liste der in der Instanz vorhandenen Tabellen.

  4. Klicken Sie für die Tabelle, für die Sie einen Änderungsstream aktivieren möchten, auf Bearbeiten.

  5. Klicken Sie auf Änderungsstream aktivieren.

  6. 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.

  7. 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öchten
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_ID: das Projekt, das die Instanz enthält
  • CHANGE_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

  1. Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, deren Tabellen Sie abrufen möchten.

  3. Klicken Sie im linken Bereich auf Tabellen.

    Die Seite "Tabellen" enthält eine Liste der in der Instanz vorhandenen Tabellen.

  4. Klicken Sie bei der Tabelle, deren Änderungsstreamkonfiguration Sie deaktivieren möchten, auf Bearbeiten.

  5. Entfernen Sie das Häkchen neben Änderungsstream aktivieren.

  6. 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öchten
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_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

  1. Öffnen Sie die Liste der Bigtable-Instanzen in der Google Cloud Console.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, deren Tabellen Sie abrufen möchten.

  3. Klicken Sie im linken Bereich auf Tabellen.

    Die Seite "Tabellen" enthält eine Liste der in der Instanz vorhandenen Tabellen.

  4. Klicken Sie bei der Tabelle, deren Änderungsstreamkonfiguration Sie ändern möchten, auf Bearbeiten.

  5. 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.

  6. 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öchten
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_ID: das Projekt, das die Instanz enthält
  • CHANGE_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