跳至主要内容
版本：v3

Generic JDBC 連接器

Generic JDBC Connector 是一種通用的 Java 資料庫連接器，可用於在 Java 應用程式中連接和訪問各種類型的關聯式資料庫，例如 MySQL、PostgreSQL、Oracle 等等。它允許應用程式透過 Java Database Connectivity (JDBC) API 連接到資料庫，並執行 SQL 查詢和命令。

使用需求條件​

使用 Generic JDBC 連接器前，需要先準備

  • 欲連接資料庫的 JDBC Driver。

此文章以連接 PostgreSQL 為範例，可以至 PostgreSQL 官網下載 所需使用的 Driver 。

Step 1: 建立 JDBC Driver​

點擊設定 Icon，並選取 Drives 選項。

進入 Drivers 頁面後，點擊 Create a JDBC Driver 按鈕。

2_generic_jdbc

填入以下配置資訊。

3_generic_jdbc

  • 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 語法
  • Ignore System Schema Pattern: 為避免系統資料表過多造成連線逾時，可以使用 regular expression 來忽略系統資料表

建立成功後，會看到建立的 Driver 顯示在頁面列表中。

7_generic_jdbc

Step 2: 建立 Generic JDBC 資料來源​

您可以透過以下兩種操作來建立資料來源，第一種為點擊側欄 Data Source 的 “+” 按鈕，或是點擊 Overview 頁面中的 Create a Data Source 按鈕來建立。

4_generic_jdbc

Step 3: 設定連線資訊​

5_generic_jdbc

  • Name: 資料庫名稱，供顯示使用，後續可作修改
  • Data Source Type: 資料庫類型，請選擇Generic JDBC.
  • Driver: 選擇需要使用的 Driver
  • URI: 填入 jdbc:<protocal>://<host>:<port>/databaseName 格式,例如 jdbc:postgresql://10.10.0.9:3432/tpchsf1.
  • Username: 連線使用的 Username
  • Password: 連線使用的 Password
  • Unsupported 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 的資料來源，點擊後可以進入此資料來源細節頁面。

6_generic_jdbc