CLI 모드

이번 장에서는 CLI 모드 사용법에 대해서 기술합니다.

개요

CLI 모드는 웹을 통하지 않고 터미널에서 직접 마이그레이션 작업을 실행하는 기능입니다.

cli.sh 파일을 통해 실행할 수 있으며, 커맨드 라인 또는 프로퍼티 파일을 통해 설정을 전달합니다.

주의

CLI 모드에서도 D-Works 서버를 실행하기 때문에, 기본 모드 또는 다른 CLI 모드와 동시에 실행할 수 없습니다.

사용법

수행예시

sh cli.sh -h

예상결과

Usage:

1. Command-line options only
    sh cli.sh <argument_name1>=<argument_value1> <argument_name2>=<argument_value2> ...
2. Property file usage
    sh cli.sh PROPERTY_FILE=cli-migration.properties
3. Property file and command-line options usage
    sh cli.sh PROPERTY_FILE=cli-migration.properties <argument_name1>=<argument_value1> <argument_name2>=<argument_value2> ...

======================================================================================================================================================
                                                   PROPERTY FILE CONFIGURATION
======================================================================================================================================================
PROPERTY_FILE                                      Path to the properties file, refer to the example file: cli-migration.properties.eg

======================================================================================================================================================
                                                   SOURCE DATABASE CONFIGURATION
======================================================================================================================================================

SOURCE_DATABASE                                    Source database vendor
...

1. 프로퍼티 파일로 옵션 전달

sh cli.sh PROPERTY_FILE=cli-migration.properties

2. 커맨드 라인으로 옵션 전달

sh cli.sh SOURCE_DATABASE=ORACLE ... MIGRATION_METHOD=FULL TABLE=SRC:T1

3. 프로퍼티 파일과 커맨드 라인으로 옵션 전달

sh cli.sh PROPERTY_FILE=cli-migration.properties SOURCE_DATABASE=ORACLE ... MIGRATION_METHOD=FULL TABLE=SRC:T1

참고

프로퍼티 파일과 커맨드 라인에서 동일한 옵션을 지정할 경우, 커맨드 라인에서 입력한 값이 프로퍼티 파일의 값보다 우선 적용됩니다.

옵션 목록

옵션

설명

기본값

필수 여부

이관 방식별 적용 여부

SOURCE_DATABASE

소스 데이터베이스 타입

true

공통

SOURCE_IPADDRESS

소스 데이터베이스 IP 주소

true

공통

SOURCE_PORT

소스 데이터베이스 포트

true

공통

SOURCE_USER

소스 데이터베이스 사용자

true

공통

SOURCE_PASSWORD

소스 데이터베이스 비밀번호

true

공통

SOURCE_DATABASE_NAME

소스 데이터베이스 이름

true

공통

SOURCE_SSL

소스 데이터베이스 SSL 사용 여부

false

공통

SOURCE_LOB_CHUNK_SIZE_VALUE

소스 데이터베이스 LOB 청크 크기

false

공통

SOURCE_LOB_CHUNK_SIZE_UNIT

소스 데이터베이스 LOB 단위

false

공통

TARGET_IPADDRESS

타겟 데이터베이스 IP 주소

true

공통

TARGET_PORT

타겟 데이터베이스 포트

true

공통

TARGET_USER

타겟 데이터베이스 사용자

true

공통

TARGET_PASSWORD

타겟 데이터베이스 비밀번호

true

공통

TARGET_DATABASE_NAME

타겟 데이터베이스 이름

true

공통

TARGET_SSL

타겟 데이터베이스 SSL 사용 여부

false

공통

TARGET_LOB_CHUNK_SIZE_VALUE

타겟 데이터베이스 LOB 청크 크기

false

공통

TARGET_LOB_CHUNK_SIZE_UNIT

타겟 데이터베이스 LOB 단위

false

공통

MIGRATION_METHOD

마이그레이션 방식

true

공통

LOG_LEVEL

로그 레벨

INFO

false

공통

TABLE, VIEW, INDEX 등

DDL_ONLY 이관 대상 객체 목록

조건부

DDL_ONLY / FULL

SOURCE_TABLE_TARGET_TABLE_PAIR

DATA_ONLY 이관 대상 테이블 매핑

조건부

DATA_ONLY

EXECUTE_DDL_STATEMENTS_ON_THE_TARGET_DB

추출된 DDL 스크립트를 타겟 데이터베이스에 수행할지 여부

true

false

DDL_ONLY

CREATE_STATEMENT_TYPE

DDL 생성 구문 타입 (CREATE, CREATE OR REPLACE)

CREATE OR REPLACE

false

DDL_ONLY / FULL

DEGREE_OF_PARALLEL_FOR_INDEX_CREATION

인덱스 생성 병렬도

false

DDL_ONLY / FULL

MIGRATE_OBJECT_COMMENTS

객체 코멘트 이관 여부

true

false

DDL_ONLY / FULL

