Tabellen erstellen und verwalten

Mit Bigtable-Tabellen können Sie große Datenmengen für Anwendungsworkloads mit niedriger Latenz organisieren und speichern. Sie können diese Tabellen mit der Google Cloud Console, der Google Cloud CLI, der cbt-CLI oder programmatisch mit den Clientbibliotheken von Cloud Bigtable erstellen und verwalten.

Weitere Informationen zum Erstellen und Verwalten autorisierter Ansichten einer Tabelle finden Sie unter Autorisierte Ansichten.

Hinweis

Wenn Sie Ihre Tabellen mithilfe von Befehlszeilentools bearbeiten möchten, folgen Sie den Schritten in diesem Abschnitt.

1. Installieren Sie die gcloud CLI.

2. Optional: Wenn Sie die cbt-Befehlszeile verwenden möchten, folgen Sie der Anleitung unter cbt-Befehlszeile installieren , einschließlich des Schritts zum Erstellen einer .cbtrc-Datei.

   Bei den Anleitungen der cbt-Befehlszeile auf dieser Seite wird davon ausgegangen, dass die Projekt-ID und die Instanz-ID in der Datei .cbtrc festgelegt sind. Alternativ können Sie diese Werte mit den Flags -project und -instance bei jeder Ausführung eines cbt-CLI-Befehls festlegen.

Tabelle erstellen

Wenn Sie eine Tabelle erstellen, müssen Sie die in der Tabelle zu verwendenden Spaltenfamilien nicht angeben. Sie können Spaltenfamilien später löschen oder hinzufügen.

Console

So erstellen Sie eine Tabelle in einer Instanz:

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

   Liste der Instanzen öffnen

2. Klicken Sie auf die Instanz, in der Sie die Tabelle erstellen möchten.

3. Klicken Sie im Bigtable-Navigationsmenü auf Tabellen.

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

4. Klicken Sie auf Tabelle erstellen.

5. Geben Sie im Bereich Tabelle erstellen im Feld Tabellen-ID eine permanente ID für die Tabelle ein.

6. Optional: Spaltenfamilien hinzufügen.

   Sie können Spaltenfamilien beim Erstellen der Tabelle oder später hinzufügen. Eine Tabelle muss mindestens eine Spaltenfamilie haben, damit Sie Daten in sie schreiben oder einen Änderungsstream aus ihr lesen können.

7. Optional: Wenn Sie in der Enterprise Plus-Version die Mikrosekunden-Zeitstempel-Detaillierung verwenden möchten, wählen Sie im Abschnitt Zeitstempel-Detaillierung die Option Zeitstempel in Mikrosekunden verwenden aus.

8. Optional: Aktivieren Sie einen Änderungsstream für die Tabelle. Bevor Sie einen Änderungsstream aktivieren, sollten Sie sich mit den Auswirkungen vertraut machen, einschließlich erhöhter Speicherkosten und Anforderungen an die Nutzung von Anwendungsprofilen. Weitere Informationen finden Sie unter Übersicht über Änderungsstreams.

   1. Wählen Sie Änderungsstream aktivieren aus.

   2. Geben Sie im Feld Aufbewahrungsdauer eine Ganzzahl von 1 bis 7 ein, um die Anzahl der Tage anzugeben, für die die Änderungsstreamdaten aufbewahrt werden sollen.

9. Optional: Konfigurieren Sie im Abschnitt Automatische Sicherung konfigurieren automatische Sicherungen für die Tabelle. Standardmäßig ist Automatische Sicherung aktivieren ausgewählt. Bigtable erstellt dann täglich eine Standardsicherung für alle Cluster in der Instanz und bewahrt jede Sicherung sieben Tage lang auf. Weitere Informationen finden Sie unter Automatische Sicherung verwenden.

   • Wenn Sie nicht möchten, dass Bigtable täglich Sicherungen der Tabelle erstellt, entfernen Sie das Häkchen bei Automatische Sicherung aktivieren.
   • Wenn Sie auf SSD-Instanzen tägliche Hot Backups anstelle von Standardsicherungen erstellen möchten, wählen Sie im Abschnitt Sicherungstyp die Option Hot aus. Geben Sie dann im Feld Hot zu Standard festlegen eine Ganzzahl von 1 bis 10 ein, um die Anzahl der Tage anzugeben, nach denen jede Sicherung automatisch in eine Standardsicherung übergeht. Der Standardwert ist 3 Tage und der Wert darf die Aufbewahrungsdauer nicht überschreiten. Sie können Hot nicht auswählen, wenn der mehrstufige Speicher aktiviert ist. Weitere Informationen finden Sie unter Heiße automatische Sicherungen konfigurieren.
   • Wenn Sie eine benutzerdefinierte Aufbewahrungsdauer festlegen möchten, geben Sie im Abschnitt Sicherungskonfiguration im Feld Aufbewahrungsdauer eine Ganzzahl zwischen 3 und 90 ein, um die Anzahl der Tage anzugeben, für die Sicherungen aufbewahrt werden sollen.
   • In der Enterprise Plus-Version können Sie bestimmte Cluster auswählen, in denen Bigtable tägliche Sicherungen erstellt. Wählen Sie dazu im Abschnitt Sicherungskonfiguration die Cluster in der Liste Cluster zum Sichern auswählen aus und klicken Sie dann auf OK. Weitere Informationen finden Sie unter Clusterstandorte für automatische Sicherungen konfigurieren.

