Heatmap-Muster für Indexschlüssel

Diese Seite zeigt Beispiele für Muster, die in einer Heatmap von Key Visualizer angezeigt werden können. Diese Muster können Ihnen bei der Behebung bestimmter Leistungsprobleme helfen.

Gleichmäßig verteilte Nutzung

Heatmap, die gleichmäßig verteilte Lese- und Schreibvorgänge zeigt

Wenn eine Heatmap eine fein strukturierte Mischung aus dunklen und hellen Farben aufweist, dann sind Schreib-/Löschvorgänge für Indexschlüssel gleichmäßig über die Datenbank verteilt. Diese Heatmap stellt wahrscheinlich ein effektives Nutzungsmuster für Firestore dar.

Indexe auf sequenzielle Schlüssel

Eine Heatmap mit einer einzelnen hellen diagonalen Linie kann auf einen Index hinweisen, der sich auf einen Schlüssel bezieht, der sich streng monoton erhöht oder verringert, z. B. einen Zeitstempel. Indexe auf sequenziellen Schlüsseln werden nicht empfohlen und können Hotspots verursachen. Beim Hotspoting kann es sein, dass Sie entsprechende erhöhte Latenzen beobachten.

Hier einige Beispiele für häufige Hotspots im Index:

Hotspots aufgrund eines zunehmenden Zeitstempels

Heatmap mit Hotspots aufgrund eines steigenden Zeitstempels

In diesem Beispiel kann eine Heatmap mit einer einzelnen hellen diagonalen Linie auf eine Datenbank hinweisen, die Indexschreib-/Löschvorgänge für einen Zeitstempelfeldnamen mit streng zunehmenden oder abnehmenden Werten verwendet.

Hotspots aufgrund zunehmender Feldnamen

Heatmap mit Hotspots aufgrund eines zunehmenden Felds

In diesem Beispiel kann eine Heatmap mit einer einzelnen hellen diagonalen Linie auf eine Datenbank hinweisen, die streng steigende oder fallende Indexschreib-/Löschvorgänge für ein inkrementelles Feld verwendet, z. B. automatisch generierte Rechnungsnummern.

Verwenden Sie das Key Visualizer-Tool, um das Hotspot-Problem zu identifizieren, und ermitteln Sie die Indexschlüsselstruktur, um herauszufinden, welcher Index das Problem verursacht. Befreien Sie diese Indexe dann mithilfe von Best Practices von der Indexierung.

Indexschlüsselstruktur

Bevor Sie die Struktur der Indexschlüssel im Key Visualizer-Tool verstehen, sollten Sie sich mit Indexen in Firestore vertraut machen.

Der folgende Code zeigt ein Beispiel für das Format eines Indexschlüssels, das angezeigt wird, wenn Sie den Mauszeiger auf den betroffenen Schlüsselbereich in der Heatmap bewegen.

COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
  PROPERTIES: (Timestamp: DESC) 
  VALUES: (16500000000000001)
  DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001

Wobei:

  • COLLECTION: Speicherort der Sammlung in Ihrer Datenbank. Je nach Umfang kann es sich um den Sammlungspfad für den Sammlungsbereich oder den Sammlungsnamen für den Sammlungsgruppenbereich handeln.
  • PROPERTIES: Felder, die zum Erstellen des Index verwendet werden. Das Sortierfeld __name__ wird nur für Indexdefinitionen angezeigt, die die Standardsortierung ändern.
  • VALUES: Wert der einzelnen Property.
  • DOCUMENT: ID des Dokuments, das bei einem Vorgang aktualisiert wurde.

Ermitteln Sie anhand des Werts PROPERTIES die Felder, um den betroffenen Index zu finden.

So finden Sie den Index:

  1. Rufen Sie in der Google Cloud Console die Seite Datenbanken auf.

    Zur Seite „Datenbanken“

  2. Wählen Sie die benötigte Datenbank aus der Liste der Datenbanken aus.

  3. Klicken Sie im Navigationsmenü auf Indexe.

  4. Rufen Sie den Tab Zusammengesetzt oder Einzelfeld auf.

    Sie können den Indextyp anhand des Felds PROPERTIES ermitteln. Weitere Informationen finden Sie unter Beispiele für Indexschlüssel.

  5. Klicken Sie auf Filter, wählen Sie Felder aus und geben Sie den Namen des Felds ein.

    Verwenden Sie den Operator OR, um bei zusammengesetzten Indexen weitere Felder hinzuzufügen.

