SEND REPLICAT
SEND REPLICAT를 사용하여 시작 또는 실행 중인 Replicat 프로세스와 통신합니다. Replicat가 사용자로부터 명령을 수락할 수 있도록 준비되면 즉시 요청이 처리됩니다.
구문
SEND REPLICAT group_name[threadID],
{
CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE} |
DEPENDENCYINFO [TXNCOUNT num] |
FORCESTOP |
GETLAG |
GETPARAMINFO [parameter_name] [FILE output_file] |
HANDLECOLLISIONS | NOHANDLECOLLISIONS [table_spec] |
INTEGRATEDPARAMS(parameter_specification) |
LOGEND |
REPORT [HANDLECOLLISIONS [table_spec]] |
RESUME |
STATUS |
STOP |
TRACE[2] [DDLINCLUDE | DDL[ONLY]] file_name |
TRACE[2] OFF |
TRACE OFF file_name |
TRACEINIT |
THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])
}
group_name[threadID]
Replicat 그룹 이름 또는 조정된 Replicat의 특정 스레드 이름(예: fin003)입니다. 특정 스레드에 대해 명령이 실행되면 사용된 옵션은 해당 스레드에만 적용됩니다. 또는 그룹 이름과 함께 0threadID0을 포함하는 대신, THREADS 옵션과 함께 SEND REPLICAT를 실행할 수 있습니다. Replicat가 실행되고 있지 않을 경우 오류가 반환됩니다.
CACHEMGR {CACHESTATS | CACHEQUEUES | CACHEVMUSAGE}
Oracle GoldenGate 메모리 캐시 관리자에 대한 통계를 반환합니다. CACHEMGR는 Oracle Support의 명시적 지침에 따라서만 사용해야 합니다.
CACHESTATS
파일 캐싱에 대한 통계를 반환합니다.
CACHEQUEUES
사용 가능한 대기열에 대해서만 통계를 반환합니다.
CACHEVMUSAGE
가상 메모리 사용에 대한 통계를 반환합니다.
DEPENDENCYINFO [TXNCOUNT num]
PR 트랜잭션 종속성 그래프에서 정보를 인쇄합니다. 먼저 현재 실행 중인 트랜잭션 그룹을 인쇄한 다음 다른 트랜잭션에 종속된 대기 트랜잭션을 인쇄합니다. TXNCOUNT는 인쇄할 대기 트랜잭션 수를 결정합니다. 기본값은 10이고 최대값은 99입니다.
FORCESTOP
강제로 Replicat가 프로세스를 정지하도록 하여 통지를 무시합니다. 이 명령은 활성 트랜잭션을 롤백하고 프로세스를 즉시 정지합니다. 이 명령은 Replicat에 전체적으로 적용되며 특정 Replicat 스레드에 사용할 수 없습니다.
GETLAG
Replicat와 추적 간의 실제 지연 시간을 보여줍니다. 지연 시간은 Replicat가 마지막 레코드를 처리한 시간과 추적의 해당 레코드에 대한 시간기록 간 차이(초)입니다. 결과는 LAG REPLICAT와 동일합니다.
GETPARAMINFO [parameter_name] [FILE output_file]
GETPARAMINFO를 사용하여 Extract, Replicat, 관리자 등 실행 중인 인스턴스의 런타임 매개변수 값을 질의할 수 있습니다. 단일 매개변수 또는 모든 매개변수에 대해 질의를 수행하고 콘솔 또는 텍스트 파일로 출력을 전송할 수 있습니다.
parameter_name
기본 동작은 사용 중인 모든 매개변수를 표시하는 것입니다. 애플리케이션이 질의한 적이 있는 매개변수를 비롯한 모든 매개변수와 현재 값이 함께 제공됩니다. 특정 매개변수를 지정하면 출력이 해당 이름으로 필터링됩니다.
FILE output_file
출력이 재지정될 텍스트 파일의 이름입니다.
HANDLECOLLISIONS |
NOHANDLECOLLISIONS [table_spec] |
HANDLECOLLISIONS 동작을 제어합니다. 이 옵션을 사용하는 대신, Replicat 매개변수를 파일에서 HANDLECOLLISIONS 또는 NOHANDLECOLLISIONS 매개변수를 지정할 수 있습니다. Oracle GoldenGate에 대한 매개변수 및 함수 참조의 HANDLECOLLISIONS \| NOHANDLECOLLISIONS를 참조하십시오. SEND REPLICAT group_name[threadID]를 통해 개별 스레드에 직접 이 명령을 전송할 수 있고, 다중 스레드가 영향을 받도록 THREADS 옵션을 사용하여 조정자 스레드를 통해 명령을 전송할 수 있습니다.
HANDLECOLLISIONS
HANDLECOLLISIONS를 사용하여 소스 데이터베이스가 활성화 상태인 동안 초기 데이터 로드를 수행할 때 자동 오류 처리를 사용으로 설정할 수 있습니다. NOHANDLECOLLISIONS 옵션을 사용하여 SEND REPLICAT 를 실행하거나 매개변수 파일에서 매개변수를 제거하여 초기 로드가 완료되고 온라인 데이터 변경사항이 대상 테이블에 적용된 후 HANDLECOLLISIONS를 사용 안함으로 설정해야 합니다. 주: `SEND가 반환한 메시지
REPLICAT` with `HANDLECOLLISIONS`, when issued for a specific Replicat thread, shows that the command set `HANDLECOLLISIONS` for all `MAP` statements, not only the one handled by the specified thread. This is a known issue. The command actually affects only the `MAP` statement that includes the specified thread.
{: .infoboxnote}
NOHANDLECOLLISIONS
HANDLECOLLISIONS 매개변수를 해제하지만 매개변수 파일에서 제거하지 않습니다. 다음 번에 Replicat가 시작할 때 HANDLECOLLISIONS가 사용으로 설정되지 않도록 하려면 매개변수 파일에서 제거합니다.
table_spec
table_spec는 HANDLECOLLISIONS 또는 NOHANDLECOLLISIONS를 특정 대상 테이블 또는 표준 와일드 카드 문자(*)가 지정된 대상 테이블 그룹으로 제한합니다.
INTEGRATEDPARAMS(parameter_specification)
(Oracle) 통합 Replicat를 지원합니다. Replicat가 통합 모드로 실행 중인 상태에서 데이터베이스 인바운드 서버로 매개변수 지정을 전송합니다. 이 명령을 통해서는 한 번에 하나의 매개변수 지정만 전송할 수 있습니다. 다중 매개변수 변경사항을 전송하려면 다음 예에서와 같이 다중 SEND REPLICAT 명령을 실행합니다.
SEND REPLICAT repe INTEGRATEDPARAMS (parallelism 4)
SEND REPLICAT repe INTEGRATEDPARAMS (max_sga_size 250)
처리의 연속성을 유지하기 위해 트랜잭션 경계에서 매개변수 변경이 적용됩니다.
LOGEND
Replicat가 데이터 소스의 모든 레코드를 처리했는지 여부를 확인합니다.
REPORT [HANDLECOLLISIONS [table_spec]]
Extract 보고서 파일에 대한 임시 통계 보고서를 생성합니다. RESETREPORTSTATS | NORESETREPORTSTATS 옵션과 함께 사용되는 경우 표시되는 통계는 STATOPTIONS 매개변수의 구성에 따라 달라집니다. STATOPTIONS를 참조하십시오.
HANDLECOLLISIONS
HANDLECOLLISIONS가 사용으로 설정된 테이블을 보여줍니다.
table spec
출력을 특정 대상 테이블 또는 표준 와일드 카드 문자(*)가 지정된 대상 테이블 그룹으로 제한합니다.
RESUME
EVENTACTIONS SUSPEND 이벤트가 일시 중지한 프로세스를 재개(활성화)합니다. 프로세스가 일시 중지된 지점에서 정상 처리를 재개합니다.
STATUS
추적 내 현재 위치 및 현재 트랜잭션과 관련된 정보를 반환합니다. 필드 출력은 다음과 같습니다.
-
처리 상태(Replicat가 조정된 경우 스레드당)
-
추적 파일에서의 위치(Replicat가 조정된 경우 스레드당)
-
추적 시퀀스 번호(Replicat가 조정된 경우 스레드당)
-
추적의 RBA
-
추적 이름
가능한 처리 상태 메시지는 다음과 같습니다.
-
Delaying– 추가 데이터를 기다리는 중입니다. -
Suspended– 재개를 기다리는 중입니다. -
Waiting on deferred apply–DEFERAPPLYINTERVAL매개변수에 기반한 처리 지연입니다. -
Processing data– 데이터 처리 -
Skipping current transaction–SKIPTRANSACTION과 함께START REPLICAT가 사용되었습니다. -
Searching for START ATCSNcsn–START REPLICAT와 함께ATCSN가 사용되었습니다. -
Searching for START AFTERCSNcsn–START REPLICAT와 함께AFTERCSN가 사용되었습니다. -
Performing transaction timeout recovery– 현재 완료되지 않은 트랜잭션을 취소하고 새로 시작되도록 재배치합니다(TRANSACTIONTIMEOUT매개변수 참조). -
Waiting for data at logical EOF after transaction timeout recovery–TRANSACTIONTIMEOUT종료 후 완료되지 않은 소스 트랜잭션의 나머지가 수신될 때까지 기다립니다. -
At EOF (end of file)– 더 이상 처리할 레코드가 없습니다
THREADS가 사용되거나 명령이 특정 스레드에 대해 실행될 때 가능한 스레드 상태 메시지는 다음과 같습니다.
-
Waiting for consensus stop point: 스레드가 차단 트랜잭션에 대해 동기화를 시도 중임을 나타냅니다. -
Waiting for Watermark: 모든 스레드가 추적의 동일한 트랜잭션 경계(전통 워터마크라고 함)에서 정지를 시도 중임을 나타냅니다. -
Waiting on all threads to start up: 스레드가 성공한 장벽 트랜잭션 또는 Replicat 시작 후 모든 스레드가 시작될 때까지 기다리는 중임을 나타냅니다.
가능한 조정 관리자 스레드 상태 메시지는 다음과 같습니다.
-
Waiting for all threads to register:MAP문이 모두 구문분석되어 이 문에 지정된 스레드 ID를 확인하고 있음을 나타냅니다. -
Processing data: 데이터가 정상적으로 처리되고 있음을 나타냅니다. -
Suspended, waiting to be resumed:SUSPEND요청으로SEND REPLICAT명령을 Replicat로 전송했음을 나타냅니다. -
At EOF: 추적에서 더 이상 처리할 데이터가 없음을 나타냅니다. -
Waiting to register MAP statistics: Replicat가 보고서 파일로 전송할 처리 통계를 수집하고 있음을 나타냅니다.
STOP
정상적으로 Replicat를 정지합니다. 이 명령은 Replicat에 전체적으로 적용되며 특정 Replicat 스레드에 사용할 수 없습니다.
THREADS (threadID[, threadID][, ...][, thread_range[, thread_range][, ...])
조정된 Replicat의 지정된 스레드 또는 다중 스레드에 대해서만 명령을 실행합니다. 이 옵션을 사용하거나 groupname와 함께 threadID을 사용할 수 있습니다. 해당 옵션 중 하나를 지정하지 않을 경우 모든 활성 스레드에 명령이 적용됩니다.
threadID[, threadID][, ...]
스레드 ID 또는 threadID, threadID, threadID 형식의 콤마로 구분된 스레드 목록을 지정합니다.
thread_range[, thread_range][, ...]
threadIDlow-threadIDhigh 형식의 스레드 범위 또는 threadIDlow-threadIDhigh, threadIDlow-threadIDhigh 형식의 콤마로 구분된 범위 목록을 지정합니다.
threadID, threadID, threadIDlow-threadIDhigh 등의 형식 조합이 허용됩니다.
TRACE[2] [DDLINCLUDE |
DDL[ONLY]] file_name |
추적을 설정 및 해제합니다. 추적은 지정된 파일에 대한 정보를 캡처하여 처리 병목을 나타냅니다. Replicat 매개변수 TRACE 및 TRACE2을 통해서도 추적을 사용으로 설정할 수 있습니다.
Replicat가 조정 모드이며 TRACE가 THREADS 목록 또는 범위와 함께 사용되는 경우 현재 활성 스레드 각각에 대해 추적 파일이 생성됩니다. 각 파일 이름에 연관된 스레드 ID가 추가됩니다. 스레드 ID로 추적 파일을 식별하는 이 방법은 groupname와 함께 threadID로 SEND REPLICAT가 실행된 경우(SEND REPLICAT fin003 TRACE 등...) 또는 THREADS로 하나의 스레드만 지정된 경우 적용되지 않습니다.
추적에서 심각한 처리 병목이 나타난 경우 오라클 고객지원센터에 문의하여 도움을 받으십시오.
TRACE
단계별 처리 정보를 캡처합니다.
TRACE2
특정 단계 이외의 코드 세그먼트를 식별합니다.
DDLINCLUDE | DDLONLY
(Replicat만 해당) DDL 추적을 사용으로 설정하고 DDL 추적이 추적 보고서에 포함되는 방법을 지정합니다.
-
DDLINCLUDE에는 DDL 추적과 트랜잭션 데이터 처리의 일반 추적이 포함됩니다. -
DDL[ONLY]은 트랜잭션 데이터 처리의 추적을 제외하며 DDL만 추적합니다. 이 옵션은DDL로 축약할 수 있습니다.
file_name
file_name은 Oracle GoldenGate가 추적 정보를 기록하는 파일의 상대 또는 전체 이름을 지정합니다. 추적이 이미 진행 중인 경우 기존 추적 파일이 닫히고 file_name으로 지정된 파일에서 추적이 재개됩니다. 예:
SEND REPLICAT group_name TRACE file_name DDLINCLUDE
파일 이름 뒤에 다른 옵션이 없을 경우 다음과 같이 FILE 키워드를 생략할 수 있습니다.
SEND REPLICAT group_name TRACE DDLINCLUDE file_name
TRACE[2] OFF
추적을 해제합니다.
TRACE OFF file_name
지정된 추적 파일에 대해서만 추적을 해제합니다. 이 옵션은 EVENTACTIONS 기능을 지원합니다. 다중 EVENTACTIONS 문으로 인해 추적 파일이 여러 개 있을 수 있습니다.
TRACEINIT
추적 통계를 0으로 재설정한 다음 통계 누적을 다시 시작합니다. 이전과 달리 이 옵션을 사용하여 현재 처리 동작을 추적할 수 있습니다.
예제
SEND REPLICAT repe, HANDLECOLLISIONS
SEND REPLICAT repe, REPORT HANDLECOLLISIONS rep_*
SEND REPLICAT repe, GETLAG
SEND REPLICAT repe, INTEGRATEDPARAMS(parallelism 10)
다음은 조정된 Replicat의 스레드 3에 대한 지연을 가져옵니다.
SEND REPLICAT repe, GETLAG
다음은 조정된 Replicat의 스레드 1에 대해서만 추적을 사용으로 설정합니다. 이 경우 하나의 스레드만 추적하므로 추적 파일에 threadID 확장이 포함되지 않습니다. 파일 이름은 trace.trc입니다.
SEND REPLICAT repe, TRACE THREADS(1) FILE ./dirrpt/trace.trc
다음은 조정된 Replicat의 스레드 1, 2 및 3에 대한 추적을 사용으로 설정합니다. 모든 스레드를 활성으로 가정하여 추적은 trace001, trace002 및 trace003 파일을 생성합니다.
SEND REPLICAT repe TRACE THREADS(1-3) FILE ./dirrpt/trace.trc
다음은 조정된 Replicat의 스레드 1에 대해서만 추적을 사용으로 설정합니다. 명령은 THREAD 절을 사용하지 않고 스레드 1에 대해 직접 실행되었으므로 추적 파일의 이름은 스레드 ID 접미어 없이 trace입니다.
SEND REPLICAT repe TRACE FILE ./dirrpt/trace.trc