10. Optional: Aktivieren Sie im Abschnitt Mehrstufigen Speicher konfigurieren den Speicher für seltenen Zugriff für die Tabelle als Teil des mehrstufigen Speichers (Vorschau). Sie können den mehrstufigen Speicher nicht aktivieren, wenn für automatische Sicherungen Hot ausgewählt ist.

    1. Klicken Sie das Kästchen Mehrstufigen Speicher aktivieren an.

    2. Geben Sie im Feld Altersschwellenwert eine Ganzzahl von 30 oder höher ein, um die Anzahl der Tage anzugeben, nach denen Bigtable Daten vom SSD-Speicher in den Speicher für seltenen Zugriff verschiebt.

11. Optional: Wenn Sie das Zeilenschlüsselschema konfigurieren möchten, wählen Sie Zeilenschlüsselschema definieren aus und gehen Sie dann so vor:

    1. Wählen Sie in der Liste Codierung einen Codierungstyp für das Zeilenschlüsselschema aus.

    2. Wenn Sie DelimitedBytes ausgewählt haben, geben Sie im Feld Trennzeichen ein Trennzeichen ein, das die Segmente in Ihren vorhandenen Zeilenschlüsseln trennt. Der Standardwert ist ein Rautezeichen (#).

    3. Geben Sie im Feld Segment einen Namen für das Segment ein, z. B. device_type.

    4. Wählen Sie in der Liste Typ den Datentyp des Zeilenschlüsselsegments aus.

    5. Je nach ausgewähltem Datentyp können Sie in der Liste Bytecodierung den Standardcodierungstyp des Zeilenschlüsselsegments beibehalten oder ändern.

    6. Optional: Wenn Ihr Zeilenschlüsselsegment mehr als einen Teil hat, klicken Sie auf Zeilenschlüsselsegment hinzufügen, um weitere Felder hinzuzufügen.

12. Klicken Sie auf Erstellen.

gcloud

Führen Sie den folgenden Befehl aus, um eine Tabelle zu erstellen. Eine vollständige Liste der Optionen finden Sie unter gcloud bigtable instances tables create.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN_FAMILIES

Ersetzen Sie Folgendes:

• TABLE_ID: Eine eindeutige ID für die neue Tabelle
• INSTANCE_ID: die ID der Instanz
• PROJECT_ID: das Projekt, das die neue Tabelle enthalten wird
• COLUMN_FAMILIES: Eine durch Kommas getrennte Liste von Spaltenfamiliennamen. Sie können später weitere Spaltenfamilien hinzufügen.

Optional:

• Wenn Sie die Tabelle vor dem Löschen schützen möchten, hängen Sie --deletion-protection an den Befehl an. Wenn Sie diese Einstellung nicht anwenden, kann die Tabelle gelöscht werden. Sie können das Löschen von Tabellen auch explizit zulassen, indem Sie --no-deletion-protection anhängen.

• Wenn Sie einen Änderungsstream für die Tabelle aktivieren möchten, geben Sie eine Aufbewahrungsdauer für die Änderungsstreamdaten an. Bevor Sie einen Änderungsstream aktivieren, sollten Sie sich über die Auswirkungen im Klaren sein, einschließlich erhöhter Speicherkosten und Anforderungen an die Nutzung von Anwendungsprofilen. Weitere Informationen finden Sie unter Übersicht über Änderungsstreams.

  --change-stream-retention-period=RETENTION_PERIOD
  

  Ersetzen Sie RETENTION_PERIOD durch die Zeitspanne, für die Bigtable Änderungsstreamdaten für die Tabelle aufbewahren soll. Der Zeitraum muss zwischen einem und sieben Tagen liegen. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s), z. B. 48h oder 6d.

