Änderungsstreams konfigurieren

Wenn Sie Datenänderungen an einer Bigtable-Tabelle verfolgen möchten, können Sie einen Änderungsstream für die Tabelle aktivieren und ihn dann mit einer Anwendung wie Dataflow lesen. Bevor Sie dieses Dokument lesen, sollten Sie sich die Übersicht über Änderungsstreams ansehen. Achten Sie insbesondere darauf, dass Sie sich der Kosten bewusst sind, die beim Streaming von Ä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 zuzuweisen, 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 in der Google Cloud Console die Liste der Bigtable-Instanzen.

    Liste der Instanzen öffnen

  2. Klicken Sie auf die Instanz, die die Tabelle enthält, 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-Eintragsdaten 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 gestreamt werden sollen
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_ID: das Projekt, das die Instanz enthält
  • CHANGE_STREAM_RETENTION_PERIOD: die Dauer, für die Bigtable Änderungsstream-Daten für die Tabelle aufbewahren soll. Muss mindestens einen und höchstens sieben Tage lang sein und als Zahl und Buchstabe für die Einheit angegeben werden. 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ägne, die erstellt wurden, bevor Sie den Änderungsstream deaktiviert haben, belegen weiterhin Speicherplatz bis zur nächsten Datenkomprimierung. Dieser Speicherplatz wird Ihnen jedoch nicht mehr in Rechnung gestellt. Nachdem Sie einen Änderungsstream deaktiviert haben, können Sie ihn nicht mehr lesen. Das gilt auch für Änderungen, die vor der Deaktivierung des Streams erfasst wurden.

Console

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

    Zur Liste der Instanzen

  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 für die Tabelle, deren Änderungsstreamkonfiguration Sie deaktivieren möchten, auf Bearbeiten.

  5. Entfernen Sie das Häkchen bei Ä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 gestreamt werden sollen
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_ID: das Projekt, das die Instanz enthält

Aufbewahrungszeit eines Änderungsstreams ändern

Sie können die Anzahl der Tage ändern, für die Ihre Änderungsstream-Einträghe in Bigtable aufbewahrt werden. Wenn Sie die Anzahl der Tage reduzieren, belegen Datensätze, die vor der Konfigurationsänderung gestreamt wurden, weiterhin Speicherplatz bis zur nächsten Datenkomprimierung. Nach der Konfigurationsänderung können Sie nur Änderungen aus dem neu angegebenen Zeitraum streamen.

Wenn Sie die Aufbewahrungsdauer verlängern, hat das keine rückwirkende Wirkung. Änderungsstreams werden ab dem Zeitpunkt, an dem Sie die Konfiguration ändern, für die angegebene Anzahl von Tagen aufbewahrt.

Console

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

    Zur Liste der Instanzen

  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 für die 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, für die Datenstream-Eintragsdaten 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 gestreamt werden sollen
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_ID: das Projekt, das die Instanz enthält
  • CHANGE_STREAM_RETENTION_PERIOD: die Dauer, für die Bigtable Änderungsstream-Daten für die Tabelle aufbewahren soll. Muss zwischen einem und sieben Tagen liegen und als Zahl und Buchstabe für die Einheit angegeben werden. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s). Beispiel: 5d

Nächste Schritte