PostgreSQL技术咨询：如何在SQL脚本中为COPY语句传递参数

我来帮你搞定这个在psql里给COPY语句传参数的问题——之前我也踩过类似的坑，咱们一步步拆解原因，再给出正确的写法。

首先得理清你遇到的核心问题：你混淆了**psql元命令（比如\copy）和SQL命令（COPY）**的变量使用方式，而且传递参数时额外加引号导致了嵌套引号的语法错误。

先分析你之前写法的问题： #

1. 直接用copy ( select * from bar ) to :v1;
   COPY是SQL命令，psql的:v1变量替换在这种场景下无法正确处理字符串格式，尤其是你传递的v1还带了额外引号，会直接导致SQL语法错误。

2. 用DO $$ BEGIN EXECUTE 'copy (select * from bar) to ' || :v1; END $$
   这种字符串拼接的方式没有处理特殊字符转义，而且如果你的v1带引号，拼接后会出现多余的引号；同时要注意：SQL的COPY是服务器端操作，文件路径是服务器上的路径，不是你本地的路径（如果是要导出到本地，应该用\copy）。

3. 用DO $$ BEGIN EXECUTE format('copy (select * from bar) to %L',:v1); END $$
   这里的问题是你传递v1时已经加了引号（-v v1="'/Users/username/test.json'"），而format的%L会自动给变量值加上单引号，最终生成的路径会变成''/Users/username/test.json''，双引号嵌套直接触发语法错误。

正确的解决方案分两种场景： #

场景1：导出到本地文件（你的需求应该是这个）

用psql的**\copy元命令**（客户端操作，文件在本地），这时候变量的使用方式更简单：

• 执行脚本时，直接传递不带引号的路径：

  psql -d my_db -f ./exports.sql -v v1="/Users/username/test.json"
  

• 脚本里这样写：

  \copy (select * from bar) to :'v1';
  

  这里的:v1是psql元命令专用的变量引用方式，psql会自动把变量值处理成带正确引号的字符串，完全不需要你手动加引号，完美避免语法错误。

场景2：导出到服务器端文件

如果你的文件是在PostgreSQL服务器的文件系统上，需要用SQL的COPY命令，这时候要正确使用format函数：

• 执行脚本时，同样传递不带引号的路径：

  psql -d my_db -f ./exports.sql -v v1="/path/on/server/test.json"
  

• 脚本里写：

  DO $$
  BEGIN
    EXECUTE format('COPY (select * from bar) TO %L', :v1);
  END $$;
  

  这里format的%L会自动给路径加上单引号并转义特殊字符，生成的SQL语句完全符合语法要求。

关键提醒 #

一定要分清COPY和\copy的区别：

• COPY是SQL命令，由PostgreSQL服务器执行，文件必须在服务器上，且服务器进程要有读写权限；
• \copy是psql的元命令，由客户端执行，文件在你的本地机器上，适合本地导出/导入的场景。

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