如何向QuestDB的非WAL表中插入ILP数据？

这个问题我之前帮人排查过，核心原因是QuestDB的ILP（行级导入协议）和BYPASS WAL表的特性冲突了，咱们一步步来解决：

为什么会报错？ #

你创建表时指定了BYPASS WAL选项，这个设置会让表跳过QuestDB的预写日志（WAL）模块，以此换取更高的写入性能，但代价是无法使用依赖WAL的写入方式——而ILP正是依赖WAL来实现高效、原子的批量写入的，所以直接用ILP客户端往这类表写数据就会触发错误。

解决方案分两种情况： #

方案一：修改表结构，启用WAL（推荐）

如果你的表还没有存储重要数据，或者可以迁移数据，最省心的方式是删除原表，重新创建不带BYPASS WAL的表（QuestDB默认会启用WAL）：

CREATE TABLE 'trades' (
  symbol SYMBOL,
  side SYMBOL,
  price DOUBLE,
  amount DOUBLE,
  timestamp TIMESTAMP
) timestamp (timestamp) PARTITION BY NONE;

修改完表结构后，你原来的Python ILP客户端代码不需要做任何调整，直接运行就能正常插入数据了。

方案二：保留非WAL表，改用其他写入方式

如果因为性能需求或其他原因必须保留BYPASS WAL的表，那得换用不依赖WAL的写入方式，比如QuestDB兼容的PostgreSQL客户端，或者COPY命令批量导入数据。

举个Python用psycopg2写入的示例：

import psycopg2
from datetime import datetime

# 连接QuestDB的PostgreSQL兼容端口（默认是8812）
conn = psycopg2.connect("host=localhost port=8812 dbname=qdb user=admin password=quest")
cur = conn.cursor()

# 执行INSERT语句写入单条数据
cur.execute("""
INSERT INTO trades (symbol, side, price, amount, timestamp)
VALUES (%s, %s, %s, %s, %s)
""", ('ETH-USD', 'sell', 2615.54, 0.00044, datetime.now()))

# 提交事务
conn.commit()

# 关闭连接资源
cur.close()
conn.close()

如果是大数据量写入，推荐用COPY命令从CSV文件导入，效率会更高。

备注：内容来源于stack exchange，提问作者Nick Woolmer