Tabellenstatistiken

Cloud Bigtable bietet Tabellenstatistiken – Metadaten zu einer Tabelle –, die Ihnen zusammenfassende Informationen zur Tabelle liefern, z. B. die Anzahl der Zeilen oder die durchschnittliche Anzahl der Zellen pro Spalte.

In diesem Dokument werden Tabellenstatistiken und ihre Verwendung mit der Google Cloud CLI beschrieben. Bevor Sie diese Seite lesen, sollten Sie das Bigtable-Speichermodell verstehen und mit den Best Practices für Schemadesign und der Automatische Speicherbereinigung vertraut sein

Tabellenstatistiken liefern Beobachtbarkeit in einer Bigtable-Tabelle. Sie können nützlich sein, wenn Sie Probleme mit der Leistung oder dem Speicher beheben oder die Quelle der Speicherkosten ermitteln möchten. Sie können auch feststellen, ob Sie mehr Daten speichern, als Sie benötigen.

Erwartete Genauigkeit

Wenn Sie Tabellenstatistiken für eine Tabelle abrufen, sind die Daten eine ungefähre Angabe. Die Tabellenstatistiken spiegeln den Status der Tabelle in einem der Cluster der Instanz seit der letzten Verdichtung wider.

Ein vollständiger Satz von Tabellenstatistiken ist erst nach der ersten Verdichtung verfügbar, die in der Regel etwa eine Woche nach dem Erstellen der Tabelle auftritt. Die Tabellenstatistiken beziehen sich auf die letzte Verdichtung, die bis zu einer Woche zurückliegen kann.

Tabellenstatistikfelder

Eine Anfrage für die Tabellenstatistiken einer Tabelle gibt die folgenden Felder zurück. Details und Beispiele finden Sie im nächsten Abschnitt.

Feld „Tabellenstatistik“	API-Name	Beschreibung
Zeilenanzahl	row_count	Die Anzahl der Zeilen in der Tabelle Weitere Informationen finden Sie unter Zeilenanzahl.
Durchschnittliche Spaltenanzahl pro Zeile	average_columns_per_row	Die durchschnittliche Anzahl der Spalten in jeder Zeile für die gesamte Tabelle. Weitere Informationen und ein Beispiel finden Sie unter Durchschnittliche Anzahl der Spalten pro Zeile.
Durchschnittliche Anzahl der Zellen pro Spalte	average_cells_per_column	Die durchschnittliche Anzahl der Zellen, die in allen Spalten und Zeilen gespeichert sind. Weitere Informationen finden Sie unter Durchschnittliche Anzahl der Zellen pro Spalte.
Logische Daten in Byte	logical_data_bytes	Der von der Tabelle belegte Speicherplatz. Weitere Informationen finden Sie unter Logische Daten in Byte.

Tabellenstatistiken enthalten auch die folgenden Felder für jede Spaltenfamilie in der Tabelle.

Feld „Statistik der Spaltenfamilie“	API-Name	Beschreibung
Durchschnittliche Spaltenanzahl pro Zeile	average_columns_per_row	Die durchschnittliche Anzahl der Spalten pro Zeile in der Spaltenfamilie. Weitere Informationen und ein Beispiel finden Sie unter Durchschnittliche Anzahl der Spalten pro Zeile.
Durchschnittliche Anzahl der Zellen pro Spalte	average_cells_per_column	Die Anzahl der Zellen in jeder Spalte, gemittelt über alle Zeilen mit Spalten in der Spaltenfamilie. Weitere Informationen und ein Beispiel finden Sie im Hilfeartikel Durchschnittliche Anzahl der Zellen pro Spalte.
Logische Daten in Byte	logical_data_bytes	Der Speicherplatz, den die Spaltenfamilie belegt. Weitere Informationen finden Sie unter Logische Daten in Byte.

Details zum Feld „Tabellenstatistiken“

Zeilenanzahl

