Erstellen von Indizes Indizes löschen Festlegung der Indexauswahl und Bereitstellung eines Indexhinweises

Indexverwaltung in Amazon DocumentDB mit Java

Indizes ermöglichen das effiziente Abrufen von Daten aus einer Amazon DocumentDB-Sammlung. Ohne Indizes muss DocumentDB jedes Dokument in der Sammlung scannen, um Ergebnisse zurückzugeben, die einer bestimmten Abfrage entsprechen. Dieses Thema enthält Informationen zum Erstellen, Löschen und Auflisten von Indizes mithilfe der MongoDB-Java-Treiber. Außerdem wird beschrieben, wie festgestellt werden kann, ob ein bestimmter Index in der Abfrage verwendet wird, und wie Amazon DocumentDB Hinweise zur Verwendung eines bestimmten Indexes gegeben werden kann.

Themen

Erstellen von Indizes
Indizes löschen
Festlegung der Indexauswahl und Bereitstellung eines Indexhinweises

Amazon DocumentDB unterstützt viele Arten von Indizes. Einen umfassenden Überblick über alle unterstützten Indizes finden Sie im Datenbank-Blog unter So indexieren Sie auf Amazon DocumentDB. AWS

Indizes mit Java erstellen

Es gibt zwei Mechanismen zum Erstellen von Indizes in Amazon DocumentDB mithilfe von MongoDB-Java-Treibern: durch runCommand() und entweder durch die createIndex() Methode für einen einzelnen Index oder die createIndexes() Methode für mehrere Indizes. Ein Grund für die Verwendung der createIndexes() Methoden createIndex() und ist, dass Sie eine bessere Fehlerbehandlung entwickeln können, indem Sie bestimmte Fehler im Zusammenhang mit der Indexerstellung abfangen. Ein weiterer Grund für die Verwendung dieser Methoden runCommand() ist, dass der MongDB-Java-Treiber eine Vielzahl unterstützender Klassen für die Indexerstellung und -bearbeitung bietet. Beachten Sie, dass diese unterstützenden Klassen nur verwendet werden können, wenn Sie die createIndex() createIndexes() OR-Methoden verwenden. Es gibt drei unterstützende Klassen:

Indexes— Diese Klasse dient als Hilfsklasse und bietet statische Factory-Methoden zum Erstellen verschiedener Arten von Indizes. Sie vereinfacht das Erstellen komplexer Indexdefinitionen und wird häufig in Verbindung mit anderen indexbezogenen Klassen verwendet.
IndexModel— Dies ist eine grundlegende Klasse, die sowohl die Definition der Indexschlüssel als auch ihre Optionen kapselt. Sie stellt eine vollständige Indexspezifikation dar, die kombiniert, was indexiert werden soll (die Schlüssel), mit der Art der Indizierung (die Optionen). Diese Klasse ist besonders nützlich, wenn Sie mehrere Indizes gleichzeitig erstellen, da Sie damit eine Sammlung von Indexspezifikationen definieren können, die an die createIndexes() Methode übergeben werden können.
IndexOptions— Dies ist eine umfassende Konfigurationsklasse, die eine Vielzahl von Methoden zur Anpassung des Indexverhaltens bietet. Sie umfasst Einstellungen für eindeutige Indizes, Indizes mit geringer Dichte, die Ablaufzeit (TTL) und partielle Filterausdrücke. Durch Methodenverkettung können Sie mehrere Optionen wie die Indexerstellung im Hintergrund und eindeutige Einschränkungen konfigurieren.

Erstellen Sie einen einzelnen Index

Dieses Beispiel zeigt, wie Sie mit dercreateIndex() -Methode im Hintergrund einen einzelnen Index erstellen. Informationen zur Erstellung von Hintergrund- und Vordergrundindizes finden Sie unterTypen zum Erstellen von Indizes. Im folgenden Codebeispiel wird IndexOptions ein eindeutiger Index mit dem Namen „unique_restaurantId_idx“ im Hintergrund erstellt. Dieses IndexOptions Objekt wird dann an die Methode übergeben. createIndex()


collection.createIndex(
    Indexes.ascending("restaurantId"),
    new IndexOptions()
        .unique(true)
        .name("unique_restaurantId_idx")
        .background(true));

Erstellen Sie mehrere Indizes

In diesem Beispiel werden mithilfe der Methode mehrere Indizes erstellt. createIndexes() Es erstellt zuerst die Option für jeden Index mithilfe des IndexModel Objekts und übergibt dann eine Liste von IndexModel Objekten an die createIndexes() Methode. Das folgende Codebeispiel zeigt, wie ein zusammengesetzter Index mithilfe der Indexes Dienstprogrammklasse erstellt wird. Diese Klasse wird auch verwendet, um anzugeben, ob Sie einen Index in aufsteigender oder absteigender Sortierreihenfolge erstellen möchten. Nach dem Erstellen mehrerer Indizes überprüft sie die Indexerstellung, indem sie die Methode aufruft. listIndexes()


// Single Field Index on cuisine
IndexModel singleIndex = new IndexModel(
    Indexes.ascending("cuisine"),
    new IndexOptions().name("cuisine_idx"));

