用途：这是一套面向 ScyllaDB 的 CQL 数据建模指南，帮助在设计新表、审查现有模式、从 SQL/关系型数据库、MongoDB 或 Cassandra 迁移、排查慢查询与超时、选择主键、建模时序/IoT/事件数据、处理大分区告警、遇到 ALLOW FILTERING、以及添加二级索引或物化视图时参考。其核心原则是“从查询出发，而非从实体出发”：先列出应用的每个 SELECT、UPDATE、DELETE，再为每种查询模式设计一张表，并接受反范式化。
主要能力：内容包括反模式（ALLOW FILTERING、大分区、热点分区、未分页查询、跨分区 BATCH）、基础规则（查询优先设计、分区键设计、聚类列）、模式（分桶、二级索引与物化视图）。主键由分区键（决定节点/分片）与聚类列（决定分区内排序）组成；分区键必须出现在每个 WHERE 子句，否则需要 ALLOW FILTERING 或二级索引。
使用方式：按每个参考文件的说明定位与当前任务相关的规则，文件中含原理、错误与正确的 CQL 示例、不适用场景、性能影响以及与 SQL/MongoDB 的对比。
限制：ScyllaDB 不支持 JOIN，不提供唯一约束（仅主键），查询必须指定分区键；事务仅支持单分区的轻量级事务（LWT）。自 ScyllaDB 2025.4 起，创建 keyspace 时 WITH replication 可选，可使用 CREATE KEYSPACE myapp;。其余具体步骤与版本细节暂未提供。