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

Oracle REDOログの順序番号と、そのログ内のデータ取得開始位置のRBA。

begin-datetime

指定された形式の日付と時刻(タイムスタンプ)。Extractでは、このタイムスタンプ値は、Extractがデータベースに登録された時点のタイムスタンプより大きい値である必要があります。

SOURCE URI source_uri

ソース・キーワードの後にソースURIを指定して、データの発生元を示します。このURIの形式には、プロトコル(証跡のみをサポートします)、ホスト名、分散サービスのポート番号およびソース証跡ファイルの場所が含まれます。

TARGET URI target_uri

少なくとも1つのTARGETオプションを指定する必要があります。完全なオブジェクトとして処理されます。複雑なものを指定する必要がある場合は、REST APIを使用する必要があります。Admin Clientでは、限定されたターゲット設定のみがサポートされており、前のコールとターゲット設定のマージは実行されません。

URI
ターゲットの配布パスのURIを指定します。
FORMAT
ターゲットの配布パスのURIの形式を指定します。
SIZEMB
証跡順序のサイズを指定します。
SEQLEN
証跡ファイルの順序の長さを指定します。
PROXY URI
ターゲットの配布パスのプロキシURIを指定します。
TYPE
ソースおよびターゲットの配布パス間の接続タイプを指定します。SOCKS PROXYまたはHTTP PROXYを選択できます。
CSALIAS
配布パスの暗号化プロファイルで使用される資格証明ストアの別名。
CSDOMAIN
配布パスの暗号化プロファイルで使用される資格証明ストアのドメイン。
COMPRESSION
証跡順序を圧縮する必要があるかどうかを指定します。YESに設定する場合は、圧縮のしきい値を指定する必要があります。
RULE

少なくとも1つのRULEオプションを指定する必要があります。たとえば:

ALTER DISTPATH dpe RULE FILTER CHUNKIDS (1, 2, 3)
PASSTHRU
『Oracle GoldenGateリファレンス』PASSTHRU | NOPASSTHRUに関する項を参照してください。
FILTER

少なくとも1つのFILTERオプションを指定する必要があります。デフォルトでは、フィルタ間のRELATIONOR、アクションは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]

オブジェクト・タイプでレコードをフィルタするルールを指定します。少なくとも1つのオブジェクト・タイプを指定する必要があります。

TAGS binary_tags

タグでレコードをフィルタするルールを指定します。タグのリストはかっこで囲み、カンマで区切る必要があります。タグは16進またはバイナリの値文字列にする必要があります。また、キーワードHEXVALUEHEXMASKBINVALUEおよび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

少なくとも1つのオプションを指定する必要があります。

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