跳至主要内容
版本：v2

Generic JDBC 連接器

Info

This feature is only available after version 2.4.3

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