Node.js-Beispiele zum Verwalten von Daten in Azure Cosmos DB

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 azure-cosmos-js. Dieser Artikel enthält Folgendes:

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

Voraussetzungen

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

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, sofern 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, sofern 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 indexPolicy-Standardwert und anschließende Onlineaktualisierung Containers.create

Serverseitige Programmierbeispiele

Die Datei index.ts im Projekt ServerSideScripts 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

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

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.