• Wenn Sie möchten, dass Bigtable täglich eine Sicherung Ihrer Tabelle erstellt und jede Sicherung für die Standardaufbewahrungsdauer von sieben Tagen aufbewahrt, verwenden Sie beim Erstellen der Tabelle das Flag --enable-automated-backup.

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN_FAMILIES \
      --enable-automated-backup
  

  Wenn Sie eine andere Aufbewahrungsdauer konfigurieren möchten, verwenden Sie das Flag --automated-backup-retention-period anstelle des Flags --enable-automated-backup und geben Sie einen Wert von bis zu 90 Tagen an. Der Wert muss als Zahl mit der Einheit m, h oder d (Minuten, Stunden oder Tage) angegeben werden, z. B. 15d für 15 Tage.

  Wenn Sie Bigtable auf SSD-Instanzen so konfigurieren möchten, dass automatische Hot-Backups erstellt werden, die automatisch in Standard-Backups umgewandelt werden, verwenden Sie das Flag --automated-backup-keep-hot-duration anstelle des Flags --enable-automated-backup. Geben Sie eine Dauer von 24h (1 Tag) bis 10d (10 Tage) an, die die Aufbewahrungsdauer nicht überschreitet. Geben Sie den Wert als Zahl mit der Einheit s, m, h oder d (Sekunden, Minuten, Stunden oder Tage) an, z. B. 24h oder 2d. Weitere Informationen finden Sie unter Automatische Hot-Backups konfigurieren.

  Enterprise Plus-Version: Bigtable erstellt standardmäßig täglich eine Sicherung in allen Clustern in der Instanz der Tabelle. Wenn Sie Clusterstandorte konfigurieren möchten, an denen Bigtable eine tägliche Sicherung der Tabelle erstellen muss, verwenden Sie das Flag --automated-backup-locations anstelle des Flags --enable-automated-backup. Geben Sie eine durch Kommas getrennte Liste von Clusterstandorten an, an denen die automatische Sicherung aktiviert werden muss, z. B. us-central1-a,us-east1-b,europe-west1-c.

  Achtung: Wenn Sie die Konfiguration für automatisierte Sicherungen einer Tabelle später ändern, müssen Sie nur die Flags für die Parameter angeben, die Sie ändern möchten. Nicht angegebene Parameter behalten ihre vorhandenen Werte bei. Wenn Sie jedoch das Flag --enable-automated-backup übergeben, werden alle Parameter der automatischen Sicherungsrichtlinie auf ihre Standardwerte zurückgesetzt.

• Verwenden Sie das Flag --tiered-storage-infrequent-access-older-than, um den seltenen Zugriff als Teil des mehrstufigen Speichers (Vorabversion) zu aktivieren:

  gcloud beta bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD
  

  Ersetzen Sie AGE_THRESHOLD durch einen Wert von mindestens 30 Tagen. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s), z. B. 32d oder 32d12h.

• Verwenden Sie das Flag --timestamp-granularity, um die Zeitstempel-Granularität für die Tabelle zu konfigurieren:

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN-FAMILIES \
      --timestamp-granularity=TIMESTAMP_GRANULARITY
  

  Ersetzen Sie TIMESTAMP_GRANULARITY durch die Genauigkeitsstufe. Die Standardgenauigkeit ist Millisekunde und der Wert ist MILLIS. Wenn die Tabelle Zeitstempel mit Mikrosekundengenauigkeit akzeptieren soll, setzen Sie den Wert auf MICROS. Zeitstempel mit Mikrosekunden-Genauigkeit sind nur für Instanzen in der Enterprise Plus-Version verfügbar.

cbt

Sie können die cbt-CLI nicht verwenden, um eine Tabelle mit aktiviertem Änderungsstream zu erstellen.

Führen Sie den folgenden Befehl aus, um eine Tabelle zu erstellen:

cbt createtable TABLE_ID

Ersetzen Sie TABLE_ID durch eine eindeutige ID für die neue Tabelle.

Optional: Wenn Sie eine aggregierte Spaltenfamilie in der Tabelle erstellen möchten, hängen Sie den Aggregationstyp an den Namen der Spaltenfamilie an. Im Folgenden wird eine aggregierte Spaltenfamilie mit einer Richtlinie für die automatische Speicherbereinigung von never erstellt:

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

Ersetzen Sie Folgendes:

• TABLE_ID: Eine eindeutige ID für die neue Tabelle
• FAMILY_NAME: Eine durch Kommas getrennte Liste von Spaltenfamiliennamen. Sie können später weitere Spaltenfamilien hinzufügen.
• TYPE: der Aggregattyp. Muss intsum, intmin, intmax oder inthll sein.

Weitere Optionen finden Sie unter Tabelle erstellen in der cbt-CLI-Referenz.

Wenn Sie versehentlich eine Tabelle gelöscht haben, versuchen Sie nicht, die gelöschte Tabelle manuell zu erstellen. Verwenden Sie den gcloud CLI-Befehl bigtable instances tables undelete, um die Tabelle wiederherzustellen.

Tabelle nach dem Zeilenschlüssel teilen

Wichtiger Hinweis: Sie können Tabellenaufteilungen nur beim Erstellen einer neuen Tabelle angeben. Diese angegebenen Aufteilungen bleiben etwa 24 Stunden lang bestehen.

Zur Optimierung der Leistung teilt Bigtable Tabellen kontinuierlich auf mehrere Knoten auf. Dabei wird die gespeicherte Datenmenge gleichmäßig auf jeden Knoten verteilt und Zeilen mit häufigem Zugriff werden nach Möglichkeit auseinandergezogen. Dieser fortlaufende Prozess erfolgt automatisch.

Wenn Sie eine neue Tabelle erstellen, können Sie anfängliche Tabellenaufteilungen angeben. Bigtable teilt die Tabelle an den von Ihnen angegebenen Zeilenschlüsseln auf. Wenn die Schlüsselbereiche zu groß sind, teilt Bigtable die Tabelle weiter auf. Die anfänglichen Aufteilungen werden etwa 24 Stunden nach Abschluss der Tabellenerstellung beibehalten. Sie können bis zu 100 Zeilenschlüssel angeben, bei denen die anfänglichen Aufteilungen erfolgen sollen.

