上傳 JDBC Driver
Generic JDBC Connector 是一種通用的 Java 資料庫連接器,可用於在 Java 應用程式中連接和訪問各種類型的關聯式資料庫,例如 MySQL、PostgreSQL、Oracle 等等。它允許應用程式透過 Java Database Connectivity (JDBC) API 連接到資料庫,並執行 SQL 查詢和命令。
使用需求條件
使用 Generic JDBC 連接器前,需要先準備:
- 欲連接資料庫的 JDBC Driver 的
jar
檔。
此文章以連接 PostgreSQL 為範例,可以至 PostgreSQL 官網下載 所需使用的 Driver 。
Step 1: 建立 JDBC Driver
點擊設定 Icon
,並選取 Drives
選項。
進入 Drivers
頁面後,點擊 Create a JDBC Driver
按鈕。
填入以下配置資訊。
Name
: Driver 顯示名稱Class Name
: Driver 的 class 名稱。例如Postgres
是用org.postgresql.Driver
Upload JAR File
: 上傳 Driver 的 jar 檔案Limit Pushdown
: 設定是否開啟 Limit Pushdown,將處理的查詢推送到資料來源端Limit Pushdown Clause
: (若開啟 Limit Pushdown),根據不同資料庫類型,選擇使用的 Limit Pushdown 語法Separator between Catalog and Schema
: 填入您欲使用的分隔符號,分隔 Catalog 和 Schema 。如果未指定,則使用預設分隔符號 . 。Ignore System Schema Pattern
: 為避免系統資料表過多造成連線逾時,可以使用 regular expression 來忽略系統資料表
建立成功後,會看到建立的 Driver 顯示在頁面列表中。
Step 2: 建立 Generic JDBC 資料來源
您可以透過以下兩種操作來建立資料來源,第一種為點擊側欄 Data Source 的 “+” 按鈕,或是點擊 Overview 頁面中的 Create a Data Source 按鈕來建立。
Step 3: 設定連線資訊
Name
: 資料庫名稱,供顯示使用,後續可作修改Data Source Type
: 資料庫類型,請選擇Generic JDBC
.Driver
: 選擇需要使用的 DriverURI
: 填入jdbc:<protocal>://<host>:<port>/databaseName
格式,例如jdbc:postgresql://10.10.0.9:3432/tpchsf1
.Username
: 連線使用的 UsernamePassword
: 連線使用的 PasswordUnsupported Type Handling
: 配置不支援的數據類型的處理方式Table Pattern
: 填入 Java regular expression 來篩選需要連接的資料表。 例如填入public.r.*
,篩選出在public
schema 底下以r
為開頭名稱的資料表。Default Scale
及Number Rounding Mode
: 若 Table 中含有浮點數的型別,例如 Double、Float,而資料中也有小數點的值,則需要設定這兩個欄位Explore Timeout
: 若資料庫中含有的 Table 數量較大,建議調高此參數,讓 Explore 可執行較久
Step 4: 完成建立
進行 Submit 後,稍後片刻將會在側欄中顯示 Oracle 的資料來源,點擊後可以進入此資料來源細節頁面。