Chat now with support
Chat with Support

SharePlex 11.4 - 참조 안내서

이 안내서 정보 이 안내서에 사용된 규칙 Oracle용 SharePlex 명령 SharePlex 매개변수 PostgreSQL용 SharePlex 명령 PostgreSQL용 SharePlex 매개변수 일반 SharePlex 유틸리티 Oracle Cloud 인프라스트럭처 SharePlex 환경 변수

SharePlex 명령에 대한 알파벳순 참조

SharePlex 명령에 대한 알파벳순 참조

그러면 SharePlex 명령에 대한 자세한 참조 문서가 알파벳순으로 시작됩니다.

abort config

abort config 명령을 사용하면 구성을 즉시 비활성화하고 관련된 모든 큐와 복제 프로세스를 동시에 삭제할 수 있습니다. 이 명령은 큐의 데이터 게시 여부에 관계없이 소스 시스템과 타겟 시스템에서 구성된 데이터 소스에 대한 모든 복제 활동을 중지합니다. 강제 비활성화입니다.

abort config 명령은 시스템, 구성 또는 데이터 문제가 있어 타겟 시스템에 게시하는 것을 방지해야 할 때 효과적입니다. 파이프라인에 남아 있는 모든 데이터를 삭제하기 때문에 이 명령이 적용되면 소스 및 타겟 인스턴스의 동기화가 해제됩니다.

abort config 명령 전이나 도중에 SharePlex 복제 프로세스가 중지되면 명령도 중지됩니다. 프로세스가 다시 시작되면 명령의 작동이 재개됩니다. 이를 통해 네트워크가 일시적으로 다운된 경우에도 abort config 명령이 작동할 수 있으며 연결이 복원될 때까지 큐에 남아 있습니다.

동일한 소스 시스템에 여러 활성 구성이 있으면 각 구성에 대해 복제 스트림을 분리하는 명명된 Export 큐가 있는 경우에만 abort config 명령을 사용합니다. 명명된 내보내기 큐가 없으면 SharePlex는 복제된 모든 데이터를 하나의 Export 큐를 통해 전달하고, 한 구성에 대한 abort config 명령은 모든 데이터를 삭제합니다. 명명된 큐를 생성하려면 SharePlex 관리자 안내서의 5장을 참조하십시오.

사용

지원되는 소스:

Oracle

지원되는 타겟: 전체
인증 수준: 관리자
실행 대상: 소스 시스템
관련 명령: deactivate config, purge config

구문

기본 명령 원격 옵션
abort config filename

[ on host |

on host:portnumber |

on login/password@host |

on login/password@host:portnumber ]

구문 설명
구성 요소 설명
filename 

중단할 구성의 이름입니다. 구성 이름은 대소문자를 구분합니다.

예:

sp_ctrl(sysA)> abort config sales

원격 옵션

이러한 옵션을 사용하면 원격 시스템에서 명령을 실행하고 로그인 이름, 비밀번호, 포트 번호 또는 이러한 항목의 조합을 포함하는 명령을 스크립트할 수 있습니다.

옵션 설명
on host

원격 시스템(현재 sp_ctrl 세션이 실행 중인 시스템이 아닌 것)에서 명령을 실행합니다. 원격 시스템에 대한 로그인 자격 증명을 묻는 메시지가 표시됩니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예: sp_ctrl(sysB)>status on SysA

on host:portnumber

원격 로그인 및 포트 번호를 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예: sp_ctrl(sysB)>status on SysA:8304

on login/password@host

원격 로그인, 비밀번호 및 호스트 이름을 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예:sp_ctrl(sysB)>status on john/spot5489@SysA

on login/password@host:portnumber

원격 로그인, 비밀번호, 호스트 이름 및 포트 번호를 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예: sp_ctrl(sysB)>status on john/spot5489@SysA:8304

abort service

abort service 명령을 사용하면 해당 프로세스가 해당 큐에서 읽기 또는 쓰기를 완료했는지 여부에 관계없이 SharePlex 복제 프로세스(서비스)를 즉시 종료할 수 있습니다. 이 명령은 프로세스가 정상적으로 중지될 때까지 기다릴 수 없거나 stop 명령을 실행해도 프로세스가 종료되지 않는 비정상적인 상황에서 효과적입니다.

이 명령은 복제된 데이터에는 영향을 주지 않습니다. 데이터는 큐에 안전하게 유지되며, 프로세스가 다시 시작되면 SharePlex가 정상적인 처리가 재개됩니다.

abort service 명령으로 중단된 프로세스는 SharePlex가 종료되었다가 재시작되더라도 정지된 상태로 유지됩니다. start 명령만 다시 시작할 수 있습니다.

abort service 명령은 다른 경로에 대한 복제에 영향을 주지 않으면서 임의(또는 모든) 시스템 또는 명명된 큐에 대한 프로세스를 중단할 수 있는 옵션을 제공합니다.

