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

SharePlex 11.4 - 참조 안내서

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

Log 매개변수

이러한 매개변수는 SharePlex 로그의 속성을 제어하는 데 사용됩니다.

SP_SLG_LOG_MAXSIZE

이 매개변수는 SharePlex 이벤트 및 추적 로그의 크기를 제어합니다.

파일이 최대 크기에 도달하면 로그에 따라 다음과 같은 경우가 발생합니다.

  • 이벤트 로그의 이름이 event_log_n으로 변경되었습니다. 여기서, n은 파일 시퀀스의 다음 번호이고 새 파일이 활성 이벤트 로그로 생성됩니다. 예를 들어 첫 번째 이벤트 로그가 최대 크기에 도달하면 event_log_0000000001로 이름이 변경된 후 새 파일이 활성 로그로 열립니다. 해당 파일이 최대 크기에 도달하면 event_log_0000000002 등으로 이름이 변경됩니다.
  • 추적 로그가 잘립니다. 이 로그에 작성하기 전에 SharePlex가 해당 크기를 확인합니다. 크기가 이 매개변수의 값보다 큰 경우 SharePlex는 파일에 작성하기 전에 파일을 자릅니다.

이 매개변수를 늘리기 전에 새 파일 크기를 수용할 수 있는 충분한 디스크 공간이 있는지 확인하십시오.

 

기본값: 500MB

유효한 값의 범위: 1MB 단위로 1~2048MB

적용 시기: SharePlex가 재시작될 때

SNMP 매개변수

이러한 매개변수는 SharePlex SNMP 지원의 속성을 제어하는 데 사용됩니다.

SP_SLG_SNMP_ACTIVE

이 매개변수는 SNMP 지원을 활성화하거나 비활성화하는 플래그입니다.

SharePlexSharePlex 복제가 지원되는 모든 Unix 및 Linux 플랫폼에서 SNMP(Simple Network Management Protocol)에 대한 에이전트 지원을 제공합니다.

참고: SharePlex는 SNMP에 대해 에이전트 지원만 제공하며 SNMP 트랩만 보냅니다. SharePlex는 트랩을 차단하기 위한 SNMP 신호 데몬(SNMP 관리자)을 제공하지 SharePlex 않습니다. SharePlex SNMP 기능은 SNMP 신호를 관리하기 위한 NMS(Network Management Station)가 있는 경우에만 사용하십시오. SharePlex SNMP 에이전트의 이름은 snmptrap이며 SharePlex product 디렉토리의 bin 하위 디렉토리에 SharePlex와 함께 설치됩니다. 이 프로그램을 실행하지 마십시오.

 

기본값: 0(설정 꺼짐)

유효한 값의 범위: 0 또는 1(설정 켜짐)

적용 시기: SharePlex가 재시작될 때

SNMP 에이전트 매개변수

다음 매개변수는 NMS와 통신하도록 SNMP 에이전트를 구성합니다. SP_SLG_SNMP_ACTIVE 매개변수가 활성화된 경우 각 매개변수에는 값이 있어야 합니다.

매개변수
SP_SLG_SNMP_HOST 트랩이 전송될 시스템(호스트)의 이름
SP_SLG_SNMP_COMMUNITY 커뮤니티 보안 문자열
SP_SLG_SNMP_MJR_ERRNUM 트랩에서 사용할 주요 오류 번호
SP_SLG_SNMP_MNR_ERRNUM 트랩에서 사용할 사소한 오류 번호

사용자 지정 MIB 매개변수

다음 매개변수는 사용자 지정 MIB에 필요한 정보를 지정합니다.

매개변수
SP_SLG_SNMP_ENTERPRISE_OID 트랩과 함께 전송할 엔터프라이즈 객체 식별자입니다. 기본값은 1.3.6.1.4.1.3.1.1입니다.
SP_SLG_SNMP_TRAP_OID 트랩에 바인딩할 사용자 지정 객체 식별자입니다. 기본값은 1.3.6.1.2.1.1.1.0입니다.
SP_SLG_SNMP_TRAP_PROGRAM 트랩 프로그램의 이름입니다. 기본값은 iwsnmptrap입니다.

