管理 Azure Cosmos DB 中数据的 Node.js 示例

适用于 :SQL API

对 Azure Cosmos DB 资源执行 CRUD 操作和其他常见操作的示例解决方案包含在 azure-cosmos-js GitHub 存储库中。 本文将提供:

  • 指向每个 Node.js 示例项目文件中任务的链接。
  • 指向相关的 API 参考内容的链接。

先决条件

如果没有 Azure 试用版订阅,请在开始前创建一个试用版订阅

可以创建一个 Azure Cosmos DB 免费层帐户,你将在帐户中获得前 400 RU/s 的免费吞吐量和 5 GB 的免费存储。 还可以将 Azure Cosmos DB Emulator URI 为 。 有关在模拟器中使用的密钥,请参阅对请求进行身份验证

也需 JavaScript SDK

注意

每个示例都是独立的,自行对自身进行设置并在完成后自行进行清理。 因此,这些示例对 Containers.create 发出多个调用。 每次执行完此操作,均会按照正在创建的容器的性能层,向订阅收取使用 1 小时的费用。

数据库示例

DatabaseManagement 文件演示如何对数据库执行 CRUD 操作。 若要在运行以下示例之前了解 Azure Cosmos 数据库,请参阅使用数据库、容器和项概念性文章。

任务 API 参考
创建数据库(如果不存在) Databases.createIfNotExists
列出帐户的数据库 Databases.readAll
按 ID 读取数据库 Database.read
删除数据库 Database.delete

容器示例

ContainerManagement 文件演示如何对容器执行 CRUD 操作。 若要在运行以下示例之前了解 Azure Cosmos 集合,请参阅使用数据库、容器和项概念性文章。

任务 API 参考
创建容器(如果不存在) Containers.createIfNotExists
列出帐户的容器 Containers.readAll
读取容器定义 Container.read
删除容器 Container.delete

项示例

ItemManagement 文件演示如何对项执行 CRUD 操作。 若要在运行以下示例之前了解 Azure Cosmos 文档,请参阅使用数据库、容器和项概念性文章。

任务 API 参考
创建项 Items.create
读取容器中的所有项 Items.readAll
按 ID 读取项 Item.read
仅当项更改时读取项 Item.read
RequestOptions.accessCondition
查询文档 Items.query
替换项 Item.replace
使用条件 ETag 检查替换项 Item.replace
RequestOptions.accessCondition
删除项 Item.delete

索引示例

IndexManagement 文件演示如何管理索引。 若要在运行以下示例之前了解 Azure Cosmos DB 中的索引,请参阅索引策略索引类型索引路径概念文章。

任务 API 参考
手动为特定项编制索引 RequestOptions.indexingDirective: 'include'
手动从索引中排除特定项 RequestOptions.indexingDirective: 'exclude'
从索引中排除路径 IndexingPolicy.ExcludedPath
在字符串路径上创建范围索引 IndexKind.RangeIndexingPolicyItems.query
使用默认 indexPolicy 创建容器,然后对其进行联机更新 Containers.create

服务器端编程示例

ServerSideScripts 项目的 index.ts 文件演示如何执行以下任务。 若要在运行以下示例之前了解 Azure Cosmos DB 中的服务器端编程,请参阅存储过程、触发器和用户定义函数概念文章。

任务 API 参考
创建存储过程 StoredProcedures.create
执行存储过程 StoredProcedure.execute

有关服务器端编程的详细信息,请参阅 Azure Cosmos DB 服务器端编程:存储过程、数据库触发器和 UDF

后续步骤

尝试为迁移到 Azure Cosmos DB 进行容量计划? 可以使用有关现有数据库群集的信息进行容量规划。