// 免費工具

Oracle 連線字串產生器

從同一個表單建立 Oracle Easy Connect 字串、TNS 連線描述元、JDBC thin URL 或 ODP.NET 字串,或貼上現有字串,查看主機、連接埠與服務名稱,並抓出 SID 與服務名稱混用的錯誤。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。

在 SQLly 中開啟此連線

開啟 SQLly 的連線編輯器,並自動填入內容。

設計即私密。 建構器和解碼器都是在此分頁中執行的純 JavaScript。頁面不會發送你輸入的任何請求,也不會儲存任何資料(甚至不在你的瀏覽器中),載入後可離線使用。開啟 SQLly 的連結會從你的瀏覽器直接進入你電腦上的應用程式。

Oracle 連線字串格式

Oracle 用戶端以三種方式命名資料庫:Easy Connect(host:1521/service_name)、完整的連線描述元((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...))))或在 tnsnames.ora。JDBC thin、ODP.NET、python-oracledb 和 node-oracledb 都接受前兩種。

常見的錯誤是把 SID 和服務名稱搞混。可插拔資料庫與雲端資料庫是透過服務名稱連線的;Easy Connect 完全無法表示 SID,而舊式 JDBC 寫法 host:port:SID 在提供服務名稱時會以 ORA-12505 失敗。

Easy Connect SQL*Plus、SQLcl、python-oracledb、node-oracledb、ODP.NET

db.example.com:1521/FREEPDB1

透過 TLS 的 Easy Connect Easy Connect Plus

tcps://db.example.com:2484/FREEPDB1

連線描述器 tnsnames.ora,每個 Oracle 用戶端

(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=FREEPDB1)))

JDBC thin Oracle JDBC (ojdbc)

jdbc:oracle:thin:@//db.example.com:1521/FREEPDB1

ADO.NET (ODP.NET) Oracle.ManagedDataAccess

User Id=app_user;Password=your_password;Data Source=db.example.com:1521/FREEPDB1;

SQLAlchemy URL python-oracledb

oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1

預留位置,例如 your_password 就只是這個意思:用上面的表單組出你自己的字串。更多關於把 SQLly 連上 Oracle 的說明: 適用於 Oracle 的 SQLly.

Easy Connect (Plus) 語法

[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]。通訊協定是 tcp (預設)或 tcps;兩者的預設連接埠都是 1521。Easy Connect 無法使用 SID。

關鍵字同義詞預設其作用
protocol - tcp tcps:// 使用 TLS。TLS 監聽器通常用 2484 這個 Oracle 註冊連接埠,但你必須自己寫出來。
port - 1521 監聽器連接埠。
service_name - - 資料庫服務,例如 PDB 名稱,如 FREEPDB1 或 ORCLPDB1.
server_type - - dedicated, shared 或 pooled.
connect_timeout - 無 建立連線允許的秒數。
transport_connect_timeout - - TCP 連線本身允許的秒數。
retry_count / retry_delay - - / 0 連線重試次數,以及重試之間的延遲。
ssl_server_dn_match - 開啟(19.2+ 客戶端) 檢查伺服器憑證的 DN 是否與主機符合。
wallet_location - - TCPS 錢包的目錄。

ODP.NET 連線字串屬性

ADO.NET 風格。 Data Source 接受 Easy Connect 字串、TNS 別名或完整描述符。

關鍵字同義詞預設其作用
User Id - - 資料庫使用者。
Password - - 密碼;如果包含特殊字元請用雙引號括起來。
Data Source - - Easy Connect、別名或連線描述符。
DBA Privilege - - SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC.
Connection Timeout - 15 等待連線池連線的秒數。
Pooling - 真 連線池機制。
Max Pool Size - 100 最大的連線池大小。
Min Pool Size - 1 最小的連線池。
Incr Pool Size - 5 連線池擴增時新增的連線。
Statement Cache Size - 0 每個連線快取的陳述式數量。
Validate Connection - 假 發出連線池中的連線前先進行檢查。
Connection Lifetime - 0 連線池中的連線可存活的秒數。

Oracle JDBC thin URL 格式

將使用者名稱和密碼作為連線屬性傳遞,而不是嵌入其中。

