使用CREATE DATABASE ... TEMPLATE语法克隆TimescaleDB失败如何解决

• 报错的核心诱因是TimescaleDB扩展会为每个已启用该扩展的数据库启动常驻后台工作进程，这类进程用于处理连续聚合、数据压缩、保留策略等自动任务，会自动和源数据库保持活跃连接，不属于用户主动发起的PSQL客户端连接，因此常规的客户端连接检查无法识别到这类会话。
• PostgreSQL的CREATE DATABASE使用模板库的强制要求是模板库不存在任何活跃连接，TimescaleDB的后台进程连接刚好触发了这个限制，所以才会返回对应报错。

方案一：修改配置后重启（推荐，稳定性更高） #

1. 编辑PostgreSQL配置文件postgresql.conf，添加/修改以下参数，临时禁用TimescaleDB后台进程：

timescaledb.max_background_workers = 0

2. 重启PostgreSQL服务，让配置生效，此时所有TimescaleDB后台进程都会退出，源库无额外活跃连接。
3. 执行克隆数据库的SQL语句：
   CREATE DATABASE my_new_clone ENCODING 'utf8' TEMPLATE my_clone_source;
4. 克隆完成后，将postgresql.conf中的timescaledb.max_background_workers参数改回原有配置（默认值为4，若之前有自定义配置则恢复自定义值），再次重启PostgreSQL服务恢复TimescaleDB的全部后台功能。

方案二：手动终止会话（无需重启，速度更快） #

1. 先查询所有连接到源库的活跃会话，确认TimescaleDB后台进程的pid：
   SELECT pid, usename, application_name FROM pg_stat_activity WHERE datname = 'my_clone_source';
2. 批量终止源库的所有活跃会话：
   SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = 'my_clone_source';
3. 终止会话后立刻执行克隆命令，避免TimescaleDB后台进程重新自动连接到源库。

注意：克隆完成后建议在新库执行ALTER EXTENSION timescaledb UPDATE;校验扩展状态，避免出现功能异常。

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