Die Zeilenanzahl ist die Anzahl der Zeilen in der Tabelle. Jede Zeile wird durch einen Zeilenschlüssel identifiziert.

Durchschnittliche Spaltenanzahl pro Zeile

Um die durchschnittliche Anzahl der Spalten pro Zeile für eine Tabelle zu ermitteln, zählt Bigtable die Anzahl der Spalten in der gesamten Tabelle und teilt diesen Wert durch die Anzahl der Zeilen in der Tabelle.

Schlüsselbegriff: Eine Spalte ist die Kombination aus Spaltenfamilie und Spaltenqualifizierer einer Zeile. Wenn dieselbe Kombination aus Spaltenfamilie und Spaltenqualifizierer in 1.000 Zeilen verwendet wird, wird die Kombination 1.000-mal als Spalte gezählt.

Sehen Sie sich als Beispiel die folgende Tabelle an. Die erste Zeile hat drei Spalten und die zweite Zeile hat zwei Spalten.

Zeilenschlüssel	Spaltenfamilie Familie-A		Spaltenfamilie-B
Zeilenschlüssel 1	Familie-A:Qualifizierer-W	Familie-A:Qualifizierer-X	Familie-B:Qualifier-Y
Zeilenschlüssel 2	Familie-A:Qualifizierer-W			Familie-B:Qualifier-Z

Die Tabelle hat fünf Spalten und zwei Zeilen. Die durchschnittliche Anzahl der Spalten pro Zeile ist also 2.5.

Diese Tabellenstatistik gibt Ihnen eine allgemeine Vorstellung davon, ob Ihre Tabelle hoch und schmal ist (wenige Spalten pro Zeile) oder kurz und breit (viele Spalten in jeder Zeile).

Durchschnittliche Anzahl der Zellen pro Spalte

Um die durchschnittliche Anzahl der Zellen pro Spalte für eine Tabelle zu ermitteln, teilt Bigtable die Gesamtzahl der in der Tabelle gespeicherten Zellen durch die Anzahl der Spalten in der Tabelle.

Schlüsselbegriff: Eine Zelle enthält einen Zeitstempelwert für eine Spalte. Jede Spalte enthält mindestens eine Zelle.

Je nach Schemadesign und Richtlinien für die automatische Speicherbereinigung enthält Ihre Tabelle möglicherweise mehrere Zellen in einer Spalte oder es gibt nur eine. Die Anzahl der Zellen, die Sie speichern können, hängt von den Größenbeschränkungen auf der Seite „Kontingente und Limits“ unter Größe von Daten in Tabellen ab.

Wenn Sie feststellen, dass diese Zahl höher als erwartet ist, prüfen Sie die Regeln für die automatische Speicherbereinigung, ob Sie mehr Zellen speichern als erforderlich. Sie können auch fragen, ob Ihr Schema und Ihre Schreibmuster angepasst werden sollten.

Logische Daten in Byte (Tabelle)

Dieser Wert stellt die ungefähre Anzahl von Byte dar, die zum Lesen der gesamten Tabelle erforderlich wäre. Diese Tabellenstatistik gibt Ihnen Aufschluss darüber, wie viele Byte in der Tabelle gespeichert sind. Wenn Sie die logischen Daten in Byte kennen, können Sie die Auswirkungen der Komprimierung auf die Tabelle besser nachvollziehen. Wenn beispielsweise die in Cloud Monitoring gemeldete Tabellengröße mit den logischen Daten für die Tabelle übereinstimmt oder größer als diese sind, speichern Sie die Daten möglicherweise in einem Format, das nicht so einfach zu komprimieren ist.

Details zum Feld für Statistiken der Spaltenfamilie

Tabellenstatistiken für eine Tabelle umfassen die folgenden Felder für jede Spaltenfamilie in der Tabelle.

Durchschnittliche Spaltenanzahl pro Zeile