// Compound Index
IndexModel compoundIndex = new IndexModel(
    Indexes.compoundIndex(
        Indexes.ascending("address.state"),
        Indexes.ascending("priceRange")),
    new IndexOptions().name("location_price_idx"));

// Build a list of IndexModel for the indexes
List < IndexModel > indexes = Arrays.asList(
    singleIndex,
    compoundIndex
);

collection.createIndexes(indexes);

// Verify created indexes
collection.listIndexes().forEach(index - > System.out.println("Created index: " + index.toJson()));

Erstellen Sie Indizes mit geringer Dichte und Teilindizes

Dieses Beispiel zeigt, wie ein Index mit geringer Dichte und ein Teilindex erstellt werden, indem IndexModel für jeden Indextyp ein Index erstellt wird.


// Sparse Index Model, this will identify only those documents that have a
// michelin star rating
IndexModel sparseIndex = new IndexModel(
    Indexes.ascending("michelin.star"),
    new IndexOptions()
    .name("michelin_sparse_idx")
    .sparse(true));

// Partial Index Model where the restaurant is active and has a rating of 4 and above
IndexModel partialIndex = new IndexModel(
    Indexes.ascending("rating.average"),
    new IndexOptions()
    .name("high_rated_active_idx")
    .partialFilterExpression(
        Filters.and(
            Filters.eq("isActive", true),
            Filters.gte("rating.average", 4.0))));

Erstellen Sie einen Textindex

Dieses Beispiel zeigt, wie ein Textindex erstellt wird. Für eine Sammlung ist nur ein Textindex zulässig, aber dieser eine Textindex kann ein zusammengesetzter Index sein, der mehrere Felder abdeckt. Wenn Sie mehrere Felder im Textindex verwenden, können Sie auch jedem der Felder im Index Gewichtungen zuweisen. Textindizes für Array-Felder werden von Amazon DocumentDB nicht unterstützt, und obwohl Sie bis zu 30 Felder im zusammengesetzten Textindex verwenden können, kann nur drei Feldern eine Gewichtung zugewiesen werden.


IndexModel textIndex = new IndexModel(
    new Document()
    .append("name", "text")
    .append("description", "text")
    .append("cuisine", "text"),
    new IndexOptions()
    .name("restaurant_text_idx")
    .weights(new Document()
        .append("name", 10) // Restaurant name gets highest weight
        .append("description", 5) // Description get medium weight
        .append("cuisine", 2) // Cuisine type gets low weight
    ));

collection.createIndex(textIndex.getKeys(), textIndex.getOptions());

Erstellen Sie einen Index mit runCommand()

Amazon DocumentDB unterstützt die parallele Indexerstellung, um die für die Erstellung von Indizes benötigte Zeit zu verkürzen. Bei der parallelen Indizierung werden mehrere Worker gleichzeitig verwendet. Für die Indexerstellung werden standardmäßig zwei Worker verwendet. Weitere Informationen finden Sie im AWS Datenbank-Blog unter Das Potenzial der parallelen Indizierung in Amazon DocumentDB nutzen. Derzeit unterstützen die MongDB-Java-Treiber die Angabe der Worker-Option nicht, wenn Sie createIndex() oder createIndexes() verwenden. Daher können Sie Worker nur über den angeben. runCommand Das folgende Codebeispiel zeigt, wie ein Index erstellt wird, der den Worker auf vier erhöht: runCommand


Document command = new Document("createIndexes", "Restaurants")
    .append("indexes", Arrays.asList(
        new Document("key", new Document("name", 1))
        .append("name", "restaurant_name_idx")
        .append("workers", 4) // Specify number of workers
    ));

Document commendResult = connectedDB.runCommand(command);

Löschen von Indizes

Der MongoDB-Java-Treiber bietet mehrere Methoden zum Löschen von Indizes, die auf unterschiedliche Szenarien und Ihre Präferenzen zugeschnitten sind. Sie können Indizes nach Namen, nach Schlüsselspezifikation oder alle Indizes auf einmal löschen. Die Methoden dropIndex() und dropIndexes() können für ein Sammlungsobjekt aufgerufen werden, um einen Index zu löschen. Wenn Sie einen Index anhand des Namens löschen, sollten Sie sicherstellen, dass der richtige Indexname verwendet wird, was möglicherweise nicht immer intuitiv ist, insbesondere bei zusammengesetzten oder automatisch generierten Indizes. Der Versuch, einen nicht existierenden Index zu löschen, führt zu einem. MongoCommandException Der default _id Index kann nicht gelöscht werden, da dadurch die Eindeutigkeit des Dokuments innerhalb der Sammlung gewährleistet wird.

Das folgende Codebeispiel zeigt, wie ein Index gelöscht wird, indem der Feldname angegeben wird, in dem der Index erstellt wird, oder indem alle Indizes gelöscht werden:


String indexName = "unique_restaurantId_idx";
Document keys = new Document("cuisine", 1);
// Drop index by name
collection.dropIndex(indexName);
            
// Drop index by keys
collection.dropIndex(keys);
            
