最小可行配置需设connecttimeout≥3s、protoversion为v4、复用session并调用session.close()退出；避免unlogged batch、二级索引及错误分区键设计，批量单batch≤64条，numconns=4且maxrequestsperconn=500。
gocql 连接 ScyllaDB 的最小可行配置
ScyllaDB 兼容 Cassandra 协议，gocql 是当前 Go 生态中唯一成熟、生产可用的驱动，无需额外适配。但直接复用 Cassandra 示例会踩坑：ScyllaDB 默认关闭了某些协议特性（如压缩、重试策略），且对连接超时更敏感。
-
gocql支持 ScyllaDB 4.0+，需显式启用ProtoVersion：必须设为gocql.Unset或gocql.V4，V3 在 ScyllaDB 5.x+ 已弃用，否则报错protocol version not supported - 集群发现依赖
gocql内置的HostFilter，ScyllaDB 节点间 gossip 稳定，但首次连接时若 DNS 解析慢，会导致no hosts resolved—— 建议在ClusterConfig中设置Timeout: 5 * time.Second和ConnectTimeout: 3 * time.Second - ScyllaDB 默认禁用
Thrift，只支持 CQL 协议，所以连接字符串里不能带thrift://，必须用cql://或直接省略协议头，仅填 IP:Port
写入吞吐瓶颈不在 SQL，而在批大小与一致性级别
ScyllaDB 不是关系型数据库，INSERT 本身极快，但默认 ConsistencyLevel 是 ONE，看似安全，实则在跨 AZ 部署时因网络抖动导致大量 WriteTimeoutError；而盲目调高到 QUORUM 又会显著拉长 P99 延迟。
- 批量写推荐用
gocql.Batch，但单个Batch不宜超过 64 条语句 —— ScyllaDB 对 batch size 敏感，超过后触发反压，错误变为RequestTimedOut而非明确提示 - 避免使用
UNLOGGED BATCH除非你确认这批数据可丢 —— ScyllaDB 的 unlogged batch 不提供原子性保证，节点宕机时部分语句可能已落盘、部分丢失 - 真正提升吞吐的关键是并发
Session.Query数量：ScyllaDB 吞吐随客户端并发线程数线性增长，直到达到服务端 CPU 或磁盘 I/O 极限；建议用固定 goroutine 池（如 16–32 个）轮询提交Query，而非为每条写请求起 goroutine
Schema 设计必须面向写优化，而非查询便利
ScyllaDB 的分区键（Partition Key）决定数据物理分布，一旦写入就无法修改。高频时序写入场景下，若把 device_id 当作唯一分区键，会导致单个分区无限膨胀，最终触发 partition too large 错误并拒绝写入。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须引入时间桶（time bucket）：例如将
created_at截断到小时级，组合成(device_id, hour_bucket)作为复合分区键，确保单个分区数据量可控（建议 ≤ 100MB） - 避免二级索引：ScyllaDB 的
CREATE INDEX在写入路径上引入额外协调节点开销，QPS 超 5k 就明显拖慢；替代方案是建物化视图（Materialized View）或反范式化冗余字段 - 宽列模型优先：一个传感器指标存一行（
sensor_id, ts, value），比把多个指标塞进 JSON blob 更利于压缩和 scan 性能 —— ScyllaDB 的 SSTable 压缩对重复列名天然友好
连接池不是 database/sql 那套，得靠 gocql 自带机制
gocql.Session 本身已是连接池，它内部维护一组到各节点的底层 TCP 连接，并自动做健康探测和重连。你不需要、也不应该再套一层 sql.DB 或自建 channel 缓冲 —— 那只会增加延迟、打乱 ScyllaDB 的负载均衡策略。
-
Session初始化后即并发安全，所有 goroutine 复用同一个实例即可，频繁NewSession会耗尽文件描述符并触发too many open files - 关键调参只有三个：
NumConns（每节点连接数，默认 2）、MaxRequestsPerConn（单连接并发请求数，默认 1000）、Timeout（单请求超时，默认 600ms）；生产环境建议NumConns=4+MaxRequestsPerConn=500，平衡复用率与队列深度 - 务必调用
session.Close()在服务退出时 ——gocql不会自动清理后台心跳 goroutine，不关会导致进程 hang 住
ScyllaDB 的写入能力远超传统关系库，但它的“快”是有前提的：schema 必须按分布式存储逻辑设计，连接和批处理必须贴合其协议特性，任何试图把它当 MySQL 用的惯性思维都会在百万级 QPS 下暴露问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
