지금 지원 담당자와 채팅
지원 담당자와 채팅

SharePlex 11.4 - 참조 안내서

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

SharePlex 명령 살펴보기

이 섹션에서는 제어하는 프로세스나 기능에 따라 그룹화된 모든 SharePlex 명령에 대한 개요를 제공합니다.

SharePlex 명령 권한 부여 수준 및 보안 그룹에 대한 자세한 내용은 SharePlex 관리 안내서를 참조하십시오.

 

구성 명령

구성 명령은 SharePlex 구성 파일 관리의 모든 측면을 제어합니다.

구성 명령 목록
명령 인증 수준 지원되는 타겟 설명
abort config 1 전체 데이터 게시 여부에 관계없이 지정된 구성 파일에 대한 복제를 즉시 종료합니다. 구성을 비활성화하고 큐와 프로세스를 삭제합니다.
activate config 1 전체 구성에 지정된 데이터의 복제를 시작합니다.
copy config 2 전체 편집하고 새 파일로 저장하기 위해 구성을 복제합니다.
create config 2 전체 복제할 객체에 대한 정보를 입력하는 새 구성 파일을 생성합니다.
deactivate config 1 전체 구성에 지정된 데이터의 복제를 정상적으로 종료하여 큐가 삭제되기 전에 큐의 데이터가 타겟 데이터베이스에 게시될 수 있도록 합니다.
edit config 2 전체 기본 텍스트 편집기를 사용하여 기존 구성 파일을 수정합니다.
list config 3 전체 소스 시스템의 모든 구성 파일(활성 및 비활성 모두)을 표시합니다.
purge config 1 전체 활성 구성에 의해 생성된 큐에서 데이터를 제거하지만 구성을 비활성화하거나 큐 자체를 제거하지는 않습니다.
rename config 2 전체 구성 파일에 다른 이름을 할당합니다.
verify config 3 전체 성공적인 활성화 및 복제를 보장하기 위해 구성의 객체가 유효한지와 구성이 올바르게 구성되었는지를 확인합니다.

정보 명령

정보 명령은 복제 환경에 대한 정보를 제공합니다. 복제 문제를 해결하려고 하거나 특정 프로세스 조건을 보려는 경우 이 명령을 사용합니다.

정보 명령 목록
명령 인증 수준 설명

show capture

3 튜닝 및 문제 해결에 사용할 Capture 프로세스에 대한 간략하거나 자세한 통계를 표시합니다.

show post

3 튜닝 및 문제 해결에 사용할 Post 프로세스에 대한 간략하거나 자세한 통계를 표시합니다.

job status

3 comparerepair 명령에 대한 현재 상태 및 내역을 표시합니다.

compare status

3 compare usingcompare 명령의 상태와 결과를 표시합니다.

repair status

2 repairrepair using 명령의 상태 및 결과를 표시합니다.

파티셔닝 명령

파티셔닝 명령은 수평으로 파티셔닝된 복제에 사용되는 파티션 scheme과 행 파티셔닝을 생성, 관리 및 표시합니다.

파티셔닝 명령 목록
명령 인증 수준 지원되는 타겟 설명
add partition 2

전체

파티션 scheme 및 행 파티션을 생성합니다.
drop partition 2

전체

파티션 scheme에서 행 파티션을 제거합니다.
drop partition scheme 2

전체

파티션 scheme을 제거합니다.
modify partition 2

전체

파티션 scheme의 행 파티션을 수정합니다.
View Partitions 3

전체

기존 파티션 scheme과 해당 행 파티션 사양을 표시합니다.

동기화 명령

동기화 명령은 데이터 동기화 측면을 제어합니다.

동기화 명령 목록

명령 인증 수준 지원되는 타겟 설명
Compare/compare using 2 PostgreSQL 소스 테이블과 타겟 테이블의 내용을 비교하여 동기화를 확인합니다.
Cancel 2 PostgreSQL 실행 중인 compare 또는 repair 명령 작업을 취소합니다.
Repair/repair using 2 PostgreSQL 소스와 타겟을 다시 동기화하기 위해 타겟 테이블에서 동기화 중단 행을 복원합니다.
flush 2 전체 소스 데이터와 타겟 데이터 간의 동기화 지점을 설정하기 위해 데이터 스트림에 마커를 배치한 다음, 해당 지점에서 Post 프로세스를 중지합니다.
reconcile 1 전체 타겟 시스템에 적용된 백업 또는 복사본의 결과를 소스 시스템의 사용자 트랜잭션과 동기화합니다.

유지 보수 명령

유지 보수 명령은 표시와 파일을 제어합니다.

유지 보수 명령 목록
명령 인증 수준 지원되는 타겟 설명
Clear History 2 PostgreSQL compare, compare usingrepair 명령 실행에 대한 작업 정보 및 소스 로그를 제거합니다.
Clear Status 2 PostgreSQL 상태 데이터베이스에서 경고 메시지를 제거합니다.

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

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

PostgreSQL의 Abort Config

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

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

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

사용

지원되는 소스:

PostgreSQL(온프레미스), Amazon RDS for PostgreSQL, Amazon Aurora for PostgreSQL, Azure Database for PostgreSQL Flexible Server, Google Cloud SQL for PostgreSQL

지원되는 타겟: PostgreSQL, Oracle, SQL Server, Kafka, Amazon RDS for PostgreSQL, Amazon Aurora for PostgreSQL, Azure Database for PostgreSQL Flexible Server, Google Cloud SQL for PostgreSQL
실행 대상: 소스 및 타겟 시스템
관련 명령: deactivate config, purge config

구문

기본 명령
abort config filename
구문 설명
구성 요소 설명
filename 

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

예: sp_ctrl(sysA)>abort config sales

