什么是 @azure/cosmos
@azure/cosmos 是一个用于访问 Azure Cosmos DB 的官方 Node.js SDK，它提供了一种简单而易用的方式来在 Node.js 中管理和访问 Azure Cosmos DB。使用 @azure/cosmos SDK，您可以轻松地编写 Node.js 应用程序来执行各种数据操作，如查询数据、更新数据、删除数据等。此外，@azure/cosmos 还支持管理您的 Azure Cosmos DB 资源，包括集合、数据库和帐户。
如何使用 @azure/cosmos
步骤1：安装 @azure/cosmos
要开始使用 @azure/cosmos，您需要先将其安装在您的 Node.js 项目中。您可以使用 npm 包管理器来安装它：
npm install @azure/cosmos
步骤2：创建 Azure Cosmos DB 帐户和数据库
在使用 @azure/cosmos 之前，您需要先创建一个 Azure Cosmos DB 帐户和数据库。Azure Cosmos DB 是微软的一个分布式多模型数据库服务，它可以在全球各地的数据中心提供高度可用的数据存储和处理服务。在 Azure Cosmos DB 中，您可以选择使用 SQL、MongoDB、Cassandra、Azure Table Storage 和 Gremlin API 数据模型来存储和查询您的数据。
要创建 Azure Cosmos DB 帐户和数据库，您可以按照以下步骤操作：
- 在 Azure 门户中，选择“创建资源”>“数据库”>“Azure Cosmos DB”。
- 输入您的新 Azure Cosmos DB 帐户的详细信息，包括订阅、资源组、帐户名称和位置。
- 选择您要使用的 API 类型和数据模型。根据您的应用程序的需求选择合适的 API 类型和数据模型。
- 设置其他选项，例如网络和安全、成本和计费等。
- 创建成功后，记录您的 Azure Cosmos DB 帐户名和密钥。这些信息将用于在 @azure/cosmos 中连接到您的 Azure Cosmos DB 帐户。
步骤3：连接到 Azure Cosmos DB 帐户
使用 @azure/cosmos，您可以轻松地连接到您的 Azure Cosmos DB 帐户。要连接到 Azure Cosmos DB 帐户，请使用以下代码：
const { CosmosClient } = require("@azure/cosmos");
const endpoint = "https://youraccount.documents.azure.com:443/";
const key = "youraccountkey";
const client = new CosmosClient({ endpoint, key });将上述代码中的 endpoint 和 key 替换为您的 Azure Cosmos DB 帐户的详细信息。接下来，您就可以使用 client 来执行各种数据操作，例如创建、读取、更新和删除文档。
步骤4：操作文档和集合
使用 @azure/cosmos，您可以轻松地操作文档和集合。要创建一个新的集合，请使用以下代码：
-- -------------------- ---- ------- ----- - ------------ - - ------------------------- ----- -------- - ----------------------------------------------- ----- --- - ----------------- ----- ------ - --- -------------- --------- --- --- ----- -------- ------------------ - ----- ---------- - ------------ ----- ----------- - ------------- ----- - -------- - - ----- ------------------------------------ --- ---------- --- -------------------- --------- ----------------- ----- - --------- - - ----- --------------------------------------- --- ----------- --- -------------------- ---------- ------------------ - -------------------------------- -- - --------------------- ---
在上述代码中，我们首先创建了一个 databaseId 为 database1 的 Azure Cosmos DB 数据库，然后创建了一个 containerId 为 container1 的集合。
要向集合中添加新的文档，请使用以下代码：
-- -------------------- ---- ------- ----- - ------------ - - ------------------------- ----- -------- - ----------------------------------------------- ----- --- - ----------------- ----- ------ - --- -------------- --------- --- --- ----- -------- ---------------- - ----- ---------- - ------------ ----- ----------- - ------------- ----- ------------ - - ----- ------- ------ ----------------- -- ----- - --------- - - ----- ---------------------------------------------------------- ----- - --------- ---- - - ----- ------------------------ --- --------- ------------ --- -------------------- ---- ---- --- ------------- - ------------------------------ -- - --------------------- ---
在上述代码中，我们首先读取了 containerId 为 container1 的集合，然后使用 create() 方法向集合中添加新的文档。
最后，如果您要查询数据，请使用以下代码：
-- -------------------- ---- -------
----- - ------------ - - -------------------------
----- -------- - -----------------------------------------------
----- --- - -----------------
----- ------ - --- -------------- --------- --- ---
----- -------- ---------------- -
----- ---------- - ------------
----- ----------- - -------------
----- ----- - ------- - ---- - ----- ---- - -----
----- --------- - -
------
----------- -
-
----- ------
------ ---------
--
--
--
----- - --------- - - ----- ----------------------------------------------------------
----- - ---------- ----- - - ----- --------------------------------------------
------------------ --------------- --------
-
------------------------------ -- -
---------------------
---在上述代码中，我们使用 query() 方法来执行 SQL 查询。在查询中，我们使用了 @id 参数来限制返回的文档列表。
小结
在本文中，我们介绍了如何使用 @azure/cosmos 包来访问 Azure Cosmos DB。我们展示了如何安装 @azure/cosmos 包、创建 Azure Cosmos DB 帐户和数据库、连接到 Azure Cosmos DB 帐户以及操作文档和集合。我们还展示了如何使用 @azure/cosmos 包来执行 SQL 查询和批处理。在将来，您可以进一步探索 @azure/cosmos 包，以充分利用 Azure Cosmos DB 提供的更多功能和服务。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedab06b5cbfe1ea0610629