为何DuckDB执行DROP COLUMN时提示指定列不存在（表中实际存在）？

问题场景 #

尝试删除DuckDB表oa_pub的oa_pub_id列时，执行删除命令报错提示列不存在，但通过DESCRIBE命令能明确看到该列存在，具体操作及报错如下：

D DESCRIBE oa_pub;
┌──────────────┬─────────────┬─────────┬─────────┬──────────────────────────┬─────────┐
│ column_name  │ column_type │  null   │   key   │         default          │  extra  │
│   varchar    │   varchar   │ varchar │ varchar │         varchar          │ varchar │
├──────────────┼─────────────┼─────────┼─────────┼──────────────────────────┼─────────┤
│ id           │ INTEGER     │ NO      │ PRI     │ nextval('oa_pub_id_seq') │ NULL    │
│ project_id   │ INTEGER     │ NO      │ UNI     │ NULL                     │ NULL    │
│ oa_author_id │ VARCHAR     │ NO      │ UNI     │ NULL                     │ NULL    │
│ oa_pub_id    │ VARCHAR     │ NO      │ UNI     │ NULL                     │ NULL    │
│ oa_pub_json  │ JSON        │ YES     │ NULL    │ NULL                     │ NULL    │
│ oa_pub_id_2  │ VARCHAR     │ YES     │ NULL    │ NULL                     │ NULL    │
└──────────────┴─────────────┴─────────┴─────────┴──────────────────────────┴─────────┘
D ALTER TABLE oa_pub DROP COLUMN oa_pub_id;
Catalog Error:
table "oa_pub" does not have a column named oa_pub_id

解决办法 #

1. 用双引号包裹列名执行删除 #

列名可能包含隐藏的空格、制表符或其他不可见字符，导致直接输入的列名和实际存储的不匹配。尝试带引号执行：

ALTER TABLE oa_pub DROP COLUMN "oa_pub_id";

2. 查询系统表确认列名的真实值 #

通过information_schema系统表查看列名的实际存储内容，避免DESCRIBE的显示误差：

SELECT column_name FROM information_schema.columns WHERE table_name = 'oa_pub';

如果怀疑有隐藏字符，可进一步检查字符的ASCII码：

SELECT 
  column_name, 
  SUBSTRING(column_name, 1, LENGTH(column_name)) AS full_name,
  ASCII(SUBSTRING(column_name, 1, 1)) AS first_char_ascii,
  ASCII(SUBSTRING(column_name, LENGTH(column_name), 1)) AS last_char_ascii
FROM information_schema.columns 
WHERE table_name = 'oa_pub' 
AND column_name LIKE '%oa_pub_id%';

如果发现首尾字符的ASCII码不是对应字母的（比如空格是32），说明有隐藏字符，需要用包含隐藏字符的列名（或复制系统表返回的列名）执行删除。

3. 检查大小写匹配问题 #

DuckDB的标识符大小写敏感规则取决于配置，如果创建表时列名是带引号的小写，删除时未加引号可能导致匹配失败。确保删除语句中的列名和DESCRIBE显示的完全一致，必要时用双引号强制匹配大小写。

4. 刷新元数据缓存 #

极少数情况下，元数据缓存可能出现不一致，尝试重新连接数据库，或执行以下命令刷新缓存后再操作：

PRAGMA reload_catalog;

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