Dieser Wert wird berechnet, indem die Anzahl der Spalten in der Spaltenfamilie durch die Anzahl der Zeilen in der Tabelle geteilt wird.

Sehen Sie sich als Beispiel die folgende Tabelle an. Die Tabelle hat drei Zeilen mit Spalten in den Spaltenfamilien family-A und family-B.

Zeilenschlüssel	Spaltenfamilie Familie-A		Spaltenfamilie-B
Zeilenschlüssel 1	Familie-A:Qualifizierer-W	Familie-A:Qualifizierer-X	Familie-B:Qualifier-Y
Zeilenschlüssel 2	Familie-A:Qualifizierer-W
Zeilenschlüssel 3	Familie-A:Qualifizierer-W	Familie-A:Qualifizierer-X	Familie-B:Qualifier-Y	Familie-B:Qualifier-Z

Die Spaltenfamilie family-A hat insgesamt fünf Spalten in der Tabelle. Durch drei Zeilen geteilt, was bedeutet, dass die durchschnittliche Anzahl der Zellen pro Spalte für family-A 1.67 (auf zwei Dezimalstellen gerundet) ist.

Die Spaltenfamilie family-B hat insgesamt drei Spalten in der Tabelle. Durch drei Zeilen geteilt, beträgt die durchschnittliche Anzahl der Spalten für family-A 1.

Durchschnittliche Anzahl der Zellen pro Spalte

Um die durchschnittliche Anzahl der Zellen pro Spalte zu ermitteln, teilt Bigtable die Anzahl aller Zellen in der Spaltenfamilie in allen Zeilen der Tabelle durch die Anzahl der Zeilen in der Tabelle.

Betrachten Sie beispielsweise die folgenden Zeilen in der Spaltenfamilie family-D.

Zeilenschlüssel	Spaltenfamilie Familie-D
Zeilenschlüssel 1	Familie-D:Qualifier-W (3 Zellen)	Familie-D:Qualifier-X (1 Zelle)
Zeilenschlüssel 2		Familie-D:Qualifier-X (10 Zellen)
Zeilenschlüssel 3	Familie-D:Qualifier-W (7 Zellen)		Familie-D:Qualifier-Y (6 Zellen)

Die Anzahl der Zellen in der Spaltenfamilie beträgt 3 + 1 + 10 + 7 + 6 = 27. Dieser Wert geteilt durch 3 (die Anzahl der Zeilen) bedeutet, dass die Spaltenfamilie family-D einen Durchschnitt von 9 Zellen pro Spalte hat.

Logische Daten in Byte (Spaltenfamilie)

Die logischen Daten in Byte spiegeln den Platz wider, den die Spaltenfamilie belegt. Dieser Wert ist in etwa die Anzahl von Byte, die Sie zum Lesen der Tabellenstatistiken zum Lesen aller Daten in der Spaltenfamilie benötigen.

Beispiel mit der gcloud CLI

Verwenden Sie den Befehl bigtable instances table describe, um Tabellenstatistiken für eine Tabelle mit dem Namen sample-table abzurufen:

bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID --view stats

Dabei gilt:

• TABLE_ID: Die permanente Kennzeichnung der Tabelle
• INSTANCE_ID: Die permanente Kennzeichnung der Instanz

Die Ausgabe sieht in etwa so aus:

  columnFamilies:
    my-family:
     stats:
       averageCellsPerColumn: 12.34
       averageColumnsPerRow: 56.78
       logicalDataBytes: 314159
  name: projects/my-project/instances/INSTANCE_ID/tables/TABLE_ID
  stats:
    averageCellsPerColumn: 12.34
    averageColumnsPerRow: 56.78
    logicalDataBytes: 314159
    rowCount: 271828

Nächste Schritte

• Überwachen Sie Ihre Bigtable-Ressourcen.
• Verwenden Sie Key Visualizer, um Ihre Nutzungsmuster zu analysieren.