使用 Oracle® RDBMS | ADW 連接器,您可以在連鎖中使用命令 在 Oracle Relational Database Management System (RDBMS) 或 Autonomous Data Warehouse® (ADW) 中執行結構化查詢語言 (SQL) 操作。例如,使用此連接器,您可以
- 執行 SQL 指令,包括
CREATE或UPDATE語句或SELECT查詢 - 擷取 Oracle RDBMS 或 ADW 中資料表的詳細資訊
- 將記錄插入 Oracle RDBMS 或 ADW
註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器,但我們無法排除故障或以其他方式協助解決源自 Workiva 平台之外的任何問題。
要求
要啟用與 Oracle 資料庫的連線,連接器使用 Java 資料庫連線 (JDBC),並以基本使用者名稱和密碼驗證。要設定連接器,您需要
- 在 Oracle RDBMS 或 ADW 中為連接器建立的指定整合使用者
- 整合使用者的使用者名稱和密碼
- JDBC 連線的 URL,例如
jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./ - 要連線至 Oracle ADW、資料庫的用戶端憑證或錢包檔案
- 若要連接至內部部署的資料庫,連線的 GroundRunner
支援的版本
Oracle® RDBMS | ADW 連接器與下列資料庫版本相容 :
- 21.x
- 19.x
- 18.3
- 12.2
- 12.1
- 11.2.0.4
ADW 錢包檔案
要啟用與 Oracle ADW 的連接,首先下載資料庫的用戶端憑證或錢包檔案 。當您設定連接器時,您會在Resources 下上傳這些錢包檔案:
cwallet.sso.lck\n* ewallet.p12.lckcwallet.ssoewallet.p12keystore.jkssqlnet.oratnsnames.oratruststore.jksojdbc.properties
要在連線器的Connection URL 屬性中指出這些資源的位置,請根據 GroundRunner 的作業系統輸入TNS_ADMIN 路徑:
- 對於 UNIX,
TNS_ADMIN=./ - 對於 Microsoft® Windows®,
TNS_ADMIN=.
注意: 如果連接器使用 CloudRunner,請使用路徑TNS_ADMIN=./ 。
設定 Oracle RDBMS | ADW 連接器
注意:為了使連接器可用於組織的鏈結,組織安全性管理員首先要從組態中啟用它。
- 在「鏈結產生器」中,按一下「連線」,然後按一下右上角的「建立」。
- 在Connector Connection 下 ,選擇Oracle RDBMS | ADW ,以及要與連線器一起使用的執行器。
- 在「基本資訊」(Basic Info) 下,輸入唯一的名稱和描述以識別連結。
- 要連線至 Oracle ADW,在Resources 下,上傳資料庫的 wallet 檔案。
- 在Properties 下 ,輸入連接器的詳細資訊:
摘要資訊 詳細資料 使用者名稱 輸入連接器整合使用者的使用者名稱。 密碼 輸入Username 屬性的密碼。 連線 URL 輸入 JDBC 連接的 URL,例如 jdbc:oracle:thin:@db201905221856_high?TNS_ADMIN=./。- 對於 Oracle RDBMS,附加連接的任何可選屬性 。
- 對於 Oracle ADW,根據所選的 runner 及其作業系統,為資料庫的 wallet 檔案附加
TNS_ADMIN路徑。
注意: 預設情況下,Oracle RDBMS 的連接埠為
1521;但您的環境可能與此不同。注意:所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。為了安全起見,避免在Connection URL 屬性中包含使用者憑證作為可選屬性。
- 選擇連接使用的環境,然後按一下儲存 。
- 要測試連線,,使用連接器的Get Table Definition 指令建立並執行連線 ,並驗證它是否傳回有效的輸出。
疑難排解
如果與 Oracle RDBMS 或 ADW 的連接失敗:
- 驗證整合使用者的驗證憑證。
- 檢查 JDBC 連線的 URL。
- 如果連接至內部部署資料庫,請檢查連接器所選的 GroundRunner。
- 如果連接至 Oracle ADW,請驗證資料庫的錢包檔案是否上傳至Resources ,並驗證Connection URL 屬性中的
TNS_ADMIN路徑。如有必要,從 Oracle ADW 下載錢包檔案,並再次上載到Resources 。
如果連接無法執行命令,請驗證其輸入(例如其 SQL 語法或表)是否有效。