n8n 中文文档

Azure Cosmos DB 节点

使用 Azure Cosmos DB 节点在 Azure Cosmos DB 中自动化工作,并将 Azure Cosmos DB 与其他应用程序集成。n8n 内置支持广泛的 Azure Cosmos DB 功能,包括创建、获取、更新和删除容器和项目。

在此页面上,您将找到 Azure Cosmos DB 节点支持的操作列表以及更多资源的链接。

提示

Credentials 凭证

您可以在Azure Cosmos DB 凭据文档找到此节点的身份验证信息。

操作

  • Container 容器:
    • Create 创建
    • Delete 删除
    • Get 获取
    • Get Many 获取多个
  • Item 数据项:
    • Create 创建
    • Delete 删除
    • Get 获取
    • Get Many 获取多个
    • Execute Query 执行查询
    • Update 更新

项目:执行查询

对容器运行 NoSQL SQL 查询,并返回匹配的数据项。

参数

参数 是否必填 说明
Container 容器 是 要对其运行查询的容器。可从列表中选择,或直接输入容器 ID。
Query 查询 是 要执行的 SQL 查询。使用 $1、$2、$3 等作为查询参数的位置占位符。n8n 会在向 Azure Cosmos DB 发送请求前,自动将其转换为 @Param1、@Param2、@Param3。例如:SELECT * FROM c WHERE c.status = $1 AND c.startDate = $2。
Simplify 简化 否 启用(默认)时,会从返回的数据项中移除 Cosmos DB 内部 metadata 字段(以 _ 开头的字段)。关闭后可接收完整的原始 API 响应。

选项

展开 Options 选项 配置查询参数。

选项 说明
Query Parameters 查询参数 逗号分隔的字符串值列表,按位置映射到查询中的 $1、$2 等占位符。所有值始终作为字符串发送。 适用于名称或状态值等简单文本筛选。示例:active,2024。
Query Parameters (JSON) 查询参数 (JSON) JSON 值数组,按位置映射到查询中的 $1、$2 等占位符。会保留原生类型:数字、布尔值、null,以及带前导零的字符串。当类型精度很重要时,请使用此选项而不是 Query Parameters 查询参数。示例:[1737062400000, "01234", true, null]。

提示

Choosing between Query Parameters and Query Parameters (JSON) 在查询参数和查询参数 (JSON) 之间进行选择

Azure Cosmos DB 执行类型敏感的比较。像这样的过滤器 如果 startDate 存储为数字,则 WHERE c.startDate = $1 不返回结果 在数据库中,但参数以字符串形式到达。

  • 当所有筛选值都是文本(名称、状态、标识符)时,使用 Query Parameters 查询参数。
  • 当你需要按数字、布尔值、null 或以数字开头且必须保持为字符串的值(例如 "01234" 这类邮政编码)进行筛选时,使用 Query Parameters (JSON) 查询参数 (JSON)。

Limitation: 限制: JavaScript 的 JSON 解析器无法表示大于 Number.MAX_SAFE_INTEGER (9007199254740991) 具有全精度。价值观超越 使用 Query Parameters (JSON) 查询参数 (JSON) 时,此限制可能会失去精度。

模板和示例

浏览 Azure Cosmos DB 节点文档集成模板 或 搜索所有模板

相关资源

有关该服务的详细信息,请参阅Azure Cosmos DB 文档。

如果您的操作不支持怎么办

如果该节点不支持您想要执行的操作,您可以使用HTTP请求节点来调用服务的API。

您可以在 HTTP 请求节点中使用为此服务创建的凭据:

  1. 在 HTTP 请求节点中,选择 Authentication 认证 > Predefined Credential Type 预定义凭证类型。
  2. 选择您要连接的服务。
  3. 选择您的凭证。

更多信息请参见自定义API操作。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。