關鍵字同義詞預設其作用
jdbc:oracle:thin:@//host:port/service - - 服務名稱(簡易連線)。
jdbc:oracle:thin:@tcps://host:port/service - - TLS;新增 ?wallet_location=/path 用於錢包。
jdbc:oracle:thin:@(DESCRIPTION=...) - - 完整連線描述符。
jdbc:oracle:thin:@alias?TNS_ADMIN=/path - - 此目錄下 tnsnames.ora 的 TNS 別名(或 oracle.net.tns_admin 屬性)。
jdbc:oracle:thin:@host:port:SID - - 舊版 SID 形式;建議使用服務名稱。

常見的 Oracle 連線錯誤

ORA-12154: TNS:could not resolve the connect identifier specified

原因: 客戶端把該字串當作 TNS 別名,卻找不到:沒有 tnsnames.ora, TNS_ADMIN 指向其他地方,或是別名或 Easy Connect 字串打錯了。

修正此問題: 使用 Easy Connect(host:1521/service)或完整的描述子來跳過 tnsnames.ora,或設定 TNS_ADMIN 到包含該檔案的目錄。

ORA-12514: TNS:listener does not currently know of service requested in connect descriptor

原因: 監聽器可以連線,但沒有資料庫向它註冊該服務名稱:可能是服務名稱錯誤或拼字錯誤、把 SID 當成服務名稱,或者資料庫尚未開啟。

修正此問題: 執行 lsnrctl services (或問 DBA)找出已註冊的服務,並使用其中一個名稱。

ORA-12505: TNS:listener does not currently know of SID given in connect descriptor

原因: 這個連線字串以 SID 連線(host:port:SID 或 (SID=...)),而該值不是監聽程式已知的 SID,通常是因為它實際上是一個服務名稱。

修正此問題: 改用服務名稱的寫法: //host:port/service_name.

ORA-12541: TNS:no listener

原因: 該主機與連接埠上沒有任何程式在監聽:監聽器已停止、連接埠錯誤,或被防火牆擋下。

修正此問題: 檢查 lsnrctl status 在伺服器上,檢查連接埠(預設為 1521)和防火牆。

ORA-01017: invalid username/password; logon denied

原因: 使用者名稱或密碼錯誤。密碼區分大小寫,含特殊字元的密碼在 SQL*Plus 中可能需要用雙引號括起。

修正此問題: 檢查認證;在 SQL*Plus 中為密碼加上引號,寫法如 user/"p@ss"@host/service.

ORA-28000: the account is locked

原因: 登入失敗次數過多或 DBA 鎖定了帳戶。

修正此問題: DBA 執行 ALTER USER app_user ACCOUNT UNLOCK;.

Oracle 連線字串常見問題

什麼是 Oracle Easy Connect 字串?

精簡的連線識別碼, host[:port]/service_name,不需要 tnsnames.ora 項目。Easy Connect Plus(19c 及之後版本)還加入了 tcps://,多台主機與 ?parameter=value 選項,例如 connect_timeout.

SID 與服務名稱有何不同?

SID 指的是一個資料庫執行個體;服務名稱則是用戶端向接聽程式要求的名稱,一個資料庫(或可插入式資料庫)可以提供多個。現代資料庫與雲端資料庫都以服務名稱連線。Easy Connect 只接受服務名稱。

Oracle 的預設連接埠是什麼?

1521,用於監聽器。TLS(TCPS)預設也用同一個連接埠,除非你另行設定;許多站台使用 2484,這是為 Oracle over TLS 註冊的連接埠。

如何在不安裝 Oracle Client 的情況下用 python-oracledb 連線?

python-oracledb 預設執行於 Thin 模式,無需 Oracle Client 函式庫: oracledb.connect(user=..., password=..., dsn="host:1521/service").

SQLly 可以透過連線字串開啟 Oracle 連線嗎?

SQLly 可以連線 Oracle,但貼上連線字串的解析器還不支援 Oracle 格式的字串,所以 Oracle 的「在 SQLly 中開啟」按鈕目前停用。請改在 SQLly 的連線編輯器中輸入主機、連接埠和服務名稱。

// 完全跳過字串

連線一次。然後只需撰寫 SQL。

SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在 Oracle 及更多引擎上獲得結構描述感知的 IntelliSense。