準備工作1：確認Oracle數據庫版本

不同同步場景下支持的Oracle數據庫版本不一致，同步前您需要檢查Oracle數據庫版本是否為支持的版本。

1. 您可以通過如下任意語句查看Oracle數據庫的版本。

   • 語句一：

     select * from v$version;

   • 語句二：

     select version from v$instance;

2. 如果查看到的Oracle數據庫版本為12c或18c，則您需要使用如下語句進一步確認該數據庫是否為cdb類型的數據庫。DataWorks數據集成實時同步任務暫不支持使用12c和18c版本的cdb類型的Oracle數據庫。

   select name,cdb,open_mode,con_id from v$database;

準備工作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 on sys.ICOL$ to '同步賬號';  //授權同步賬號查看數據庫中的對象。sys.obj$表是Oracle字典表中的對象基礎表，存放Oracle的所有對象。

   如果您涉及使用離線全量同步數據，還需要執行如下命令，授權同步賬號所有表的查詢權限。

   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中兩大類字符型數據的存儲類型。

準備工作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';，查詢目標表的所有信息，獲取數據類型。

單表離線同步任務配置指導

• 操作流程請參見通過向導模式配置離線同步任務、通過腳本模式配置離線同步任務。

• 腳本模式配置的全量參數和腳本Demo請參見下文的附錄：腳本Demo與參數說明。

單表實時同步任務配置指導

操作流程請參見DataStudio側實時同步任務配置。

整庫離線、整庫（實時）全增量、整庫（實時）分庫分表等整庫級別同步配置指導

操作流程請參見數據集成側同步任務配置。

離線任務腳本配置方式

如果您配置離線任務時使用腳本模式的方式進行配置，您需要按照統一的腳本格式要求，在任務腳本中編寫相應的參數，詳情請參見通過腳本模式配置離線同步任務，以下為您介紹腳本模式下數據源的參數配置詳情。