您现在的位置：程式碼之家 >> 數據庫知識 > >> Oracle 資料庫 >> Oracle 資料庫基礎

ADO 連接 Oracle 連線字串陷阱：DataSource vs Data Source 空格差異導致連線失敗

編輯：Oracle 資料庫基礎

前言

VC++ 使用 ADO (OraOLEDB.Oracle) 連接 Oracle 時，連線字串關鍵字拼寫極其敏感。本文記錄一個經典案例：**`DataSource` (無空格) vs `Data Source` (有空格)** 導致本地連線正常、遠端連線失敗的詭異現象。

現象重現

環境

客戶端：Windows XP + VC++ 6.0 + ADO + OraOLEDB.Oracle.1
本地資料庫：Oracle 9i on Windows XP
遠端資料庫：Oracle 9i on Windows Server 2003

連線字串對比

場景	連線字串	結果
本地連線	`Provider=OraOLEDB.Oracle.1;DataSource=orabase;User ID=its;PassWord=its`	✅ 成功
遠端連線	`Provider=OraOLEDB.Oracle.1;DataSource=orabase;User ID=its;PassWord=its`	❌ 失敗
遠端連線 (修正)	`Provider=OraOLEDB.Oracle.1;Data Source=orabase;User ID=its;PassWord=its`	✅ 成功

根因分析

OraOLEDB.Oracle 提供者關鍵字規範

根據 Oracle 官方文檔，OraOLEDB.Oracle 標準關鍵字為 **`Data Source`** (含空格)，對應 OLE DB 標準 `DBPROP_INIT_DATASOURCE`。

為什麼本地能用 `DataSource`？

本地連線可能走 **Bequeath Protocol (IPC/Bequeath)**，繞過 TNS Listener
Oracle Client 本地別名解析機制對 `DataSource` 寬容處理
遠端連線強制走 **TCP/IP → Listener → TNS**，嚴格驗證關鍵字

標準連線字串模板



Provider=OraOLEDB.Oracle.1;Data Source=tns_alias;User ID=username;Password=password;


Provider=OraOLEDB.Oracle.1;
Data Source=ORCL;
User ID=scott;
Password=tiger;
Persist Security Info=False;
Pooling=True;
Min Pool Size=0;
Max Pool Size=100;
Connection Lifetime=0;
Connection Timeout=15;

關鍵字完整對照表

關鍵字 (標準)	別名/錯誤寫法	說明
Data Source	DataSource, Server, Address	TNS 服務名或 Easy Connect 字串
User ID	UID, Username	資料庫用戶名
Password	PWD, PassWord	密碼 (區分大小寫)
Persist Security Info		True/False，是否在屬性中保留密碼
Pooling		True/False，連線池啟用
FetchSize		陣列提取大小 (預設 100)
ChunkSize		LOB 讀寫塊大小
OSAuthent		True/False，作業系統驗證
PLSQLRSet		True/False，支援 PL/SQL 回傳結果集

除錯步驟

先用 SQL*Plus 驗證 TNS 別名：`sqlplus user/pass@tns_alias`
用 UDL 檔案測試：建立 `test.udl`，雙擊設定提供者與參數，測試連線
啟用 OLE DB 追蹤：註冊表 `HKEY_LOCAL_MACHINE\SOFTWARE\Oracle\OLEDB\TraceLevel = 1`
檢查 tnsnames.ora：確認客戶端與伺服器端別名一致
對比成功/失敗連線字串：逐字元比對 (空格、分號、大小寫)

跨版本相容性提醒

Oracle Client 版本	提供者名稱	關鍵字敏感度
9i/10g	OraOLEDB.Oracle.1	高 (嚴格要求 Data Source)
11g/12c/19c	OraOLEDB.Oracle.1 / OraOLEDB.Oracle	中 (部分別名兼容)
21c+	OraOLEDB.Oracle	建議嚴格遵循標準