YugabyteDB中带TTL的YCQL表二级索引插入错误问题

这个错误是YugabyteDB 2.9.0版本的已知局限——启用事务的表同时搭配二级索引和TTL功能时，部分操作会触发"Feature Not Supported"异常。结合你的表结构和查询需求，我给你几个可行的解决方案：

方案1：升级到更高版本（最推荐） #

YugabyteDB在2.10.0及后续版本中修复了事务、二级索引与TTL共存的兼容性问题。如果你能升级到稳定的新版本（比如2.10.x或更晚），可以直接保留现有表结构和配置，不需要做额外调整，插入操作和TTL功能都能正常工作。

方案2：关闭事务支持（若业务允许） #

如果暂时无法升级版本，且你的业务不需要跨表/跨行的强ACID事务支持，可以关闭表和索引的事务开关：

-- 修改表的事务设置
ALTER TABLE lists.list_table SET transactions = {'enabled': 'false'};
-- 修改二级索引的事务设置
ALTER INDEX lists.list_created_at_idx SET transactions = {'enabled': 'false'};

之后再设置TTL（比如30天，对应2592000秒）：

ALTER TABLE lists.list_table SET default_time_to_live = 2592000;

这样调整后，插入数据和两种查询模式都能正常运行，同时TTL功能也会生效。

方案3：调整数据模型适配版本限制 #

如果业务必须保留事务支持，你可以优化主键结构，去掉二级索引，让两种查询都能通过主键完成：

-- 先删除旧表（注意备份数据）
DROP TABLE lists.list_table;
-- 创建新表，将list_id作为分区键，item_value和created_at作为聚类键
CREATE TABLE lists.list_table (
 item_value text,
 list_id uuid,
 created_at timestamp,
 updated_at timestamp,
 is_deleted boolean,
 valid_from timestamp,
 valid_till timestamp,
 metadata jsonb,
 PRIMARY KEY ((list_id), item_value, created_at)
) WITH default_time_to_live = 2592000 AND transactions = {'enabled': 'true'};

这个结构下：

• 80%占比的查询select * from list_table where list_id= <id> and item_value = <value>可以通过list_id（分区键）+item_value（聚类键前缀）快速定位；
• 20%占比的查询select * from list_table where list_id= <id> and created_at>= <created_at>可以通过list_id（分区键）+created_at（聚类键范围）直接查询，完全不需要二级索引，自然避开了兼容性问题。

验证建议 #

无论选择哪种方案，修改后都建议插入几条测试数据，确认"Feature Not Supported"错误消失，同时验证两种查询模式都能返回正确结果，TTL功能也能按预期运行。

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