Azure Cosmos DB for NoSQL: Beispiele für Version 4 des Java SDK
GILT FÜR: 
NoSQL
Wichtig
Weitere Informationen zu Java SDK v4 finden Sie in den Versionshinweisen zu Azure Cosmos DB Java SDK v4, im Maven-Repository, in den Tipps zur Leistungssteigerung und im Leitfaden zur Problembehandlung für Azure Cosmos DB Java SDK v4. Wenn Sie aktuell eine ältere Version als v4 verwenden, lesen Sie den Leitfaden Migrieren zu Azure Cosmos DB Java SDK v4, um Hilfe beim Aktualisieren auf v4 zu erhalten.
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-cosmos-java-sql-api-samples. Dieser Artikel enthält Folgendes:
- Links zu den Aufgaben in den einzelnen Java-Beispielprojektdateien.
- Links zum zugehörigen API-Referenzinhalt.
Voraussetzungen
Zum Ausführen dieser Beispielanwendung benötigen Sie Folgendes:
- Java Development Kit 8
- Azure Cosmos DB Java SDK v4
Optional können Sie Maven verwenden, um die aktuellen Binärdateien von Azure Cosmos DB Java SDK v4 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-cosmos</artifactId>
<version>LATEST</version>
</dependency>
Ausführen der Beispielanwendungen
Klonen des Beispielrepositorys:
$ git clone https://github.com/Azure-Samples/azure-cosmos-java-sql-api-samples.git
$ cd azure-cosmos-java-sql-api-samples
Sie können die Beispiele entweder in einer IDE (Eclipse, IntelliJ oder VS Code) oder über die Befehlszeile mit Maven ausführen.
Diese Umgebungsvariablen müssen festgelegt sein,
ACCOUNT_HOST=your account hostname;ACCOUNT_KEY=your account primary key
um den Beispielen Lese-/Schreibzugriff auf Ihr Konto zu gewähren.
Zum Ausführen eines Beispiels müssen Sie die zugehörige Hauptklasse (Main Class) angeben,
com.azure.cosmos.examples.sample.synchronicity.MainClass
wobei sample.synchronicity.MainClass Folgendem entsprechen kann:
- crudquickstart.sync.SampleCRUDQuickstart
- crudquickstart.async.SampleCRUDQuickstartAsync
- indexmanagement.sync.SampleIndexManagement
- indexmanagement.async.SampleIndexManagementAsync
- storedprocedure.sync.SampleStoredProcedure
- storedprocedure.async.SampleStoredProcedureAsync
- changefeed.SampleChangeFeedProcessor (für changefeed gibt es nur ein asychrones und kein synchrones Beispiel) usw.
Hinweis
Jedes Beispiel ist eigenständig mit eigener Einrichtung und Bereinigung. In den Beispielen werden mehrere Aufrufe ausgegeben, um einen CosmosContainer oderCosmosAsyncContainer zu erstellen. Dabei wird Ihrem Abonnement jedes Mal 1 Stunde Nutzung gemäß der Leistungsstufe der erstellten Sammlung berechnet.
Datenbankbeispiele
Die Datenbank CRUD-Beispieldateien für die Synchronisierung und asynchron zeigen, wie die folgenden Aufgaben ausgeführt werden. Um mehr über die Azure Cosmos DB-Datenbanken zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.
| Aufgabe | API-Referenz |
|---|---|
| Erstellen einer Datenbank | CosmosClient.createDatabaseIfNotExists CosmosAsyncClient.createDatabaseIfNotExists |
| Lesen einer Datenbank nach ID | CosmosClient.getDatabase CosmosAsyncClient.getDatabase |
| Lesen aller Datenbanken | CosmosClient.readAllDatabases CosmosAsyncClient.readAllDatabases |
| Löschen einer Datenbank | CosmosDatabase.delete CosmosAsyncDatabase.delete |
Sammlungsbeispiele
Die Datenbank CRUD-Beispieldateien für die Synchronisierung und asynchron zeigen, wie die folgenden Aufgaben ausgeführt werden. Um mehr über die Azure Cosmos DB-Sammlungen zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.
| Aufgabe | API-Referenz |
|---|---|
| Erstellen einer Sammlung | CosmosDatabase.createContainerIfNotExists CosmosAsyncDatabase.createContainerIfNotExists |
| Ändern der konfigurierten Leistung einer Sammlung | CosmosContainer.replaceThroughput CosmosAsyncContainer.replaceProvisionedThroughput |
| Abrufen einer Auflistung nach ID | CosmosDatabase.getContainer CosmosAsyncDatabase.getContainer |
| Lesen aller Sammlungen in einer Datenbank | CosmosDatabase.readAllContainers CosmosAsyncDatabase.readAllContainers |
| Löschen einer Sammlung | CosmosContainer.delete CosmosAsyncContainer.delete |
Beispiele der Autoskalierungssammlung
Um vor dem Ausführen dieser Beispiele mehr über die Autoskalierung zu erfahren, lesen Sie diese Anweisungen zum Aktivieren der Autoskalierung in Ihrem Konto und in Ihren Datenbanken und Containern.
Die Datenbank CRUD-Beispieldateien für die Synchronisierung und asynchron zeigen, wie die folgenden Aufgaben ausgeführt werden.
| Aufgabe | API-Referenz |
|---|---|
| Erstellen einer Datenbank mit einem definierten maximalen per Autoskalierung bereitgestellten Durchsatz | CosmosClient.createDatabase CosmosAsyncClient.createDatabase |
Die Datenbank CRUD-Beispieldateien für die Synchronisierung und asynchron zeigen, wie die folgenden Aufgaben ausgeführt werden.
| Aufgabe | API-Referenz |
|---|---|
| Erstellen einer Sammlung mit einem definierten maximalen per Autoskalierung bereitgestellten Durchsatz | CosmosDatabase.createContainerIfNotExists CosmosAsyncDatabase.createContainerIfNotExists |
| Ändern des für eine Sammlung konfigurierten maximalen per Autoskalierung bereitgestellten Durchsatzes | CosmosContainer.replaceThroughput CosmosAsyncContainer.replaceThroughput |
| Lesen der Konfiguration des per Autoskalierung bereitgestellten Durchsatzes für eine Sammlung | CosmosContainer.readThroughput CosmosAsyncContainer.readThroughput |
Beispiele der Analysespeichersammlung
Die Datenbank CRUD-Beispieldateien für die Synchronisierung und asynchron zeigen, wie die folgenden Aufgaben ausgeführt werden. Um vor dem Ausführen der folgenden Beispiele mehr über die Azure Cosmos DB-Sammlungen zu erfahren, lesen Sie die Informationen zu Azure Cosmos DB-Synapse und -Analysespeicher.
| Aufgabe | API-Referenz |
|---|---|
| Erstellen einer Sammlung | CosmosDatabase.createContainerIfNotExists CosmosAsyncDatabase.createContainerIfNotExists |
Elementbeispiele
Die Datenbank CRUD-Beispieldateien für die Synchronisierung und asynchron zeigen, wie die folgenden Aufgaben ausgeführt werden. Um mehr über die Azure Cosmos DB-Dokumente zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Arbeiten mit Datenbanken, Containern und Elementen.
Hinweis
Sie müssen einen Partitionsschlüssel angeben, wenn Sie Operationen mit einem bestimmten Element durchführen.
Indizierungsbeispiele
Die Datei Collection CRUD Samples zeigt, wie die folgenden Aufgaben ausgeführt werden. Um mehr über die Indizierung in Azure Cosmos DB zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele die Konzeptartikel Indizierungsrichtlinien, Indizierungstypen und Indizierungspfade.
| Aufgabe | API-Referenz |
|---|---|
| Einschließen bestimmter Dokumentpfade in den Index | IndexingPolicy.IncludedPaths |
| Ausschließen bestimmter Dokumentpfade aus dem Index | IndexingPolicy.ExcludedPaths |
| Erstellen eines zusammengesetzten Index | IndexingPolicy.setCompositeIndexes CompositePath |
| Erstellen eines „GeoSpatial“-Index | IndexingPolicy.setSpatialIndexes SpatialSpec SpatialType |
Weitere Informationen zur Indizierung finden Sie unter Indizierungsrichtlinien für Azure Cosmos DB.
Beispiele für Abfragen
Die Datei Query Samples und async zeigen, 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.
Beispiel für einen Änderungsfeed
Die Datei Change Feed Processor Sample zeigt, wie die folgenden Aufgaben ausgeführt werden. Machen Sie sich anhand von Lesen des Azure Cosmos DB-Änderungsfeeds und Änderungsfeedprozessor in Azure Cosmos DB mit Änderungsfeeds in Azure Cosmos DB vertraut, bevor Sie die folgenden Beispiele ausführen.
| Aufgabe | API-Referenz |
|---|---|
| Grundlegende Funktionen von Änderungsfeeds | ChangeFeedProcessor.changeFeedProcessorBuilder |
| Lesen eines Änderungsfeeds von Anfang an | ChangeFeedProcessorOptions.setStartFromBeginning() |
Serverseitige Programmierbeispiele
Die Datei Stored Procedure Sample zeigt, wie die folgenden Aufgaben ausgeführt werden. Machen Sie sich anhand von Gespeicherte Prozeduren, Trigger und benutzerdefinierte Funktionen mit der serverseitigen Programmierung in Azure Cosmos DB vertraut, bevor Sie die folgenden Beispiele ausführen.
| Aufgabe | API-Referenz |
|---|---|
| Erstellen einer gespeicherten Prozedur | CosmosScripts.createStoredProcedure |
| Ausführen einer gespeicherten Prozedur | CosmosStoredProcedure.execute |
| Löschen einer gespeicherten Prozedur | CosmosStoredProcedure.delete |
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