Citus中enable_repartition_joins设置后不生效的原因排查求助

以下是导致执行SET citus.enable_repartition_joins = on;后，SHOW citus.enable_repartition_joins;仍返回off的可能原因和对应解决方法：

• 会话级设置仅对当前连接有效
  默认的SET命令是会话级配置，仅在当前数据库连接周期内生效，断开连接后设置会重置。如果你在执行SET后新开会话查询，结果自然还是off。要配置全局永久生效的参数，需执行：

  ALTER SYSTEM SET citus.enable_repartition_joins = on;
  SELECT pg_reload_conf(); -- 无需重启Postgres即可加载新配置
  

  执行后再次查询就能看到参数已生效，且重启Postgres后配置会保留。

• 配置文件存在硬编码覆盖
  检查PostgreSQL的postgresql.conf文件，看是否明确设置了citus.enable_repartition_joins = off。如果有这个配置，它会覆盖会话级或ALTER SYSTEM的设置（取决于加载优先级）。此时需要修改postgresql.conf中的对应参数，再执行pg_reload_conf()或重启Postgres。
  可以通过以下SQL查看参数的来源：

  SELECT name, setting, source FROM pg_settings WHERE name = 'citus.enable_repartition_joins';
  

  source字段会显示参数的来源，比如configuration file表示来自postgresql.conf，file表示来自postgresql.auto.conf，session表示仅当前会话有效。

• Citus扩展未加载或版本不兼容
  先确认Citus扩展已在当前数据库中加载：

  SELECT * FROM pg_extension WHERE extname='citus';
  

  如果没有结果，需先执行CREATE EXTENSION citus;加载扩展。另外，部分旧版本Citus不支持citus.enable_repartition_joins参数，建议升级到兼容的新版本。

• 临时会话执行的设置无法持久
  你用postgres -c "psql -p 9700 -U postgres -c 'SET citus.enable_repartition_joins = on;'"的方式执行设置，会创建一个临时会话，命令执行完会话就关闭了，设置不会保留到后续会话。应该进入持续的psql会话执行全局配置命令，或者用ALTER SYSTEM设置永久生效的参数。

• 未在Citus协调器节点执行设置
  Citus是分布式架构，全局参数必须在协调器节点设置，worker节点的配置不影响协调器的查询逻辑。如果你的SET命令是在worker节点执行的，协调器的参数不会改变，查询依然会报错。先确认当前连接的是协调器节点，再执行设置。

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