Indexe verwalten

MongoDB API

Verwenden Sie die Methode createIndex(), um einen Textindex zu erstellen. Wenn im folgenden Beispiel ein Dokument in die Sammlung cities geschrieben wird, wobei die Felder country oder food ausgefüllt sind, werden diese Felder für die Suche indexiert.

db.cities.createIndex({"country": "text", "food": "text"})

Ein Feld muss ein String oder ein Array von Strings sein, damit es indexiert werden kann. Array-Indexe werden nicht für die Suche indexiert. Wenn Sie a.1.b indexieren, wird something in {a: {1: {b: something}}}, aber nicht in {a: [one, {b: something}]} indexiert.

Sie können auch mit db.runCommand() Indexe erstellen. Sie können nur einen Textindex pro Sammlung haben, aber mehrere Indexe unterschiedlicher Typen in einer db.runCommand() erstellen. Im folgenden Beispiel wird db.runCommand() verwendet, um einen Textindex zu erstellen:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text" },
      name: "country_text_food_text"
    }
  ]
})

Standardsprache festlegen

Sie können optional auch eine Standardsprache oder einen Feldpfad in Ihrem Dokument angeben, der die Standardsprache enthält.

Im folgenden Beispiel wird myLanguageField als language_override angegeben. Wenn ein Dokument in der Sammlung cities ein Feld mit dem Namen myLanguageField enthält, wird der Wert dieses Felds verwendet, um die Sprache für die Indexierung des Felds country für dieses bestimmte Dokument zu bestimmen. Dieser Wert überschreibt die Standardsprache von french.

db.cities.createIndex({"country": "text"}, {"default_language": "french", "language_override": "myLanguageField"})

• Sie können eine Sprache entweder als Langform (english) oder als zweistelligen ISO-Sprachcode (en) eingeben.
• Wenn die Standardsprache nicht festgelegt ist, wird Cloud Firestore standardmäßig Englisch verwendet.
• Das Feld für die Sprachüberschreibung muss ein Feld der obersten Ebene sein. Wenn das Feld für die Sprachüberschreibung nicht festgelegt ist, wird standardmäßig language verwendet.
• Wenn Sie die Standardsprache auf das Zeichen null festlegen, wird in Cloud Firestore kein Feld als Sprachüberschreibung verwendet.

Textindex partitionieren

Sie können Ihren Index auch mithilfe eines Felds partitionieren, damit Sie Abfragen nach einem bestimmten Feldwert filtern können. Mit dieser Konfiguration können Sie leistungsfähigere Abfragen ausführen, wenn Sie immer ein bestimmtes Feld im Index filtern müssen, den Sie abfragen.

So erstellen Sie einen Index mit einer Partition: Konfigurieren Sie das Feld firestoreOptions so:

