如何通过C#代码设置Azure Cosmos DB集合TTL为开启无默认值

嗨，RajGan！我来帮你把这两个问题讲清楚：

首先要明确一个关键知识点：集合级默认TTL不会覆盖文档级的TTL设置。具体逻辑是：

• 如果集合设置了默认TTL（比如n秒），文档没有自定义TTL时，会继承集合的默认过期时间；
• 只要文档自己设置了TTL值，就会优先使用文档级的配置，完全不受集合默认值影响。

你想要的“开启TTL但无默认值”状态，本质是让集合的TTL功能处于启用状态，但不设置全局默认过期时间——这样只有明确配置了TTL的文档会自动过期，未配置的文档会永久留存。

在Azure Cosmos DB的.NET SDK（以常用的v3版本为例）中，要实现这个状态，你需要将集合的TimeToLiveInSeconds属性设置为null。注意和文档里提到的-1（完全关闭TTL功能）区分开：-1是彻底禁用TTL，而null是启用TTL但不设置默认值。

场景1：创建新集合时配置 #

using Azure;
using Azure.Cosmos;

// 初始化Cosmos客户端
var cosmosClient = new CosmosClient("你的Cosmos DB连接字符串");
var database = await cosmosClient.CreateDatabaseIfNotExistsAsync("目标数据库名称");

// 定义集合属性，设置TTL为null
var containerProps = new ContainerProperties("目标集合名称", "/你的分区键路径")
{
    TimeToLiveInSeconds = null // 开启TTL功能但无默认过期时间
};

// 创建集合（如果不存在的话）
var container = await database.CreateContainerIfNotExistsAsync(containerProps);

场景2：修改已有集合的TTL配置 #

如果要给已存在的集合更新这个设置，代码如下：

// 获取目标集合
var container = cosmosClient.GetContainer("目标数据库名称", "目标集合名称");

// 读取集合当前属性
var containerResponse = await container.ReadContainerAsync();
var props = containerResponse.Resource;

// 更新TTL设置为null
props.TimeToLiveInSeconds = null;

// 保存修改
await container.ReplaceContainerAsync(props);

文档级TTL配置示例 #

完成集合设置后，你就可以在单个文档中通过添加ttl字段（小写）来指定过期时间了，比如：

{
    "id": "sample-doc-001",
    "partitionKey": "user-001",
    "content": "这是一个带自定义TTL的文档",
    "ttl": 86400 // 24小时后过期，单位为秒
}

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