PostgreSQL 9.6：使用外部数据包装器调用远程函数报错

这种远程调用失败的情况我之前也碰到过，核心问题在于本地调用和dblink远程调用对VARIADIC参数的解析逻辑不一样，再加上字符串转义的坑，很容易踩雷。下面给你拆解原因和解决方案：

为什么本地正常远程失败？ #

你的函数定义是接收VARIADIC text[]参数，本地调用时PostgreSQL会自动把你传入的多个字符串打包成数组，匹配函数的参数要求。但通过dblink调用时，你是把一段SQL字符串发送给远程数据库执行——如果直接写public.insert_log('usage', 'txn', 'dimensions')，远程库会认为你在找一个接收3个独立text参数的函数，而不是接收VARIADIC数组的那个，自然会报错“函数不存在”或者参数不匹配。另外手动转义单引号也容易出语法错误。

靠谱的解决方案 #

方案1：明确用VARIADIC传递数组 #

在远程执行的SQL里，直接把参数打包成数组，并用VARIADIC关键字声明，让远程库正确识别参数类型：

SELECT dblink('pg_log', 
  'SELECT public.insert_log(VARIADIC ARRAY[''usage'', ''txn'', ''dimensions'']::text[])');

这里注意单引号要转义（用两个单引号表示一个），确保远程能解析出正确的数组。

方案2：用format函数自动处理转义（更省心） #

如果参数里有特殊字符（比如带单引号的内容），手动转义很容易出错，用format的%L占位符自动处理转义：

SELECT dblink('pg_log', 
  format('SELECT public.insert_log(VARIADIC ARRAY[%L, %L, %L]::text[])', 
         'usage', 'txn', 'dimensions'));

比如你要传'user's operation'这种带单引号的参数，format会自动转成'user''s operation'，避免SQL语法崩溃。

方案3：参数化查询（最安全，推荐） #

dblink支持参数化查询，完全不用管转义，把参数单独传递给远程库：

SELECT dblink('pg_log', 
  'SELECT public.insert_log(VARIADIC $1::text[])',
  ARRAY[['usage', 'txn', 'dimensions']]::text[][]);

这里第三个参数是参数数组：因为我们要传递的是一个text[]类型的参数（对应函数的VARIADIC数组），所以需要把它包装成text[][]类型（dblink的参数是一维数组，每个元素对应一个SQL占位符）。这种方式还能避免SQL注入风险。

常见错误排查 #

• 如果报function public.insert_log(text, text, text) does not exist：说明远程库没识别到VARIADIC参数，必须用VARIADIC ARRAY[...]的方式传递。
• 如果报SQL语法错误：检查单引号转义，或者直接用format/参数化查询规避。

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