共用方式為

開始搭配使用 Azure Cosmos DB for NoSQL 與 JavaScript

  • 發行項

適用於：NoSQL

本文顯示如何使用 JavaScript SDK 連線至 Azure Cosmos DB for NoSQL。 連線之後，您即可在資料庫、容器和項目上執行作業。

套件 (npm) | 範例 | API 參考 | 程式庫原始程式碼 | 提供意見反應

必要條件

設定本機專案

  1. 在 Bash 殼層中，建立您 JavaScript 專案的新目錄。

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

  2. 搭配使用 npm init 命令與主控台範本來建立新的 JavaScript 應用程式。

    npm init -y

  3. 安裝 Azure Cosmos DB for NoSQL JavaScript SDK 所需的相依性。

    npm install @azure/cosmos

連線至 Azure Cosmos DB for NoSQL

若要連線到 Azure Cosmos DB 的 API for NoSQL，請建立 CosmosClient 類別的執行個體。 此類別是針對資料庫執行所有作業的起點。

若要使用 Microsoft Entra 連線到 NoSQL 帳戶的 API，請使用安全性主體。 主體的確切類型取決於您裝載應用程式碼的位置。 下表可作為快速參考指南。

應用程式的執行位置 安全性主體
本機電腦 (開發和測試) 使用者身分識別或服務主體
Azure 受控識別
Azure 外部的伺服器或用戶端 服務主體

匯入 @azure/identity

@azure/identity npm 套件包含所有 Azure SDK 程式庫之間共用的核心驗證功能。

  1. 使用 npm install 命令來匯入 @azure/identity npm 套件。

    npm install @azure/identity

  2. 在程式碼編輯器中，新增相依性。

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

使用預設認證實作建立 CosmosClient

如果您要在本機電腦上進行測試，或應用程式將在 Azure 服務上執行，並直接支援受控識別，請建立 DefaultAzureCredential 執行個體以取得 OAuth 權杖。 然後，使用 COSMOS_ENDPOINT 環境變數和 TokenCredential 物件作為參數，建立 CosmosClient 類別的新執行個體。

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

const credential = new DefaultAzureCredential();

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

建置您的 應用程式

組建應用程式時，程式碼主要與四種資源互動：

  • API for NoSQL 帳戶是 Azure Cosmos DB 資料的唯一最上層命名空間。

  • 資料庫，用於組織帳戶中的容器。

  • 容器，其中包含資料庫中的一組個別項目。

  • 項目，代表容器中的 JSON 文件。

下圖顯示資源之間的關係。

Azure Cosmos DB 階層中包含帳戶、資料庫、容器和項目的圖表。

每種資源都會以一或多個相關聯類別來代表。 以下是最常見類別的清單：

類別 描述
CosmosClient 此類別提供適用於 Azure Cosmos DB 服務的用戶端邏輯表示法。 用戶端物件會用於設定及執行針對服務的要求。
Database 此類別是服務中可能或可能不存在的資料庫參考。 當您嘗試存取資料庫或對其執行作業時，資料庫為已驗證的伺服器端。
Container 此類別為容器參考，可能尚未於伺服器中存在。 當您嘗試使用此項目時，容器為已驗證的伺服器端。

下列指南說明如何以上每個類別來組建應用程式。

指南 描述
建立資料庫 建立資料庫
建立容器 建立容器
建立和讀取項目 點讀取特定項目
查詢項目 查詢多個項目

另請參閱

下一步

使用 JavaScript 在 Azure Cosmos DB for NoSQL 中建立資料庫