Beispiele für das Azure Cosmos DB for NoSQL SDK für JS

  • Artikel

GILT FÜR: NoSQL

Beispiellösungen, 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 JavaScript SDK for Azure Cosmos DB. Dieser Artikel enthält Folgendes:

  • Links zu den Aufgaben in den einzelnen Node.js-Beispielprojektdateien.
  • Links zum zugehörigen API-Referenzinhalt.

Voraussetzungen

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.

Darüber hinaus benötigen Sie das JavaScript SDK.

Hinweis

Jedes Beispiel ist eigenständig mit eigener Einrichtung und Bereinigung. In den Beispielen werden mehrere Aufrufe von Containers.create ausgegeben. Bei jeder Ausführung dieses Vorgangs wird Ihrem Abonnement eine Stunde Nutzung gemäß Leistungsstufe des erstellten Containers in Rechnung gestellt.

Datenbankbeispiele

Die Datei DatabaseManagement veranschaulicht, wie die CRUD-Vorgänge für die Datenbank 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 (falls noch nicht vorhanden) Databases.createIfNotExists
Auflisten von Datenbanken für ein Konto Databases.readAll
Lesen einer Datenbank nach ID Database.read
Löschen einer Datenbank Database.delete

Containerbeispiele

Die Datei ContainerManagement veranschaulicht, wie die CRUD-Vorgänge für den Container 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 eines Containers (falls noch nicht vorhanden) Containers.createIfNotExists
Auflisten von Containern für ein Konto Containers.readAll
Lesen einer Containerdefinition Container.read
Löschen eines Containers Container.delete

Elementbeispiele

Die Datei ItemManagement veranschaulicht, wie die CRUD-Vorgänge für das Element 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.

Aufgabe API-Referenz
Erstellen von Elementen Items.create
Lesen aller Elemente in einem Container Items.readAll
Lesen eines Elements nach ID Item.read
Festlegen, dass ein Element nur gelesen wird, wenn es geändert wurde Item.read - RequestOptions.accessCondition
Abfragen von Dokumenten Items.query
Ersetzen eines Elements Item.replace
Ersetzen eines Elements mit bedingter ETag-Überprüfung Item.replace - RequestOptions.accessCondition
Löschen eines Elements Item.delete

Indizierungsbeispiele

Die Datei IndexManagement veranschaulicht die Verwaltung der Indizierung. 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
Manuelles Indizieren eines bestimmten Elements RequestOptions.indexingDirective: 'include'
Manuelles Ausschließen eines bestimmten Elements aus dem Index RequestOptions.indexingDirective: 'exclude'
Ausschließen eines Pfads aus dem Index IndexingPolicy.ExcludedPath
Erstellen eines Bereichsindexes in einem Zeichenfolgenpfad IndexKind.Range, IndexingPolicy, Items.query
Erstellen eines Containers mit Standardwert für indexPolicy und anschließende Onlineaktualisierung des Containers Containers.create

Serverseitige Programmierbeispiele

Die Datei index.ts zeigt, wie die folgenden Aufgaben ausgeführt werden. Um mehr über die serverseitige Programmierung in Azure Cosmos DB zu erfahren, lesen Sie vor dem Ausführen der folgenden Beispiele den Konzeptartikel Gespeicherte Prozeduren, Trigger und benutzerdefinierte Funktionen.

Aufgabe API-Referenz
Erstellen einer gespeicherten Prozedur StoredProcedures.create
Ausführen einer gespeicherten Prozedur StoredProcedure.execute
Massenupdate mit gespeicherter Prozedur StoredProcedure.execute

Weitere Informationen zur serverseitigen Programmierung finden Sie unter Serverseitige Azure Cosmos DB-Programmierung: gespeicherte Prozeduren, Datenbanktrigger und benutzerdefinierte Funktionen.

Authentifizierung mit Microsoft Entra: Beispiele

Die Datei EntraAuth.ts zeigt, wie die folgenden Aufgaben ausgeführt werden.

Aufgabe API-Referenz
Create credential object from @azure/identity API
Übergeben von Tokenanmeldeinformationen an den Clientkonstruktor API
Ausführen eines Cosmos-Clients mit AAD-Anmeldeinformationen API

Verschiedene Beispiele

Die folgenden zusammengestellten Beispiele veranschaulichen gängige Szenarien.

Aufgabe API-Referenz
Ändern des Abfragedurchsatzes API
Abrufen des Abfragedurchsatzes API
Verwenden von SasToken zum Gewähren des bereichsbezogenen Zugriffs auf Cosmos DB-Ressourcen API

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.