DataWorks：Oracle資料來源

準備工作1：確認Oracle資料庫版本

不同同步情境下支援的Oracle資料庫版本不一致，同步前您需要檢查Oracle資料庫版本是否為支援的版本。

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

   • 語句一：

     select * from v$version;

   • 語句二：

     select version from v$instance;

2. 如果查看到的Oracle資料庫版本為12c或18c，則您需要使用如下語句進一步確認該資料庫是否為cdb類型的資料庫。DataWorksData Integration即時同步任務暫不支援使用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側即時同步任務配置。

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

操作流程請參見Data Integration側同步任務配置。

離線任務指令碼配置方式

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