SNMP 트랩 매개변수

다음 매개변수는 특정 복제 이벤트에 대한 트랩을 보내도록 SNMP 에이전트를 구성합니다. 이벤트에 대한 메시지 또는 오류 텍스트는 트랩에 포함되며 이벤트 로그에 나타나는 오류와 동일합니다.

이벤트에 대해 SNMP 트랩을 활성화하려면 해당 매개변수를 값 1로 설정합니다. 기본적으로 모든 트랩은 비활성화되어 있습니다(매개변수 값 0).

매개변수 SharePlex 이벤트
SP_SLG_SNMP_INT_ERROR SharePlex 논리 오류 및 프로세스 종료를 초래하는 오류
SP_SLG_SNMP_SYS_ERROR SharePlex에서 발생한 시스템 관련 오류
SP_SLG_SNMP_ERROR 기타 SharePlex 오류
SP_SLG_SNMP_OUT_OF_SYNC 복제가 동기화 중단 상태임
SP_SLG_SNMP_STARTUP SharePlex 시작됨
SP_SLG_SNMP_SHUTDOWN SharePlex 종료됨
SP_SLG_SNMP_LAUNCH SharePlex 프로세스가 시작됨
SP_SLG_SNMP_EXIT SharePlex 프로세스가 중지됨

System 매개변수

이러한 매개변수는 시스템 관련 SharePlex 속성을 제어합니다.

SP_SYS_HOST_NAME

이 매개변수는 대체 네트워크 인터페이스가 있는 클러스터 및 시스템과 같이 하나의 SharePlex variable-data 디렉토리가 여러 노드 간에 공유되는 환경에서 사용하기 위한 것입니다. 프로세스 중 하나가 이름 조회를 실행하면 로컬 시스템 이름을 대체하여 SharePlex에 올바른 논리적 호스트 이름(글로벌 클러스터 패키지 이름)을 제공합니다. 이 매개변수로 설정된 이름을 사용하면 SharePlex가 장애 조치 중에 올바르게 마이그레이션할 수 있습니다.

  • 구성을 활성화하기 전에 기본 노드와 모든 보조(대체) 노드에 SP_SYS_HOST_NAME을 설정하고 장애 조치되는 패키지에 이를 구성합니다.
  • Unix 및 Linux 시스템의 .profiles 파일에서 이 매개변수를 설정합니다.
  • Unix 및 Linux 시스템에서는 공유 variable-data 디렉토리의 sp_ctrl 을 통해 이 매개변수를 설정합니다. sp_ctrl을 통해 SP_SYS_HOST_NAME을 설정하면 장애 조치의 일부인 variable-data 디렉토리에 영구적으로 설정되며, 복제를 시작할 준비가 되었을 때 sp_cop이 시작되기 전에 패키지 이름을 내보냅니다.
  • 클러스터 내의 시스템에만 SP_SYS_HOST_NAME을 설정합니다.

클러스터 시스템에 영향을 미치는 시스템에서 sp_ctrl 명령을 실행하는 경우 [on host] 옵션에서 호스트로 SP_SYS_HOST_NAME으로 설정된 이름을 사용하거나 host 명령을 사용하여 해당 이름을 sp_ctrl의 기본값으로 설정합니다.

클러스터된 시스템에서 SharePlex 설치 및 설정 안내서 설정 방법에 대한 자세한 내용은 SharePlex를 참조하십시오.

 

기본값: 없음

유효한 값의 범위: 패키지 이름의 문자열

적용 시기: SharePlex가 재시작될 때

 

SP_SYS_IN_SYNC

