捨棄檔 | NODISCARDFILE

有效對象

擷取與 Replicat

說明

使用 DISCARDFILE 參數執行下列作業：

• 自訂捨棄檔案的名稱、位置、大小和寫入模式。依預設，每當使用 START 命令啟動程序時，就會產生捨棄檔。若要保留預設特性，不需要 DISCARDFILE 參數。

• 指定捨棄檔來處理從作業系統命令行開始的處理作業，且預設不會建立捨棄檔的方法。

使用 NODISCARDFILE 參數來停用捨棄檔的使用。如果 NODISCARDFILE 與 DISCARDFILE 搭配使用，則程序會中止。

使用 DISCARDFILE 時，請使用 PURGE 或 APPEND 選項。否則，您必須先指定不同的捨棄檔名稱，才能開始執行每個處理作業，因為 Oracle GoldenGate 不會寫入沒有這些指示的現有捨棄檔，而且會終止。

請參閱 "DISCARDROLLOVER "，瞭解如何控制將捨棄檔案變換至新檔案的頻率。

如需有關捨棄檔的詳細資訊，請參閱Oracle GoldenGate 錯誤處理簡介。

預設

如果使用 START 命令啟動處理作業，就會產生捨棄檔案，如下所示：

• 檔案會依照建立檔案的程序命名，副檔名為 .dsc。如果處理作業是協調式 Replicat，則每個繫線會產生一個檔案。每個檔案名稱都會附加至對應繫線的繫線 ID。

• 檔案會建立在 Oracle GoldenGate 安裝目錄的 dirrpt 子目錄中。

• 檔案大小上限為 50 MB。

• 啟動時，如果有捨棄檔案，該檔案會在寫入新資料之前被清除。

• 檔案名稱上限為 250 個字元，包括目錄。

從作業系統的命令行啟動處理作業時，預設不應產生捨棄檔。

語法

DISCARDFILE { [<file_name>]
[, APPEND | PURGE]
[, MAXBYTES <n> | MEGABYTES <n>] } |
NODISCARDFILE

DISCARDFILE

指示正在變更捨棄檔的名稱或其他屬性。

<file_name>

捨棄檔的相對或完整名稱，包括實際檔案名稱。對於協調式 Replicat，請指定最多五個字元的檔案名稱，因為每個檔案名稱都會附加至寫入它的繫線 ID。若要將檔案儲存在 Oracle GoldenGate 目錄中，相對路徑名稱就已足夠，因為 Oracle GoldenGate 會將名稱限定為 Oracle GoldenGate 安裝目錄。

APPEND

若檔案已存在，則新增內容至現有內容。如果未使用 APPEND 或 PURGE，您必須先指定其他捨棄檔案名稱，才能開始每次執行處理。

PURGE

寫入新內容之前，請先清除檔案。如果未使用 PURGE 或 APPEND，您必須先指定不同的捨棄檔案名稱，才能開始每次執行處理。

MAXBYTES <n>

設定檔案的大小上限 (位元組)。有效的位址介於 1 到 4096967295。預設值為 3000000。如果超過指定的大小，處理作業就會中止。

MEGABYTES <n>

設定檔案的大小上限 (MB)。有效的位址介於 1 到 4096。預設值為 3。如果超過指定的大小，處理作業就會中止。

NODISCARDFILE

避免處理程序建立捨棄檔案。

範例

範例 1

此範例指定非預設檔案名稱和副檔名、非預設寫入模式，以及非預設的檔案大小上限。此範例顯示如何變更線上程序之捨棄檔的預設特性，或指定從作業系統命令行開始，且預設沒有捨棄檔之處理作業的捨棄檔使用方式。

DISCARDFILE .dirrpt/discard.txt, APPEND, MEGABYTES 20

範例 2

此範例只會變更線上處理程序之預設捨棄檔案的寫入模式。

DISCARDFILE .dirrpt/finance.dsc, APPEND

範例 3

此範例會停用線上處理程序的捨棄檔案。

NODISCARDFILE