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