如何解决QuestDB插入数据时报“Cannot insert rows out of order”错误

QuestDB默认创建的无分区、无自定义乱序容忍配置的表，仅支持按时间升序写入数据。你导入的历史数据时间戳早于表内已有数据，或是CSV文件内部数据时间戳乱序跨度超过默认阈值，就会触发Cannot insert rows out of order错误。

你可以根据自己的场景选择以下任意一种方案解决：

• 方案1：重新建表配置乱序支持（适合还未写入任何数据的场景）
  建表时增加分区规则和乱序容忍窗口（commitLag）配置，可根据导入数据的最大时间跨度调整commitLag的数值，示例建表语句如下：

create table records(
type INT,
interval INT,
timestamp TIMESTAMP,
name STRING) timestamp(timestamp)
-- 可根据数据时间粒度调整分区规则，如YEAR/MONTH/DAY/HOUR
PARTITION BY DAY 
-- 允许最大365天的乱序跨度，可按需调整
WITH maxUncommittedRows=100000, commitLag=365d;

数据导入完成后如果后续仅写入实时数据，可将commitLag改小以降低内存占用。

• 方案2：CSV导入时添加排序参数（适合不想修改表结构的场景）
  使用curl上传CSV时，增加sort=timestamp参数，QuestDB会先将CSV内容按时间戳字段排序后再写入，不会触发乱序错误，示例curl命令如下：

curl -F data=@你的数据文件路径.csv "http://QuestDB服务地址:9000/imp?name=records&sort=timestamp&timestamp=timestamp"

• 方案3：临时调整全局配置（适合已写入数据不想重建表的场景）
  修改QuestDB安装目录下的conf/server.conf配置文件，调整以下两个参数：

# 最大未提交行数，可根据数据量调整
cairo.max.uncommitted.rows=100000
# 全局乱序容忍窗口，按需调整为超过你数据最大乱序跨度的值
cairo.commit.lag=365d

修改完成后重启QuestDB服务再执行导入即可，导入完成后可将参数改回默认值降低资源占用。

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