必要條件
在您可以登陸或複寫資料之前,確認完成下列先決條件:
-
在 資料移動閘道 伺服器安裝必要 driver
資訊備註只有在您選擇使用 資料移動閘道 時,才需要此。如需關於 資料移動閘道 福利以及何時需要的資訊,請參閱 Qlik 資料閘道 - 資料移動。
-
在資料來源授予必要權限
-
設定資料來源連接器
在 z/OS 上安裝 R4Z 產品
您必須先在 z/OS 上安裝並設定 R4Z 產品,才能使用 z/OS 版 IBM DB2 來源。
-
移至 產品下載。
-
選取 Qlik 資料整合。
-
向下捲動產品清單並選取 Qlik Talend Data Integration。
-
在下載連結欄中,按一下 QlikReplicate_2023.5.0.191_r4z.zip 連結以開始下載。
-
下載 R4Z 並安裝在 z/OS 資料來源。
如需安裝和設定說明,請參閱 安裝並設定 R4Z。
安裝並設定驅動程式
您可以使用驅動程式安裝公用程式 (建議) 或手動安裝 driver。只能在不太可能發生的事件 (您在使用驅動程式安裝公用程式時遇到問題) 中嘗試手動安裝。
使用驅動程式安裝公用程式來安裝驅動程式
此區段描述如何安裝所需的 driver。該流程涉及下載 driver、複製到所需的資料夾 (見下文),以及執行將會自動安裝並設定該驅動程式的指令碼。您也可以執行指令碼,以根據需求更新並解除安裝 driver。
準備安裝
-
確認 Python 3.6 或更高版本安裝於 資料移動 閘道伺服器。
Python 會預先安裝在大部分的 Linux 發行版。您可以執行下列命令,以查看哪個 Python 版本安裝在您的系統上:
python3 --version
-
從 IBM 網站下載 IBM Data Server Client「<version>_linuxx64_client.tar.gz」。您可以在 /opt/qlik/gateway/movement/drivers/manifests/db2.yaml 的 binary-artifacts 之下找到支援的版本。下載完成後,將檔案複製到:
/opt/qlik/gateway/movement/drivers/db2
安裝 driver
若要安裝 driver:
-
停止 Data Movement gateway 服務:
sudo systemctl stop repagent
-
可自選,確認服務已停止:
sudo systemctl status repagent
狀態應如下所示:
Active: inactive (dead) since <timestamp> ago
-
在 資料移動 閘道機器上,將工作目錄變更為:
opt/qlik/gateway/movement/drivers/bin
-
執行下列命令:
語法:
./install db2
否則,就會顯示 driver 的 EULA。
-
執行下列其中一個動作:
- 重複按下 [Enter] 以緩慢瀏覽 EULA。
- 重複按下空格鍵以快速瀏覽 EULA。
- 按下 q 以結束授權文字並呈現 EULA 接受選項。
-
執行下列其中一個動作:
- 輸入「y」並按下 [Enter] 以接受 EULA 並開始安裝。
- 輸入「n」並按下 [Enter] 以拒絕 EULA 並退出安裝。
-
輸入「v」並按下 [Enter] 以再次檢視 EULA。
-
等待安裝完成 (以「完成!」指示),然後開始 Data Movement gateway 服務:
sudo systemctl start repagent
-
可自行選擇確認服務已開始:
sudo systemctl status repagent
狀態應如下所示:
Active: active (running) since <timestamp> ago
將會安裝 driver。
更新 driver
若您想要在安裝提供的 driver 之前解除安裝先前的 driver 版本,請執行更新命令。
若要更新 driver:
-
停止 Data Movement gateway 服務:
sudo systemctl stop repagent
-
可自選,確認服務已停止:
sudo systemctl status repagent
狀態應如下所示:
Active: inactive (dead) since <timestamp> ago
-
在 資料移動 閘道機器上,將工作目錄變更為:
opt/qlik/gateway/movement/drivers/bin
-
執行下列命令:
語法:
./update db2
否則,就會顯示 driver 的 EULA。
-
執行下列其中一個動作:
- 重複按下 [Enter] 以緩慢瀏覽 EULA。
- 重複按下空格鍵以快速瀏覽 EULA。
- 按下 q 以結束授權文字並呈現 EULA 接受選項。
-
執行下列其中一個動作:
- 輸入「y」並按下 [Enter] 以接受 EULA 並開始安裝。
- 輸入「n」並按下 [Enter] 以拒絕 EULA 並退出安裝。
- 輸入「v」並按下 [Enter] 以從頭檢閱 EULA。
-
等待安裝完成 (以「完成!」指示),然後開始 Data Movement gateway 服務:
sudo systemctl start repagent
-
可自行選擇確認服務已開始:
sudo systemctl status repagent
狀態應如下所示:
Active: active (running) since <timestamp> ago
將會解除安裝舊版 driver,並安裝新版 driver。
解除安裝 driver
若您想要解除安裝 driver,請執行解除安裝命令。
若要解除安裝 driver:
-
停止設定為使用此連接器的所有任務。
-
在 資料移動 閘道機器上,將工作目錄變更為:
opt/qlik/gateway/movement/drivers/bin
-
執行下列命令:
語法:
./uninstall db2
將會解除安裝 driver。
手動安裝驅動程式
只有在自動驅動程式安裝無法成功完成時,才能嘗試手動安裝 driver。
Linux ODBC 用戶端套件
您可以在安裝完整 ODBC 用戶端套件或僅安裝資料伺服器用戶端之間選擇,如以下 Linux 資料伺服器用戶端 中所述。
不支援「enableWLB」驅動程式選項。要施行連線於並行 sysplex 自動切換至另一個 LPAR(如「容錯移轉」),在驅動程式設定中將「enableACR」設定為「真」,「enableWLB」設定為「假」。
在 Data Movement gateway 機器上,開啟 shell prompt 並進行以下項目:
-
停止 Data Movement gateway 服務:
sudo systemctl stop repagent
-
可自選,確認服務已停止:
sudo systemctl status repagent
狀態應如下所示:
Active: inactive (dead) since <timestamp> ago
- 安裝 v11.5.8_linuxx64_server_dec.tar.gz 並選擇「用戶端」選項。
-
舉例來說,如果 Data Movement gateway 機器沒有 DB2,透過進行以下指令建立 DB2:
adduser <db2_instance_name>
/opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>
-
變更任務目錄至 <Data Movement gateway_Install_Dir>/bin。
-
新增 DB2 驅動程式位置至 Linux 物件庫路徑。
要這麼做,請新增以下行至 site_ arep_login.sh 檔案如下:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib
其中 path 為驅動程式的用戶端路徑。
範例 (以 db2clnt1 作為執行個體名稱):
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit
export DB2INSTANCE=db2clnt1
-
可自選,確認已複製驅動程式位置:
cat site_arep_login.sh
-
新增以下輸入至 /etc: 底下的 odbcinst.ini 檔案:
[IBM DB2 ODBC DRIVER]
Driver = /home/db2clnt1/sqllib/lib/libdb2o.so
fileusage=1
dontdlclose=1
-
開始 Data Movement gateway 服務:
sudo systemctl start repagent
-
可自行選擇確認服務已開始:
sudo systemctl status repagent
狀態應如下所示:
Active: active (running) since <timestamp> ago
Linux 資料伺服器用戶端
-
從 IBM Fix Central 下載 v11.5.8_linuxx64_client.tar.gz 並解壓縮檔案。
停止 Data Movement gateway 服務:
sudo service repagent stop
可自選,確認服務已停止:
sudo service repagent status
狀態應如下所示:
Active: inactive (dead) since <timestamp> ago
- 將工作目錄變更為 /opt/client 並執行 db2_install。
建立 RSP 檔案 (請參閱下面的 RSP 檔案範例) 然後執行下列命令 (從 /opt/client):
./db2setup -r /file-path/client.rsp
新增以下輸入至 /etc 底下的 odbcinst.ini 檔案:
[IBM DB2 ODBC DRIVER]
Driver = /opt/ibm/db2/V11.5/lib64/libdb2o.so
fileusage=1
dontdlclose=1
開始 Data Movement gateway 服務:
sudo service repagent start
可自行選擇確認服務已開始:
sudo service repagent status
狀態應如下所示:
Active: active (running) since <timestamp> ago
RSP 檔案範例
*----------------------------------------------------- * Generated response file used by the DB2 Setup wizard * generation time: 2/18/22 4:10 PM *----------------------------------------------------- * Product Installation LIC_AGREEMENT = ACCEPT PROD = CLIENT FILE = /opt/ibm/db2/V11.5 INSTALL_TYPE = TYPICAL * ---------------------------------------------- * Instance properties * ---------------------------------------------- INSTANCE = inst1 inst1.TYPE = client * Instance-owning user inst1.NAME = qlik inst1.UID = 1000 inst1.GROUP_NAME = qlik inst1.HOME_DIRECTORY = /home/qlik inst1.AUTOSTART = NO *----------------------------------------------- * Installed Languages *----------------------------------------------- LANG = EN
伺服器端 ODBC 設定
繫結要用於 ODBC 的計畫,如 ODBC 初始化檔案中的 PLANNAME= 值所指定。預設名稱是 DSNACLI。BIND 工作可見於成員 DSNTIJCL,這在來源 DB2 安裝的 SDSNSAMP 物件庫中。
使用 DB2CLI 繫結命令將 ODBC 提供的套件繫結至預期的來源 z/OS DB2 子系統。IBM 網站上的設定開發人員和執行時間環境中描述了此動作。如需關於 DB2CLI 公用程式的資訊,包括繫結公用程式的範例,請參閱 IBM 網站上的 db2cli - DB2 互動式 CLI 命令。
必要權限
若要啟用 Data Movement gateway 以從來源表格擷取資料 (完整載入和變更資料擷取),必須向 z/OS 版 IBM DB2 連接器設定中指定的使用者授予下列權限:
- 讀取 UDTF 之 IFI 的 EXECUTE (僅變更資料擷取需要)
- 來源表格和下列系統目錄表格上的 SELECT:
- SYSIBM.SYSDUMMY1
- SYSIBM.SYSTABLES
- SYSIBM.SYSTABLESPACE
- SYSIBM.SYSPARMS
- SYSIBM.SYSROUTINES
- SYSIBM.SYSCOLUMNS
- SYSIBM.SYSLGRNX
- SYSIBM.SYSTABLEPART
- 用來開始 IFI 工作階段的 MONITOR2 (僅變更資料擷取需要)
擷取資料變更
若要從 z/OS 版 IBM DB2 擷取變更,Data Movement gateway 會使用特殊程式 (作為外部例行事項叫用),這是使用者定義的表格函數 (UDTF)。需要先在 z/OS 系統上安裝並設定此程式 (載入模組) 以及 UDTF,才能擷取變更。安裝並設定 R4Z 中描述了應由 DBA 執行的安裝程序。
此外,必須為每個您想要擷取其變更的表格設定資料擷取變更屬性。您可以手動進行此動作,或在 連接器 設定中啟用自動啟用資料擷取變更 (需要管理員權限) 選項 (預設),以允許 Data Movement gateway 進行此動作,