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

주: 관리 클라이언트에서 이전 규칙이 있는 동안 규칙을 생성하면 이전 규칙이 제거되고 새 규칙이 추가됩니다. 관리 클라이언트에서 규칙을 추가할 수 없습니다. 복잡한 규칙을 생성하거나 기존 규칙에 규칙을 추가해야 하는 경우 웹 인터페이스 또는 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

태그로 레코드를 필터링할 규칙을 지정합니다. 태그 목록은 괄호로 묶이고 콤마로 구분되어야 합니다. 태그는 16진수 또는 이진 값 문자열이며 키워드 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가 새 데이터를 확인하는 빈도를 지정합니다.

기존 경로의 필터 설정 규칙에 대한 자세한 내용은 Change the Path Filtering을 참조하십시오.

AUTHENTICATION OAUTH

외부 ID 제공자(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