Beispielsweise können Sie bestimmte Zeilen für die Vorabaufteilung festlegen, wenn Sie viele Zeilen in die Tabelle schreiben möchten.

Eine Tabelle muss nicht unbedingt im Voraus aufgeteilt werden, es ist jedoch von Vorteil, da Cloud Bigtable so schon beim Erstellen der Tabelle darüber informiert wird, wo die Last und das Datenvolumen wahrscheinlich landen werden. Die Aufteilung im Voraus verhindert, dass Bigtable gleichzeitig die Tabellen aufteilen und die Last ausgleichen muss, während die Daten eintreffen.

Console

Sie können die Zeilen nicht im Voraus aufteilen, wenn Sie eine Tabelle mit derGoogle Cloud Console erstellen.

gcloud

Führen Sie den folgenden Befehl aus, um eine Tabelle nach Zeilenschlüssel aufzuteilen. Eine vollständige Liste der Optionen finden Sie unter gcloud bigtable instances tables create.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN_FAMILIES \
    --splits=SPLITS

Ersetzen Sie Folgendes:

• TABLE_ID: Eine eindeutige ID für die neue Tabelle
• INSTANCE_ID: die ID der Instanz
• PROJECT_ID: das Projekt, das die neue Tabelle enthalten wird
• COLUMN_FAMILIES: Eine durch Kommas getrennte Liste von Spaltenfamiliennamen. Sie können später weitere Spaltenfamilien hinzufügen.
• SPLITS: die Zeilenschlüssel, an denen die Tabelle anfänglich aufgeteilt werden soll, z. B. 10,20.

cbt

Führen Sie den folgenden Befehl aus, um eine Tabelle basierend auf dem Zeilenschlüssel im Voraus aufzuteilen:

cbt createtable TABLE_ID splits=SPLITS

Ersetzen Sie Folgendes:

• TABLE_ID: Eine eindeutige ID für die neue Tabelle
• SPLITS: eine durch Kommas getrennte Liste mit Zeilenschlüsselpräfixen, die für die Vorabaufteilung verwendet werden sollen

Verwenden Sie folgenden Befehl, um die Tabelle my-table beispielsweise im Voraus bei den Zeilenschlüsseln aufzuteilen, die mit 10 und 20 beginnen:

cbt createtable my-table splits=10,20

Spaltenfamilien in einer Tabelle anpassen

Sie können Spaltenfamilien beim Erstellen einer Tabelle oder zu einer vorhandenen Tabelle hinzufügen. Wenn für die Tabelle der Löschschutz nicht aktiviert ist, können Sie Spaltenfamilien in der Tabelle löschen.

Spaltenfamilien hinzufügen

Console

Spaltenfamilien zu einer neuen Tabelle hinzufügen

1. Klicken Sie im Bereich Tabelle erstellen für jede Spaltenfamilie, die Sie hinzufügen möchten, auf Spaltenfamilie hinzufügen.

2. Geben Sie im Feld Name der Spaltenfamilie eine eindeutige Kennung für die Spaltenfamilie ein.

3. Wählen Sie den Spaltenfamilientyp aus:

   • Standard: Erstellt eine Standardspaltenfamilie, die von Richtlinien für die automatische Speicherbereinigung verwaltet wird.
   • Aggregat: Erstellt eine Spaltenfamilie, die Daten beim Schreiben automatisch aggregiert. Sie können eine Richtlinie für die automatische Speicherbereinigung speziell für die Aggregation konfigurieren, um Richtlinien zur Datenaufbewahrung wie Zeit-Buckets zu verwalten.

4. Wenn Sie Aggregieren ausgewählt haben, wählen Sie im Feld Aggregator eine der folgenden Optionen aus:

   • Summe: Aggregiert die Summe aller Zellenwerte.
   • Min: Aggregiert den minimalen Zellenwert.
   • Max: Der maximale Zellenwert wird aggregiert.
   • HyperLogLog: Aggregiert die ungefähre Kardinalität von Zellenwerten.

5. Legen Sie die Richtlinie für die automatische Speicherbereinigung für die Spaltenfamilie fest.

6. Klicken Sie auf Fertig.

Spaltenfamilien zu einer vorhandenen Tabelle hinzufügen

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, die Sie ändern möchten, auf Bearbeiten.

