기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CLI에 대한 참조 AWS Schema Conversion Tool
이 섹션에서는 AWS SCT 명령줄 인터페이스 (CLI) 를 시작하는 방법을 설명합니다. 또한 이 섹션에서는 주요 명령 및 사용 모드에 대한 정보도 제공합니다. AWS SCT CLI명령에 대한 전체 참조는 를 참조하십시오참조 자료.
주제
AWS SCT 명령줄 인터페이스를 사용하기 위한 사전 조건
최신 버전의 Amazon Corretto 11을 다운로드하여 설치합니다. 자세한 내용은 Amazon Corretto 11 사용 설명서의 Amazon Corretto 11 다운로드를 참조하세요.
의 최신 버전을 다운로드하여 설치합니다. AWS SCT자세한 내용은 설치 AWS Schema Conversion Tool 단원을 참조하십시오.
AWS SCT CLI대화형 모드
AWS SCT 명령줄 인터페이스는 대화형 모드에서 사용할 수 있습니다. 이 모드에서는 콘솔에 명령을 하나씩 입력합니다. 이 대화형 모드를 사용하여 CLI 명령에 대해 자세히 알아보거나 가장 일반적으로 사용되는 CLI 시나리오를 다운로드할 수 있습니다.
원본 데이터베이스 스키마를 로 변환하려면 새 프로젝트 만들기 AWS SCT, 원본 및 대상 데이터베이스에 연결, 매핑 규칙 만들기, 데이터베이스 개체 변환 등의 시퀀스 작업을 실행합니다. 이 워크플로는 복잡할 수 있으므로 AWS SCT CLI 모드에서는 스크립트를 사용하는 것이 좋습니다. 자세한 내용은 스크립트 모드 단원을 참조하십시오.
AWS SCT 설치 경로의 app 폴더에서 AWS SCT CLI 명령을 실행할 수 있습니다. Windows에서 기본 설치 경로는 C:\Program Files\AWS Schema Conversion Tool\입니다. 이 폴더에 AWSSchemaConversionToolBatch.jar 파일이 포함되어 있어야 합니다.
AWS SCT CLI대화형 모드로 전환하려면 사전 요구 사항을 완료한 후 다음 명령을 사용하십시오.
java -jar AWSSchemaConversionToolBatch.jar -type interactive
이제 명령을 실행할 AWS SCT CLI 수 있습니다. 새로운 줄에 /로 명령을 끝내야 합니다. 또한 명령 파라미터 값 앞뒤에 곧은 작은따옴표(')를 사용해야 합니다.
참고
앞의 명령이 Unexpected error를 반환하는 경우 다음을 수행합니다.
java -Djdk.jar.maxSignatureFileSize=20000000 -jar AWSSchemaConversionToolBatch.jar
AWS SCT CLI대화형 모드에서 사용 가능한 명령 목록을 보려면 다음 명령을 실행합니다.
help /
AWS SCT CLI명령에 대한 정보를 보려면 다음 명령을 사용합니다.
help -command: 'command_name' /
위 예제에서는 다음을 대체합니다.command_name 명령의 이름으로.
AWS SCT CLI명령의 매개 변수에 대한 정보를 보려면 다음 명령을 사용합니다.
help -command: 'command_name' -parameters: 'parameters_list' /
위 예제에서는 다음을 대체합니다.command_name 명령의 이름으로. 그런 다음 바꾸십시오.parameters_list 쉼표로 구분된 매개변수 이름 목록으로
AWS SCT CLI대화형 모드에서 파일에서 스크립트를 실행하려면 다음 명령을 사용합니다.
ExecuteFile -file: 'file_path' /
위 예제에서는 다음을 대체하십시오.file_path 스크립트가 있는 파일의 경로를 입력하세요. 파일 확장자는 .scts여야 합니다.
AWS SCT CLI대화형 모드를 종료하려면 quit 명령을 실행합니다.
예시
다음 예제는 Convert 명령에 대한 정보를 표시합니다.
help -command: 'Convert' /
다음 예제는 Convert 명령의 두 파라미터에 대한 정보를 표시합니다.
help -command: 'Convert' -parameters: 'filter, treePath' /
AWS SCT CLI시나리오 가져오기
가장 일반적으로 사용되는 AWS SCT 시나리오를 가져오려면 GetCliScenario 명령을 사용할 수 있습니다. 대화형 모드에서 이 명령을 실행한 다음, 다운로드한 템플릿을 편집할 수 있습니다. 편집한 파일을 스크립트 모드에서 사용합니다.
GetCliScenario 명령은 선택한 템플릿 또는 사용 가능한 모든 템플릿을 지정된 디렉터리에 저장합니다. 템플릿에는 스크립트를 실행하기 위한 전체 명령 세트가 포함되어 있습니다. 이러한 템플릿에서 파일 경로, 데이터베이스 보안 인증 정보, 객체 이름 및 기타 데이터를 편집해야 합니다. 또한 사용하지 않는 명령은 제거하고 필요한 경우 스크립트에 새 명령을 추가해야 합니다.
GetCliScenario명령을 실행하려면 사전 요구 사항을 완료하고 AWS SCT CLI 대화형 모드로 전환하십시오. 자세한 내용은 대화형 모드 단원을 참조하십시오.
그런 다음, 다음 구문을 사용하여 GetCliScenario 명령을 실행하고 AWS SCT
시나리오를 가져옵니다.
GetCliScenario -type: 'template_type' -directory: 'file_path' /
위 예제에서는 다음을 대체합니다.template_type 다음 표의 템플릿 유형 중 하나로 다음으로 교체하십시오.file_path 스크립트를 다운로드하려는 폴더의 경로를 입력합니다. 관리자 권한을 요청하지 않고도 이 폴더에 액세스할 AWS SCT 수 있는지 확인하세요. 또한 명령 파라미터 값 앞뒤에 곧은 작은따옴표(')를 사용해야 합니다.
모든 AWS SCT CLI 템플릿을 다운로드하려면 위의 명령을 -type 옵션 없이 실행하십시오.
다음 표에는 다운로드할 수 있는 AWS SCT CLI 템플릿 유형이 나와 있습니다. 각 템플릿에 대한 테이블에는 파일 이름과 스크립트를 사용하여 실행할 수 있는 작업에 대한 설명이 포함됩니다.
| 템플릿 유형 | 파일 이름 | 설명 |
|---|---|---|
|
BTEQScriptConversion |
|
테라데이타 기본 테라데이타 쿼리 (BTEQ) FastExport FastLoad, 및 MultiLoad 스크립트를 Amazon Redshift로 변환합니다. RSQL 자세한 내용은 다음을 사용하여 데이터 변환 ETL 단원을 참조하십시오. |
ConversionApply |
|
소스 데이터베이스 스키마를 변환하고 변환된 코드를 대상 데이터베이스에 적용합니다. 변환된 코드를 SQL 스크립트로 저장하고 평가 보고서를 저장할 수도 있습니다. 자세한 내용은 스키마 변환 단원을 참조하십시오. |
GenericAppConversion |
|
일반 AWS SCT 응용 프로그램 변환기를 사용하여 응용 프로그램에 포함된 SQL 코드를 변환합니다. 자세한 내용은 SQL코드 단원을 참조하십시오. |
HadoopMigration |
|
온프레미스 하둡 클러스터를 Amazon으로 마이그레이션합니다. EMR 자세한 내용은 를 사용하여 Apache 하둡 데이터베이스에 연결 AWS Schema Conversion Tool 단원을 참조하십시오. |
HadoopResumeMigration |
|
온프레미스 하둡 클러스터를 Amazon으로 중단된 마이그레이션을 재개합니다. EMR 자세한 내용은 를 사용하여 Apache 하둡 데이터베이스에 연결 AWS Schema Conversion Tool 단원을 참조하십시오. |
Informatica |
|
Informatica 추출, 변환 및 로드 () 스크립트에 내장된 SQL 코드를 변환합니다. ETL ETL스크립트의 소스 및 대상 데이터베이스에 대한 연결을 구성하고 변환 후 변환된 스크립트를 저장합니다. 자세한 내용은 인포매티카 스크립트 ETL 단원을 참조하십시오. |
LanguageSpecificAppConversion |
|
응용 프로그램 변환기를 사용하여 C#, C++, Java 및 Pro*C 응용 프로그램에 포함된 SQL 코드를 변환합니다. AWS SCT 자세한 내용은 애플리케이션 변환 SQL 단원을 참조하십시오. |
OozieConversion |
|
Apache Oozie 워크플로를 로 변환합니다. AWS Step Functions자세한 내용은 를 사용하여 Apache Oozie 워크플로에 연결 AWS Schema Conversion Tool 단원을 참조하십시오. |
RedshiftAgent |
|
소스 데이터 웨어하우스 스키마를 변환하고 변환된 코드를 대상 Amazon Redshift 데이터베이스에 적용합니다. 그런 다음, 데이터 추출 에이전트를 등록하고 데이터 마이그레이션 작업을 생성한 후 시작합니다. 자세한 내용은 데이터 웨어하우스에서 마이그레이션 단원을 참조하십시오. |
ReportCreation |
|
여러 소스 데이터베이스 스키마에 대한 데이터베이스 마이그레이션 보고서를 생성합니다. 그런 다음 이 보고서를 파일로 저장합니다. CSV PDF 자세한 내용은 평가 보고서 단원을 참조하십시오. |
SQLScriptConversion |
|
SQL*Plus 또는 TSQL 스크립트를 PL/로 SQL 변환하고 변환된 스크립트를 저장합니다. 또한 평가 보고서도 저장합니다. |
AWS SCT CLI템플릿을 다운로드한 후 텍스트 편집기를 사용하여 소스 및 대상 데이터베이스에서 실행되도록 스크립트를 구성하십시오. 그런 다음 AWS SCT CLI 스크립트 모드를 사용하여 스크립트를 실행합니다. 자세한 내용은 AWS SCT CLI스크립트 모드 단원을 참조하십시오.
예시
다음 예제는 모든 템플릿을 C:\SCT\Templates 폴더에 다운로드합니다.
GetCliScenario -directory: 'C:\SCT\Templates' /
다음 예제에서는 ConversionApply 작업에 필요한 템플릿을 C:\SCT\Templates 폴더에 다운로드합니다.
GetCliScenario -type: 'ConversionApply' -directory: 'C:\SCT\Templates' /
AWS SCT CLI시나리오 편집
시나리오 템플릿을 다운로드한 후 데이터베이스에서 실행할 수 있는 작업 스크립트를 가져오도록 구성합니다.
모든 템플릿에 대해 소스 및 대상 데이터베이스의 드라이버 경로를 제공해야 합니다. 자세한 내용은 에 대한 JDBC 드라이버 설치 AWS Schema Conversion Tool 단원을 참조하십시오.
소스 및 대상 데이터베이스의 데이터베이스 보안 인증 정보를 포함해야 합니다. 또한 변환 프로젝트의 소스-대상 페어를 설명하는 매핑 규칙을 설정해야 합니다. 자세한 내용은 데이터 유형 매핑 단원을 참조하십시오.
다음으로, 실행할 작업의 범위를 구성합니다. 사용하지 않는 명령을 제거하거나 새 명령을 스크립트에 추가할 수 있습니다.
예를 들어 소스 Oracle 데이터베이스의 모든 스키마를 Postgre로 변환할 계획이라고 가정해 보겠습니다. SQL 그런 다음 데이터베이스 마이그레이션 평가 보고서를 PDF a로 저장하고 변환된 코드를 대상 데이터베이스에 적용할 계획입니다. 이 경우 ConversionApply 작업에 템플릿을 사용할 수 있습니다. 다음 절차를 사용하여 AWS SCT CLI 템플릿을 편집하십시오.
ConversionApply작업에 사용할 AWS SCT CLI 템플릿을 편집하려면
다운로드한
ConversionTemplate.scts를 엽니다. 자세한 내용은 예시 단원을 참조하십시오.스크립트에서 -filter, ApplyToTarget -filter SaveTargetSQLSaveTargetSQLbyStatement, 및 SaveReportCSV작업을 제거하고 CreateFilter변환합니다.
SetGlobalSettings작업 중인 oracle_driver_file의 경우 오라클 드라이버의 경로를 입력하십시오. 그런 다음 postgresql_driver_file에 Postgre 드라이버의 경로를 입력하십시오. SQL
다른 데이터베이스 엔진을 사용하는 경우에는 설정에 해당 이름을 사용합니다. 작업에서 설정할 수 있는 글로벌 설정의 전체 목록은 의 글로벌 설정 매트릭스를 참조하십시오. SetGlobalSettings참조 자료
(선택 사항 CreateProject) 에는 프로젝트 이름과 로컬 프로젝트 파일 위치를 입력합니다. 기본값을 사용하여 작업을 진행하는 경우 AWS SCT 는 관리자 권한을 요청하지 않고도
C:\temp폴더에 파일을 생성할 수 있어야 합니다.AddSource에 원본 데이터베이스 서버의 IP 주소를 입력합니다. 또한 소스 데이터베이스 서버에 연결할 사용자 이름, 암호 및 포트를 입력합니다.
AddTarget에 대상 데이터베이스 서버의 IP 주소를 입력합니다. 또한 대상 데이터베이스 서버에 연결할 사용자 이름, 암호 및 포트를 입력합니다.
(선택 사항 AddServerMapping) 매핑 규칙에 추가할 원본 및 대상 데이터베이스 개체를 입력합니다.
sourceTreePath및targetTreePath파라미터를 사용하여 데이터베이스 객체의 경로를 지정할 수 있습니다. 선택적으로sourceNamePath및targetNamePath를 사용하여 데이터베이스 객체의 이름을 지정할 수 있습니다. 자세한 내용은 참조 자료에서 서버 매핑 명령을 참조하세요.AddServerMapping작업의 기본값은 모든 소스 스키마를 대상 데이터베이스에 매핑합니다.
파일을 저장한 다음, 스크립트 모드를 사용하여 해당 파일을 실행합니다. 자세한 내용은 스크립트 모드 단원을 참조하십시오.
AWS SCT CLI스크립트 모드
AWS SCT CLI스크립트를 만들거나 템플릿을 편집한 후 RunSCTBatch 명령을 사용하여 실행할 수 있습니다. CLI스크립트와 함께 파일을 .scts 확장자로 저장해야 합니다.
AWS SCT 설치 경로의 app 폴더에서 AWS SCT CLI 스크립트를 실행할 수 있습니다. Windows에서 기본 설치 경로는 C:\Program Files\AWS Schema Conversion Tool\입니다. 이 폴더에 RunSCTBatch.cmd 또는 RunSCTBatch.sh 파일이 포함되어 있어야 합니다. 또한 이 폴더에는 AWSSchemaConversionToolBatch.jar 파일이 포함되어야 합니다.
운영 체제의 PATH 환경 변수에 RunSCTBatch 파일의 경로를 추가할 수도 있습니다. PATH환경 변수를 업데이트한 후에는 모든 폴더에서 AWS SCT CLI 스크립트를 실행할 수 있습니다.
AWS SCT CLI스크립트를 실행하려면 Windows에서 다음 명령을 사용합니다.
RunSCTBatch.cmd --pathtoscts "file_path"
위 예제에서는 다음을 대체하십시오.file_path 스크립트가 있는 파일의 경로를 입력하세요.
AWS SCT CLI스크립트를 실행하려면 Linux에서 다음 명령을 사용합니다.
RunSCTBatch.sh --pathtoscts "file_path"
위 예제에서는 다음을 대체하십시오.file_path 스크립트가 있는 파일의 경로를 입력하세요.
이 명령에 데이터베이스 보안 인증 정보, 콘솔 출력의 세부 정보 수준 등과 같은 선택적 파라미터를 제공할 수 있습니다. 자세한 내용은 에서 AWS SCT 명령줄 인터페이스 참조를 다운로드하십시오참조 자료.
예시
다음 예제는 C:\SCT\Templates 폴더에서 ConversionTemplate.scts 스크립트를 실행합니다. Windows에서 이 예제를 사용할 수 있습니다.
RunSCTBatch.cmd --pathtoscts "C:\SCT\Templates\ConversionTemplate.scts"
다음 예제는 /home/user/SCT/Templates 디렉터리에서 ConversionTemplate.scts 스크립트를 실행합니다. Linux에서 이 예제를 사용할 수 있습니다.
RunSCTBatch.sh --pathtoscts "/home/user/SCT/Templates/ConversionTemplate.scts"
AWS SCT CLI참조 자료
AWS Schema Conversion Tool 명령줄 인터페이스 (CLI) 에 대한 참조 자료는 다음 가이드에서 찾을 수 있습니다. AWS Schema Conversion Tool CLI참조
