Docker Compose中TimescaleDB函数by_range调用失败问题排查

原因1：目标数据库没启用TimescaleDB扩展 #

如果你的Docker Compose里指定了自定义的POSTGRES_DB，timescaledb-ha镜像默认只会在postgres库自动启用TimescaleDB扩展。初始化脚本直接跑create_hypertable时，目标库还没加载TimescaleDB的函数，自然找不到by_range。

解决办法 #

在init.sql开头加启用扩展的语句：

CREATE EXTENSION IF NOT EXISTS timescaledb;

如果是针对特定数据库，先切换过去再执行：

\c 你的目标数据库名
CREATE EXTENSION IF NOT EXISTS timescaledb;

原因2：函数调用没指定schema #

by_range属于timescaledb schema，初始化脚本执行时的search_path可能没包含这个schema，PostgreSQL就找不到函数。而你直接在数据库执行时，会话的search_path已经配置了包含timescaledb，所以能正常运行。

解决办法 #

要么显式指定函数的schema：

SELECT create_hypertable('measurement', timescaledb.by_range('check_time'), migrate_data => TRUE);

要么在脚本开头设置search_path：

SET search_path = public, timescaledb;

原因3：脚本执行时机早于TimescaleDB扩展初始化 #

有些timescaledb-ha镜像的初始化流程里，用户挂载的init.sql会在TimescaleDB扩展完全初始化前执行。这时候哪怕扩展最终会创建，脚本执行时函数还没注册好。

解决办法 #

修改脚本，加个循环检查函数是否存在，等就绪了再执行：

DO $$
BEGIN
  WHILE NOT EXISTS (SELECT 1 FROM pg_proc WHERE proname = 'by_range') LOOP
    PERFORM pg_sleep(1);
  END LOOP;
  SELECT create_hypertable('measurement', by_range('check_time'), migrate_data => TRUE);
END $$;

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