DBeaver自动补全大小写混合表名后报'relation不存在'错误

环境信息 #

• DBeaver：版本23.0.1.202303250535
• 设备：MacBook Pro/Apple M1 Max，系统macOS Ventura 13.2.1
• 数据库：Azure上的PostgreSQL（推测为PostgreSQL 11）

问题重现 #

在DBeaver中配置好数据库和Schema后，编写查询语句：

SELECT * FROM D

自动补全列表中出现Dim_Date表，双击补全后语句变为：

select * from "Dim_Date" dd

执行时触发错误：

SQL Error [42P01]: ERROR: relation "Dim_Date" does not exist
Position: 15

已知该表实际存在（否则不会触发自动补全），问题出在哪里？

问题原因及解决方案 #

核心原因：PostgreSQL标识符大小写规则 + DBeaver自动补全偏差 #

PostgreSQL对表名、列名这类标识符的大小写处理有严格规则：

• 不加双引号的标识符会被自动转为小写，比如写Dim_Date会被数据库识别为dim_date
• 加双引号的标识符会严格区分大小写，此时数据库会精确查找名称完全匹配（包括大小写）的表

自动补全给表名加上双引号后，数据库找不到对应大小写的表，就会报错。另外也可能是自动补全显示的是其他Schema下的表，但执行时未指定Schema，导致找不到。

解决步骤 #

1. 去掉双引号，用小写表名测试
   把查询语句改成：

select * from dim_date dd

执行看是否成功。如果成功，说明你的表实际名称是小写的dim_date，自动补全错误添加了双引号。

2. 明确指定表所在的Schema
   如果表不在当前连接的默认Schema下，需要加上Schema前缀，比如：

select * from public.dim_date dd

（把public换成表实际所在的Schema名称）

3. 刷新DBeaver元数据缓存
   右键点击数据库连接，选择「刷新元数据」，避免缓存的旧信息导致自动补全和实际数据库不一致。

4. 查询系统表确认表的真实名称
   执行以下语句查看表的实际名称和所在Schema：

SELECT table_name, table_schema FROM information_schema.tables WHERE table_name ILIKE '%dim_date%';

根据返回的真实信息调整查询语句即可。

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