Azure Cosmos DB for NoSQL: Beispiele für Spring Data Azure Cosmos DB v5
GILT FÜR: NoSQL
Wichtig
Diese Versionshinweise gelten für Version 5 von Spring Data Azure Cosmos DB. Versionshinweise für Version 3 finden Sie hierund Version 2 hier.
Spring Data Azure Cosmos DB unterstützt nur die API für NoSQL.
In diesen Artikeln finden Sie Informationen zu Spring Data für andere Azure Cosmos DB-APIs:
Wichtig
Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.
- Sie können Visual Studio-Abonnementvorteile aktivieren: Ihr Visual Studio-Abonnement beinhaltet ein monatliches Guthaben, das Sie für zahlungspflichtige Azure-Dienste verwenden können.
Sie können Azure Cosmos DB kostenlos testen – ohne Azure-Abonnement und unverbindlich. Alternativ können Sie ein Azure Cosmos DB-Konto im Free-Tarif erstellen, bei dem die ersten 1000 RUs/Sek. sowie 25 GB Speicher kostenlos sind. Sie können auch den Azure Cosmos DB-Emulator mit dem URI https://localhost:8081
verwenden. Informationen zur Verwendung des Schlüssels mit dem Emulator finden Sie unter Verwenden des Azure Cosmos-Emulators für lokale Entwicklungs- und Testvorgänge.
Die neuesten Beispielanwendungen, in denen CRUD-Vorgänge und andere gängige Vorgänge für Azure Cosmos DB-Ressourcen ausgeführt werden, finden Sie im GitHub-Repository azure-spring-boot-samples. Dieser Artikel enthält Folgendes:
- Links zu den Aufgaben in den einzelnen Spring Data Azure Cosmos DB-Beispielprojektdateien.
- Links zum zugehörigen API-Referenzinhalt.
Voraussetzungen
Zum Ausführen dieser Beispielanwendung benötigen Sie Folgendes:
- Java Development Kit 8
- Spring Data Azure Cosmos DB v5
Optional können Sie Maven verwenden, um die aktuellen Binärdateien von Spring Data Azure Cosmos DB v3 zur Verwendung in Ihrem Projekt abzurufen. Maven fügt alle erforderlichen Abhängigkeiten automatisch hinzu. Andernfalls können Sie die in der Datei pom.xml aufgelisteten Abhängigkeiten direkt herunterladen und Ihrem Buildpfad hinzufügen.
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-spring-data-cosmos</artifactId>
<version>LATEST</version>
</dependency>
Ausführen der Beispielanwendungen
Klonen des Beispielrepositorys:
$ git clone https://github.com/Azure-Samples/azure-spring-boot-samples
$ cd cosmos/azure-spring-data-cosmos/spring3-samples/cosmos-quickstart-samples
Sie können die Beispiele entweder in einer IDE (Eclipse, IntelliJ oder VS Code) oder über die Befehlszeile mit Maven ausführen.
Die folgenden Umgebungsvariablen müssen in application.properties festgelegt sein.
cosmos.uri=${ACCOUNT_HOST}
cosmos.key=${ACCOUNT_KEY}
cosmos.secondaryKey=${SECONDARY_ACCOUNT_KEY}
dynamic.collection.name=spel-property-collection
# Populate query metrics
cosmos.queryMetricsEnabled=true
Hiermit wird den Beispielen Lese-/Schreibzugriff auf Ihr Konto, Datenbanken und Container gewährt.
Vielleicht bietet Ihre IDE die Möglichkeit, den Spring Data-Beispielcode auszuführen. Andernfalls können Sie den folgenden Terminalbefehl verwenden, um das Beispiel auszuführen:
mvn spring-boot:run
CRUD-Beispiele für Dokumente
Die Beispieldatei zeigt, wie die folgenden Aufgaben ausgeführt werden. Um mehr über Azure Cosmos DB-Dokumente zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.
Aufgabe | API-Referenz |
---|---|
Erstellen eines Dokuments | CosmosRepository.save |
Lesen eines Dokuments nach ID | CosmosRepository.derivedQueryMethod |
Löschen aller Dokumente | CosmosRepository.deleteAll |
Beispiele für abgeleitete Abfragemethoden
Die Beispieldatei zeigt, wie die folgenden Aufgaben ausgeführt werden. Um mehr über Azure Cosmos DB-Abfragen zu erfahren, können Sie vor dem Ausführen der folgenden Beispiele den Artikel zu abgeleiteten Abfragemethoden in Spring von Baeldung lesen.
| Abfragen von Dokumenten | CosmosRepository.derivedQueryMethod |
Beispiele für benutzerdefinierte Abfragen
Die Beispieldatei zeigt, wie die folgenden Aufgaben mithilfe der SDL-Abfragegrammatik ausgeführt werden. Machen Sie sich im Artikel SQL-Abfragebeispiele mit der SQL-Abfragereferenz in Azure Cosmos DB vertraut, bevor Sie die folgenden Beispiele ausführen.
Aufgabe | API-Referenz |
---|---|
Abfragen aller Dokumente | @Query-Anmerkung |
Abfragen der Gleichheit mit „==“ | @Query-Anmerkung |
Abfragen der Ungleichheit mit „!=“ und „NOT“ | @Query-Anmerkung |
Abfragen mit Bereichsoperatoren wie >, <, >=, <= | @Query-Anmerkung |
Abfragen mit Bereichsoperatoren für Zeichenfolgen | @Query-Anmerkung |
Abfragen mit „ORDER BY“ | @Query-Anmerkung |
Abfragen mit „DISTINCT“ | @Query-Anmerkung |
Abfragen mit Aggregatfunktionen | @Query-Anmerkung |
Verwenden von Unterdokumenten | @Query-Anmerkung |
Abfragen mit dokumentinternen Verknüpfungen (Joins) | @Query-Anmerkung |
Abfragen mit Zeichenfolgen-, mathematischen und Arrayoperatoren | @Query-Anmerkung |
Nächste Schritte
Versuchen Sie, die Kapazitätsplanung für eine Migration zu Azure Cosmos DB durchzuführen? Sie können Informationen zu Ihrem vorhandenen Datenbankcluster für die Kapazitätsplanung verwenden.
- Wenn Sie nur die Anzahl der virtuellen Kerne und Server in Ihrem vorhandenen Datenbankcluster kennen, lesen Sie die Informationen zum Schätzen von Anforderungseinheiten mithilfe von virtuellen Kernen oder virtuellen CPUs
- Wenn Sie die typischen Anforderungsraten für Ihre aktuelle Datenbankworkload kennen, lesen Sie die Informationen zum Schätzen von Anforderungseinheiten mit dem Azure Cosmos DB-Kapazitätsplaner