PostgreSQL创建表后主键与外键约束在DBeaver中不显示问题咨询

问题场景 #

我通过以下DDL在PostgreSQL中创建表：

CREATE TABLE projeto_modelo.exemplo_fk1 
(
    id SERIAL NOT NULL,
    nome varchar(30) NOT NULL,
    criado_em timestamp NOT NULL,
    id_exmp_fk2 int4 NOT NULL,

    CONSTRAINT exemplo_fk1_id_exmp_fk2_fkey 
        FOREIGN KEY (id_exmp_fk2) 
        REFERENCES projeto_modelo.exemplo_fk2(id),
    PRIMARY KEY(id)
);

但在DBeaver中查看该表结构时，生成的推荐DDL缺失了主键和外键约束：

CREATE TABLE projeto_modelo.exemplo_fk1 
(
    id serial4 NOT NULL,
    nome varchar(30) NOT NULL,
    criado_em timestamp NOT NULL,
    id_exmp_fk2 int4 NOT NULL
);

同时约束列表中也没有任何约束显示，以下是可能的原因：

1. DBeaver元数据缓存未同步 #

DBeaver会缓存数据库的元数据，若刚执行完建表语句就查看，缓存可能还没更新。右键点击表节点选择「刷新」（或按F5），再重新查看约束和DDL即可。

2. 外键依赖的目标表不满足条件 #

PostgreSQL创建外键时，要求被引用的表（projeto_modelo.exemplo_fk2）必须存在，且被引用的列（id）是主键或唯一约束。如果这两个条件不满足，建表语句执行时外键约束会创建失败；若建表时直接报错，说明表本身可能未成功创建。可以通过执行以下SQL验证约束是否真的存在：

SELECT conname, contype 
FROM pg_constraint 
WHERE conrelid = 'projeto_modelo.exemplo_fk1'::regclass;

如果结果为空，说明约束确实未创建；若有结果则是DBeaver端的问题。

3. DBeaver的DDL生成配置未包含约束 #

DBeaver的DDL生成功能有可配置项，可能默认未勾选约束相关选项：

• 右键表选择「生成DDL」，在弹出窗口中确认是否勾选「主键」「外键」等选项；
• 进入全局设置（菜单「编辑」→「偏好设置」→「数据库」→「DDL生成」），检查默认配置是否包含约束生成。

4. 当前数据库用户权限不足 #

如果连接数据库的用户没有访问系统元数据表（如pg_constraint、information_schema.table_constraints）的权限，DBeaver无法获取约束信息。可以尝试用超级用户（如postgres）连接数据库，查看约束是否显示，以此验证权限问题。

5. SERIAL类型的显示差异（非约束问题） #

注意到DBeaver将SERIAL显示为serial4是正常的，因为SERIAL本身就是serial4的别名，这属于类型名称的规范显示，和约束缺失无关。

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