이 매개변수는 SharePlex가 NULL 값이 허용되는 키 컬럼이 있는 테이블을 복제하는 방식을 제어합니다.

  • 이 매개변수가 기본값인 0(설정 꺼짐)으로 설정되면 SharePlex는 해당 컬럼에 NULL이 포함되어 있는지 여부에 관계없이 키를 사용하여 타겟 시스템에서 행을 찾습니다. 행의 키에 NULL이 포함되어 있으면 UPDATE 및 DELETE에 대해 동기화 중단 상태가 발생할 수 있습니다. 행의 고유성을 보장할 수는 없으며 SharePlex가 타겟 시스템에서 잘못된 행을 변경할 수 있습니다.
  • 이 매개변수가 1(설정 켜짐)로 설정되면 SharePlex에 키를 사용하도록 지시하지만 이는 행의 키에 NULL이 없는 경우에만 해당됩니다. 키에 NULL 값이 포함된 경우 SharePlex는 행의 모든 컬럼을 시뮬레이션된 키로 사용하여 올바른 타겟 행을 찾도록 합니다.

애플리케이션의 키에 NULL이 포함되지 않는다는 것을 알고 있는 경우(NULL이 선언되었음에도 불구하고) 이 매개변수의 설정을 끕니다. 사용하는 추가된 논리로 인해 더 많은 오버헤드가 발생하기 때문입니다. 소스 시스템에서 이 매개변수를 설정하고 구성을 활성화하기 전에 설정하십시오.

 

기본값: 0(설정 꺼짐)

유효한 값의 범위: 0 또는 1(플래그)

적용 시기: Capture 및 Read가 재시작될 때

SP_SYS_JOB_HISTORY_RETENTION

이 매개변수는 job status 및/또는 report 명령을 표시하기 위해 지난 compare, compare using, repair, copy 또는 append 작업에 대한 정보를 보관할 기간(일)을 정의합니다.

 

기본값: 90일

유효한 값의 범위: 0 또는 양의 정수

적용 시기: 즉시

SP_SYS_JOB_HISTORY_SIZE

이 매개변수는 SharePlex variable-data 디렉토리의 data 하위 디렉토리에 있는 작업 상태 데이터베이스의 크기를 제어합니다. 지정된 값은 데이터베이스에 허용되는 최대 크기(KB)를 결정합니다. 데이터베이스 크기가 지정된 값을 초과하면 가장 오래된 항목부터 삭제됩니다. 기본값은 0이며 무제한으로 지정됩니다.

 

기본값: 0(무제한)

유효한 값의 범위: 0 또는 양의 정수

적용 시기: 즉시

 

SP_SYS_SUSPEND_ON_ERROR

이 매개변수는 시스템 또는 내부 SharePlex 오류가 발생할 때 Capture 또는 Post 프로세스를 중지할지 여부를 제어합니다. 기본값 1은 오류가 있을 때 프로세스를 중지하도록 지시합니다. 0으로 설정하면 프로세스가 계속 진행되지만 이벤트 로그에 메시지가 생성됩니다.

중요: Capture가 너무 오랫동안 중지되면 Oracle과의 속도가 느려지고 리두 로그가 래핑될 수 있습니다. 이 경우 Capture는 아카이브 로그를 읽지만 아카이브 로그를 사용할 수 없게 되면 데이터를 재동기화해야 합니다.

 

기본값: 1(오류 발생 시 중지)

유효한 값의 범위: 0 또는 1(플래그)

적용 시기: 즉시

SP_SYS_TARGET_COMPATIBILITY

이 매개변수를 사용하면 서로 다른 SharePlex 버전 간의 호환성을 유지하여 보다 원활한 마이그레이션 및 업그레이드가 가능합니다. SharePlex는 새로운 사용자 요구 사항을 충족하기 위해 계속 발전하고 있기 때문에 새 버전에 추가된 기능이 이전 버전과 항상 호환되는 것은 아닙니다. 이 매개변수를 사용하면 소스 시스템의 SharePlex 상위 버전에서 타겟 시스템의 하위 버전으로 복제가 가능합니다.

기본적으로 이 매개변수는 설치된 SharePlex 소프트웨어 버전으로 설정됩니다.

  • 소스 시스템의 상위 버전에서 타겟의 SharePlex 하위 버전으로 복제하는 경우 이 매개변수를 타겟의 SharePlex 버전과 가장 근접하게 일치하는 값으로 설정합니다. 예를 들어 SharePlex가 소스의 버전 8.6.3이고 타겟의 버전 8.6.2인 경우 이 매개변수를 8.6.2로 설정합니다.
  • 동일한 버전 간에 복제하는 경우 두 시스템 모두에서 이 매개변수 세트를 기본값으로 둡니다.

 

