Erste Schritte mit Azure Cosmos DB for NoSQL unter Verwendung von JavaScript

Artikel
10/04/2024

GILT FÜR: NoSQL

In diesem Artikel erfahren Sie, wie Sie mithilfe des Python SDK eine Verbindung mit Azure Cosmos DB for NoSQL herstellen. Sobald die Verbindung hergestellt ist, können Sie Vorgänge für Datenbanken, Container und Elemente ausführen.

Paket (npm) | Beispiele | API-Dokumentation | Bibliothekquellcode | Feedback einreichen

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
Azure Cosmos DB for NoSQL-Konto. Erstellen eines „API für NoSQL“-Kontos.
Node.js LTS
Azure-Befehlszeilenschnittstelle (CLI) oder Azure PowerShell

Einrichten Ihres lokalen Projekts

Erstellen Sie ein neues Verzeichnis für Ihr JavaScript-Projekt in einer Bash-Shell.

mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples

Erstellen Sie eine neue .NET-Anwendung mithilfe des Befehls npm init mit der Konsole-Vorlage.
```
npm init -y
```
Installieren Sie die erforderliche Abhängigkeit für das Azure Cosmos DB for NoSQL JavaScript SDK.
```
npm install @azure/cosmos
```

Herstellen einer Verbindung mit Azure Cosmos DB for NoSQL

Um eine Verbindung mit der API für NoSQL von Azure Cosmos DB herzustellen, erstellen Sie eine Instanz der CosmosClient-Klasse. Diese Klasse ist der Ausgangspunkt, um alle Vorgänge für Datenbanken auszuführen.

Um eine Verbindung mit Ihrer API für das NoSQL-Konto mithilfe von Microsoft Entra herzustellen, verwenden Sie einen Sicherheitsprinzipal. Der genaue Prinzipaltyp hängt davon ab, wo Sie Ihren Anwendungscode hosten. Die folgende Tabelle dient als Kurzanleitung.

Ausführungsort der Anwendung	Sicherheitsprinzipal
Lokaler Computer (Entwickeln und Testen)	Benutzeridentität oder Dienstprinzipal
Azure	Verwaltete Identität
Server oder Clients außerhalb von Azure	Dienstprinzipal

Importieren Sie @azure/identity

Das azure/identity npm-Paket enthält grundlegende Authentifizierungsfunktionen, die von allen Azure SDK-Bibliotheken gemeinsam genutzt werden.

Importieren Sie das @azure/identity npm-Paket mithilfe des npm install-Befehls.
```
npm install @azure/identity
```

Fügen Sie in Ihrem Code-Editor die Abhängigkeiten hinzu.

const { DefaultAzureCredential } = require("@azure/identity");

Erstellen von CosmosClient mit Standard-Implementierung von Anmeldeinformationen

Wenn Sie auf einem lokalen Computer testen oder Ihre Anwendung auf Azure-Diensten mit direkter Unterstützung für verwaltete Identitäten ausgeführt wird, rufen Sie ein OAuth-Token ab, indem Sie eine DefaultAzureCredential-Instanz erstellen. Erstellen Sie dann eine neue Instanz der CosmosClient-Klasse mit der COSMOS_ENDPOINT-Umgebungsvariable und dem TokenCredential-Objekt als Parameter.

const { CosmosClient } = require("@azure/cosmos");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

Erstellen Ihrer Anwendung

Beim Erstellen Ihrer Anwendung interagiert Ihr Code hauptsächlich mit vier Arten von Ressourcen:

Das API für NoSQL-Konto, das der eindeutige Namespace der obersten Ebene für Ihre Azure Cosmos DB-Daten ist.
Datenbanken, die Container in Ihrem Konto organisieren.
Container, die eine Reihe einzelner Elemente in Ihrer Datenbank enthalten.
Elemente, die ein JSON-Dokument in Ihrem Container darstellen.

Im folgenden Diagramm ist die Beziehung zwischen diesen Ressourcen dargestellt.

Diagram der Azure Cosmos DB-Hierarchie, einschließlich Konten, Datenbanken, Containern und Elementen.

Jeder Ressourcentyp wird durch eine oder mehrere zugeordnete Klassen dargestellt. Nachstehend finden Sie eine Liste der gängigsten Klassen:

Klasse	BESCHREIBUNG
`CosmosClient`	Diese Klasse bietet eine clientseitige logische Darstellung für den Azure Cosmos DB-Dienst. Das Clientobjekt wird zum Konfigurieren und Ausführen von Anforderungen für den Dienst verwendet.
`Database`	Diese Klasse ist ein Verweis auf eine Datenbank, die möglicherweise noch nicht im Dienst vorhanden ist. Die Datenbank wird vom Server aus überprüft, wenn Sie versuchen, darauf zuzugreifen oder einen Vorgang auszuführen.
`Container`	Diese Klasse ist ein Verweis auf einen Container, der möglicherweise noch nicht im Dienst vorhanden ist. Der Container wird serverseitig validiert, wenn Sie versuchen, damit zu arbeiten.

In den folgenden Leitfäden wird gezeigt, wie Sie diese verschiedenen Klassen verwenden, um Ihre Anwendung zu erstellen.

Handbuch	BESCHREIBUNG
Erstellen einer Datenbank	Erstellen von Datenbanken
Container erstellen	Erstellen von Containern.
Erstellen und Lesen eines Elements	Punktlesevorgang eines bestimmten Elements
Abfrageelemente	Mehrere Elemente abfragen

Weitere Informationen

Nächste Schritte

Erstellen einer Datenbank in Azure Cosmos DB for NoSQL mit JavaScript

Freigeben über