PostgreSQL의 Activate Config

activate config 명령을 사용하여 구성을 활성화할 수 있습니다. 활성화 프로세스가 완료되는 즉시 복제가 시작됩니다.

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

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

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

참고:

  • 논리적 복제를 사용하여 구성을 활성화하는 동안 커밋되지 않은 트랜잭션이 PostgreSQL 인스턴스에서 실행되는 경우, 구성 활성화에 지연이 발생할 수 있습니다.

  • 파티셔닝된 테이블의 경우 사용자는 모든 하위 파티션에 대해 복제본 ID를 전체로 설정해야 합니다. 설정하지 않으면 verify config에 "해당 파티션의 복제본 ID가 전체로 설정되어 있지 않기 때문에 객체를 복제할 수 없습니다."라는 메시지가 표시됩니다. 활성화해도 복제에 파티셔닝된 테이블이 추가되지 않습니다. 활성화 로그에 전체로 설정된 복제본 ID가 없는 모든 하위 파티션 테이블 이름이 기록됩니다.

활성화 가이드라인

  • 구성을 활성화하려면 복제할 객체가 포함된 데이터베이스를 마운트하고 열어야 합니다. 활성화에 소요되는 시간은 구성된 객체의 크기, 개수. 구조에 따라 다릅니다.
  • 각 시스템의 PostgreSQL 서버당 하나의 구성을 활성화할 수 있습니다. 예를 들어 인스턴스 dbname1에 대해 ConfigA, ConfigB, ConfigC가 있는 경우 한 번에 하나만 활성화할 수 있습니다. 동일한 데이터 소스에 대해 다른 구성을 활성화하면 첫 번째 구성이 자동으로 비활성화됩니다.
  • 구성을 활성화하기 전에 verify config 명령을 사용하여 성공적인 활성화 및 복제에 대한 기본 요구 사항이 충족되었는지 확인합니다. 이 명령은 활성화 실패를 초래할 수 있는 잠재적인 문제를 경고합니다.

활성화 상태 및 결과 보기

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

활성화 결과를 보려면 show config 명령을 실행합니다.

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

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

활성화하기 전에 verify config 명령을 실행하지 않은 경우에는 지금 실행하여 발견되는 문제를 해결합니다. 그런 다음, 다시 활성화하십시오.

사용

지원되는 소스: PostgreSQL(pglsn 옵션은 물리적 복제에만 적용 가능), Amazon RDS for PostgreSQL, Amazon Aurora for PostgreSQL, Azure Database for PostgreSQL Flexible Server, Google Cloud SQL for PostgreSQL
지원되는 타겟: PostgreSQL, Oracle, SQL Server, Kafka, Amazon RDS for PostgreSQL, Amazon Aurora for PostgreSQL, Azure Database for PostgreSQL Flexible Server, Google Cloud SQL for PostgreSQL
인증 수준: 관리자(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 config filename pglsn=lsn_value
구문 설명
구성 요소 설명
filename 

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

예: sp_ctrl(sysA)>activate config sales

pglsn=lsn_number

이 옵션을 사용하면 WAL 파일의 특정 LSN에서 복제를 시작하도록 구성을 활성화할 수 있습니다. 구성을 활성화하기 전에 다음을 수행합니다.

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

show last_posted 명령을 사용하여 모든 Post 프로세스에서 게시된 마지막 트랜잭션의 LSN을 가져옵니다(명명된 큐를 사용하는 경우). activate config에는 해당 LSN 값 중 가장 낮은 값을 사용합니다.

예: sp_ctrl> activate config myconfig pglsn=6/555FAE0

참고: 논리적 복제에는 LSN을 사용한 활성화가 지원되지 않습니다. 데이터베이스가 동기화되지 않으면 사용자는 외부 유틸리티를 사용하여 데이터를 수동으로 동기화해야 합니다.

참고: 활성화가 성공적으로 완료되면 데이터베이스에 물리적 슬롯과 논리적 슬롯이 생성됩니다.

 

중요!

지속적인 복제의 일부인 Alter Table 컬럼 추가/삭제 작업을 수행할 때 따라야 할 단계입니다.

주의:

  • 테이블을 변경하는 동안에는 Capture 프로세스를 중지하지 마십시오.

  • 컬럼이 추가되거나 삭제되는 테이블에서는 DML 작업을 수행하면 안 됩니다.

아래 단계를 따릅니다.

  1. 테이블에 대해 DML을 수행하지 않고 Alter Table 컬럼 추가/삭제에 대한 쿼리를 실행합니다.

  2. 최신 세부 정보를 가져와서 모든 프로세스의 객체 캐시에 저장할 수 있도록 구성 파일을 다시 활성화합니다.

  3. 다시 활성화가 완료되면 테이블에서 DML 작업을 수행할 수 있습니다.

지속적인 복제의 일부인 Alter Table 파티션 추가/삭제 작업을 수행할 때 따라야 할 단계입니다.

주의:

  • 테이블을 변경하는 동안에는 Capture 프로세스를 중지하지 마십시오(다시 활성화가 진행 중인 경우에만 적용 가능).

  • 파티션이 추가되거나 삭제되는 테이블에서는 DML 작업을 수행하면 안 됩니다.

아래 단계를 따릅니다.

  1. 테이블에 대해 DML을 수행하지 않고 Alter Table 파티션 추가/삭제에 대한 쿼리를 실행합니다.

  2. Capture 프로세스에서 최신 파티션 세부 정보를 가져오고 사용하도록 구성 파일을 다시 활성화하거나 Capture 프로세스를 재시작합니다.

  3. 다시 활성화나 Capture 프로세스가 완료되면 테이블에서 DML 작업을 수행할 수 있습니다.

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택