기본값: 설치된 SharePlex 소프트웨어의 버전

유효한 값의 범위: SharePlex 6.0.0부터 현재 버전까지의 릴리스 버전, 최대 3자리 숫자(예: 8.6.3)

적용 시기: Capture가 재시작될 때

 

SP_SYS_VAR_FULL

이 매개변수는 SharePlex variable-data 디렉토리가 설치된 디스크의 사용 가능한 공간에 대한 임계값을 설정합니다. 이는 사용 가능한 디스크 공간을 큐가 초과하는 것을 방지합니다. Capture, Read 또는 Import로 처리 중인 작업으로 인해 사용 가능한 디스크 공간이 이 매개변수에 설정된 값 아래로 떨어지면 프로세스가 중지됩니다. 사용 가능한 디스크 공간이 SP_SYS_VAR_OK 매개변수로 설정된 임계값에 도달하면 처리가 재개됩니다.

 

기본값: 30MB

유효한 값의 범위: SP_SYS_VAR_OK 값보다 큰 양의 정수

적용 시기: 즉시

SP_SYS_VAR_OK

이 매개변수는 SP_SYS_VAR_FULL 값에 도달했기 때문에 Capture, Read 또는 Import가 중지된 후 처리를 재개하는 사용 가능한 디스크 공간의 양을 설정합니다.

 

기본값: 50MB

유효한 값의 범위: 양의 정수

적용 시기: 즉시

Compare/Repair 매개변수

이러한 매개변수는 SharePlex compare 명령의 속성을 제어합니다.

SP_DEQ_IGNORE_ORACLE_ERROR_NUM

이 매개변수를 사용하면 사용자는 무시할 Oracle 오류 번호를 지정할 수 있습니다. 지정된 오류 번호는 최대 500회까지 무시됩니다. 이 매개변수는 주로 디버깅 목적으로 사용되며 Repair 또는 Repair1 옵션과 함께 사용하면 안 됩니다.

 

기본값: 0(없음)

유효한 값의 범위: 유효한 Oracle 오류 번호(예: 1406)

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_IP_MAPPING

이 매개변수는 소스 시스템과 타겟 시스템 간에 NAT(Network Address Translation)가 구현될 때 IP 주소를 매핑합니다. NAT가 구현되면 소스 시스템의 타겟 IP 주소(예: 192.168.32.10)와 타겟 시스템의 IP 주소(예: 213.18.123.103)가 다를 수 있으므로 comparerepair 명령이 실행되면 혼동이 발생할 수 있습니다. 타겟 시스템에서 SP_DEQ_IP_MAPPING 매개변수를 설정하면 IP 주소 192.168.32.10은 IP 주소 213.18.123.103과 동일한 것으로 간주되므로 Post가 비교 메시지를 처리하고 비교 sp_declt 클라이언트 프로세스가 비교 프로세스를 완료할 수 있습니다.

다음 예와 같이 타겟 시스템에서 SP_DEQ_IP_MAPPING 매개변수를 설정합니다.

sp_ctrl> set param SP_DEQ_IP_MAPPING "192.168.32.10:213.18.123.103"

참고: 소스 및 타겟 시스템에 적절한 IP 주소를 사용하십시오. 위에 나열된 IP 주소는 예시일 뿐입니다.

또한 SP_DEQ_IP_MAPPING 매개변수는 다음 예와 같이 쉼표로 구분되는 여러 매핑을 허용합니다.

sp_ctrl> set param SP_DEQ_IP_MAPPING "192.168.32.10:213.18.123.103,10.2.3.4:50.64.70.88"

 

기본값: 없음

유효한 값의 범위: 쉼표로 구분된 하나 이상의 유효한 IP 주소

적용 시기: 다음 비교 명령이 실행될 때

 

SP_DEQ_LOG_FILESIZE

이 매개변수는 비교 서버와 비교 클라이언트에서 생성되는 SQL 로그 파일의 크기를 제어합니다.

 

