ALTER RECVPATH

使用 ALTER RECVPATH 來變更「接收端服務」中目標啟動的分送路徑屬性。

語法

ALTER RECVPATH path-name
  |         ( BEGIN   ( NOW
  |                   | SEQNO trail-sequence-number RBA relative-byte-address
  |                   | begin-datetime )
  |         | SOURCE  ( URI           source-uri
  |                   | PROXY URI     proxy-uri )
  |         | TARGET  ( FORMAT        ( CANONICAL | TEXT | SQL | XML )
  |                   | SIZEMB        megabytes-number
  |                   | SEQLEN        sequence-length
  |                           TYPE    ( SOCKS | HTTP )
  |                           [ CSALIAS credential-store-alias
  |                             [ CSDOMAIN credential-store-domain ] ]
  |                   | ENCRYPTIONPROFILE encryptionprofile_name
  |                   | 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

Oracle 重做日誌的序號及該日誌內用來開始擷取資料的 RBA。

begin_datetime

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

SOURCE URI source_uri

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

PROXY URI proxy_uri

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

TARGET

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

CANONICAL

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

TEXT

文字資料。

SQL

有效的 SQL 敘述句。

XML

XML 格式資料。

FORMAT

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

SIZEMB megabytes_number

設定分送路徑的大小 (MB)。

SEQLEN sequence_length

設定分送路徑的序號長度。

TYPE

設定分送路徑所使用的代理主機類型 (HTTP 或 SOCKS)。

CSALIAS credential_store_alias

指定您的證明資料存放區別名。

CSALIAS credential_store_domain

指定您的證明資料存放區網域名稱。

AUTHENTICATION OAUTH

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

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

AUTHENTICATION CERTIFICATE certificate-name

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

AUTHENTICATION USERIDALIAS

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

ENCRYPTIONPROFILE

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

COMPRESSION {ON

OFF

THRESHOLD compression_threshold}

指定資料是否壓縮。若設為 ON，您可以指定臨界值層次。

RULE

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

ALTER RECVPATH rcvp 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 RECVPATH rcvp RULE FILTER OBJECTNAMES (hr.emp, pdbnorth.hr.department)

OBJECTTYPES [ DML | DDL | PROCEDURE]

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

TAGS binary_tags

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

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

PROCEDUREFEATURENAMES feature_names

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

ALTER RECVPATH rcvp 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 RECVPATH rcvp 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 在達到其資料來源中目前資料的結尾後，檢查新資料的頻率。

ENCRYPTIONPROFILE

指定「接收端」路徑的加密設定檔名稱。

範例

---

ALTER RECVPATH rcvp BEGIN NOW

---

ALTER RECVPATH rcvp BEGIN SEQNO 1 RBA 10355

---

ALTER RECVPATH rcvp OPTIONS AUTORESTART RETRIES 3

---

ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES (hr.*, sales.*) ACTION EXCLUDE

---

ALTER RECVPATH rcvp RULE FILTER TAGS (AE00, MASK AB00, FF)

---

ALTER RECVPATH rcvp RULE FILTER COLUMNVALUES (c##ggadmin.hr.employees NE nope, c##ggadmin.hr.employees
    EQ 3 AFTER, c##ggadmin.hr.employees GE 5, c##ggadmin.hr.employees GT 5 BEFORE)

---

ALTER RECVPATH rcvp RULE FILTER OBJECTNAMES(hr.*,sales.*) RELATION AND ACTION EXCLUDE