Ä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 über die Kosten im Klaren sind, die bei Streamingänderungen anfallen.

Auf dieser Seite wird beschrieben, wie Sie den Aufbewahrungszeitraum 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

Einen Ä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 Datenstreamdatensätze 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 ist das Projekt, das die Instanz enthält.
  • CHANGE_STREAM_RETENTION_PERIOD: Die Zeitspanne, für die Bigtable Änderungsstreamdaten für die Tabelle aufbewahren soll. Muss mindestens einen Tag und höchstens sieben Tage betragen. Die Angabe erfolgt 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. Datensatzänderungen, die vor dem Deaktivieren des Änderungsstreams erstellt wurden, belegen weiterhin Speicherplatz bis zur nächsten Kompaktierung. Dieser Speicherplatz wird Ihnen jedoch nicht mehr in Rechnung gestellt. Sie können einen Änderungsstream nicht mehr lesen, nachdem Sie ihn deaktiviert haben. Das gilt auch für Änderungen, die vor der Deaktivierung des Streams aufgezeichnet wurden.

Console

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

    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 für die Tabelle, deren Change Stream-Konfiguration 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 Sie streamen möchten
  • INSTANCE_ID: die Instanz, die die Tabelle enthält
  • PROJECT_ID ist das Projekt, das die Instanz enthält.

Aufbewahrungsdauer eines Änderungsstreams ändern

Sie können die Anzahl der Tage ändern, die Bigtable Ihre Änderungsstream-Datensätze aufbewahrt. Wenn Sie die Anzahl der Tage verringern, belegen Aufzeichnungen, die vor der Konfigurationsänderung gestreamt wurden, weiterhin Speicherplatz, bis zur nächsten Kompaktierung. Nach der Konfigurationsänderung können Sie nur noch Änderungen aus dem neu angegebenen Zeitraum streamen.

Wenn Sie die Aufbewahrungsdauer verlängern, gilt das nicht rückwirkend. Änderungsstreams werden ab dem Zeitpunkt der Änderung der Konfiguration für die verlängerte Anzahl von Tagen aufbewahrt.

Console

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

    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 für die Tabelle, deren Change Stream-Konfiguration 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-Datensätze 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 ist das Projekt, das die Instanz enthält.
  • CHANGE_STREAM_RETENTION_PERIOD: Die Zeitspanne, für die Bigtable Änderungsstreamdaten 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