기본값: 50MB

유효한 값의 범위: 0보다 큰 크기

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_MALLOC

이 매개변수는 임포트 배치 크기를 제어합니다. 배치 크기는 SharePlex가 비교를 위해 한 번에 선택하는 행 수를 제어합니다. 배치 크기가 크면 처리 속도가 빨라지지만 더 많은 메모리가 필요합니다. 사용할 비교 스레드 수로 값을 균등하게 나눈 다음, 합산된 모든 컬럼의 크기를 기준으로 배치 크기를 다시 계산합니다.

 

기본값: 500(MB)

유효한 값의 범위: 50~32,767(MB)

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_PARALLELISM

이 매개변수는 select 문 DOP(Degree of Parallelism) 힌트를 관리합니다.

SP_DEQ_PARRALLISM이 0으로 설정되면 병렬 힌트가 사용되지 않습니다. 명령줄에서 사용자가 제공한 힌트의 우선순위가 더 높습니다.

 

기본값: 2

유효한 값의 범위: 0~500

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_PARTIAL_REPAIR_CLR_OOS

이 매개변수를 사용하면 WHERE 절 또는 Oracle [하위] 파티션 이름(수평으로 파티셔닝된 복제 포함)로 지정된 행 하위 집합과 같이 해당 테이블의 행 하위 집합만 비교-복원한 후 repair 프로세스가 테이블에 대한 statusdb에서 동기화 중단 메시지를 지울 수 있습니다.

중요! 타겟 시스템에서 이 매개변수를 설정합니다. 소스 시스템에는 영향을 미치지 않습니다.

이 매개변수는 다음과 같이 작동합니다.

  • 값 0(비활성화, 기본값): 동기화 중단 메시지는 행의 하위 집합을 비교 및 복원한 후 statusdb에 보관됩니다. 선택 기준에 따라 적격하지 않은 동기화 중단 행이 있을 수 있음을 사용자가 알 수 있도록 메시지가 보관됩니다.
  • 값 1(활성화): 행의 하위 집합을 비교 및 복원한 후 동기화 중단 메시지가 지워집니다. 하위 집합의 행이 테이블에서 동기화 중단 상태인 유일한 행이라는 것을 알고 있는 경우에만 이 매개변수를 활성화합니다.

참고: 테이블에서 동기화 중단 상태인 모든 행이 복원되었는지 확인하려면 전체 테이블에 대해 compare-repair를 실행합니다.

 

기본값: 0(비활성화)

유효한 값의 범위: 0 또는 1(플래그)

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_PART_TABLE_UPDATE

이 매개변수는 파티셔닝된 Oracle 타겟 테이블에 대해 실행될 때 repair using 및 repair 명령의 동작에 영향을 줍니다.

  • 이 매개변수가 기본값인 0으로 설정되면 파티셔닝된 Oracle 타겟 테이블은 INSERT 및 DELETE만 사용하여 복원됩니다. UPDATE가 필요한 복원은 DELETE 다음에 INSERT로 변환되어 UPDATE로 인해 행의 파티션이 변경될 수 있고 테이블에 대해 행 이동이 활성 화되지 않은 경우에 오류를 방지합니다.
  • 이 매개변수가 1로 설정되면 파티셔닝된 Oracle 테이블은 적절하게 INSERT, UPDATE 및 DELETE를 사용하여 복원됩니다. UPDATE로 인해 행이 타겟 테이블의 파티션을 변경되지 않는다는 것을 알고 있거나 타겟 테이블에 대해 행 이동이 활성화된 경우에만 이 모드를 사용합니다.

타겟 시스템에서 이 매개변수를 설정합니다.

 

기본값: 0(UPDATE로 복원하지 않음)

유효한 값의 범위: 0 또는 1(플래그)

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_READ_BUFFER_SIZE

이 매개변수는 compare/repair 작업 중에 LOB 및 LONG 컬럼에만 적용됩니다. 해당 컬럼을 비교 및 복원할 때 가져온 LOB 또는 LONG 데이터를 보유하는 버퍼의 크기를 조정합니다. 매개변수 값은 사용 가능한 시스템 메모리와 데이터 크기에 따라 조정되어야 합니다.

 

