Ä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 die Übersicht über Änderungsstreams Achten Sie insbesondere darauf, sollten Sie sich der Kosten bewusst sein, 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 mit der Tabelle, für die Sie eine Änderung aktivieren möchten. als Stream.

  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, für die Sie eine Änderung aktivieren möchten, auf Bearbeiten. .

  5. Klicken Sie auf Änderungsstream aktivieren.

  6. Geben Sie im Feld Ablaufzeit eine Zahl zwischen 1 und 7 ein, Anzahl der Tage konfigurieren, die Datenstream-Einträge enthalten sollen bleiben erhalten.

  7. Klicken Sie auf Speichern.

gcloud

Um einen Änderungsstream für eine Tabelle zu aktivieren, verwenden Sie den gcloud bigtable instances tables update .

  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: 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 nicht weniger als einen Tag und nicht mehr als sieben Tage, ausgedrückt als Zahl und einem Buchstaben 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ä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. Sie können einen Änderungsstream nicht mehr lesen, nachdem Sie deaktiviert werden. Dies 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.

    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 Änderungsstreams Sie konfigurieren möchten, auf Bearbeiten. zum Deaktivieren.

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

  6. Klicken Sie auf Speichern.

gcloud

Um einen Änderungsstream für eine Tabelle zu deaktivieren, verwenden Sie den gcloud bigtable instances tables update .

  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: 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 dies nicht rückwirkend Auswirkungen auf Änderungsstreams. werden über einen längeren Zeitraum aufbewahrt, Konfiguration.

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 Änderungsstreams Sie konfigurieren möchten, auf Bearbeiten. zu ändern.

  5. Geben Sie im Feld Ablaufzeit eine Zahl zwischen 1 und 7 ein. Tage, an denen Datensätze aus Datenstreams aufbewahrt werden sollen.

  6. Klicken Sie auf Speichern.

gcloud

Um die Aufbewahrungsdauer für den Änderungsstream einer Tabelle zu ändern, verwenden Sie den gcloud bigtable instances tables update .

  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: 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. Beispiel: 5d

Nächste Schritte