// Drop all indexes
collection.dropIndexes();

Wenn Sie Indizes mit mehreren Schlüsseln löschen, stellen Sie sicher, dass ein zusammengesetzter Index vorhanden ist, der alle angegebenen Schlüssel enthält, und dass die Reihenfolge der Schlüssel korrekt ist. Der obige Beispielcode zur Indexerstellung zeigt einen zusammengesetzten Schlüssel zu „Küche“ und Funktionen. Wenn Sie versuchen, diesen zusammengesetzten Schlüssel zu löschen, aber die Reihenfolge nicht der Reihenfolge entspricht, die für die Erstellung verwendet wurde, tritt ein MongoCommnadException Fehler wie folgt auf:


Document keys = new Document("features", 1)
    .append("cuisine", 1);
try {
    // Drop index by keys
    collection.dropIndex(keys);
    System.out.println("Successfully dropped index with keys: " + keys.toJson());

} catch (MongoCommandException commErr) {
    System.out.println("Error dropping index: " + commErr.getErrorMessage());
    throw new RuntimeException("MongoCommandException was thrown while dropping index", commErr);
}

Der folgende Fehler wird angezeigt:


Error dropping index: Cannot drop index: index not found.
Tests run: 3, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.819 sec <<< FAILURE!
com.amazon.docdb.guide.DocDBGuideTest.testindexGuide()  Time elapsed: 0.817 sec  <<< FAILURE!
org.opentest4j.AssertionFailedError: Unexpected exception thrown: java.lang.RuntimeException: MongoCommandException was thrown while dropping index

Festlegung der Indexauswahl und Bereitstellung eines Indexhinweises

Die Arbeit mit der Erklärungsfunktion in Amazon DocumentDB ist entscheidend, um die Abfrageleistung und Indexnutzung zu verstehen. Wenn Sie eine Abfrage ausführen, können Sie die explain() Methode anhängen, um detaillierte Informationen über den Abfrageplan zu erhalten, einschließlich der Indizes, falls vorhanden, die verwendet werden. Die explain() Ausgabe bietet Einblicke in die Phasen der Abfrageausführung, die Anzahl der untersuchten Dokumente und die für jede Phase benötigte Zeit. Diese Informationen sind von unschätzbarem Wert, um festzustellen, ob ein bestimmter Index effektiv verwendet wird oder ob die Abfrage von einer anderen Indexstruktur profitieren könnte.

Die explain() Methode kann mit der Methode verkettet werden. find() Die explain() Methode kann eine optionale ExplainVerbosity Aufzählung annehmen, die den Grad der Ausführlichkeit bestimmt, der zurückgegeben wird. explain() Derzeit werden nur die QUERY_PLANNER Enumeratoren EXECUTION_STATS und von DocumentDB unterstützt. Das folgende Codebeispiel zeigt, wie Sie den Abfrageplaner für eine bestimmte Abfrage abrufen:


// Query we want to analyze
Document query = new Document()
    .append("cuisine", "Thai")
    .append("rating.average", new Document("$gte", 4.0));


Document allPlansExplain = collection.find(query).explain(ExplainVerbosity.QUERY_PLANNER);
System.out.println("All Plans Explain:\n" + allPlansExplain.toJson());

Das folgende JSON-Dokument wird für die Ausführlichkeitsstufe des Abfrageplaners zurückgegeben:


{
  "queryPlanner": {
    "plannerVersion": 1,
    "namespace": "ProgGuideData.Restaurants",
    "winningPlan": {
      "stage": "IXSCAN",
      "indexName": "cuisine_idx",
      "direction": "forward"
    }
  },
  "serverInfo": {
    "host": "guidecluster3",
    "port": 27017,
    "version": "5.0.0"
  },
  "ok": 1,
  "operationTime": {
    "$timestamp": {
      "t": 1739221668,
      "i": 1
    }
  }
}

Sie haben mehrere Möglichkeiten, Amazon DocumentDB zu beeinflussen oder zu zwingen, einen bestimmten Index zu verwenden. Mit den hintString() Methoden hint() und können Sie das Standardverhalten des Abfrageoptimierers bei der Indexauswahl außer Kraft setzen, indem Sie explizit angeben, welcher Index für eine Abfrage verwendet werden soll. Während der Abfrageoptimierer von DocumentDB im Allgemeinen eine gute Wahl für die Indexauswahl bietet, gibt es auch Szenarien, in denen das hint() Durchsetzen eines bestimmten Indexes von Vorteil sein hintString() kann, z. B. beim Umgang mit schiefen Daten oder beim Testen der Indexleistung.

Das folgende Codebeispiel erzwingt die Verwendung des zusammengesetzten Indexes „cuisine_features_idx“ für dieselbe Abfrage, die im obigen Code ausgeführt wurde:


// Query we want to analyze
Document query = new Document()
    .append("cuisine", "Thai")
    .append("rating.average", new Document("$gte", 4.0));

List < Document > queryDocs = new ArrayList < > ();
collection.find(query).hintString("cuisine_features_idx").forEach(doc - > queryDocs.add(doc));

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

CRUD-Operationen mit Java

Event-driven programmieren