PostgreSQL file_fdw创建含单引号文件名外部表后无法访问

核心结论 #

这大概率不是file_fdw的bug，而是文件名转义方式错误或路径解析问题导致的，以下是具体解决思路：

1. 修正文件名的转义写法 #

PostgreSQL中字符串转义有两种常用方式，针对带单引号的文件名，推荐使用**美元引号（Dollar-quoted Strings）**避免转义混乱：

• 如果文件名本身包含单引号（比如示例中的'test_1111 _2_ABC Hr. Schmidt_2024.csv'），创建外部表时用美元引号包裹文件名参数，无需转义内部单引号：

CREATE FOREIGN TABLE test_csv (
    -- 按需定义表结构字段
    col1 text,
    col2 varchar(50)
)
SERVER file_server
OPTIONS (
    filename $$'test_1111 _2_ABC Hr. Schmidt_2024.csv'$$,
    format 'csv'
);

• 若坚持使用单引号包裹，需将内部单引号用两个单引号转义（PostgreSQL标准字符串转义规则）：

OPTIONS (
    filename '''test_1111 _2_ABC Hr. Schmidt_2024.csv''',
    format 'csv'
);

2. 使用绝对路径指定文件 #

相对路径依赖PostgreSQL服务器进程的工作目录，容易导致路径解析错误，直接使用绝对路径可以彻底避免这个问题：

OPTIONS (
    filename $$/data/csv_files/'test_1111 _2_ABC Hr. Schmidt_2024.csv'$$,
    format 'csv'
);

3. 验证操作系统中的文件名准确性 #

• 用操作系统命令（Linux的ls、Windows的dir）确认文件名的精确拼写，包括空格、单引号的位置和数量，避免视觉误差导致的文件名不匹配。
• 若文件名包含特殊字符（比如全角空格），需确保创建外部表时使用完全一致的字符。

4. 排查COPY命令的转义问题 #

如果COPY命令也无法找到文件，说明问题根源不在file_fdw，而是文件名转义错误。测试COPY的正确写法：

COPY test_table (col1, col2)
FROM $$/data/csv_files/'test_1111 _2_ABC Hr. Schmidt_2024.csv'$$
DELIMITER ',' CSV;

若COPY仍失败，优先检查路径和文件名的准确性，而非怀疑file_fdw的问题。

5. 版本兼容性检查 #

旧版本的PostgreSQL（比如9.x系列）的file_fdw对特殊字符文件名的解析可能存在缺陷，尝试升级到PostgreSQL 12及以上版本，后续版本优化了file_fdw的字符串处理逻辑。

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