db.runCommand({
  createIndexes: "cities",
  indexes: [
    {
      key: { "country": "text", "food": "text"},
      name: "country_text_food_text"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

Wobei:

• PARTITIONED_FIELD ist der Name des Felds, das für die Partition verwendet wird. Dieser Wert muss ein String sein und sich auf ein Feld der obersten Ebene beziehen. Wenn Sie eine Abfrage für einen partitionierten Index ausführen, können Sie die Ergebnisse anhand eines Werts dieses Felds filtern. Sie können Ihren Index beispielsweise mit city partitionieren. Wenn in Ihrem Textindex ein city-Feld definiert ist, können Nutzer Abfragen für eine bestimmte Stadt ausführen.

  Die Partition darf nur ein Feld sein. Wenn Sie einen Index partitionieren, können Sie nur Abfragen ausführen, in denen das partitionierte Feld angegeben ist.

Einschränkungen

• Sie können nur einen Index pro Anfrage erstellen.
• Audit-Logs für die Indexerstellung mit der MongoDB-API verwenden den Methodennamen google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
• Informationen zu unterstützten Indexoptionen finden Sie unter Indizes und Indexeigenschaften.

Firebase Console

1. Rufen Sie in der Firebase Console die Seite Firestore-Datenbank auf.

   Zur Firestore-Datenbank

2. Wählen Sie eine Datenbank aus der Liste der Datenbanken aus.

3. Klicken Sie auf dem Tab Indizes auf Index erstellen.

4. Geben Sie eine Sammlungs-ID ein.

5. Fügen Sie einen oder mehrere Feldpfade hinzu und wählen Sie für jeden eine Indexoption aus.

6. Klicken Sie auf Erstellen.

7. Ihr neuer Index wird in der Liste der Indexe angezeigt und MongoDB-kompatible Vorgänge beginnen mit dem Erstellen des Index. Wenn Ihr Index erstellt wurde, sehen Sie daneben ein grünes Häkchen. Wenn kein Index erstellt wird, finden Sie unter Fehler beim Erstellen von Indexen mögliche Ursachen.

MongoDB API

Verwenden Sie die Methode createIndex(), um einen Index zu erstellen. Beispiel:

db.restaurants.createIndex({"location" : "2dsphere", "region": "2dsphere"})

Die Indexerstellung mit db.runCommand() wird auch mit maximal einem Index unterstützt:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
    }
  ]
})

2dsphere-Index partitionieren

Sie können Ihren Index auch mithilfe eines Felds partitionieren, damit Sie Abfragen nach einem bestimmten Feldwert filtern können. Mit dieser Konfiguration können Sie leistungsfähigere Abfragen ausführen, wenn Sie immer ein bestimmtes Feld im Index filtern müssen, den Sie abfragen.

So erstellen Sie einen Index mit einer Partition: Konfigurieren Sie das Feld firestoreOptions so:

db.runCommand({
  createIndexes: "restaurants",
  indexes: [
    {
      key: { "location": "2dsphere", "region": "2dsphere" },
      name: "location_2dsphere_region_2dsphere"
      firestoreOptions: {"customPartitionFields": ["PARTITIONED_FIELD"]
    }
  ]
})

Wobei:

• PARTITIONED_FIELD ist der Name des Felds, das für die Partition verwendet wird. Wenn Sie eine Abfrage für einen partitionierten Index ausführen, können Sie die Ergebnisse anhand eines Werts dieses Felds filtern. Wenn Ihr Index beispielsweise ein Feld region für regionale Standorte enthält, können Sie ihn mit region partitionieren, damit Nutzer nach Restaurants in ihrer Region suchen können.

  Wenn Sie einen Index partitionieren, können Sie nur Abfragen ausführen, in denen das partitionierte Feld angegeben ist.

Einschränkungen

• Sie können nur einen Index pro Anfrage erstellen.
• Für Audit-Logs für die Indexerstellung mit der MongoDB API wird der Methodenname google.firestore.admin.v1.FirestoreAdmin.CreateIndex verwendet.
• Informationen zu unterstützten Indexoptionen finden Sie unter Indizes und Indexeigenschaften.

Firebase Console

1. Rufen Sie in der Firebase Console die Seite Firestore-Datenbank auf.

   Zur Firestore-Datenbank

2. Wählen Sie eine Datenbank aus der Liste der Datenbanken aus.

3. Klicken Sie auf dem Tab Indizes auf Index erstellen.

4. Geben Sie eine Sammlungs-ID ein.

5. Fügen Sie einen oder mehrere Feldpfade hinzu und wählen Sie für jeden eine Indexoption aus.

6. Klicken Sie auf Erstellen.

7. Ihr neuer Index wird in der Liste der Indexe angezeigt und MongoDB-kompatible Vorgänge beginnen mit der Erstellung des Index. Wenn Ihr Index erstellt wurde, sehen Sie daneben ein grünes Häkchen. Wenn kein Index erstellt wird, finden Sie unter Fehler beim Erstellen von Indexen mögliche Ursachen.