分区键为Null时的取值是什么？如何清理分区键为Null的脏数据？

先回答你的核心疑问：分区键为Null时的实际取值 #

在以/companyId为分区键的Cosmos DB集合中，如果文档缺失companyId字段，或者companyId的值为null，这些文档会被归类到系统默认的空分区键分区——这个分区对应的标识是Undefined.Value（SDK中的枚举值），本质上是Cosmos DB内部用于标记无有效分区键的特殊值，和你直接传入null作为分区键并不是完全等价的，这也是你之前尝试可能失效的原因之一。

针对脏数据的有效清理方案 #

你之前尝试的两种方法没成功，大概率是没有精准匹配到这个特殊分区，下面给你几个可行的操作方式：

1. 使用SDK精准查询并删除

直接通过SDK构造查询，匹配所有缺失companyId或companyId为null的文档，同时指定PartitionKey.None来定位到空分区：

// C# SDK示例
var container = cosmosClient.GetContainer("你的数据库名", "你的集合名");
// 构造查询条件：匹配无companyId字段或字段值为null的文档
var queryText = "SELECT * FROM c WHERE NOT IS_DEFINED(c.companyId) OR c.companyId = null";
var queryIterator = container.GetItemQueryIterator<dynamic>(
    queryText,
    requestOptions: new QueryRequestOptions { PartitionKey = PartitionKey.None }
);

while (queryIterator.HasMoreResults)
{
    var results = await queryIterator.ReadNextAsync();
    foreach (var doc in results)
    {
        // 根据文档ID和空分区键删除
        await container.DeleteItemAsync<dynamic>(doc.id, PartitionKey.None);
    }
}

如果是其他语言SDK，核心逻辑一致：查询时指定针对空分区的请求选项，遍历结果逐个删除。

2. 改进存储过程实现

如果想用存储批量删除，需要确保存储过程里正确指定空分区的查询选项，同时精准匹配脏数据：

// Cosmos DB存储过程代码
function deleteNullPartitionDocuments() {
    const collection = getContext().getCollection();
    const response = getContext().getResponse();
    // 匹配无companyId或值为null的文档
    const query = 'SELECT * FROM c WHERE NOT IS_DEFINED(c.companyId) OR c.companyId = null';
    // 指定查询空分区
    const queryOpts = { partitionKey: undefined };

    // 递归删除文档
    function deleteBatch(docs) {
        if (docs.length === 0) {
            response.setBody("所有空分区键文档已删除");
            return;
        }
        const doc = docs[0];
        collection.deleteDocument(doc._self, {}, (err) => {
            if (err) throw err;
            deleteBatch(docs.slice(1));
        });
    }

    // 执行查询并启动删除流程
    collection.queryDocuments(collection.getSelfLink(), query, queryOpts, (err, docs) => {
        if (err) throw err;
        deleteBatch(docs);
    });
}

调用这个存储过程时，需要在SDK中指定PartitionKey.None作为分区键参数，确保执行范围覆盖空分区。

3. 批量处理（适合大量脏数据）

如果脏数据量很大，推荐使用Azure Cosmos DB Bulk Executor Library，它能高效批量删除文档，避免逐个操作的性能瓶颈。核心逻辑还是先查询出所有目标文档，再批量提交删除请求。

为什么你之前的尝试可能失败？ #

• 直接用new PartitionKey(Undefined.Value)时，可能没有在查询/删除的请求选项中正确指定，导致Cosmos DB没有定位到空分区；
• 未修改的默认存储过程，通常是针对指定分区键的操作，没有适配空分区的查询和删除逻辑，所以无法匹配到脏数据。

内容的提问来源于stack exchange，提问作者Mark C.