5. Führen Sie für jede Spaltenfamilie, die Sie hinzufügen möchten, die folgenden Schritte aus:

   1. Klicken Sie auf Spaltenfamilie hinzufügen.
   2. Geben Sie im Feld Name der Spaltenfamilie eine eindeutige Kennung für die Spaltenfamilie ein.

   3. Wählen Sie den Spaltenfamilientyp aus:

      • Standard: Erstellt eine Standardspaltenfamilie, die von Richtlinien für die automatische Speicherbereinigung verwaltet wird.
      • Aggregat: Erstellt eine Spaltenfamilie, die Daten beim Schreiben automatisch aggregiert. Sie können eine Richtlinie für die automatische Speicherbereinigung speziell für die Aggregation konfigurieren, um Richtlinien zur Datenaufbewahrung wie Zeit-Buckets zu verwalten.

   4. Wenn Sie Aggregieren ausgewählt haben, wählen Sie im Feld Aggregator eine der folgenden Optionen aus:

      • Summe: Aggregiert die Summe aller Zellenwerte.
      • Min: Aggregiert den minimalen Zellenwert.
      • Max: Der maximale Zellenwert wird aggregiert.
      • HyperLogLog: Aggregiert die ungefähre Kardinalität von Zellenwerten.

   5. Legen Sie die Richtlinie für die automatische Speicherbereinigung für die Spaltenfamilie fest.

   6. Klicken Sie auf Fertig.

6. Klicken Sie auf Speichern.

gcloud

Sie können die gcloud CLI nicht verwenden, um einer Tabelle Spaltenfamilien hinzuzufügen.

cbt

Führen Sie den folgenden Befehl aus, um einer Tabelle eine Spaltenfamilie hinzuzufügen:

cbt createfamily TABLE_ID FAMILY_NAME

Ersetzen Sie Folgendes:

• TABLE_ID: die ID der Tabelle, in der die Spaltenfamilie hinzugefügt werden soll
• FAMILY_NAME: der Name der hinzuzufügenden Spaltenfamilie

Führen Sie beispielsweise den folgenden Befehl aus, um die Spaltenfamilien cf1 und cf2 zur Tabelle my-table hinzuzufügen:

cbt createfamily my-table cf1
cbt createfamily my-table cf2

Optional: Wenn Sie der Tabelle eine aggregierte Spaltenfamilie hinzufügen möchten, hängen Sie den Aggregationstyp an den Namen der Spaltenfamilie an. Im Folgenden wird eine Tabelle mit einer aggregierten Spaltenfamilie mit einer Richtlinie für die automatische Speicherbereinigung von never erstellt.

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

Ersetzen Sie Folgendes:

• TABLE_ID: die Tabellen-ID
• FAMILY_NAME: Eine durch Kommas getrennte Liste von Spaltenfamiliennamen. Sie können später weitere Spaltenfamilien hinzufügen.
• TYPE: der Aggregationstyp. Muss intsum, intmin, intmax oder inthll sein.

Spaltenfamilien löschen

Sie können Spaltenfamilien in einer Tabelle löschen, für die der Löschschutz nicht aktiviert ist.

Warnung: Wenn Sie eine Spaltenfamilie löschen, werden auch die in dieser Spaltenfamilie gespeicherten Daten gelöscht. Das Löschen einer Spaltenfamilie kann nicht rückgängig gemacht werden.

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, die Sie ändern möchten, auf Bearbeiten.

5. Führen Sie für jede Spaltenfamilie, die Sie löschen möchten, die folgenden Schritte aus:

   1. Bewegen Sie den Mauszeiger auf die Zeile für die Spaltenfamilie, die Sie löschen möchten.
   2. Klicken Sie auf .

6. Klicken Sie auf Speichern.

7. Geben Sie „Spaltenfamilien löschen“ in das Textfeld ein, um zu bestätigen, dass Sie verstanden haben, dass das Löschen einer Spaltenfamilie endgültig ist und alle Daten in der Spaltenfamilie gelöscht werden.

8. Klicken Sie auf Bestätigen.

gcloud

Sie können die gcloud CLI nicht verwenden, um Spaltenfamilien aus einer Tabelle zu löschen.

cbt

Führen Sie den folgenden Befehl aus, um eine Spaltenfamilie aus einer Tabelle zu löschen:

cbt deletefamily TABLE_ID FAMILY_NAME

Ersetzen Sie Folgendes:

• TABLE_ID: die ID der Tabelle, aus der die Spaltenfamilie gelöscht werden soll
• FAMILY_NAME: Der Name der zu löschenden Spaltenfamilie.

Führen Sie beispielsweise den folgenden Befehl aus, um die Spaltenfamilie cf2 aus der Tabelle my-table zu löschen:

cbt deletefamily my-table cf2

Tabellenliste abrufen

Console

So können Sie eine Liste der in einer Instanz vorhandenen Tabellen abrufen:

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.

   • Klicken Sie auf den Pfeil neben der Tabellen-ID, um die Liste mit den Replikationen der Tabelle zu erweitern.
   • Klicken Sie neben einem Tabellennamen auf Messwerte ansehen, um Systemstatistikdaten für die Tabelle aufzurufen.

gcloud

Führen Sie den Befehl gcloud bigtable instances tables list aus, um eine Liste der Tabellen aufzurufen:

gcloud bigtable instances tables list --instances=INSTANCE_IDS

Ersetzen Sie INSTANCE_IDS durch eine durch Kommas getrennte Liste von Instanz-IDs.

cbt

Führen Sie den folgenden Befehl aus, um eine Liste der in einer Instanz vorhandenen Tabellen abzurufen:

