Tabellen erstellen und verwalten

Console

So erstellen Sie in einer Instanz eine neue Tabelle:

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. Geben Sie eine Tabellen-ID für die Tabelle ein.

5. Spaltenfamilien hinzufügen (optional)

   Sie können Spalten jetzt oder später hinzufügen. Eine Tabelle muss mindestens eine Spaltenfamilie haben, bevor Sie Daten in sie schreiben können. Eine Tabelle muss mindestens eine Spaltenfamilie haben, bevor Sie Daten in sie schreiben oder einen Änderungsstream daraus lesen können.

6. Optional: Aktivieren Sie einen Änderungsstream für die Tabelle. Bevor Sie einen Änderungsstream aktivieren, sollten Sie sich über die Auswirkungen im Klaren sein, z. B. über erhöhte Speicherkosten und Anforderungen an die Nutzung des App-Profils. Weitere Informationen finden Sie unter Übersicht über Änderungsstreams.

   1. Wählen Sie Änderungsstream aktivieren aus.

   2. Geben Sie im Feld Ablaufzeit eine Zahl zwischen 1 und 7 ein, um die Anzahl der Tage anzugeben, für die die Änderungsstreamdaten aufbewahrt werden sollen.

   3. Klicken Sie auf Erstellen.

7. Optional: Wenn Bigtable nicht täglich eine Sicherung der Tabelle erstellen soll, entfernen Sie das Häkchen neben Automatische Sicherung aktivieren. Weitere Informationen finden Sie unter Automatische Sicherung verwenden.

8. Klicken Sie auf Tabelle 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

Dabei gilt:

• 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 den Befehl mit --deletion-protection 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 einen Aufbewahrungszeitraum für die Änderungsstreamdaten an. Bevor Sie einen Änderungsstream aktivieren, sollten Sie sich über die Auswirkungen im Klaren sein, z. B. über erhöhte Speicherkosten und Anforderungen an die Nutzung von App-Profilen. Weitere Informationen finden Sie unter Übersicht über Änderungsstreams.

  --change-stream-retention-period=RETENTION_PERIOD
  

  Ersetzen Sie RETENTION_PERIOD durch den Zeitraum, in dem Bigtable Änderungsstreamdaten für die Tabelle beibehalten soll. Die Zeit muss zwischen einem und sieben Tagen liegen. Zulässige Einheiten sind Tage (d), Stunden (h), Minuten (m) und Sekunden (s). Beispiele: 48h oder 6d

• Wenn Sie möchten, dass Bigtable täglich eine Sicherung Ihrer Tabelle erstellt und jede Sicherung für den standardmäßigen Aufbewahrungszeitraum von sieben Tagen beibehalten wird, 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 einen anderen Aufbewahrungszeitraum 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 als Zahl mit einer Einheit von m, h oder d (Minuten, Stunden oder Tage) ausgedrückt wird, z. B. 15d für 15 Tage.

cbt

Verwenden Sie den folgenden Befehl und ersetzen Sie TABLE_NAME durch den Namen Ihrer Tabelle. Sie können die cbt-Befehlszeile nicht verwenden, um eine Tabelle mit aktiviertem Änderungsstream zu erstellen.

cbt createtable TABLE_ID

Optional: Wenn Sie eine Spaltenfamilie für aggregierte Daten in der Tabelle erstellen möchten, hängen Sie den Aggregationstyp an den Namen der Spaltenfamilie an. Mit dem folgenden Code 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.

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

Dabei gilt:

• 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 anfangs aufgeteilt werden soll, z. B. 10,20.

cbt

Wenn Sie eine Tabelle basierend auf dem Zeilenschlüssel im Voraus aufteilen möchten, erstellen Sie die Tabelle mit der folgenden Syntax. Ersetzen Sie [TABLE_NAME] durch den Tabellennamen und [SPLITS] durch eine durch Kommas getrennte Liste mit Zeilenschlüsselpräfixen, die für die Vorabaufteilung verwendet werden sollen.

```none
cbt createtable [TABLE_NAME] splits=[SPLITS]
```

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

```none
cbt createtable my-table splits=10,20
```

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 editBearbeiten.

5. Geben Sie für jede Spaltenfamilie, die Sie hinzufügen möchten, folgende Schritte ein:

   1. Klicken Sie auf Spaltenfamilie hinzufügen.
   2. Geben Sie eine eindeutige Kennung für die Spaltenfamilie ein.
   3. Legen Sie die Richtlinie für die automatische Speicherbereinigung für die Spaltenfamilie fest.
   4. Klicken Sie auf Fertig.
   5. Klicken Sie auf Speichern.

gcloud

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

cbt

Den folgenden Befehl verwenden, um eine Spaltenfamilie hinzuzufügen:

cbt createfamily TABLE_ID FAMILY_NAME

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 Namen der Spaltenfamilie an den Aggregationstyp an. Mit dem folgenden Befehl 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.

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 editBearbeiten.

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 delete.

6. Klicken Sie auf Speichern.

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

8. Klicken Sie auf Bestätigen.

gcloud

Mit der gcloud CLI können Sie keine Spaltenfamilien aus einer Tabelle löschen.

cbt

Verwenden Sie den folgenden Befehl, um eine Spaltenfamilie aus einer Tabelle zu löschen. Dabei ersetzen Sie [TABLE_NAME] durch den Tabellennamen und [FAMILY_NAME] durch den Namen der Spaltenfamilie:

cbt deletefamily [TABLE_NAME] [FAMILY_NAME]

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

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 Daten zu Systemstatistiken für die Tabelle anzeigen zu lassen.

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 Folgendes:

• INSTANCE_IDS: 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 Folgendes:

• INSTANCE_ID: Die permanente Kennzeichnung der Instanz.

C++

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#

// 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

// Lists tables in the current instance.
try {
  List<String> tableIds = adminClient.listTables();
  for (String tableId : tableIds) {
    System.out.println(tableId);
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

// List tables in current project
const [tables] = await instance.getTables();
tables.forEach(table => {
  console.log(table.id);
});

PHP

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

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

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

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.

4. Klicken Sie auf edit, 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

Wenn Sie Informationen zu einer Tabelle aufrufen möchten, führen Sie den Befehl gcloud bigtable instances tables describe aus.

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.

Verwenden Sie den folgenden Befehl und ersetzen Sie dabei [TABLE_NAME] durch den Tabellennamen:

cbt ls [TABLE_NAME]

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 more_vert.

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 zum Löschen von Tabellen den Befehl gcloud bigtable instances tables delete aus.

   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

Zum Löschen einer Tabelle verwenden Sie den im Folgenden aufgeführten Befehl. Ersetzen Sie dabei [TABLE_NAME] durch den Tabellennamen:

cbt deletetable [TABLE_NAME]

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 more_vert.

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. Es wird nur die gültige Option angezeigt.

gcloud

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

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

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

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

Dabei gilt:

+ TABLE_ID: the unique identifier for the table
+ INSTANCE_ID: the ID of the instance

cbt

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