Azure Cosmos DB 节点#
使用 Azure Cosmos DB 节点在 Azure Cosmos DB 中自动化工作，并将 Azure Cosmos DB 与其他应用程序集成。n8n 内置支持广泛的 Azure Cosmos DB 功能，包括创建、获取、更新和删除容器和项目。
在此页面上，您将找到 Azure Cosmos DB 节点支持的操作列表以及更多资源的链接。
凭据
您可以在此处找到此节点的身份验证信息。
操作#
- Container 容器:
- Create 创建
- Delete 删除
- Get 获取
- Get Many 获取多个
- Item 数据项:
- Create 创建
- Delete 删除
- Get 获取
- Get Many 获取多个
- Execute Query 执行查询
- Update 更新
Item 数据项：Execute Query 执行查询#
对容器运行 NoSQL SQL 查询，并返回匹配的数据项。
Parameters 参数#
| 参数 | 是否必填 | 说明 |
|---|---|---|
| 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 选项#
展开 Options 选项 配置查询参数。
| 选项 | 说明 |
|---|---|
| Query Parameters 查询参数 | 逗号分隔的字符串值列表，按位置映射到查询中的 $1、$2 等占位符。所有值始终作为字符串发送。 适用于名称或状态值等简单文本筛选。示例：active,2024。 |
| Query Parameters (JSON) 查询参数 (JSON) | JSON 值数组，按位置映射到查询中的 $1、$2 等占位符。会保留原生类型：数字、布尔值、null，以及带前导零的字符串。当类型精度很重要时，请使用此选项而不是 Query Parameters 查询参数。示例：[1737062400000, "01234", true, null]。 |
选择 Query Parameters 与 Query Parameters (JSON)
Azure Cosmos DB 执行类型敏感的比较。如果 startDate 在数据库中存储为数字，但参数以字符串传入，像
WHERE c.startDate = $1 这样的筛选不会返回结果。
- 当所有筛选值都是文本（名称、状态、标识符）时，使用 Query Parameters 查询参数。
- 当你需要按数字、布尔值、
null或以数字开头且必须保持为字符串的值（例如"01234"这类邮政编码）进行筛选时，使用 Query Parameters (JSON) 查询参数 (JSON)。
限制： JavaScript 的 JSON 解析器无法以完整精度表示大于
Number.MAX_SAFE_INTEGER (9007199254740991) 的整数。使用 Query Parameters (JSON) 查询参数 (JSON) 时，超出此限制的值可能丢失精度。
模板和示例#
相关资源#
有关该服务的更多信息，请参阅 Azure Cosmos DB 文档。
如果不支持您的操作该怎么办#
如果此节点不支持您想要执行的操作，您可以使用 HTTP 请求节点来调用服务的 API。
您可以在 HTTP 请求节点中使用为此服务创建的凭据：
- 在 HTTP 请求节点中，选择身份验证 > 预定义凭据类型。
- 选择您要连接的服务。
- 选择您的凭据。
有关更多信息，请参阅自定义 API 操作。