如何基于带联合主键的表创建TimescaleDB hypertable并解决Flyway调用报错

这个报错和Flyway不支持TimescaleDB函数无关，本质是当前数据库执行会话找不到create_hypertable函数，触发PostgreSQL 42883错误码（函数不存在/参数不匹配）。你移除主键后仍然报错也验证了这一点，和表的主键配置无关。

常见的触发原因有两个：

• 你执行迁移的目标schema未启用TimescaleDB扩展，扩展相关函数无法被当前会话识别
• 数据库会话的search_path未包含TimescaleDB扩展所在的schema，导致调用时没有匹配到函数

按以下步骤调整你的迁移SQL即可解决：

1. 提前加载TimescaleDB扩展
   在你的V1__init_schema.sql文件最开头添加扩展创建语句，确保当前schema可以识别TimescaleDB相关函数：

CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;

2. 调用函数时明确指定schema前缀（推荐）
   如果你的TimescaleDB固定安装在public schema下，调用create_hypertable时加上schema前缀，避免search_path配置问题导致的函数找不到：

SELECT public.create_hypertable('cars', 'time_bought');

3. 多租户场景适配
   如果你是多租户schema隔离的部署模式，可以在执行hypertable创建语句前临时调整search_path，包含扩展所在的schema和当前租户schema：

SET search_path TO public, <你的当前租户schema名称>;

4. 可选：添加显式类型转换
   如果调整schema配置后仍然报错，可以按照报错提示添加显式类型转换，明确参数类型即可：

SELECT create_hypertable('cars'::regclass, 'time_bought'::name);

你现有的联合主键(id, time_bought)完全符合TimescaleDB的hypertable创建要求（联合主键必须包含时间分区列），不需要修改主键配置。

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