CREATE_SCHEMA_USER

스키마 유저 생성 여부

true

false

DDL_ONLY / FULL

PASSWORD_POLICY

패스워드 정책 (DEFAULT, SET_INITIAL_PASSWORD)

DEFAULT

false

DDL_ONLY / FULL

INITIAL_PASSWORD

SET_INITIAL_PASSWORD 정책 시 초기 비밀번호

tibero

false

DDL_ONLY / FULL

GRANT_SYSTEM_PRIVILEGES

시스템 권한 부여 여부

true

false

DDL_ONLY / FULL

GRANT_OBJECT_PRIVILEGES

객체 권한 부여 여부

true

false

DDL_ONLY / FULL

GRANT_ROLE

롤 부여 여부

true

false

DDL_ONLY / FULL

ASSIGN_TABLESPACE_QUOTAS

테이블스페이스 쿼터 부여 여부

true

false

DDL_ONLY / FULL

ASSIGN_PROFILE

프로파일 부여 여부

true

false

DDL_ONLY / FULL

TABLE_OPTION_CREATE_TABLE_WITH_CONSTRAINTS

제약 포함 테이블 생성 여부

true

false

DDL_ONLY / FULL

TABLE_OPTION_INCLUDE_FOREIGN_KEY_CONSTRAINTS

FK 포함 여부

true

false

DDL_ONLY / FULL

TABLE_OPTION_CREATE_CONSTRAINTS_WITH_VALIDATE

VALIDATE로 생성 여부

true

false

DDL_ONLY / FULL

TABLE_OPTION_CHANGE_SEMANTIC_FROM_BYTE_TO_CHAR

CHAR 또는 VARCHAR 컬럼의 길이 기준을 BYTE → CHAR로 변경할지 여부

false

DDL_ONLY / FULL

TABLE_OPTION_SCALE_COLUMN_SIZE

컬럼 크기 배율 적용 여부

false

DDL_ONLY / FULL

TABLE_OPTION_SCALE_COLUMN_SIZE_CHAR

CHAR 컬럼 크기 배율

false

DDL_ONLY / FULL

TABLE_OPTION_SCALE_COLUMN_SIZE_VARCHAR

VARCHAR 컬럼 크기 배율

false

DDL_ONLY / FULL

ROLE_OPTION_GRANT_SYSTEM_PRIVILEGES

롤 시스템 권한 부여 여부

true

false

DDL_ONLY / FULL

ROLE_OPTION_GRANT_OBJECT_PRIVILEGES

롤 객체 권한 부여 여부

true

false

DDL_ONLY / FULL

ROLE_OPTION_GRANT_ROLE

롤에 롤 부여 여부

true

false

DDL_ONLY / FULL

INSERT_METHOD

데이터 적재 방식

DPL

false

DATA_ONLY

NUM_OF_JOBS

병렬 작업 개수 (= 동시에 이관할 테이블의 개수)

false

DATA_ONLY

PARALLEL_EXTRACT

병렬 추출 여부

true

false

DATA_ONLY

PARALLEL_EXTRACT_THREAD_COUNT

추출 스레드 개수

false

DATA_ONLY

PARALLEL_EXTRACT_HINT

병렬 힌트 사용 여부

true

false

DATA_ONLY

PARALLEL_EXTRACT_HINT_OF_DEGREE

병렬 힌트 병렬도

false

DATA_ONLY

FETCH_SIZE

Fetch 크기

false

DATA_ONLY

PARALLEL_INSERT

병렬 적재 여부

true

false

DATA_ONLY

PARALLEL_INSERT_THREAD_COUNT

적재 스레드 개수

false

DATA_ONLY

BATCH_COUNT

배치 크기(CPL 방식에서 사용)

100

false

DATA_ONLY

DISABLE_INDEX

데이터 이관 전 인덱스 비활성화 여부

false

DATA_ONLY

REBUILD_INDEX

데이터 이관 후 인덱스 재구성 여부

false

DATA_ONLY

COMMIT_AT_END

종료 시 커밋 (CPL 방식에서 사용)

true

false

DATA_ONLY

COMMIT_AFTER_EACH_ROW

행마다 커밋 (CPL 방식에서 사용)

false

DATA_ONLY

COMMIT_SIZE

커밋 단위(건, CPL 방식에서 사용)

1000

false

DATA_ONLY

BYTE_TO_STRING_CONVERSION

CHAR 또는 VARCHAR 데이터를 java String 타입 변환 없이 이관할 지 여부

false

DATA_ONLY

LOG_UNIT_SIZE

로그 단위(행)

10000

false

DATA_ONLY

옵션 참고 사항

마이그레이션 방식별 필수 옵션

DDL_ONLY 또는 FULL 방식인 경우: TABLE, INDEX와 같은 객체 목록 중 최소 1개 이상
DATA_ONLY: SOURCE_TABLE_TARGET_TABLE_PAIR 옵션 사용 필수

TABLE, INDEX 등 객체 목록 입력 방식