기본값: 1MB

유효한 값의 범위: 1에서 100 사이의 정수(MB 단위의 값)

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_ROW_LOCK_THRESHOLD

이 매개변수는 repair 프로세스가 복원 수행 시 전체 타겟 테이블을 잠그는지 아니면 동기화 중단 행만 잠그는지 여부를 제어합니다. 동기화 중단 행 수가 지정된 값보다 적으면 복원을 위해 동기화 중단 행만 잠깁니다. 이렇게 하면 Post 프로세스가 테이블의 다른 행에 계속 게시할 수 있습니다. 소스 테이블의 동기화 중단 행 수가 이 값보다 적으면 잠깁니다. 적지 않으면 읽기 일관성 값을 보장하기 위해 테이블에 대한 간단한 잠금이 수행됩니다.

 

기본값: 동기화 중단 행 1,000개

유효한 값의 범위: 양의 정수

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_SKIP_LOB

이 매개변수는 compare/repair 처리에 LOB가 포함되는지 여부를 결정합니다.

  • 매개변수가 기본값인 0으로 설정되면 Compare 프로세스의 처리에 LOB가 포함됩니다.
  • 매개변수를 1로 설정하면 LOB가 아닌 컬럼만 비교 및 복원됩니다. LOB가 삽입된 후 수정되지 않으면 이 매개변수를 1로 설정하여 처리 속도를 높일 수 있습니다.

소스 시스템에서 이 매개변수를 설정합니다.

 

기본값: 0

유효한 값의 범위: 0 또는 1(플래그)

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_THREADS

이 매개변수는 소스 시스템의 compare 명령에 사용되는 처리 스레드 수를 제어합니다. 각 스레드는 타겟 시스템에 sp_declt 프로세스를 생성합니다.

기본값인 2개의 스레드가 작동 중인 시스템에 가장 적합한 수인 것이 입증되었지만 최대 15개의 스레드를 사용하면 성능을 향상시킬 수 있습니다. 스레드가 너무 많으면 이점이 줄어듭니다. 특히 큰 테이블을 동시에 비교할 경우 더욱 그렇습니다.

스레드 수 값은 비교할 테이블 수와 관계가 없으며 SharePlex는 비교할 테이블 수보다 더 많은 스레드를 생성하지 않습니다. 시스템에 프로세서가 하나만 있는 경우 이 매개변수 값을 1로 설정합니다. 시스템의 프로세서 수보다 크게 설정하지 마십시오.

 

기본값: 스레드 2개

유효한 값의 범위: 1~15

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_TIMEOUT

이 매개변수는 compare와 repair 명령에 대한 연결 시간 초과를 제어합니다. sp_desvr 프로세스는 복제 큐를 사용하여 타겟 시스템의 sp_declt 프로세스를 인스턴스화하기 때문에 큐의 모든 이전 메시지가 처리될 때까지 sp_declt 프로세스를 시작할 수 없습니다. 지연 시간이 이 매개변수에 지정된 시간 초과보다 길면 sp_desvr이 종료되고 오류가 반환됩니다. 큐가 30분 이상 백로그된 것을 알고 있는 경우에는 필요에 따라 이 매개변수를 늘릴 수 있습니다.

 

기본값: 1,800초(30분)

유효한 값의 범위: 121초 이상

적용 시기: 다음 비교 시 즉시 가능

SP_DEQ_USE_SP_CKSUM

이 매개변수는 Oracle ora_hash()가 비교에 사용되는지 여부를 결정합니다.

  • 이 매개변수를 기본값인 0으로 설정하면 Oracle ora_hash()가 사용됩니다.
  • 이 매개변수를 1로 설정하면 SharePlex 내부 체크섬 방법이 사용됩니다.

 

기본값: 0

유효한 값의 범위: 0 또는 1

적용 시기: 다음 비교 시 즉시 가능

The document was helpful.

평가 결과 선택

I easily found the information I needed.

평가 결과 선택