通过 JavaScript 开始使用 Azure Cosmos DB for NoSQL

本文介绍如何使用 JavaScript SDK 连接到 Azure Cosmos DB for NoSQL。 连接后，可以对数据库、容器和项目执行操作。

包 （npm） | API 参考 | 库源代码 | 提供反馈

先决条件

• 拥有有效订阅的 Azure 帐户。 免费创建帐户。
• Azure Cosmos DB for NoSQL 帐户。 为 NoSQL 帐户创建 API。
• Node.js LTS
• Azure 命令行接口 (CLI) 或 Azure PowerShell

设置本地项目

1. 在 bash shell 中为 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 的 NoSQL API，请创建类的 CosmosClient 实例。 此类是针对数据库执行所有操作的起点。

若要使用 Microsoft Entra 连接到 NoSQL 帐户 的 API，请使用安全主体。 主体的确切类型将取决于应用程序代码的托管位置。 下表可用作快速参考指南。

导入 @azure/identity

@azure/identity npm 包包含在所有 Azure SDK 库之间共享的核心身份验证功能。

1. 使用命令导入 npm install npm 包。

   npm install @azure/identity
   

2. 在代码编辑器中，添加依赖项。

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

使用默认凭据实现创建 CosmosClient

如果在本地计算机上进行测试，或者应用程序将在 Azure 服务上运行，并直接支持托管标识，则通过创建 DefaultAzureCredential 实例来获取 OAuth 令牌。 然后，使用环境变量和 COSMOS_ENDPOINT 对象作为参数创建 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 文档。

下图显示了这些资源之间的关系。

每种类型的资源都由一个或多个关联的类表示。 下面是最常见的类的列表：

以下指南介绍了如何使用上述每个类来生成应用程序。

另请参阅

• npm 包
• API 参考
• 库源代码
• 提供反馈

后续步骤