：配置資料來源（來源為Oracle）

使用限制

• Oracle僅支援在主庫中為主庫或備庫開啟補充日誌。
• 當前Data Integration同步資料時，僅支援UTF8、AL32UTF8、AL16UTF16及ZHS16GBK編碼格式。
• 當前Data Integration進行即時同步時，不支援LONG、BFILE、LONG RAW及NCLOB資料類型 。Oracle單一實例即時同步日支援最大變更量為500GB。
• 即時同步Oracle資料目前僅支援配置Oracle資料來源為Oracle的10g、11g、12c non cdb、18c non cdb或19c non cdb版本資料庫，不支援配置為Oracle的12c cdb、18c cdb及19c cdb版本資料庫。資料庫容器CDB（Container Database）是Oracle 12c及之後版本的資料庫新特性，用於承載多個可插拔資料庫PDB（Pluggable Database）。

注意事項

• DataWorksData Integration即時同步任務，目前對於Oracle主庫支援訂閱聯機重做日誌（Online Redo），對於Oracle備庫僅支援訂閱歸檔日誌。因此，對於時效性要求比較高的即時同步任務，建議訂閱主庫的即時增量變更。訂閱Oracle備庫時，Oracle日誌的產生到可以被擷取的最短延遲時間取決於Oracle的自動切換歸檔日誌的時間，不能保證時效性。
• Oracle資料庫的歸檔日誌建議保留3天。當寫入大批量資料至Oracle資料庫時，即時同步資料的速度可能會慢於日誌產生的速度，方便在同步任務出現問題時，為追溯資料預留足夠的時間。您可以通過分析歸檔日誌排查問題並恢複資料。
• DataWorksData Integration即時同步任務，不支援對Oracle資料庫中無主鍵的表進行truncate操作。對於無主鍵表進行日誌分析（即logminer操作）是根據Rowid進行回查，當遇到truncate操作時會修改原表的Rowid，該操作會導致同步任務運行報錯。
• 在規格為24 vCPU 192 GiB的DataWorks上運行即時同步任務時，如果非update等動作記錄較多，並且速度達到約每秒記錄3~5W條資料的極限速度，則Oracle伺服器的單核CPU使用率最高可以達到25%～35%；如果處理update等動作記錄，則處理即時同步訊息的DataWorks機器可能會存在效能瓶頸，Oracle伺服器的單核CPU使用率僅可以達到1%～5%。

操作步驟

1. 配置白名單。
   將獨享資料資源群組所在的VPC網段添加至Oracle的白名單中，操作如下：
   1. 查看並記錄獨享資料資源群組所在的VPC網路。
      1. 登入DataWorks控制台。
      2. 在左側導覽列，單擊資源群組列表。
      3. 在獨享資源群組頁簽下，單擊目標Data Integration資源群組後的查看資訊。
      4. 複製對話方塊中的EIP地址和網段至資料庫白名單。
      5. 在獨享資源群組頁簽下，單擊目標Data Integration資源群組後的網路設定。
      6. 在專用網路綁定頁簽，查看交換器網段並將其添加至資料庫的白名單中。
   2. 將上述步驟中記錄的獨享Data Integration資源群組的EIP地址和網段添加至Oracle叢集的白名單中。
