Ctrlk
Docs Home
For the complete documentation index, see llms.txt. This page is also available as Markdown.
PDF로 내보내기

Discard

DML DISCARD

ProSync가 동기화 과정 속에 DML을 Target DB에 반영 중 에러가 발생할 수 있다. 일반적인 경우에는 ProSync가 해당 DML에 대한 반영을 성공할 때 까지 재시도하게 된다.

해당 기능을 사용하면 특정한 에러에 대해 재시도하는 대신 해당 DML에 대한 반영을 생략하고 이후의 동기화를 진행하도록 설정할 수 있다.

또한 DISCARD 기능이 발생한 이력을 기록하는 Discard file 을 작성할 수 있다.

해당 기능을 사용하기 위해선 config 파일에 다음과 같은 Parameter를 설정해야 한다.

DISCARD_YN=[Y|N]
DISCARD_EC=2 10007 8033
DISCARD_FILE_YN=[Y|N]

DISCARD_FILE_DIR=/directory/to/save/file
DISCARD_FILE_SIZE=200M
DISCARD_BACKUP_DIR=/directory/to/save/backup/file
DISCARD_BACKUP_SIZE=10G
파라미터 이름
설명

DISCARD_YN

동기화 중 에러가 발생하는 경우에 스킵할지 여부를 설정한다. Y 상태에선 발생한 에러가 DISCARD_EC 에 작성된 에러코드에 속해있는 경우 재시도를 생략한다.

  • 유형: Y/N

  • 범위: Y/N

  • 기본값: N

DISCARD_EC

재시도를 하지 않고 건너뛰고자 하는 에러코드를 입력한다.

  • 유형: 에러코드

  • 범위: 최대 256개

  • 기본값:

DISCARD_FILE_YN

DISCARD 동작이 발생했을 때 해당 내용을 discard 파일에 남기는 기능을 활성화 하는 파라미터이다.

  • 유형: Y/N, dynamic

  • 범위: Y/N

  • 기본값: N

DISCARD_FILE_DIR

discard file의 저장 위치를 지정하는 파라미터.

  • 유형: 디렉토리

  • 범위: -

  • 기본값: (LOG_DIR과 같은 디렉토리)

DISCARD_FILE_SIZE

discard 파일의 최대 크기를 지정하는 파라미터.

  • 유형: int32, dynamic

  • 범위: 1M - 1G

  • 기본값: 100M

DISCARD_BACKUP_DIR

discard 파일의 크기가 설정한 최대 크기를 초과하게 되면 생성하는 백업파일의 위치를 지정하는 파라미터.

  • 유형: 디렉토리

  • 범위: -

  • 기본값: (LOG_BACKUP_DIR과 같은 디렉토리)

DISCARD_BACKUP_SIZE

backup 디렉토리의 최대 크기를 지정하는 파라미터.

  • 유형: uint64, dynamic

  • 범위: 0 - 128G

  • 기본값: 0(무제한)

주의

  • DISCARD 기능을 활성화하면 batch apply 기능이 사용 불가능하다.

  • DML을 반영할 때 발생하는 에러에 대해서 만 DISCARD 기능을 지원한다.

  • (12032)Deadlock detected. 에러는 DISCARD 기능을 지원하지 않는다.

  • SAM_BIND_VALUE=Y 를 사용하면, discard log에 실패한 query의 value 값이 함께 저장된다.

변환 실패 DISCARD

ProSync가 Source DB의 값을 Target DB의 데이터 타입으로 변환하지 못하면(지원하지 않는 timestamp 지역 정보 등) 해당 DML은 반영에 실패하고, 일반적인 경우에는 성공할 때까지 재시도하게 된다.

DISCARD_CAST_ERR=Y로 설정하면 변환에 실패한 DML을 재시도하지 않고 건너뛴 뒤 이후의 동기화를 진행한다. 건너뛴 DML은 Target DB에 반영되지 않는다.

파라미터 이름
설명

DISCARD_CAST_ERR

데이터 변환에 실패한 DML을 재시도하지 않고 건너뛸지 여부를 설정한다. DISCARD_YN, DISCARD_EC 설정과 무관하게 동작한다.

  • 유형: Y/N

  • 범위: Y/N

  • 기본값: N

주의

  • 건너뛴 DML은 Apply 로그에 skip insert stmt because of cast error.(xid: <xid>) 형태의 경고로 남는다. UPDATE, DELETE도 같은 형식으로 남는다.

  • DISCARD_FILE_YN=Y이면 discard 파일에 cast error discarded와 함께 해당 DML의 xid, seqno, tsn, obj_id가 기록된다. SQL 문은 기록되지 않는다.

DDL DISCARD

DDL도 DML과 마찬가지로 Target DB에 반영 중 에러가 발생할 수 있다. 일반적인 경우에는 ProSync가 해당 DDL에 대한 반영을 성공할 때 까지 재시도하게 된다.

해당 기능을 사용하면 재시도하는 대신 해당 DDL에 대한 반영을 생략하고 이후의 동기화를 진행하도록 설정할 수 있다.

주의

단, TABLE 관련 DDL은 해당 기능을 사용하더라도 실패하는 경우 생략할 수 없다.

또한 DISCARD 기능이 발생한 이력을 기록하는 Discard file 을 작성할 수 있다.

해당 기능을 사용하기 위해선 config 파일에 다음과 같은 Parameter를 설정해야 한다.

파라미터 이름
설명

DISCARD_DDL_YN

동기화 중 에러가 발생하는 경우에 스킵할지 여부를 설정한다.

  • 유형: Y/N

  • 범위: Y/N

  • 기본값: N

DISCARD_DDL_FILE_YN

DISCARD 동작이 발생했을 때 해당 내용을 discard 파일에 남기는 기능을 활성화 하는 파라미터이다.

  • 유형: Y/N

  • 범위: Y/N

  • 기본값: N

DISCARD_DDL_FILE_DIR

discard file의 저장 위치를 지정하는 파라미터.

  • 유형: 디렉토리

  • 범위: -

  • 기본값: $PRS_HOME/var/<인스턴스명>/ddl_err

DISCARD_DDL_FILE_SIZE

discard 파일의 최대 크기를 지정하는 파라미터.

  • 유형: int32

  • 범위: 1M - 1G

  • 기본값: 100M

DISCARD_DDL_BACKUP_DIR

discard 파일의 크기가 설정한 최대 크기를 초과하게 되면 생성하는 백업파일의 위치를 지정하는 파라미터.

  • 유형: 디렉토리

  • 범위: -

  • 기본값: $PRS_HOME/var/<인스턴스명>/ddl_err/backup

DISCARD_DDL_BACKUP_SIZE

backup 디렉토리의 최대 크기를 지정하는 파라미터.

  • 유형: uint64

  • 범위: 0 - 128G

  • 기본값: 0

이전Data Conflict Rule (DCR)
다음History