如何通过ConnectorX Python连接多服务器多端口的Oracle数据库？

方案1：直接使用Oracle Easy Connect Plus格式拼接连接串 #

ConnectorX支持Oracle的Easy Connect Plus语法，可直接在连接字符串中指定多节点信息，示例代码如下：

import connectorx as cx

# 替换为实际的用户名、密码、节点地址、服务名
conn_str = "oracle://username:password@(DESCRIPTION=(LOAD_BALANCE=on)(FAILOVER=on)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=host1)(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=host2)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=your_service_name)))"
df = cx.read_sql(conn_str, "SELECT * FROM your_table")

• 核心参数说明：
  • LOAD_BALANCE=on：开启负载均衡，随机分配连接请求到可用节点
  • FAILOVER=on：开启故障转移，节点不可用时自动切换至其他节点
  • ADDRESS_LIST：按格式添加所有需要连接的服务器主机和端口
  • SERVICE_NAME：替换为Oracle数据库的服务名（注意区分SID，多节点环境优先用服务名）

方案2：通过本地TNS配置文件连接 #

如果不想在代码中写冗长的连接串，可通过配置本地tnsnames.ora文件实现：

1. 找到Oracle客户端的tnsnames.ora文件（通常位于$ORACLE_HOME/network/admin或%ORACLE_HOME%\network\admin目录）
2. 添加多节点的TNS条目：

YOUR_CUSTOM_SERVICE =
  (DESCRIPTION =
    (LOAD_BALANCE=on)
    (FAILOVER=on)
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = host1)(PORT = 1521))
      (ADDRESS = (PROTOCOL = TCP)(HOST = host2)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = your_service_name)
    )
  )

3. 在ConnectorX中通过TNS名称连接：

import connectorx as cx

conn_str = "oracle://username:password@YOUR_CUSTOM_SERVICE"
df = cx.read_sql(conn_str, "SELECT * FROM your_table")

注意：需确保Oracle客户端的环境变量（如ORACLE_HOME、TNS_ADMIN）配置正确，让ConnectorX能找到tnsnames.ora文件。

常见排查点 #

• 升级ConnectorX：旧版本可能对多节点连接支持不足，执行pip install --upgrade connectorx更新至最新版
• 网络与权限：确认本地机器能访问所有指定节点的对应端口，且数据库用户具备跨节点访问权限
• 服务名校验：避免混淆SID和SERVICE_NAME，多节点集群通常使用服务名而非SID

内容的提问来源于stack exchange，提问作者Mr.Jul