사용

지원되는 소스:

Oracle

지원되는 타겟: 전체
인증 수준: 운영자(2), Capture를 중단할 관리자(1)
실행 대상:

Capture, Read 및 Export에 대한 abort service가 소스 시스템에 대해 실행됩니다.

Import 및 Post에 대한 abort service가 타겟 시스템에 대해 실행됩니다.

관련 명령: start, stop

구문

기본 명령 명령 옵션 원격 옵션
abort service service

[to host]

[from host]

[for datasource]

[for datasource-datadest]

[queue queuename]

[ on host |

on host:portnumber |

on login/password@host |

on login/password@host:portnumber ]

구문 설명
구성 요소 설명
서비스

필수. 중단할 SharePlex 복제 프로세스입니다. 유효한 값은 다음과 같습니다.

capture

read

export

import

post

to host

이 옵션을 사용하면 지정된 시스템으로 Export가 중단되고 다른 시스템으로 Export는 계속됩니다.

  • host는 타겟 시스템의 이름입니다.

:

sp_ctrl(sysA)> abort service export to sysB

이 예에서는 sysA에서 sysB로의 Export가 중단되지만 sysA에서 다른 타겟 시스템으로의 다른 Export 프로세스는 계속됩니다.

from host

이 옵션을 사용하면 지정된 시스템에서 Import가 중단되고 다른 시스템에서의 Import는 계속됩니다.

host는 소스 시스템의 이름입니다.

:

sp_ctrl(sysD)> abort service import from sysC

이 예에서는 sys C에서 Import가 sysD에서 중단되지만 다른 소스 시스템에서 sysD의 다른 Import 프로세스는 계속됩니다.

for datasource

이 옵션을 사용하면 지정된 데이터 소스에 대한 Capture 또는 Read가 중단되지만 동일한 시스템의 다른 복제 데이터 소스에는 영향을 미치지 않습니다.

  • datasource는 o.SID로 표시됩니다. 여기서, SID는 소스 Oracle 인스턴스의 ORACLE_SID입니다.

:

sp_ctrl(sysA)> abort service read for o.oraA

이 예에서는 인스턴스 oraA에 대한 sysA에서 Read가 중단되지만 sysA의 다른 인스턴스에 대한 다른 Read 프로세스는 계속됩니다.

for datasource-datadest

이 옵션을 사용하면 지정된 소스 SID 타겟 SID 데이터 스트림에 대한 Post가 중단되고 다른 Post 활동은 계속됩니다.

  • datasourceo.SID로 표시됩니다. 여기서, SID는 소스 Oracle 인스턴스의 ORACLE_SID입니다.
  • datadesto.SID로 표시됩니다. 여기서, SID는 타겟 Oracle 인스턴스의 ORACLE_SID입니다.

예:

sp_ctrl(sysC)> abort service post for o.oraA-o.oraC

이 예에서는 인스턴스 oraA가 oraC에 복제되는 경우 Post가 sysC에서 중단되지만 sysC의 다른 Post 프로세스는 계속됩니다.

queue queuename

이 옵션을 사용하면 명명된 큐와 관련된 Export, Import 또는 Post 프로세스가 중단되고 다른 명명된 큐를 통한 복제는 계속됩니다.

  • queuename은 큐의 이름입니다.

:

sp_ctrl(sysA)> abort service export queue QA

이 예에서는 명명된 내보내기 큐 QA를 통한 데이터 Export가 sysA에서 중단되지만 다른 모든 명명된 큐에 할당된 데이터에 대한 Export는 계속됩니다.

원격 옵션

이러한 옵션을 사용하면 원격 시스템에서 명령을 실행하고 로그인 이름, 비밀번호, 포트 번호 또는 이러한 항목의 조합을 포함하는 명령을 스크립트할 수 있습니다.

옵션 설명
on host

원격 시스템(현재 sp_ctrl 세션이 실행 중인 시스템이 아닌 것)에서 명령을 실행합니다. 원격 시스템에 대한 로그인 자격 증명을 묻는 메시지가 표시됩니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예: sp_ctrl(sysB)>status on SysA

on host:portnumber

원격 로그인 및 포트 번호를 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예: sp_ctrl(sysB)>status on SysA:8304

on login/password@host

원격 로그인, 비밀번호 및 호스트 이름을 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예:sp_ctrl(sysB)>status on john/spot5489@SysA

on login/password@host:portnumber

원격 로그인, 비밀번호, 호스트 이름 및 포트 번호를 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

예: sp_ctrl(sysB)>status on john/spot5489@SysA:8304

activate config

