定義檔案

有效對象

DEFGEN

說明

使用 DEFSFILE 參數來識別 DEFGEN 將寫入資料定義的檔案名稱。依預設，資料定義檔案會以本機作業系統的字元集寫入。您可以使用 CHARSET 選項來變更字元集。

預設

無

語法

DEFSFILE <file_name> [APPEND | PURGE] [CHARSET <character_set>] [FORMAT RELEASE <major>.<minor>]

<file_name>

相對或完整檔案名稱。檔案會在您執行 DEFGEN 時建立。

APPEND

指示 DEFGEN 在任何現有內容 (如果指定的檔案已經存在) 的結尾寫入新內容 (從目前的執行)。如果定義檔案已經存在，但其版本是舊版的 Oracle GoldenGate，您可以將 FORMAT RELEASE 選項設為與現有檔案相同的版本，以避免發生錯誤。否則，DEFGEN 會嘗試新增較新的中繼資料功能與中止。以下是使用 APPEND 時的限制：

如果現有資料定義檔案的格式比 Oracle GoldenGate 11.2.1 舊，DEFGEN 會以舊格式附加表格定義，其中不支援具有多位元組和特殊字元的表格和資料欄名稱。
如果現有的資料定義檔案採用 11.2.1 版所導入的較新格式，DEFGEN 會以檔案的現有字元集附加表格定義。
如果現有檔案來自版本 11.2 或更舊版本，則是在 DEFGEN 不支援三部分物件名稱時寫入，如果新描述資料包含三部分名稱，則會導致錯誤。如果您使用 DEFGEN 參數檔中的 NOCATALOG 參數來移除容器或目錄部分，則可以指定 Oracle 容器資料庫中的物件。

PURGE

指示 DEFGEN 先清除指定的檔案，再從目前的執行寫入新內容。使用 PURGE 時，您可以將舊版 DEFGEN 所建立的現有定義檔案覆寫為支援較新功能 (例如三部分物件名稱) 的較新中繼資料。

CHARSET <character_set>

以指定的字元集產生定義檔案。如果沒有 CHARSET，則會使用作業系統的預設字元集。如果為 11.2.1 或更新的版本定義檔案指定 APPEND 模式，則會忽略 CHARSET，並使用現有定義檔案的字元集。

FORMAT RELEASE <major.minor>

指定 DEFGEN 傳送至定義檔之定義的描述資料格式。中繼資料會告知讀取器處理程序檔案記錄是否為其支援的版本。描述資料格式會依 Oracle GoldenGate 處理作業的版本而有所不同。舊版和新版的 Oracle GoldenGate 所包含的描述資料不同。舊版 Oracle GoldenGate 的處理將使用定義檔時，請使用 FORMAT。

FORMAT 為必要關鍵字。
RELEASE 指定 Oracle GoldenGate 發行版本版本。<major> 是主要版本號碼，<minor> 是次要版本號碼。X.x 必須反映 Oracle GoldenGate 的最新或更舊版本 (GA) 發行版本。有效值為 9.0 (透過目前的 Oracle GoldenGate X.x 版本號碼)，例如 11.2 或 12.1。(如果您使用 9.0 之前的 Oracle GoldenGate 版本，請指定 9.0 或 9.5。)

以程式設計方式將發行版本對應回適當的內部相容性層級。預設為寫入此歷程檔之處理作業的目前版本。請注意，早於 12.1 的 RELEASE 版本不支援三部分的物件名稱。

FORMAT RELEASE <major.minor>

指定 Extract 傳送給歷程檔、檔案或 (若為遠端作業) 其他處理作業之資料的描述資料格式。讀取器處理作業可從描述資料判斷資料記錄是否為其支援的版本。描述資料格式會依 Oracle GoldenGate 處理作業的版本而有所不同。舊版和新版的 Oracle GoldenGate 所包含的描述資料不同。

FORMAT RELEASE 指定 Oracle GoldenGate 發行版本版本。major 是主要版本號碼，minor 是次要版本號碼。X.x 必須反映 Oracle GoldenGate 目前或舊的正式 (GA) 發行版本。有效值為 11.1 到目前的 Oracle GoldenGate X.x 版本號碼，例如 11.2 或 12.1。發行版本會以程式設計方式對應回適當的歷程檔格式相容性層級。預設為寫入此歷程檔之處理作業的目前版本。備註：RELEASE 版本若早於 12.1，則不支援三部分物件名稱。

注意：如果在單一 Extract 中使用多個歷程檔，則只有相同的 RELEASE 版本可以共存。

Oracle Database 12.2 或更新版本支援下列設定值：

Oracle Database 12。2 的非 CDB 或更新版本的相容性設為 12.1 時，支援 FORMAT RELEASE 12.2 或更新的版本。
For Oracle Database 12.2 non-CDB or higher with compatibility set to 12.2, FORMAT RELEASE 12.2 or above is supported.
對於相容性設為 12.2 的 Oracle Database 12。2 CDB/PDB 或更新版本的 CDB/PDB，只支援 FORMAT RELEASE 值 12.3 或更新的版本。這是因為 PDB 使用本機還原，而需要使用 PDB 編號來增強交易 ID，以確保交易 ID 的唯一性。

範例

DEFSFILE ./dirdef/orcldef CHARSET ISO-8859-11 FORMAT RELEASE 11.2