Nachdem Sie den Index gefunden haben, der Probleme verursacht, können Sie die folgenden Lösungen verwenden:

  • Zusammengesetzter Index: Ändern Sie den Index so, dass das Feld, dessen Wert monoton steigt oder fällt, nicht als erstes Feld für die Indexierung ausgewählt wird, oder löschen Sie den Index.

  • Einzelfeldindex: Fügen Sie eine Ausnahme für das Feld und die Sortierreihenfolge hinzu, die Sie ausschließen möchten. Weitere Informationen finden Sie unter Ausnahme für einzelnes Feld hinzufügen.

Beispiele für Indexschlüsseleinträge in der Heatmap

Typ Beschreibung Beispiel
Einzelfeldindexe auf Sammlungsebene, aufsteigend, absteigend Firestore erstellt standardmäßig Indexe mit Sammlungsbereich.

Indexeintrag für den Einzelfeldindex für das Feld Timestamp in absteigender Reihenfolge für das Dokument Users/5000000000000001.		 COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
PROPERTIES: (Timestamp: DESC)
VALUES: (16500000000000001)
DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001
Einzelfeldindexe auf Sammlungsebene für Arrayfelder Für jedes Arrayfeld in einem Dokument erstellt und verwaltet Firestore einen „array-contains“-Index des Sammlungsbereichs.

Indexeintrag für Einzelfeldindexe im Modus „Array enthält“, der erstellt wird, wenn dem Dokument ein Feld Country: [USA, Japan] hinzugefügt wird. Für dieses Feld werden standardmäßig auch ASC- und DESC-Indexe erstellt. Das Beispiel zeigt den ASC-Index für das Feld Country.		 COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
PROPERTIES:(Country: ASC)
VALUES:([USA, Japan]) DOCUMENT:(projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001)
Einzelfeldindexe für Sammlungsgruppen ASC, DESC, ARRAY Eine Sammlungsgruppe enthält alle Sammlungen mit derselben Sammlungs-ID.
Indexeintrag für den Einzelfeldindex der Sammlungsgruppe für das Feld Timestamp in absteigender Reihenfolge.		 COLLECTION GROUP: Users
PROPERTIES: (Timestamp: DESC)
VALUES: (16500000000000001L)
DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001
Einzelfeldindexe für Sammlungsgruppen ASC, DESC, ARRAY Indexeintrag für den Einzelfeldindex der Sammlungsgruppe für das Feld Country im Modus array-contains COLLECTION GROUP: Users PROPERTIES: (Country: ARRAY ASC) VALUES: (USA) DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001
Eintrag für zusammengesetzten Index einer Sammlung mit den Eigenschaften ASC, ASC und ARRAY Einträge für zusammengesetzte Indexe mit übergeordneten Elementen werden erstellt, wenn verschachtelte Dokumente mit einer Indexdefinition auf Sammlungsebene erstellt werden.

Indexeintrag für zusammengesetzten Index mit den Feldern Timestamp und Name in aufsteigender Reihenfolge und Country im Modus array-contains.		 COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
PROPERTIES: (Timestamp: ASC, Name: ASC,Country: ARRAY)
VALUES: (16500000000000001L, 'Alice', 'USA')
DOCUMENT: (projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001)
Eintrag in einem zusammengesetzten Index mit Umfang der Sammlungsgruppe mit den Eigenschaften „ASC“, „ASC“ Indexeintrag für den zusammengesetzten Index für das Feld Timestamp in aufsteigender Reihenfolge und das Feld Name in aufsteigender Reihenfolge COLLECTION GROUP: Users
PROPERTIES: (Timestamp: ASC, Name: ASC)
VALUES: (16500000000000001L, 'Alice')
DOCUMENT: (projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001)
Indexeintrag für zusammengesetzten Index auf Sammlungsebene mit ASC- und __name__-Attributen Indexeintrag für den zusammengesetzten Index für das Feld Timestamp in aufsteigender Reihenfolge und mit __name__ in absteigender Reihenfolge für das Dokument Users/5000000000000001. Sie können __name__ als letztes Feld in einer Indexdefinition verwenden, um die Standardsortierung der Ergebnisse zu ändern. COLLECTION: projects/PROJECT_ID/databases/(default)/documents/Users
PROPERTIES: (Timestamp: ASC, __name__ DESC)
VALUES: (16500000000000001)
DOCUMENT: projects/PROJECT_ID/databases/(default)/documents/Users/5000000000000001

Nächste Schritte