2. 建立帳號並配置帳號許可權。
   您需要規劃一個資料庫的登入賬戶用於後續執行操作，此帳號需要擁有Oracle的相關操作許可權。
   1. 建立帳號。
      操作詳情請參見建立Oracle帳號。
   2. 配置許可權。
      您可以參考以下命令為帳號添加相關許可權。如下執行語句在實際使用時，請替換'同步帳號'為上述建立的帳號。

      grant create session to '同步帳號';  //授權同步帳號登入資料庫。
      grant connect to '同步帳號';  //授權同步帳號串連資料庫。
      grant select on nls_database_parameters to '同步帳號';  //授權同步帳號查詢資料庫的nls_database_parameters系統配置。
      grant select on all_users to '同步帳號';  //授權同步帳號查詢資料庫中的所有使用者。
      grant select on all_objects to '同步帳號';  //授權同步帳號查詢資料庫中的所有對象。
      grant select on DBA_MVIEWS to '同步帳號';  //授權同步帳號查看資料庫的物化視圖。
      grant select on DBA_MVIEW_LOGS to '同步帳號';  //授權同步帳號查看資料庫的物化視圖日誌。
      grant select on DBA_CONSTRAINTS to '同步帳號';  //授權同步帳號查看資料庫所有表的約束資訊。
      grant select on DBA_CONS_COLUMNS to '同步帳號';  //授權同步帳號查看資料庫中所有表指定約束中所有列的相關資訊。
      grant select on all_tab_cols to '同步帳號';  //授權同步帳號查看資料庫中表、視圖和叢集中列的相關資訊。
      grant select on sys.obj$ to '同步帳號';  //授權同步帳號查看資料庫中的對象。sys.obj$表是Oracle字典表中的對象基礎資料表，存放Oracle的所有對象。
      grant select on SYS.COL$ to '同步帳號';  //授權同步帳號查看資料庫表中列的定義資訊。SYS.COL$用於儲存表中列的定義資訊。
      grant select on sys.USER$ to '同步帳號';  //授權同步帳號查看資料庫的系統資料表。sys.USER$是使用者會話的預設服務。
      grant select on sys.cdef$ to '同步帳號';  //授權同步帳號查看資料庫的系統資料表。
      grant select on sys.con$ to '同步帳號';  //授權同步帳號查看資料庫的約束資訊。sys.con$記錄了Oracle的相關約束資訊。
      grant select on all_indexes to '同步帳號';  //授權同步帳號查看資料庫的所有索引。
      grant select on v_$database to '同步帳號';  //授權同步帳號查看資料庫的v_$database視圖。
      grant select on V_$ARCHIVE_DEST to '同步帳號';  //授權同步帳號查看資料庫的V_$ARCHIVE_DEST視圖。
      grant select on v_$log to '同步帳號';  //授權同步帳號查看資料庫的v_$log視圖。v_$log用於顯示控制檔案中的記錄檔資訊。
      grant select on v_$logfile to '同步帳號';  //授權同步帳號查看資料庫的v_$logfile視圖。v_$logfile包含有關Redo記錄檔的資訊。
      grant select on v_$archived_log to '同步帳號';  //授權同步帳號查看資料庫的v$archived_log視圖。v$archived_log包含有關歸檔日誌的相關資訊。
      grant select on V_$LOGMNR_CONTENTS to '同步帳號';  //授權同步帳號查看資料庫的V_$LOGMNR_CONTENTS視圖。
      grant select on DUAL to '同步帳號';   //授權同步帳號查看資料庫的DUAL表。DUAL是用來構成select文法規則的虛擬表，Oracle的中DUAL中僅保留一條記錄。
      grant select on v_$parameter to '同步帳號';  //授權同步帳號查看資料庫的v_$parameter視圖。v$parameter是Oracle的動態字典表，儲存了資料庫參數的設定值。
      grant select any transaction to '同步帳號';  //授權同步帳號查看資料庫的任意事務。
      grant execute on SYS.DBMS_LOGMNR to '同步帳號';  //授權同步帳號使用資料庫的Logmnr工具。Logmnr工具可以協助您分析事務，並找回丟失的資料。
      grant alter session to '同步帳號';  //授權同步帳號修改資料庫的串連。
      grant select on dba_objects to '同步帳號';  //授權同步帳號查看資料庫的所有對象。
      grant select on v_$standby_log to '同步帳號';  //授權同步帳號查看資料庫的v_$standby_log視圖。v_$standby_log包含備用庫的歸檔日誌。
      grant select on v_$ARCHIVE_GAP to '同步帳號';  //授權同步帳號查詢缺失的歸檔日誌。

      如果您涉及使用離線全量同步資料，還需要執行如下命令，授權同步帳號所有表的查詢許可權。

      grant select any table to '同步帳號'; 

      Oracle 12c及之後的版本需要執行如下命令，授權同步帳號可以進行日誌挖掘。Oracle 12c之前的版本，內建日誌挖掘功能，無需執行該命令。

      grant LOGMINING TO '同步帳號';

3. 開啟歸檔日誌、補充日誌並切換Redo記錄檔。
   您需要進入主庫執行如下操作：

   1. 開啟歸檔日誌，SQL語句如下。

      shutdown immediate;
      startup mount;
      alter database archivelog;
      alter database open;

   2. 開啟補充日誌。

      您可以根據需要選擇開啟合適的補充日誌，SQL語句如下。

      alter database add supplemental log data(primary key) columns; //為資料庫的主鍵列開啟補充日誌。
      alter database add supplemental log data(unique) columns; //為資料庫的唯一索引列開啟補充日誌。

   3. 切換Redo記錄檔。
      開啟補充日誌後，您需要多次（一般建議執行5次）執行如下命令，切換Redo記錄檔。

      alter system switch logfile;

      說明 多次執行上述命令切換Redo記錄檔，是保證當前記錄檔被寫滿後可以切換至下一個記錄檔。使執行過的操作記錄不會丟失，便於後續恢複資料。
4. 檢查資料庫的字元編碼。
   您需要在當前使用的資料庫中，執行如下命令檢查資料庫的字元編碼。

   select * from v$nls_parameters where PARAMETER IN ('NLS_CHARACTERSET', 'NLS_NCHAR_CHARACTERSET');

   • v$nls_parameters用於存放資料庫參數的設定值。
   • NLS_CHARACTERSET及NLS_NCHAR_CHARACTERSET為資料庫字元集和國家字元集，表明Oracle中兩大類字元型資料的儲存類型。
   當前Data Integration同步資料時，僅支援UTF8、AL32UTF8、AL16UTF16及ZHS16GBK編碼格式。如果資料庫中包含不支援的字元編碼，請進行修改後再執行資料同步。
5. 檢查資料庫表的資料類型。
   您可以使用查看錶的SQL相關語句（SELECT）查詢資料庫表的資料類型。樣本查看'tablename'表資料類型的語句如下。

   select COLUMN_NAME,DATA_TYPE from all_tab_columns where TABLE_NAME='tablename'; 

   • COLUMN_NAME：表的列名稱。
   • DATA_TYPE：對應列的資料類型。
   • all_tab_columns：存放資料庫表所有列相關資訊的視圖。
   • TABLE_NAME：需要查詢的目標表的名稱。執行上述語句時，請替換'tablename'為實際需要查看的表名稱。

   您也可以執行select * from 'tablename';，查詢目標表的所有資訊，擷取資料類型。
   如果表裡包含這些欄位類型，請將該表從即時同步工作清單中移除，或修改表欄位類型後再執行資料同步。