ALTER DISTPATH

使用 ALTER DISTPATH 來變更分配路徑的屬性。

語法

ALTER DISTPATH path-name
        ( BEGIN ( NOW
                  | SEQNO trail-sequence-number RBA relative-byte-address
                  | begin-datetime ),
                  | SOURCE (source-uri),
                  | TARGET (target-uri),
                  | FORMAT ( CANONICAL | TEXT | SQL | XML))
                  | SIZEMB megabytes-number
                  | SEQLEN sequence-length
                  | PROXY URI proxy-uri
                          TYPE ( SOCKS | HTTP
                          (CSALIAS credential-store-alias)
                            [ CSDOMAIN credential-store-domain ]
                  | COMPRESSION ( ON | OFF | THRESHOLD compression-threshold )
  |               | RULE    ( PASSTHRU
  |                   | FILTER [ CHUNKIDS    chunk-ids ]
  |                            [ OBJECTNAMES object-names-wildcard ]
  |                            [ OBJECTTYPES [ DML ] [ DDL ] [ PROCEDURE ] ]
  |                            [ TAGS        binary-tags ]
  |                            [ PROCEDUREFEATURENAMES feature-names-wildcard ]
  |                            [ COLUMNVALUES column-values ]
  |                            [ PARTITIONNAMES partition-names-wildcard ] )
  |                   [ RELATION    ( AND  | OR  ) ]
  |                   [ ACTION      ( INCLUDE | EXCLUDE ) ]
  |         | OPTIONS [ AUTORESTART RETRIES retries [ DELAY delay ] ]
  |                   [ CRITICAL ( YES | NO ) ]
  |                   [ EOFDELAY    eofdelay         ]
  |         | AUTHENTICATION ( OAUTH
                                   | ( CERTIFICATE certificate-name )
                                   | ( USERIDALIAS alias [DOMAIN domain
                                   | ( ENCRYPTIONPROFILE encryption-profile-name] ) ) )

path-name

您要變更的分送路徑名稱。

BEGIN {NOW

SEQNO sequence-number RBA relative-byte-address

begin-datetime}

指定資料來源中用來開始處理的時戳。

NOW

指定 ADD EXTRACT 命令的發行時間。

sequence-number relative-byte-address

開始擷取資料之檔案中的歷程檔和 RBA 的序號。

begin-datetime

以指定格式表示的日期與時間 (時戳)。針對 Extract，此時戳值必須大於向資料庫註冊 Extract 的時戳。

SOURCE URI source_uri

指定來源關鍵字之後的來源 URI，以指示資料的起源位置。此 URI 的格式包含「分送服務」的協定 (只支援歷程檔)、主機名稱、連接埠號碼，以及來源歷程檔的位置。

TARGET URI target_uri

至少必須指定一個 TARGET 選項。它會被視為一個完整物件。如果您需要指定複雜的項目，則需使用 REST API。「管理從屬端」只支援一組有限的目標設定值，而且不會將目標設定值與先前的呼叫合併。

CANONICAL

定義單一位元組順序，資料單一浮點表示法。

TEXT

文字資料。

SQL

有效的 SQL 敘述句。

XML

XML 格式資料。

URI

指定目標分送路徑的 URI。

FORMAT

指定目標分送路徑的 URI 格式。

SIZEMB

指定歷程檔序列的大小。

SEQLEN

指定歷程檔序列長度。

PROXY URI

指定目標分送路徑的代理主機 URI。

TYPE

指定來源與目標分送路徑之間的連線類型。您可以選擇 SOCKS PROXY 或 HTTP PROXY。

CSALIAS

分送路徑的加密設定檔所使用的證明資料存放區別名。

CSDOMAIN

分送路徑的加密設定檔所使用的證明資料存放區網域。

COMPRESSION

指定是否必須壓縮歷程檔序列。如果您將它設為 YES，則必須指定壓縮的臨界值。

RULE

注意：從「管理從屬端」中，如果您在先前的規則存在時建立規則，則會移除先前的規則並新增新規則。您無法從「管理從屬端」附加規則。如果您需要建立複雜的規則或將規則附加至現有規則，請直接使用 Web 介面或 REST API 呼叫。

至少必須指定一個 RULE 選項。舉例而言：

ALTER DISTPATH dpe RULE FILTER CHUNKIDS (1, 2, 3)

PASSTHRU

請參閱 Oracle GoldenGate 的參數和函數參照中的 PASSTHRU \| NOPASSTHRU 。

FILTER

至少必須指定一個 FILTER 選項。依照預設，篩選之間的 RELATION 為 OR，而動作為 KEEP。

CHUNKIDS chunk_ids

指定規則以依記錄的區塊 ID (分區) 篩選記錄。區塊 ID 清單必須以括號括住並以逗號區隔。

OBJECTNAMES object_names

指定規則以依記錄的物件名稱篩選記錄。物件名稱清單必須以括號括住並以逗號區隔。物件名稱必須依循下列文法：

[cdb_name.]schema_name.table_name

舉例而言：

ALTER DISTPATH dpe RULE FILTER OBJECTNAMES (hr.emp, pdbnorth.hr.department)

OBJECTTYPES [ DML | DDL | PROCEDURE]

指定規則以依記錄的物件類型篩選記錄。必須至少指定一個物件類型。

TAGS binary_tags

指定規則以依記錄的標記篩選記錄。標記清單必須以括號括住並以逗號區隔。標記必須是十六進位或二進位值字串，且前面加上關鍵字 HEXVALUE、HEXMASK、BINVALUE 和 BINMASK。如果標記是 BITMASK，則篩選會在遮罩與 LCR 記錄的標記值之間執行位元 AND 作業。如果結果等於 MASK，則會套用此動作。舉例而言：

ALTER DISTPATH dpe RULE FILTER TAGS (hexvalue A4, hexvalue 18, hexmask F0, hexvalue F8F, binvalue 01001100, binmask 0110)

PROCEDUREFEATURENAMES feature_names

指定規則以依程序功能名稱篩選記錄。程序功能名稱清單必須以括號括住並以逗號區隔。舉例而言：

ALTER DISTPATH dpe RULE FILTER PROCEDUREFEATURENAMES (RAS, AUTOCDR, AQ)

COLUMNVALUES column_values

指定規則以依記錄的資料欄值篩選記錄。篩選規則必須依循此語法並以逗號區隔：

[cdb_name.]schema_name.table_name.column_name ( EQ | NE | LT | GT | LE | GE ) column_value [ BEFORE | AFTER ]

EQ = 等於

NE = 不等於

LT = 小於

GT = 大於

LE = 小於或相等

GE = 大於或等於

舉例而言：

ALTER DISTPATH dpe RULE FILTER COLUMNVALUES (pdbnorth.ggadmin.hr.emp.emp_id EQ 0 BEFORE, cdbsouth.c##ggadmin.hr.emp.emp_id GT 100)

OPTIONS

至少必須指定一個選項：

AUTORESTART {RETRIES retries

DELAY delay}

指定分送路徑會自動重新啟動、重試啟動的次數，以及任何的延遲。

CRTICAL [YES | NO]

指示分送路徑對於部署至關重要。預設值為 NO。

EOFDELAY eofdelay

指定 Extract、資料汲取或 Replicat 在達到其資料來源中目前資料的結尾後，檢查新資料的頻率。

請參閱變更路徑篩選，以瞭解現有路徑之篩選設定的規則。

AUTHENTICATION OAUTH

如果您使用外部身分識別提供者 (IDCS) 的授權設定檔，請使用此選項。這將會設定從分送服務至接收端服務的流程。

注意：如果您的部署已啟用 IDCS，您仍然可以選擇使用其他認證選項來認證。

AUTHENTICATION CERTIFICATE certificate-name

已上傳分送路徑特定從屬端憑證的識別碼，且在管理服務中管理。

AUTHENTICATION USERIDALIAS

除了憑證認證之外，您可以將每個分送路徑與目標 DBLOGIN USERIDALIAS 建立關聯。

ENCRYPTIONPROFILE

指定分送路徑的加密設定檔名稱。

範例

---

ALTER DISTPATH dpe BEGIN NOW

---

ALTER DISTPATH dpe BEGIN SEQNO 1 RBA 10355

---

ALTER DISTPATH dpn OPTIONS AUTORESTART RETRIES 3

---

ALTER DISTPATH dpe RULE FILTER OBJECTNAMES (hr.*, sales.*) ACTION EXCLUDE

---

ALTER DISTPATH dpe RULE FILTER TAGS (AE00, MASK AB00, FF)

---

ALTER DISTPATH dpe RULE FILTER COLUMNVALUES (hr.employess.deptno NE nope, hr.employees.employee_id
    EQ 3 AFTER, hr.employees.deptno GE 5, hr.employees.employee_id GT 5 BEFORE)

---

ALTER DISTPATH dpe RULE FILTER OBJECTNAMES(hr.*,sales.*) RELATION AND ACTION EXCLUDE

---

此範例會將所有表格中符合 part1* 的所有分割區排除：

ALTER DISTPATH dpe RULE FILTER PARTITIONNAMES (part_2022*) ACTION EXCLUDE