cbt ls INSTANCE_ID

Ersetzen Sie INSTANCE_ID durch die permanente Kennung für die Instanz.

C++

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

namespace cbt = ::google::cloud::bigtable;
namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::StreamRange;
[](cbta::BigtableTableAdminClient admin, std::string const& project_id,
   std::string const& instance_id) {
  std::string instance_name = cbt::InstanceName(project_id, instance_id);

  google::bigtable::admin::v2::ListTablesRequest r;
  r.set_parent(instance_name);
  r.set_view(google::bigtable::admin::v2::Table::NAME_ONLY);

  StreamRange<google::bigtable::admin::v2::Table> tables =
      admin.ListTables(std::move(r));
  for (auto& table : tables) {
    if (!table) throw std::move(table).status();
    std::cout << table->name() << "\n";
  }
}

C#

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

// Lists tables in intance.
// Initialize request argument(s).
ListTablesRequest request = new ListTablesRequest
{
    ParentAsInstanceName = s_instanceName
};
try
{
    // Make the request.
    PagedEnumerable<ListTablesResponse, Table> response = bigtableTableAdminClient.ListTables(request);

}
catch (Exception ex)
{
    Console.WriteLine($"Error listing tables {ex.Message}");
}

Java

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

// Lists tables in the current instance.
try {
  String parent = "projects/" + projectId + "/instances/" + instanceId;
  ListTablesRequest request = ListTablesRequest.newBuilder().setParent(parent).build();
  for (Table table : adminClient.listTables(request).iterateAll()) {
    System.out.println(table.getName());
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

// List tables in current project
const [tables] = await adminClient.listTables({parent: instance.name});
tables.forEach(table => {
  console.log(table.name);
});

PHP

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableTableAdminClient;
use Google\Cloud\Bigtable\Admin\V2\ListTablesRequest;

/**
 * List tables in an instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance
 */
function list_tables(
    string $projectId,
    string $instanceId
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();
    $tableAdminClient = new BigtableTableAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    printf('Listing Tables:' . PHP_EOL);
    $listTablesRequest = (new ListTablesRequest())
        ->setParent($instanceName);
    $tables = $tableAdminClient->listTables($listTablesRequest)->iterateAllElements();
    $tables = iterator_to_array($tables);
    if (empty($tables)) {
        print('No table exists.' . PHP_EOL);
        return;
    }
    foreach ($tables as $table) {
        print($table->getName() . PHP_EOL);
    }
}

Python

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

tables = instance.list_tables()
print("Listing tables in current project...")
if tables != []:
    for tbl in tables:
        print(tbl.table_id)
else:
    print("No table exists in current project...")

Ruby

Informationen zum Installieren und Verwenden der Clientbibliothek für Bigtable finden Sie unter Bigtable-Clientbibliotheken.

Richten Sie zur Authentifizierung bei Bigtable die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

# instance_id = "my-instance"
bigtable.tables(instance_id).all.each do |t|
  puts "Table: #{t.name}"
end

Informationen zu einer Tabelle ansehen

Console

So rufen Sie Informationen zu einer Tabelle auf:

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. Für jede Tabelle zeigt die Google Cloud Console die Anzahl der Cluster an, in denen die Tabelle gespeichert ist, sowie den Status, die Speicherauslastung und die Kennungen für alle aktuellen Sicherungen der Tabelle. Für Tabellen mit aktiviertem mehrstufigem Speicher (Vorabversion) können Sie die SSD-Speicherauslastung und die Auslastung des Speichers für seltenen Zugriff aufrufen.

4. Klicken Sie auf , um die Namen der Spaltenfamilien für die Tabelle aufzurufen. Klicken Sie auf Abbrechen, um den Bereich Tabelle bearbeiten zu schließen.

5. Klicken Sie auf den Namen der Tabelle, um weitere Details zur Tabelle anzuzeigen, einschließlich Messwerte auf Tabellenebene und Replikationsstatus.

gcloud

Führen Sie den Befehl gcloud bigtable instances tables describe aus, um Informationen zu einer Tabelle aufzurufen.

gcloud bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID

Ersetzen Sie Folgendes:

• TABLE_ID: Eine eindeutige ID der Tabelle
• INSTANCE_ID: die ID der Instanz

cbt

Mit der cbt-Befehlszeile können Sie eine Liste der vorhandenen Spaltenfamilien in einer Tabelle abrufen.

Führen Sie den folgenden Befehl aus, um die Spaltenfamilien in einer Tabelle aufzurufen:

cbt ls TABLE_ID

Ersetzen Sie TABLE_ID durch die eindeutige ID der Tabelle.

Richtlinien zur automatischen Speicherbereinigung festlegen

Eine Richtlinie für die automatische Speicherbereinigung teilt Bigtable mit, welche Daten beibehalten und welche zum Löschen markiert werden sollen. Sie legen Richtlinien für die automatische Speicherbereinigung auf der Ebene der Spaltenfamilie fest, wenn Sie die Tabelle erstellen oder später.

Wenn Sie eine Spaltenfamilie erstellen, können Sie die Anzahl der Zellen angeben, die Sie in jeder Spalte der Spaltenfamilie beibehalten möchten. Wenn Sie diese Einstellung nicht angeben, verwendet Bigtable eine der folgenden Standardeinstellungen.

• Wenn Sie die Spaltenfamilie mit dem Cloud Bigtable HBase-Client für Java oder der HBase-Shell oder einem anderen Tool erstellen, das den HBase-Client für Java verwendet, behält Bigtable nur eine Zelle für jede Zeilen- oder Spaltenschnittmenge in der Spaltenfamilie bei. Diese Standardeinstellung stimmt mit HBase überein.

• Wenn Sie die Spaltenfamilie mit der Google Cloud Console, einer anderen Clientbibliothek oder mit der cbt-Befehlszeile erstellen, behält Bigtable in jeder Spalte eine unbegrenzte Anzahl von Zellen bei.

Unter Richtlinien für die automatische Speicherbereinigung konfigurieren finden Sie eine detaillierte Anleitung, wie Sie Richtlinien für die automatische Speicherbereinigung anzeigen, festlegen und aktualisieren.

Tabelle sichern und wiederherstellen

Eine Anleitung zum Sichern einer Tabelle und zum Wiederherstellen aus einer Sicherung in einer neuen Tabelle finden Sie unter Sicherungen verwalten.

Wenn Sie die automatische Sicherung beim Erstellen einer Tabelle aktivieren, können Sie die Konfiguration für die automatische Sicherung der Tabelle später ändern. Sie können die automatische Sicherung aktivieren oder deaktivieren, heiße automatische Sicherungen auf SSD-Instanzen konfigurieren, die Aufbewahrungsdauer auf bis zu 90 Tage ändern oder in der Enterprise Plus-Version die Cluster auswählen, in denen Bigtable Sicherungen speichert. Weitere Informationen finden Sie unter Automatische Sicherung verwenden.

Änderungsstream aktivieren, deaktivieren oder konfigurieren

Eine Anleitung für die folgenden Aufgaben finden Sie unter Änderungsstream konfigurieren.

• Änderungsstream für eine vorhandene Tabelle aktivieren
• Änderungsstream deaktivieren
• Aufbewahrungsdauer für einen Änderungsstream aktualisieren

Tabelle löschen

Beim Löschen einer Tabelle werden auch alle autorisierten Ansichten der Tabelle gelöscht. Wenn für autorisierte Ansichten der Tabelle der Löschschutz aktiviert ist, können Sie die Tabelle nicht löschen. Sie können auch keine Tabelle löschen, auf der eine kontinuierliche materialisierte Ansicht basiert.

Warnung: Wenn Sie eine Tabelle löschen, löschen Sie auch die in dieser Tabelle gespeicherten Daten.

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, die Sie löschen möchten, auf .

5. Klicken Sie auf Löschen.

6. Mit der Eingabe der Tabellen-ID in das Feld Tabelle löschen akzeptieren Sie, dass diese Aktion die Tabelle aus allen Clustern in der Instanz löscht und Sie nur sieben Tage Zeit haben, um die Tabelle wiederherzustellen.

7. Klicken Sie auf Löschen.

gcloud

1. Führen Sie den Befehl gcloud bigtable instances tables delete aus, um Tabellen zu löschen.

   gcloud bigtable instances tables delete TABLE_ID --instance=INSTANCE_ID
   

   Ersetzen Sie Folgendes:

   • TABLE_ID: die eindeutige ID der Tabelle
   • INSTANCE_ID: die ID der Instanz

2. Geben Sie im Terminal y ein, um das Löschen der Tabelle zu bestätigen.

cbt

Führen Sie den folgenden Befehl aus, um eine Tabelle zu löschen:

cbt deletetable TABLE_ID

Ersetzen Sie TABLE_ID durch die eindeutige ID der Tabelle.

Tabelle wiederherstellen

Wenn Sie eine Tabelle versehentlich löschen, können Sie die Tabelle mit dem gcloud CLI-Befehl bigtable instances tables undelete wiederherstellen. Versuchen Sie nicht, die gelöschte Tabelle manuell neu zu erstellen.

Führen Sie den folgenden Befehl im Terminal aus, um eine Tabelle wiederherzustellen:

gcloud bigtable instances tables undelete TABLE_ID --instance=INSTANCE_ID

Ersetzen Sie Folgendes:

• TABLE_ID: die eindeutige Kennung für die Tabelle
• INSTANCE_ID: die ID der Instanz

Wenn Sie eine Tabelle wiederherstellen, aktiviert Bigtable automatisch den Löschschutz für die Tabelle.

Es gelten folgende Einschränkungen:

• Die Möglichkeit, eine Tabelle wiederherzustellen, ist für einen Zeitraum von etwa sieben Tagen nach dem Löschen der Tabelle verfügbar.
• Mit der Google Cloud -Console, den Cloud Bigtable-Clientbibliotheken oder der cbt-Befehlszeile können gelöschte Tabellen nicht wiederhergestellt werden.
• Sie können eine Tabelle nicht aus einer Instanz wiederherstellen, die gelöscht wurde.
• Sie können eine Tabelle, für die CMEK aktiviert war, nicht wiederherstellen.
• Wenn Sie ein Downgrade der Instanz auf die Enterprise-Version durchgeführt haben, können Sie eine Tabelle mit Mikrosekunden-Zeitstempel-Granularität nicht wiederherstellen. Wenn Sie eine Tabelle wiederherstellen möchten, muss die Instanz die Enterprise Plus-Version haben.
• Wenn Sie eine Tabelle wiederherstellen, werden in Bigtable keine detaillierten IAM-Richtlinienbindungen für die gelöschte Tabelle wiederhergestellt.

Optional können Sie den Status des Vorgangs undelete in den Audit-Logs prüfen.

Löschschutz ändern

Sie können den Löschschutz für eine Tabelle aktivieren oder deaktivieren, wenn Sie Hauptkonto in einer Rolle sind, die die Berechtigung bigtable.tables.update enthält, z. B. roles/bigtable.admin. Der Löschschutz verhindert das Löschen der Tabelle, aller Spaltenfamilien in der Tabelle und der Instanz, die die Tabelle enthält.

Wenn Sie den Löschschutz für eine Tabelle aktivieren, wird er nicht für autorisierte Ansichten der Tabelle aktiviert. Wenn Sie den Löschschutz einer Tabelle deaktivieren, wird er nicht für autorisierte Ansichten der Tabelle deaktiviert. Sie müssen die autorisierten Ansichten der Tabelle separat aktualisieren.

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 neben der Tabellen-ID auf .

5. Klicken Sie auf Löschen verhindern, um den Löschschutz zu aktivieren. Klicken Sie auf Löschen aktivieren, um den Löschschutz zu deaktivieren. Nur die gültige Option ist sichtbar.

gcloud

Führen Sie den Befehl gcloud bigtable instances tables update aus, um den Löschschutz für eine Tabelle zu aktivieren:

gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --deletion-protection

Ersetzen Sie Folgendes:

• TABLE_ID: die eindeutige Kennung für die Tabelle
• INSTANCE_ID: die ID der Instanz

Führen Sie den folgenden Befehl aus, um den Löschschutz für eine Tabelle zu deaktivieren:

gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --no-deletion-protection

Ersetzen Sie Folgendes:

• TABLE_ID: die eindeutige Kennung für die Tabelle
• INSTANCE_ID: die ID der Instanz

cbt

Sie können die cbt-Befehlszeile nicht verwenden, um den Löschschutz zu aktivieren oder zu deaktivieren.

Altersgrenze für selten genutzten Speicher ändern

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Sie können den Altersschwellenwert für den seltenen Zugriff, der Teil des gestuften Speichers ist, jederzeit ändern.

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, die Sie ändern möchten, auf Bearbeiten.

5. Geben Sie im Feld Altersschwellenwert die neue Anzahl von Tagen ein, nach denen Bigtable Daten vom SSD-Speicher in den Speicher für seltenen Zugriff verschiebt. Die Zahl muss mindestens 30 sein.

gcloud

Führen Sie den Befehl gcloud beta bigtable instances tables update mit dem Flag --tiered-storage-infrequent-access-older-than aus, um den Altersschwellenwert für den Speicher mit seltenem Zugriff zu ändern:

gcloud beta bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD

Ersetzen Sie Folgendes:

• TABLE_ID: die ID der Tabelle, die Sie aktualisieren möchten
• INSTANCE_ID: die ID der Instanz
• PROJECT_ID: das Projekt, das die Tabelle enthält, die Sie aktualisieren möchten
• AGE_THRESHOLD: der Schwellenwert für das Alter, der mindestens 30 Tage betragen muss. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s), z. B. von zuvor 32d auf 33d.

Speicher für selten genutzte Daten deaktivieren

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Sie können den seltenen Zugriff auf Tiered Storage jederzeit deaktivieren. Daher verschiebt Bigtable alle Daten im Speicher für seltenen Zugriff in den SSD-Speicher. Bevor Sie den Speicher für seltenen Zugriff deaktivieren, sollten Sie sich über die Auswirkungen auf die Kosten im Klaren sein.

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, die Sie ändern möchten, auf Bearbeiten.

5. Entfernen Sie das Häkchen aus dem Kästchen Mehrstufigen Speicher aktivieren.

6. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud beta bigtable instances tables update mit dem Flag --clear-tiered-storage-config, um den Speicher für seltenen Zugriff zu deaktivieren:

gcloud beta bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --clear-tiered-storage-config

Ersetzen Sie Folgendes:

• TABLE_ID: die ID der Tabelle, die Sie aktualisieren möchten
• INSTANCE_ID: die ID der Instanz
• PROJECT_ID: das Projekt, das die Tabelle enthält, die Sie aktualisieren möchten

Nächste Schritte

• Daten in Ihre Tabelle importieren und daraus exportieren