Freigeben über

Erste Schritte mit Azure Cosmos DB für NoSQL mit JavaScript

  • Gilt für:: ✅ NoSQL

In diesem Artikel erfahren Sie, wie Sie mithilfe des JavaScript SDK eine Verbindung mit Azure Cosmos DB für NoSQL herstellen. Nach der Verbindung können Sie Vorgänge für Datenbanken, Container und Elemente ausführen.

Paket (npm) | API-Referenz | Quellcode | der BibliothekFeedback geben

Voraussetzungen

Einrichten Ihres lokalen Projekts

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

  2. Erstellen Sie eine neue JavaScript-Anwendung mithilfe des npm init Befehls mit der Konsolenvorlage .

    npm init -y

  3. Installieren Sie die erforderliche Abhängigkeit für das Azure Cosmos DB für 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 zu Ihrem NoSQL-API-Konto über Microsoft Entra herzustellen, verwenden Sie einen Sicherheitsprinzipal. Der genaue Prinzipaltyp hängt davon ab, wo Sie Den 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 Service Principal

Importieren @azure/identity

Das @azure/ Identitäts-npm-Paket enthält Kernauthentifizierungsfunktionen, die für alle Azure SDK-Bibliotheken freigegeben werden.

  1. Importieren Sie das @azure/Identity npm-Paket mithilfe des npm install Befehls.

    npm install @azure/identity

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

Das folgende Diagramm zeigt die Beziehung zwischen diesen Ressourcen.

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

Jeder Ressourcentyp wird durch eine oder mehrere zugeordnete Klassen dargestellt. Hier ist eine Liste der am häufigsten verwendeten Klassen:

Class Description
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 im Dienst vorhanden sein kann oder nicht. Die Datenbank wird serverseitig ü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 überprüft, wenn Sie versuchen, damit zu arbeiten.

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

Guide Description
Erstellen einer Datenbank Erstellen von Datenbanken
Container erstellen Erstellen von Containern.
Erstellen und Lesen eines Elements Punktlesevorgang eines bestimmten Elements
Abfrageelemente Abfragen mehrerer Elemente

Siehe auch

Nächste Schritte

Erstellen einer Datenbank in Azure Cosmos DB für NoSQL mit JavaScript

  • Last updated on