準(zhǔn)備工作1：確認(rèn)Oracle數(shù)據(jù)庫版本

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

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

   • 語句一：

     select * from v$version;

   • 語句二：

     select version from v$instance;

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

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

準(zhǔn)備工作2：創(chuàng)建賬號并配置賬號權(quán)限

您需要規(guī)劃一個(gè)數(shù)據(jù)庫的登錄賬戶用于后續(xù)執(zhí)行操作，此賬號需要擁有Oracle的相關(guān)操作權(quán)限。

1. 創(chuàng)建賬號。操作詳情請參見創(chuàng)建Oracle賬號。

2. 配置權(quán)限。

   您可以參考以下命令為賬號添加相關(guān)權(quán)限。如下執(zhí)行語句在實(shí)際使用時(shí)，請?zhí)鎿Q'同步賬號'為上述創(chuàng)建的賬號。

   grant create session to '同步賬號';  //授權(quán)同步賬號登錄數(shù)據(jù)庫。
   grant connect to '同步賬號';  //授權(quán)同步賬號連接數(shù)據(jù)庫。
   grant select on nls_database_parameters to '同步賬號';  //授權(quán)同步賬號查詢數(shù)據(jù)庫的nls_database_parameters系統(tǒng)配置。
   grant select on all_users to '同步賬號';  //授權(quán)同步賬號查詢數(shù)據(jù)庫中的所有用戶。
   grant select on all_objects to '同步賬號';  //授權(quán)同步賬號查詢數(shù)據(jù)庫中的所有對象。
   grant select on DBA_MVIEWS to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的物化視圖。
   grant select on DBA_MVIEW_LOGS to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的物化視圖日志。
   grant select on DBA_CONSTRAINTS to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫所有表的約束信息。
   grant select on DBA_CONS_COLUMNS to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫中所有表指定約束中所有列的相關(guān)信息。
   grant select on all_tab_cols to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫中表、視圖和集群中列的相關(guān)信息。
   grant select on sys.obj$ to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫中的對象。sys.obj$表是Oracle字典表中的對象基礎(chǔ)表，存放Oracle的所有對象。
   grant select on SYS.COL$ to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫表中列的定義信息。SYS.COL$用于保存表中列的定義信息。
   grant select on sys.USER$ to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的系統(tǒng)表。sys.USER$是用戶會話的默認(rèn)服務(wù)。
   grant select on sys.cdef$ to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的系統(tǒng)表。
   grant select on sys.con$ to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的約束信息。sys.con$記錄了Oracle的相關(guān)約束信息。
   grant select on all_indexes to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的所有索引。
   grant select on v_$database to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的v_$database視圖。
   grant select on V_$ARCHIVE_DEST to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的V_$ARCHIVE_DEST視圖。
   grant select on v_$log to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的v_$log視圖。v_$log用于顯示控制文件中的日志文件信息。
   grant select on v_$logfile to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的v_$logfile視圖。v_$logfile包含有關(guān)Redo日志文件的信息。
   grant select on v_$archived_log to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的v$archived_log視圖。v$archived_log包含有關(guān)歸檔日志的相關(guān)信息。
   grant select on V_$LOGMNR_CONTENTS to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的V_$LOGMNR_CONTENTS視圖。
   grant select on DUAL to '同步賬號';   //授權(quán)同步賬號查看數(shù)據(jù)庫的DUAL表。DUAL是用來構(gòu)成select語法規(guī)則的虛擬表，Oracle的中DUAL中僅保留一條記錄。
   grant select on v_$parameter to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的v_$parameter視圖。v$parameter是Oracle的動態(tài)字典表，保存了數(shù)據(jù)庫參數(shù)的設(shè)置值。
   grant select any transaction to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的任意事務(wù)。
   grant execute on SYS.DBMS_LOGMNR to '同步賬號';  //授權(quán)同步賬號使用數(shù)據(jù)庫的Logmnr工具。Logmnr工具可以幫助您分析事務(wù)，并找回丟失的數(shù)據(jù)。
   grant alter session to '同步賬號';  //授權(quán)同步賬號修改數(shù)據(jù)庫的連接。
   grant select on dba_objects to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的所有對象。
   grant select on v_$standby_log to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫的v_$standby_log視圖。v_$standby_log包含備用庫的歸檔日志。
   grant select on v_$ARCHIVE_GAP to '同步賬號';  //授權(quán)同步賬號查詢?nèi)笔У臍w檔日志。
   grant select on sys.ICOL$ to '同步賬號';  //授權(quán)同步賬號查看數(shù)據(jù)庫中的對象。sys.obj$表是Oracle字典表中的對象基礎(chǔ)表，存放Oracle的所有對象。

   如果您涉及使用離線全量同步數(shù)據(jù)，還需要執(zhí)行如下命令，授權(quán)同步賬號所有表的查詢權(quán)限。

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

   Oracle 12c及之后的版本需要執(zhí)行如下命令，授權(quán)同步賬號可以進(jìn)行日志挖掘。Oracle 12c之前的版本，內(nèi)置日志挖掘功能，無需執(zhí)行該命令。

   grant LOGMINING TO '同步賬號';