스키마 종속 객체: SCHEMA:OBJECT1,OBJECT2;SCHEMA2:OBJECT3,OBJECT4
- 예: TABLE=TEST_USER:T,T2;TEST_USER2:T3,T4
- Job의 경우에는 JOB_${JOB_ID} 형식으로 입력
  - 예: JOB=TEST_USER:JOB_1,JOB_2;TEST_USER2:JOB_3,JOB_4
스키마 독립 객체: OBJECT1,OBJECT2,OBJECT3
- 예: ROLE=ROLE1,ROLE2,ROLE3
SOURCE_TABLE_TARGET_TABLE_PAIR 옵션 입력 방식
- :를 기준으로 소스 및 타겟 스키마 구분, ,를 기준으로 하나의 매핑 구분
  - 예: SOURCE_TABLE_TARGET_TABLE_PAIR=SOURCE_USER.T:TARGET_USER.T,SOURCE_USER2.T3:TARGET_USER2.T3
  - => SOURCE_USER의 테이블 T와 TARGET_USER의 테이블T를 매핑
  - => SOURCE_USER2의 테이블 T3와 TARGET_USER2의 테이블T3를 매핑

주의

Remap Tablespaces, Tablespace Creation Settings, Users' Default Tablespace Settings, Change Schema Name Settings에 관한 옵션은 제공하지 않습니다.

사용 예시

Case 1. DDL_ONLY: 테이블, 인덱스 일부만 이관하는 예시

sh cli.sh \
  SOURCE_DATABASE=TIBERO SOURCE_IPADDRESS=localhost SOURCE_PORT=8629 \
  SOURCE_USER=tibero SOURCE_PASSWORD=tmax SOURCE_DATABASE_NAME=tibero \
  TARGET_IPADDRESS=localhost TARGET_PORT=9268 \
  TARGET_USER=tibero TARGET_PASSWORD=tmax TARGET_DATABASE_NAME=tibero \
  MIGRATION_METHOD=DDL_ONLY \
  TABLE=TEST_USER:T,T2;TEST_USER2:T3,T4 \
  INDEX=TEST_USER:IDX_T,IDX_T2

Case 2. DATA_ONLY: 특정 테이블 매핑 이관, 병렬 추출/적재 활성화

sh cli.sh \
  SOURCE_DATABASE=TIBERO SOURCE_IPADDRESS=localhost SOURCE_PORT=8629 \
  SOURCE_USER=tibero SOURCE_PASSWORD=tmax SOURCE_DATABASE_NAME=tibero \
  TARGET_IPADDRESS=localhost TARGET_PORT=9268 \
  TARGET_USER=tibero TARGET_PASSWORD=tmax TARGET_DATABASE_NAME=tibero \
  MIGRATION_METHOD=DATA_ONLY \
  SOURCE_TABLE_TARGET_TABLE_PAIR=TEST_USER.T:TEST_USER.T,TEST_USER2.T3:TEST_USER2.T3 \
  INSERT_METHOD=DPL BATCH_COUNT=500 COMMIT_SIZE=20000

프로퍼티 파일 예시 (cli-migration.properties.eg)

프로퍼티 파일 예시는, 동봉된 cli-migration.properties.eg 파일에서 확인할 수 있습니다.

해당 프로퍼티 예시 파일을 복사 및 수정하여 사용하면 됩니다.

PreviousConnection

Last updated 3 months ago

hashtag개요

hashtag

hashtag사용법

hashtag수행예시

hashtag예상결과

hashtag1. 프로퍼티 파일로 옵션 전달

hashtag2. 커맨드 라인으로 옵션 전달

hashtag3. 프로퍼티 파일과 커맨드 라인으로 옵션 전달

hashtag

hashtag옵션 목록

hashtag옵션 참고 사항

hashtag마이그레이션 방식별 필수 옵션

hashtagTABLE, INDEX 등 객체 목록 입력 방식

hashtag

hashtag사용 예시

hashtagCase 1. DDL_ONLY: 테이블, 인덱스 일부만 이관하는 예시

hashtagCase 2. DATA_ONLY: 특정 테이블 매핑 이관, 병렬 추출/적재 활성화

hashtag

hashtag프로퍼티 파일 예시 (cli-migration.properties.eg)

hashtag

개요

사용법

수행예시

예상결과

1. 프로퍼티 파일로 옵션 전달

2. 커맨드 라인으로 옵션 전달

3. 프로퍼티 파일과 커맨드 라인으로 옵션 전달

옵션 목록

옵션 참고 사항

마이그레이션 방식별 필수 옵션

TABLE, INDEX 등 객체 목록 입력 방식

사용 예시

Case 1. DDL_ONLY: 테이블, 인덱스 일부만 이관하는 예시

Case 2. DATA_ONLY: 특정 테이블 매핑 이관, 병렬 추출/적재 활성화

프로퍼티 파일 예시 (cli-migration.properties.eg)