activate config 명령을 사용하여 구성을 활성화할 수 있습니다. 활성화 프로세스가 완료되는 즉시 복제가 시작됩니다. 구성을 활성화하면 발생하는 상황에 대한 자세한 내용은 SharePlex 관리 안내서를 참조하십시오.

활성화 프로세스는 구성 파일을 읽고 여기에서 SharePlex에 필요한 모든 정보를 가져와서 다음 작업을 수행합니다.

  • 복제 중인 객체 식별
  • 복제된 변경 사항을 적절한 타겟 데이터베이스로 라우팅
  • Post가 타겟에 변경 사항을 적용하는 데 사용하는 SQL 생성
  • 복제에 추가된 모든 테이블 활성화

구성을 활성화하기 위해 sp_cop을 호출하는 프로세스는 sp_tconf입니다.

활성화는 비동기 병렬 처리 스레드를 생성하여 여러 테이블을 동시에 활성화합니다. 각 테이블은 매우 짧은 시간, 즉 테이블을 활성화할 수 있을 만큼만 잠겨 있습니다. 각 테이블의 복제는 활성화가 완료되는 즉시 시작됩니다.

하나 이상의 테이블이 활성화되지 않으면 SharePlex는 다른 테이블의 활성화를 계속합니다. 애플리케이션이 복제 구성의 테이블에 대해 NOWAIT 잠금을 사용하는 경우, 활성화 중인 객체에 대한 잠금을 얻으려고 시도하면 실패할 수 있습니다.

활성화 가이드라인

  • 구성을 활성화하려면 복제할 객체가 포함된 데이터베이스를 마운트하고 열어야 합니다. 활성화에 소요되는 시간은 구성된 객체의 크기, 개수. 구조에 따라 다릅니다.
  • 각 시스템의 데이터 소스당(Oracle 인스턴스) 하나의 구성을 활성화할 수 있습니다. 예를 들어 인스턴스 ora10에 대해 ConfigA, ConfigB, ConfigC가 있는 경우 한 번에 하나만 활성화할 수 있습니다. 동일한 데이터 소스에 대해 다른 구성을 활성화하면 첫 번째 구성이 자동으로 비활성화됩니다.
  • 활성화 중에는 TRUNCATE를 포함한 DDL을 수행하지 마십시오. 활성화 중에는 DML 변경만 허용됩니다.
  • 활성화하려면 애플리케이션에 재시도 논리가 있어야 합니다. 복제 구성의 테이블에 대한 NOWAIT 잠금으로 인해 활성화 중인 객체에 대한 잠금을 얻으려고 시도하면 애플리케이션이 실패할 수 있습니다.
  • 활성화 프로세스는 활성화가 완료될 때까지 sp_ctrl 인터페이스에 대한 제어를 유지합니다. 동일한 시스템의 다양한 데이터 소스에 대해 여러 구성을 활성화하려면 첫 번째 구성을 활성화한 다음, sp_ctrl 의 다른 세션을 열어 두 번째 구성을 활성화합니다. 활성화할 구성 수만큼 sp_ctrl 세션을 엽니다.
  • 구성을 활성화하기 전에 verify config 명령을 사용하여 성공적인 활성화 및 복제에 대한 기본 요구 사항이 충족되었는지 확인합니다. 이 명령은 활성화 실패를 초래할 수 있는 잠재적인 문제를 경고합니다.

활성화 스레드 수 설정

활성화 스레드 수를 전역적으로(모든 활성화에 대해) 설정할 수 있으며 활성화에 대해 이 설정을 재정의할 수 있습니다.

스레드 수를 전역적으로 설정하려면 다음을 수행합니다.

  1. sp_ctrl을 실행합니다.
  2. 다음 명령을 실행합니다. 최대 32개의 스레드 값을 사용할 수 있습니다.

    sp_ctrl> set param SP_OCF_THREAD_COUNT number_of_threads

현재 활성화에 대한 스레드 수를 설정하려면 다음을 수행합니다.

activate config 명령을 실행하는 경우 [thread=n] 옵션을 사용합니다.

활성화 상태 및 결과 보기

SharePlex는 구성 파일의 순서가 아닌 객체 ID에 따라 객체 활성화하므로 활성화 순서를 예측할 방법이 없습니다.

SharePlex는 개별 테이블의 활성화 실패 여부에 관계없이 활성화를 계속하기 때문에 테이블이 활성화에 실패하면 sp_ctrl 프롬프트에 다음과 같은 오류 메시지를 표시하여 경고합니다. “WARNING, not all objects activated successfully. Check activation log.”

활성화 결과를 보려면 다음을 수행합니다.

show config 명령을 실행합니다.

활성화에 실패한 경우 수행할 작업

테이블 또는 전체 구성의 활성화가 실패할 수 있는 원인은 여러 가지가 있습니다. 예를 들어 구성 파일에 하나 이상의 구성 요소를 잘못 입력한 경우 영향을 받는 객체의 활성화가 실패합니다.