準(zhǔn)備工作3：開啟歸檔日志、補(bǔ)充日志并切換Redo日志文件

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

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

2. 開啟補(bǔ)充日志。

   您可以根據(jù)需要選擇開啟合適的補(bǔ)充日志，SQL語句如下。

   alter database add supplemental log data(primary key) columns; //為數(shù)據(jù)庫的主鍵列開啟補(bǔ)充日志。
   alter database add supplemental log data(unique) columns; //為數(shù)據(jù)庫的唯一索引列開啟補(bǔ)充日志。

3. 切換Redo日志文件。

   開啟補(bǔ)充日志后，您需要多次（一般建議執(zhí)行5次）執(zhí)行如下命令，切換Redo日志文件。

   alter system switch logfile;

   說明

   多次執(zhí)行上述命令切換Redo日志文件，是保證當(dāng)前日志文件被寫滿后可以切換至下一個(gè)日志文件。使執(zhí)行過的操作記錄不會丟失，便于后續(xù)恢復(fù)數(shù)據(jù)。

準(zhǔn)備工作4：檢查數(shù)據(jù)庫的字符編碼

您需要在當(dāng)前使用的數(shù)據(jù)庫中，執(zhí)行如下命令檢查數(shù)據(jù)庫的字符編碼。

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

• v$nls_parameters用于存放數(shù)據(jù)庫參數(shù)的設(shè)置值。

• NLS_CHARACTERSET及NLS_NCHAR_CHARACTERSET為數(shù)據(jù)庫字符集和國家字符集，表明Oracle中兩大類字符型數(shù)據(jù)的存儲類型。

準(zhǔn)備工作5：檢查數(shù)據(jù)庫表的數(shù)據(jù)類型

您可以使用查看表的SQL相關(guān)語句（SELECT）查詢數(shù)據(jù)庫表的數(shù)據(jù)類型。示例查看'tablename'表數(shù)據(jù)類型的語句如下。

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

• COLUMN_NAME：表的列名稱。

• DATA_TYPE：對應(yīng)列的數(shù)據(jù)類型。

• all_tab_columns：存放數(shù)據(jù)庫表所有列相關(guān)信息的視圖。

• TABLE_NAME：需要查詢的目標(biāo)表的名稱。執(zhí)行上述語句時(shí)，請?zhí)鎿Q'tablename'為實(shí)際需要查看的表名稱。

您也可以執(zhí)行select * from 'tablename';，查詢目標(biāo)表的所有信息，獲取數(shù)據(jù)類型。

單表離線同步任務(wù)配置指導(dǎo)

• 操作流程請參見通過向?qū)Ｊ脚渲秒x線同步任務(wù)、通過腳本模式配置離線同步任務(wù)。

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

單表實(shí)時(shí)同步任務(wù)配置指導(dǎo)

操作流程請參見DataStudio側(cè)實(shí)時(shí)同步任務(wù)配置。

整庫離線、整庫（實(shí)時(shí)）全增量、整庫（實(shí)時(shí)）分庫分表等整庫級別同步配置指導(dǎo)

操作流程請參見數(shù)據(jù)集成側(cè)同步任務(wù)配置。

離線任務(wù)腳本配置方式

如果您配置離線任務(wù)時(shí)使用腳本模式的方式進(jìn)行配置，您需要按照統(tǒng)一的腳本格式要求，在任務(wù)腳本中編寫相應(yīng)的參數(shù)，詳情請參見通過腳本模式配置離線同步任務(wù)，以下為您介紹腳本模式下數(shù)據(jù)源的參數(shù)配置詳情。