EXTTRAIL

有效對象

擷取

說明

使用 EXTTRAIL 參數指定本機系統上使用 ADD EXTTRAIL 命令建立的歷程檔。歷程檔由「分送路徑」讀取，或由本機系統上的 Replicat 讀取。

EXTTRAIL 必須在所有關聯的 TABLE 敘述句之前。您可以使用多個 EXTTRAIL 陳述式來定義 Extract 的不同歷程檔，但使用 GTID 集定位時 MySQL Extract 除外，因為僅支援一個歷程檔。

從 Oracle GoldenGate 19c 開始，主要 Extract 會在升級期間，以與現有歷程檔格式相同的格式寫入歷程檔，除非您使用 FORMAT RELEASE 選項明確指定歷程檔格式版本。這可避免後續的 Replicat 在未升級時異常中止。

您可以使用 ENCRYPTTRAIL 參數來加密此歷程檔中的資料。如需詳細資訊，請參閱 ENCRYPTTRAIL \| NOENCRYPTTRAIL 。

注意：使用 ENCRYPTRAIL 參數搭配 EXTTRAIL 參數時，請確定在 EXTTRAIL 之前提及 ENCRYPTRAIL 參數，否則將不會加密歷程檔。

注意：傳送至 NSK 的「分送路徑」將使用的本機歷程檔，您必須使用 TRAILBYTEORDER BIGENDIAN。無法在資料汲取中更改此項目。

預設

無

語法

EXTTRAIL <file_name>
[, FORMAT RELEASE <major>.<minor>]
[, TRAILBYTEORDER {BIGENDIAN | LITTLEENDIAN | NATIVEENDIAN}]

<trail_name>

歷程檔的相對或完整路徑名稱。歷程檔名稱只能包含兩個字元。

注意：在 Microservices Architecture 中，軌跡檔案名稱二字元前置碼必須以字母形式開始。

每當有新檔案建立時，Oracle GoldenGate 都會在此名稱附加一組九位數的序號。例如，名為 /tr 的歷程檔會包含名為 /tr000000001、/tr000000002 的檔案。

FORMAT RELEASE <major.minor>

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

FORMAT RELEASE 指定 Oracle GoldenGate 發行版本版本。major 是主要版本號碼，minor 是次要版本號碼。major.minor 值必須反映 Oracle GoldenGate 發行版本目前或之前的一般可用 (GA) 版本。有效值為 11.2 到目前的 Oracle GoldenGate X.x 版本號碼，例如 23.26 或 19.1。

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

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

TRAILBYTEORDER {BIGENDIAN

LITTLEENDIAN

NATIVEENDIAN}

設定歷程檔的位元組格式。僅適用於 FORMAT RELEASE 版本至少為 12.1 的歷程檔。有效值為 BIGENDIAN (大位元組順序)、LITTLEENDIAN (小位元組順序) 及 NATIVEENDIAN。預設值為 NATIVEENDIAN。如需其他使用說明，請參閱 GLOBALS 版本的 TRAILBYTEORDER 。

範例

範例 1

EXTTRAIL ny

範例 2

在 Linux 上：

EXTTRAIL trails/ny, FORMAT RELEASE 12.3

範例 3

在 Windows 上：

EXTTRAIL trails\ny, FORMAT RELEASE 12.3

範例 4

在所擷取的同一組表格中，有兩種歷程檔格式：

EXTTRAIL ea
TABLE hr.tab1
TABLE hr.tab2
EXTTRAIL eb
TABLE scott.tab3
TABLE scott.tab4