Kysely项目中对CockroachDB支持的改进

Kysely作为一个类型安全的SQL查询构建器，最近在处理CockroachDB数据库时遇到了一个兼容性问题。本文将详细介绍这个问题的背景、原因以及解决方案。

问题背景

当开发者尝试在CockroachDB上运行Kysely的迁移脚本时，系统抛出了一个错误："pg_get_serial_sequence(): 'crdb_internal.statement_activity' is not a table"。这个错误发生在Kysely执行PostgreSQL的内省查询时，表明系统试图访问CockroachDB特有的内部表。

技术分析

Kysely的PostgreSQL内省查询原本设计用于标准PostgreSQL数据库，它会查询系统目录表来获取数据库元数据。查询中已经包含了对"pg"和"information_schema"模式的过滤，以避免查询系统内部表。然而，CockroachDB作为PostgreSQL兼容数据库，引入了自己的内部模式"crdb_internal"，这导致了查询失败。

解决方案

Kysely团队迅速响应，在PostgreSQL内省查询中添加了对"crdb_internal"模式的过滤。这个修改确保了查询不会尝试访问CockroachDB的内部系统表，从而解决了兼容性问题。

实现细节

修改后的查询现在会显式排除以下模式：

• pg_catalog
• information_schema
• crdb_internal

这种改进不仅解决了当前的错误，还为Kysely在CockroachDB上的稳定运行提供了更好的支持。

影响范围

这一改进主要影响：

1. 使用Kysely与CockroachDB集成的开发者
2. 执行数据库迁移操作的用户
3. 依赖Kysely内省功能的应用程序

最佳实践

对于使用Kysely与CockroachDB的开发者，建议：

1. 确保使用包含此修复的Kysely版本
2. 定期检查数据库兼容性更新
3. 在开发环境中充分测试迁移脚本

这一改进体现了Kysely项目对多数据库支持的持续投入，为开发者提供了更稳定、更兼容的数据库操作体验。