如何在Django模型中访问Oracle数据库链接？遇ORA-04054错误求助

问题原因 #

你当前的db_table格式导致Oracle解析错误，错误地将字段名CUST_NUM识别为数据库链接名称，从而抛出"database link not found"异常。

解决步骤 #

1. 修正db_table的格式 #

Oracle中带Schema和数据库链接的表名正确写法不需要给数据库链接添加双引号（除非链接名是大小写敏感的特殊名称），修改模型的Meta类：

class Meta:
    # 如果数据库链接名是大写默认格式，去掉链接名的双引号
    db_table = '"MY_SCHEMA"."TABLE_NAME"@OTHER_DB'
    managed = False

如果你的数据库链接创建时用了双引号（即大小写敏感），则保留链接名的双引号，但需确保名称完全匹配：

class Meta:
    db_table = '"MY_SCHEMA"."TABLE_NAME"@"OTHER_DB"'
    managed = False

2. 验证Oracle数据库链接的有效性 #

在Oracle客户端执行以下SQL，确认数据库链接存在且当前用户有权限访问：

-- 检查数据库链接是否存在（注意大小写，Oracle默认存储为大写）
SELECT * FROM ALL_DB_LINKS WHERE DB_LINK = 'OTHER_DB';

-- 直接测试远程表访问
SELECT cust_num, customer_number FROM "MY_SCHEMA"."TABLE_NAME"@OTHER_DB;

如果这一步报错，说明是Oracle端的问题，需要先确保数据库链接创建正确、权限配置到位。

3. 备选方案：使用同义词简化配置 #

如果上述格式调整仍有问题，可以在Oracle中创建同义词指向远程表：

CREATE SYNONYM MY_REMOTE_CUSTOMER FOR "MY_SCHEMA"."TABLE_NAME"@OTHER_DB;

然后修改Django模型的db_table为同义词名称：

class Meta:
    db_table = '"MY_REMOTE_CUSTOMER"'
    managed = False

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