Änderungsstreams konfigurieren

Wenn Sie Datenänderungen an einer Bigtable-Tabelle nachverfolgen 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. Machen Sie sich insbesondere mit den Kosten vertraut, die beim Streamen von Ä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

Änderungsstream aktivieren

Führen Sie die folgenden Schritte aus, um einen Änderungsstream für eine vorhandene Tabelle zu aktivieren:

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 gcloud bigtable instances tables update Befehl, 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: die Zeitspanne, für die Bigtable Änderungsstreamdaten für die Tabelle aufbewahren soll. Sie muss mindestens einen und höchstens sieben Tage betragen 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. Datenstreamdatensätze, die vor der Deaktivierung des Änderungsstreams erstellt wurden, belegen weiterhin Speicherplatz bis zur nächsten Komprimierung. Ihnen werden diese Speicherkosten jedoch nicht mehr in Rechnung gestellt. Nach der Deaktivierung können Sie einen Änderungsstream nicht mehr lesen, auch nicht die Ä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 Änderungsstreamkonfiguration Sie deaktivieren möchten, auf Bearbeiten.

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

  6. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den gcloud bigtable instances tables update Befehl, 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

Aufbewahrungszeit für einen Änderungsstream ändern

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

Wenn Sie die Aufbewahrungszeit verlängern, gilt dies 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 Ä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 Datenstreamdatensätze aufbewahrt werden sollen.

  6. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den gcloud bigtable instances tables update Befehl, um den Aufbewahrungszeitraum 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: die Zeitspanne, für die Bigtable Änderungsstreamdaten für die Tabelle aufbewahren soll. Sie 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