Python连接Oracle云自治数据仓库时遭遇ORA-12506错误的技术求助

阿华AIGC实验室

2026-4-23

问题分析

楼主遇到的这个ADW连接问题我之前帮不少开发者排查过，属于Oracle云自治库连接的典型坑。你用SQLAlchemy尝试连接时抛出ORA-12506错误，核心是无法建立加密连接，进而没法访问库内的表和数据。先贴出你的代码方便参考：

from sqlalchemy import create_engine

user = 'admin'
password = '****'
tns = <string from the tnsnames.ora file>

engine = create_engine('oracle+cx_oracle://{0}:{1}@{2}'.format(user, password, tns))
con = engine.connect()

下面按优先级给你梳理几个必查的解决方向：

1. 先搞定Oracle客户端与cx_Oracle的环境配置（最关键）

ADW要求用TCPS加密连接，这一步错了后面全白搭：

必须安装带SSL支持的Oracle Instant Client（推荐19c或21c版本），并且把客户端的库路径添加到系统环境变量：Windows加PATH，Linux加LD_LIBRARY_PATH，macOS加DYLD_LIBRARY_PATH。
确保cx_Oracle版本和客户端兼容（比如cx_Oracle 8.x对应Oracle 19c+），可以用pip install cx-Oracle --upgrade更到最新兼容版。

2. 核对Wallet文件与TNS配置

ADW依赖Wallet完成SSL认证，这里最容易出细节错误：

确认你已经从Oracle Cloud控制台下载了Wallet压缩包，并且解压到本地固定目录。
检查TNS字符串里的wallet_location参数，路径要准确指向解压后的Wallet文件夹（注意系统路径格式：Windows用\\，Linux/macOS用/）。
更省心的方式是设置环境变量TNS_ADMIN，指向Wallet解压目录，这样cx_Oracle会自动读取该目录下的tnsnames.ora和sqlnet.ora，不用手动复制长串TNS字符。

3. 调整SQLAlchemy连接字符串的写法

直接传TNS字符串可能有转义问题，试试这两种写法：

写法一：用cx_Oracle的dsn对象

import cx_Oracle
from sqlalchemy import create_engine

# 复制tnsnames.ora里的完整TNS字符串
tns = "(description=...)"
dsn = cx_Oracle.makedsn(None, None, service_name=None, params=tns)
engine = create_engine(f"oracle+cx_oracle://{user}:{password}@{dsn}")
con = engine.connect()

写法二：通过TNS_ADMIN用别名连接

如果已经设置了TNS_ADMIN，直接用tnsnames.ora里的别名（比如ADW_high）就行：

from sqlalchemy import create_engine

tns_alias = "ADW_high"
engine = create_engine(f"oracle+cx_oracle://{user}:{password}@{tns_alias}")
con = engine.connect()

4. 先测纯cx_Oracle连接，排除SQLAlchemy干扰

绕过SQLAlchemy，先确认底层连接是否正常：

import cx_Oracle

connection = cx_Oracle.connect(user, password, tns)
cursor = connection.cursor()
cursor.execute("SELECT * FROM dual")
print("连接成功！测试结果：", cursor.fetchone())
connection.close()

如果这个测试失败，问题肯定在客户端、Wallet或网络；如果成功，再排查SQLAlchemy的写法问题。