> For the complete documentation index, see [llms.txt](https://docs.tibero.com/technical-guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/technical-guides/topics/migration/sql/parameter-configuration.md). # DB 파라미터 지정 데이터베이스 파라미터 지정 과정을 예시와 함께 설명합니다. 파라미터를 지정하는 컨트롤 파일은 기본으로 migrator.properties 파일로 지정됩니다. ## 파라미터 예시 (migrator.properties 파일에 설정) ```html SOURCE_TYPE=ORACLE SOURCE_DRIVER=oracle.jdbc.OracleDriver SOURCE_URL=jdbc:oracle:thin:@localhost:1539:orcl SOURCE_USER=sys SOURCE_PASSWORD=oracle SOURCE_LOGIN_AS=sysdba SOURCE_SCHEMA=SCOTT SOURCE_TABLE=t1 SOURCE_TABLE_DEDUPLICATE=N TARGET_TYPE=DEFAULT TARGET_DRIVER=com.m.internal.jdbc.MInternalDriver TARGET_URL=jdbc:internal:thin:@localhost:59166:tibero TARGET_USER=tibero TARGET_PASSWORD=tmax TARGET_SCHEMA=TIBERO TARGET_TABLE=t1 EXTRACT_PARALLEL=N EXTRACT_PARALLEL_RANGE_BY_ROWID=N EXTRACT_THREAD_COUNT=1 SELECT_TSN=17322052 SELECT_CONDITION= c1>1 SELECT_FETCH_SIZE=1024 SELECT_PARTITION=part1 SELECT_SUBPARTITION=subpar1 SELECT_AS_BYTE=N DB_FILE_MULTIBLOCK_READ_COUNT=-1 OPTIMIZER_HINT=/*+ FULL(t) PARALLEL(t, 4) */ USE_PARALLEL_HINT=N USE_OBJECT_PARALLEL_HINT=N PARALLEL_HINT_CNT=-1 INSERT_METHOD=dpl COMMIT_SIZE=-1 INDEX_DISABLE=N INSERT_BATCH=Y BATCH_THRESHOLD=128 DPL_LOG_UNIT=500 INSERT_PARALLEL=N INSERT_THREAD_COUNT=1 INSERT_PARTITION= INSERT_ZERO_LENGTH_STRING_AS_NULL=Y TRIM= BYTEA_TO_BLOB=N TEXT_TO_CLOB=N MONITORING_LOG=N MONITORING_LOG_UNIT=500 MONITORING_SESS_STAT=CPU used by this session;parse time cpu;parse count(hard) CHECK_COLUMN_METADATA=N ROW_QUEUE_TYPE=ARRAY(10240) VERIFY_TABLE=N VERIFY_TABLE_NAME=VERIFY_TBL LOG_LEVEL=INFO LOG_FILE_NAME=tableMigrator.log LOG_DIR= ``` 각 파라미터의 설명은 아래와 같습니다. ### Source 접속 정보 관련
파라미터설명
SOURCE_TYPESource DB의 타입을 설정하는 파라미터

– ORACLE(기본값) : Source DB가 Oracle일 때 설정하며 SOURCE_LOGIN_AS 파라미터의 설정이 필요

– GENERIC : Source DB가 일반 DB일 때 설정한다. 특정 벤더별 API를 사용하지 않고 표준 JDBC API만을 이용하여 동작하며 SOURCE_DRIVER 파라미터의 설정이 필요

– DEFAULT : Source DB가 Tibero일 때 설정
SOURCE_DRIVERSource DB에 접속할 때 사용하는 JDBC Driver 클래스를 설정하는 파라미터로 SOURCE_TYPE=GENERIC일 경우 설정이 필요

– Oracle(기본값) : oracle.jdbc.OracleDriver
– MSSQL : com.microsoft.sqlserver.jdbc.SQLServerDriver
– DB2 : com.ibm.db2.jcc.DB2Driver
– MYSQL : com.mysql.jdbc.Driver
– PostgreSQL : org.postgresql.Driver
– Sybase ASE : com.sybase.jdbc3.jdbc.SybDriver
– Informix : com.informix.jdbc.IfxDriver
SOURCE_URLSource DB의 JDBC 연결 URL을 설정하는 파라미터

– Oracle(기본값) : jdbc:oracle:thin:@localhost:1521:orcl
– MSSQL : jdbc:sqlserver://127.0.0.1:1433;databaseName=master
– DB2 : jdbc:db2://127.0.0.1:50000/logdb
– MYSQL : jdbc:mysql://127.0.0.1:3306/mysql
– PostgreSQL : jdbc:postgresql://127.0.0.1:5432/postgres
– Sybase ASE : jdbc:sybase:Tds:127.0.0.1:7100?ServiceName=sybase
– Informix : jdbc:informix-sqli://127.0.0.1:18220/informix:INFORMIXSERVER=informix
SOURCE_USER

Source DB에 로그인하는 사용자 이름을 설정하는 파라미터

기본적으로 대문자로 인식되며 큰따옴표를 통해 대소문자 구분이 가능

(기본값 : sys)

SOURCE_PASSWORDSource DB에 로그인 하는 사용자 패스워드를 설정하는 파라미터

(기본값 : oracle)
SOURCE_LOGIN_ASOracle에 접속할 때 권한을 설정하는 파라미터로 SOURCE_TYPE=ORACLE인 경우에만 설정

– SYSDBA(기본값)
– NORMAL
SOURCE_SCHEMASource DB에서 이관하는 Table의 실제 사용자 이름을 설정하는 파라미터기본적으로 대문자로 인식되며 큰따옴표를 통해 대소문자 구분이 가능

(기본값 : SOURCE_USER에서 설정한 사용자 이름)
SOURCE_TABLE

Source DB에서 이관하는 Table 이름을 설정하는 파라미터

기본적으로 대문자로 인식되며 큰따옴표를 통해 대소문자 구분이 가능

(필수 입력)

SOURCE_TABLE_DEDUPLICATE

dedup 옵션이 사용된 테이블의 이관 동안 발생하는 deadlock 에러를 무시하는 파라미터

BATCH_THRESHOLD=2 이상일 경우 데이터 무결성이 보장되지 않으므로 BATCH_THRESHOLD=1인 경우에만 설정

- Y
- N

### Target 접속 정보 관련
파라미터설명
TARGET_TYPETarget DB의 타입을 설정하는 파라미터

– DEFAULT : Target DB가 Tibero일 때 설정
TARGET_DRIVERTarget DB에 접속할 때 사용하는 JDBC Driver 클래스를 설정하는 파라미터

(기본값 : com.m.internal.jdbc.MInternalDriver)
TARGET_URLTarget DB의 JDBC 연결 URL을 설정하는 파라미터

(기본값 : jdbc:internal:thin:@localhost:8629:tibero)
TARGET_USER

Target DB에 로그인하는 사용자 이름을 설정하는 파라미터

기본적으로 대문자로 인식되며 큰따옴표를 통해 대소문자 구분이 가능

(기본값 : sys)

TARGET_PASSWORDTarget DB에 로그인하는 사용자 패스워드를 설정하는 파라미터

(기본값 : tibero)
TARGET_SCHEMA

Target DB에 이관 받는 Table의 실제 사용자 이름

기본적으로 대문자로 인식되고 큰따옴표를 통해 대소문자 구분이 가능

(기본값 : TARGET_USER에서 설정한 사용자 이름)

TARGET_TABLE

Target DB에 이관 받는 Table 이름을 설정하는 파라미터

기본적으로 대문자로 인식되고 큰따옴표를 통해 대소문자 구분이 가능

(기본값 : SOURCE_TABLE에서 설정한 Table 이름)

### 데이터 Extractor 관련 | 파라미터 | 설명 | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | EXTRACT\_PARALLEL |

SOURCE DB에서 데이터를 추출하는 Thread의 parallel 동작 여부를 설정하는 파라미터 SOURCE\_TYPE이 Oracle, default, postgresql인 경우에만 사용 가능

row가 rowid Hashing을 통해 나눠지므로 이관 동안 rowid 변경이 발생하지 않도록 주의

- Y
- N (기본값)

| | EXTRACT\_PARALLEL\_RANGE\_BY\_ROWID |

rowid의 범위를 지정하여 row를 나누도록 설정하는 파라미터

SOURCE\_TYPE=Oracle, EXTRACT\_PARALLEL=Y인 경우에만 설정 가능ora\_hash function을 지원하지않는 Oracle 9버전 이하에서 성능적 이점 존재

IOT 테이블은 해당 옵션 사용불가

- Y
- N

| | EXTRACT\_THREAD\_COUNT |

데이터를 추출하는 Thread의 수를 설정하는 파라미터

EXTRACT\_PARALLEL\_RANGE\_BY\_ROWID 옵션을 사용하는 경우 테이블의 extent 수에 따라 적절한 값으로 설정

(기본값 : 1)

| | SELECT\_TSN |

특정 TSN (Oacle에서는 SCN) 시점 이후의 데이터를 추출하도록 설정하는 파라미터

(기본값 : 미사용)

| | SELECT\_CONDITION |

Table 데이터 전체가 아닌 조건절에 해당하는 데이터만 추출하도록 설정하는 파라미터

(기본값 : 미사용)

| | SELECT\_FETCH\_SIZE |

Source DB에서 추출해온 결과 set을 fetch 해오는 단위 (row 수)를 설정하는 파라미터

(기본값 : 1024)

| | SELECT\_PARTITION |

파티션 Table에서 지정한 파티션에서만 데이터를 추출하도록 설정하는 파라미터

(기본값 : 미사용)

| | SELECT\_SUBPARTITION |

파티션 Table에서 지정한 서브 파티션에서만 데이터를 추출하도록 설정하는 파라미터 SELECT\_PARTITION 옵션과 같이 사용할 경우 SELECT\_PARTITION 옵션이 적용

(기본값 : 미사용)

| | SELECT\_AS\_BYTE |

Table의 char, varchar와 같은 문자열을 저장하기 위한 열에 데이터베이스 설정과 다른 캐릭터셋을 사용하여 실제 문자열이 저장되면 문자열 형태로 데이터를 가져올 시 문자열의 정상적 배열 불가

이를 방지하기 위하여 문자열이 아닌 바이너리 형태로 데이터를 가져오고, 바이너리 형태로 Tibero에 옮기도록 설정하는 파라미터

- Y
- N (기본값)

| | DB\_FILE\_MULTIBLOCK\_READ\_COUNT |

이관 전 해당 세션에 대한 DB\_FILE\_MULTBLOCK\_READ\_COUNT 값을 설정하는 파라미터

SOURCE\_TYPE=Oracle인 경우에만 설정 가능하며 값을 -1로 설정 시 동작하지 않음

(기본값 : -1)

| | OPTIMIZER\_HINT |

SOURCE DB로 부터 데이터를 SELECT 할 때 사용할 힌트를 설정하는 파라미터

테이블 이름은 't'를 사용하며 SOURCE\_TYPE=Oracle, SOURCE\_TYPE=Default인 경우에만 사용 가능 만약 USE\_PARALLEL\_HINT 옵션과 동시에 사용된다면, OPTIMIZER\_HINT 옵션이 우선적으로 적용

- 예 : OPTIMIZER\_HINT=/\*+ FULL(t) PARALLEL(t, 4)

| | USE\_PARALLEL\_HINT |

SOURCE DB에서 데이터를 SELECT 할 때 PARALLEL 힌트 사용 여부를 설정하는 파라미터 SOURCE\_TYPE=Oracle, SOURCE\_TYPE=Default인 경우에만 사용 가능

- Y
- N (기본값)

| | USE\_OBJECT\_PARALLEL\_HINT |

PARALLEL 힌트 사용 시 Table 이름을 명시할 수 있도록 설정하는 파라미터

해당 옵션을 활성화하기 위해서는 USE\_PARALLEL\_HINT=Y 설정이 필요, SOURCE\_DB가 Default, Oracle인 경우에만 사용 가능

- Y
- N (기본값)

| | PARALLEL\_HINT\_CNT |

PARALLEL 힌트 사용 시 DOP를 설정하는 파라미터

해당 옵션을 활성화하기 위해서는 USE\_PARALLEL\_HINT=Y 설정이 필요


(기본값 : -1)

| ### 데이터 Loader 관련 | 파라미터 | 설명 | | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | INSERT\_METHOD |

데이터의 INSERT 방식을 지정하는 파라미터

– DPL(기본값) : DIRECT PATH LOADING
– CPL : CONVENTIONAL PATH LOADING

| | COMMIT\_SIZE |

TARGET\_DB에 데이터를 commit하는 사이즈를 지정하는 파라미터

INSERT\_METHOD=cpl인 경우에만 동작하며 COMMIT\_SIZE=-1로 설정하는 경우 기본값인 commit only once로 동작

(기본값 : commit once after loading)

| | INDEX\_DISABLE |

TARGET\_TABLE의 INDEX를 자동으로 DISABLE 하도록 설정하는 파라미터

- Y
- N (기본값)

| | INSERT\_BATCH |

Table의 데이터를 Batch Insert 방식으로 load 하도록 설정하는 파라미터

INSERT\_METHOD=CPL인 경우에만 동작

- Y
- N

| | BATCH\_THRESHOLD |

TARGET\_DB에 Batch를 실행할 때 단위(row 수)를 설정하는 파라미터

INSERT\_METHOD=CPL, INSERT\_BATCH=Y 인 경우에만 동작하며 -1 값을 입력하면 미 동작

(기본값 : 32)

| | DPL\_LOG\_UNIT |

로그를 출력하는 row의 로딩 단위를 설정하는 파라미터

INSERT\_METHOD=DPL인 경우에만 사용 가능하며 0으로 설정하는 경우 로그가 미 출력

(기본값 : 500)

| | INSERT\_PARALLEL |

데이터를 load하는 Thread의 parallel 동작 여부를 설정하는 파라미터

- Y(기본값)
- N

| | INSERT\_THREAD\_COUNT |

데이터 loader thread 개수를 설정하는 파라미터 INSERT\_PARALLEL=Y인 경우에만 동작

(기본값 : 4)

| | INSERT\_PARTITION |

지정한 파티션에 이관할 경우 설정하는 파라미터

(기본값 : 미사용)

| | INSERT\_ZERO\_LENGTH\_STRING\_AS\_NULL |

길이가 0인 String 타입 데이터가 이관 시 NULL로 들어가도록 설정하는 파라미터 INSERT\_ZERO\_LENGTH\_STRING\_AS\_NULL=N으로 설정 시 길이가 0인 데이터는 공백('')으로 들어가며 SOURCE\_TYPE=Oracle인 경우 설정이 무시

- Y(기본값)
- N

| | TRIM |

CHAR 타입 데이터의 선행, 후행에 있는 pad 문자 제거

- Y
- N(기본값)

| ### POSTGRESQL 관련 | 파라미터 | 설명 | | --------------- | ----------------------------------------------------------------- | | BYTEA\_TO\_BLOB |

bytea 타입을 blob 타입으로 전환하도록 설정하는 파라미터

- Y
- N(기본값)

| | TEXT\_TO\_CLOB |

text 타입을 clob 타입으로 전화하도록 설정하는 파라미터

- Y
- N(기본값)

| ### 일반 설정
파라미터설명
MONITORING_LOG

모니터링 로그 출력 여부를 설정하는 파라미터

이관에 사용된 동작에 대한 평균 시간 로그를 출력

- Y
- N (기본값)

MONITORING_LOG_UNIT모니터링 로그에서 시간을 평균 낼 때 사용할 로우의 수를 설정하는 파라미터

(기본값 : 500)
MONITORING_SESS_STAT

모니터링할 stat을 설정하는 파라미터

여러개의 stat을 설정할 경우 ;로 구분해주며 해당 옵션은 SOURCE_TYPE=ORACLE인 경우에만 설정 가능

(기본값 : 미사용)

- 예 : MONITORING_SESS_STAT=CPU used by this session;parse time cpu;parse count (hard)

CHECK_COLUMN_METADATAINSERT_METHOD=dpl인 경우 이관하기 전에 SOURCE DB table과 TARGET DB table의 메타데이터를 확인하는 옵션

- Y(기본값)
- N
ROW_QUEUE_TYPE추출한 데이터를 저장하는 queue 타입을 설정하는 파라미터 EXTRACT_PARALLEL=Y, INSERT_PARALLEL=Y 인 경우 SYNCHRO 타입을 사용하는 것이 성능상 좋으며 ARRAY 타입은 사이즈 특정 가능

- ARRAY
(기본값 : 10240)

- SYNCHRO
VERIFY_TABLE이관 검증 테이블 사용 여부를 설정하는 파라미터

- Y
- N (기본값)
VERIFY_TABLE_NAME검증 테이블 이름을 설정하는 파라미터

(기본값 : VERIFY_TBL)
LOG_LEVEL로그 레벨을 설정하는 파라미터

(기본값 : INFO)
LOG_FILE_NAME로그 파일 이름을 설정하는 파라미터

(기본값 : tableMigrator.log)
LOG_DIR로그 파일이 생성되는 디렉토리 경로를 설정하는 파라미터

(기본값 : Migrator 실행 경로)
###