Azure Cosmos DB for NoSQL: Beispiele für Spring Data Azure Cosmos DB v5

  • Artikel

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 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.