如何在Cosmos DB中无需指定索引为数组所有元素新增属性？

方案1：使用UDF（用户定义函数）配合SQL更新 #

你可以创建一个自定义UDF来遍历数组并为每个元素添加新属性，再通过SQL更新语句批量处理目标文档。

1. 创建UDF：

function addPropToAllItems(items, propName, propValue) {
    if (!Array.isArray(items)) return items;
    return items.map(item => {
        item[propName] = propValue;
        return item;
    });
}

2. 执行SQL更新语句：

UPDATE c
SET c.items = udf.addPropToAllItems(c.items, 'prop2', 'value')
WHERE IS_ARRAY(c.items)

这条语句会匹配所有包含items数组的文档，调用UDF为数组内每个元素批量添加prop2属性。

方案2：SDK读取-修改-写入（小规模场景） #

如果待处理文档数量不多，可以通过SDK先读取文档，在内存中遍历数组添加属性后再写回Cosmos DB。

以.NET SDK为例：

var container = cosmosClient.GetContainer("databaseName", "containerName");
var query = container.GetItemQueryIterator<MyDocument>("SELECT * FROM c WHERE IS_ARRAY(c.items)");

while (query.HasMoreResults)
{
    var response = await query.ReadNextAsync();
    foreach (var doc in response)
    {
        foreach (var item in doc.Items)
        {
            item.Prop2 = "value";
        }
        await container.ReplaceItemAsync(doc, doc.Id);
    }
}

注意：大规模数据场景下，这种方法可能存在性能或并发冲突问题，建议结合分区键优化或批量操作逻辑。

方案3：ETL工具批量处理（大规模场景） #

如果需要处理海量文档，可以使用Azure Data Factory这类ETL工具：读取Cosmos DB数据，在转换环节为数组元素添加目标属性，最后将处理后的数据写回数据库，适合大规模批量操作。

补充：Cosmos DB的Patch操作目前确实需要指定数组索引，无法直接对所有元素批量操作，上述方案可满足你的需求。

内容的提问来源于stack exchange，提问作者Annamalai