활성화하기 전에 verify config 명령을 실행하지 않은 경우에는 지금 실행하여 발견되는 문제를 해결합니다. 그런 다음, 다시 활성화하십시오. 더 많은 문제 해결 조언을 보려면 SharePlex 관리 안내서를 참조하십시오.

사용

지원되는 소스: Oracle(모든 옵션)
지원되는 타겟: 전체
인증 수준: 관리자(1)
실행 대상: 소스 시스템
관련 명령: abort config, copy config, create config, deactivate config, edit config, list config, purge config, remove config, rename config, show config, verify config, view config 

구문

기본 명령 명령 옵션 원격 옵션
activate configfilename

[threads=n]

[nolock]

scn=scn_value

seqno=log_sequence_number

[ on host |

on host:portnumber |

on login/password@host |

on login/password@host:portnumber ]

구문 설명
구성 요소 설명
filename 

필수. 활성화하려는 구성의 이름입니다. 구성 이름은 대소문자를 구분합니다.

예:

sp_ctrl(sysA)> activate config sales

threads=n

(Oracle에 유효) 이 옵션을 사용하면 활성화 프로세스에서 생성되는 분석 스레드 수를 설정할 수 있습니다. 이 옵션은 SP_OCF_THREAD_COUNT 매개변수로 설정된 기본값을 재정의합니다.

n의 유효한 값 범위는 1~32이지만 스레드를 5개 이하로 사용하는 것이 좋습니다. 일반적으로 이 개수를 넘으면 스레드 사용의 이점이 줄어들기 때문입니다. SharePlex는 분석할 테이블 수보다 많은 스레드를 시작하지 않습니다.

이 옵션을 사용하는 경우 필수 명령 인수 뒤에 나타나야 합니다.

예:

sp_ctrl(sysA)> activate config sales threads=3

 

nolock

(Oracle에 유효) 이 옵션을 사용하면 복제에 추가되는 테이블을 잠그지 않고 활성화할 수 있습니다.

scn=scn_value

(Oracle에 유효) 이 옵션을 사용하면 리두 로그의 특정 SCN에서 복제를 시작하도록 구성을 활성화할 수 있습니다. 구성을 활성화하기 전에 다음을 수행합니다.

  • 이전에 활성 구성이 있었던 경우 소스 및 모든 타겟에서 ora_cleansp 유틸리티를 실행하여 환경을 정리 상태로 복원합니다. 자세한 내용은 Ora_cleansp를 참조하십시오.
  • show scn 명령을 사용하여 모든 Post 프로세스에서 게시된 마지막 트랜잭션의 SCN을 가져옵니다(명명된 큐를 사용하는 경우). activate config에는 해당 SCN 값 중 가장 낮은 값을 사용합니다.

이 옵션을 nolock 옵션과 함께 사용하지 마십시오.

예:

sp_ctrl> activate config myconfig scn=123456

seqno=log_sequence_number

(Oracle에 유효) 이 옵션을 사용하면 특정 리두 로그 시퀀스 번호에서 복제를 시작하도록 구성을 활성화할 수 있습니다.

이 옵션을 nolock 옵션과 함께 사용하지 마십시오.

  • 이전에 활성 구성이 있었던 경우 소스 및 모든 타겟에서 ora_cleansp 유틸리티를 실행하여 환경을 정리 상태로 복원합니다. 자세한 내용은 Ora_cleansp를 참조하십시오.

    예:

    activate config myconfig seqno=98765

  • 원격 옵션

    이러한 옵션을 사용하면 원격 시스템에서 명령을 실행하고 로그인 이름, 비밀번호, 포트 번호 또는 이러한 항목의 조합을 포함하는 명령을 스크립트할 수 있습니다.

    옵션 설명
    on host

    원격 시스템(현재 sp_ctrl 세션이 실행 중인 시스템이 아닌 것)에서 명령을 실행합니다. 원격 시스템에 대한 로그인 자격 증명을 묻는 메시지가 표시됩니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

    예: sp_ctrl(sysB)>status on SysA

    on host:portnumber

    원격 로그인 및 포트 번호를 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

    예: sp_ctrl(sysB)>status on SysA:8304

    on login/password@host

    원격 로그인, 비밀번호 및 호스트 이름을 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

    예:sp_ctrl(sysB)>status on john/spot5489@SysA

    on login/password@host:portnumber

    원격 로그인, 비밀번호, 호스트 이름 및 포트 번호를 제공해야 하는 경우 원격 시스템에서 명령을 실행합니다. 사용되는 경우 명령 구문의 마지막 구성 요소여야 합니다.

    예: sp_ctrl(sysB)>status on john/spot5489@SysA:8304

    The document was helpful.

    Select Rating

    I easily found the information I needed.

    Select Rating