来自 Azure 流分析的 Azure Cosmos DB 输出

Azure Cosmos DB 是一种分布全球的数据库服务,它提供全球范围内不设限的弹性缩放、丰富查询和自动索引(经由与构架无关的数据模型)。 若要了解流分析的 Azure Cosmos DB 容器选项,请参阅将 Azure Cosmos DB 用作输出的流分析一文。

流分析中的 Azure Cosmos DB 输出当前在由世纪互联运营的 Azure 和 Azure 德国 (T-Systems International) 中不可用。

注意

Azure 流分析仅支持使用 SQL API 连接到 Azure Cosmos DB。 尚不支持使用其他 Azure Cosmos DB API。 如果使用其他 API 将 Azure 流分析指向 创建的 Azure Cosmos DB 帐户,则可能无法正确存储数据。

下表描述了用于创建 Azure Cosmos DB 输出的属性。

属性名称 说明
输出别名 用于在流分析查询中引用此输出的别名。
接收器 Azure Cosmos DB。
导入选项 选择“从订阅中选择 Azure Cosmos DB”或“手动提供 Azure Cosmos DB 设置”。
帐户 ID Azure Cosmos DB 帐户的名称或终结点 URI。
帐户密钥 Azure Cosmos DB 帐户的共享访问密钥。
数据库 Azure Cosmos DB 数据库名称。
容器名称 要使用的容器名称,该名称必须存在于 Azure Cosmos DB 中。 示例:
  • MyContainer:名为“MyContainer”的容器必须存在。
文档 ID 可选。 输出事件中的字段的名称,该字段用于指定插入或更新操作所基于的主键。

注意

用于 Azure 流分析的 Azure Cosmos DB 输出使用 .NET V3 SDK。 写入多个区域时,SDK 会自动选取可用的最佳区域。

分区

分区键基于查询中的 PARTITION BY 子句。 输出编写器的数量与完全并行化的查询的输入分区一致。 流分析会将 Azure Cosmos DB 输出分区键转换为字符串。 例如,如果分区键的值为 bigint 类型的 1,则它将转换为字符串类型的“1”。 无论是否将分区属性写入 Azure Cosmos DB,都会发生这种转换。

输出批大小

有关最大消息大小,请参阅 Azure Cosmos DB 限制。 批大小和写入频率根据 Azure Cosmos DB 响应动态调整。 流分析不会施加预先确定的限制。

后续步骤