기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 에 대한 CLI 참조 AWS Schema Conversion Tool
이 섹션에서는 AWS SCT 명령줄 인터페이스(CLI)를 시작하는 방법을 설명합니다. 또한 이 섹션에서는 주요 명령 및 사용 모드에 대한 정보도 제공합니다. AWS SCT CLI 명령에 대한 전체 참조는 섹션을 참조하세요[참조 자료](#CHAP_Reference.Download).
**Topics**
+ [AWS SCT 명령줄 인터페이스를 사용하기 위한 사전 조건](#CHAP_Reference.Prerequisites)
+ [AWS SCT CLI 대화형 모드](#CHAP_Reference.InteractiveMode)
+ [AWS SCT CLI 시나리오 가져오기](#CHAP_Reference.Scenario)
+ [AWS SCT CLI 시나리오 편집](#CHAP_Reference.Editing)
+ [AWS SCT CLI 스크립트 모드](#CHAP_Reference.ScriptMode)
+ [AWS SCT CLI 참조 자료](#CHAP_Reference.Download)
## AWS SCT 명령줄 인터페이스를 사용하기 위한 사전 조건
최신 버전의 Amazon Corretto 11을 다운로드하여 설치합니다. 자세한 내용은 *Amazon Corretto 11 사용 설명서*의 [Amazon Corretto 11 다운로드](https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html)를 참조하세요.
최신 버전의를 다운로드하여 설치합니다 AWS SCT. 자세한 내용은 [설치 AWS Schema Conversion Tool](CHAP_Installing.Procedure.md) 단원을 참조하십시오.
## AWS SCT CLI 대화형 모드
대화형 모드에서 AWS SCT 명령줄 인터페이스를 사용할 수 있습니다. 이 모드에서는 콘솔에 명령을 하나씩 입력합니다. 이 대화형 모드를 사용하여 CLI 명령에 대해 자세히 알아보거나 가장 일반적으로 사용되는 CLI 시나리오를 다운로드할 수 있습니다.
에서 소스 데이터베이스 스키마를 변환하려면 새 프로젝트 생성 AWS SCT, 소스 및 대상 데이터베이스에 연결, 매핑 규칙 생성, 데이터베이스 객체 변환 등의 시퀀스 작업을 실행합니다. 이 워크플로는 복잡할 수 있으므로 AWS SCT CLI 모드에서 스크립트를 사용하는 것이 좋습니다. 자세한 내용은 [스크립트 모드](#CHAP_Reference.ScriptMode) 단원을 참조하십시오.
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\$1name*을 명령 이름으로 바꿉니다.
AWS SCT CLI 명령의 파라미터에 대한 정보를 보려면 다음 명령을 사용합니다.
```
help -command: 'command_name' -parameters: 'parameters_list'
/
```
이전 예제에서 *command\$1name*을 명령 이름으로 바꿉니다. 그런 다음 *parameters\$1list*를 쉼표로 구분된 파라미터 이름 목록으로 바꿉니다.
AWS SCT CLI 대화형 모드의 파일에서 스크립트를 실행하려면 다음 명령을 사용합니다.
```
ExecuteFile -file: 'file_path'
/
```
이전 예제에서 *file\$1path*를 스크립트가 있는 파일 경로로 바꿉니다. 파일 확장자는 `.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 대화형 모드로 전환합니다. 자세한 내용은 [대화형 모드](#CHAP_Reference.InteractiveMode) 단원을 참조하십시오.
그런 다음, 다음 구문을 사용하여 `GetCliScenario` 명령을 실행하고 AWS SCT 시나리오를 가져옵니다.
```
GetCliScenario -type: 'template_type' -directory: 'file_path'
/
```
이전 예제에서 *template\$1type*을 다음 표의 템플릿 유형 중 하나로 바꿉니다. 그런 다음, 스크립트를 다운로드하려는 폴더 경로로 *file\$1path*를 바꿉니다. 가 관리자 권한을 요청하지 않고이 폴더에 액세스할 AWS SCT 수 있는지 확인합니다. 또한 명령 파라미터 값 앞뒤에 곧은 작은따옴표(`'`)를 사용해야 합니다.
모든 AWS SCT CLI 템플릿을 다운로드하려면 `-type` 옵션 없이 이전 명령을 실행합니다.
다음 표에는 다운로드할 수 있는 AWS SCT CLI 템플릿 유형이 나와 있습니다. 각 템플릿에 대한 테이블에는 파일 이름과 스크립트를 사용하여 실행할 수 있는 작업에 대한 설명이 포함됩니다.
| 템플릿 유형 | 파일 이름 | 설명 |
| --- | --- | --- |
| BTEQScriptConversion | `BTEQScriptConversionTemplate.scts` | Teradata Basic Teradata Query(BTEQ), FastExport, FastLoad 및 MultiLoad 스크립트를 Amazon Redshift RSQL로 변환합니다. 자세한 내용은 [ETL을 사용하여 데이터 변환](CHAP-converting-etl.md) 단원을 참조하십시오. |
| ConversionApply | `ConversionTemplate.scts` | 소스 데이터베이스 스키마를 변환하고 변환된 코드를 대상 데이터베이스에 적용합니다. 변환된 코드를 SQL 스크립트로 저장하고 평가 보고서를 저장할 수도 있습니다. 자세한 내용은 [스키마 변환](CHAP_Converting.md) 단원을 참조하십시오. |
| GenericAppConversion | `GenericApplicationConversionTemplate.scts` | 일반 애플리케이션 변환기를 사용하여 AWS SCT 애플리케이션에 포함된 SQL 코드를 변환합니다. 자세한 내용은 [SQL 코드](CHAP_Converting.App.Generic.md) 단원을 참조하십시오. |
| HadoopMigration | `HadoopMigrationTemplate.scts` | 온프레미스 Hadoop 클러스터를 Amazon EMR로 마이그레이션합니다. 자세한 내용은 [를 사용하여 Apache Hadoop 데이터베이스에 연결 AWS Schema Conversion Tool](CHAP_Source.Hadoop.md) 단원을 참조하십시오. |
| HadoopResumeMigration | `HadoopResumeMigrationTemplate.scts` | 온프레미스 Hadoop 클러스터를 Amazon EMR로의 중단된 마이그레이션을 재개합니다. 자세한 내용은 [를 사용하여 Apache Hadoop 데이터베이스에 연결 AWS Schema Conversion Tool](CHAP_Source.Hadoop.md) 단원을 참조하십시오. |
| Informatica | `InformaticaConversionTemplate.scts` | Informatica 추출, 전환, 적재(ETL) 스크립트에 포함된 SQL 코드를 변환합니다. ETL 스크립트에서 소스 및 대상 데이터베이스에 대한 연결을 구성한 다음, 변환 후 변환된 스크립트를 저장합니다. 자세한 내용은 [Informatica ETL 스크립트](CHAP-converting-informatica.md) 단원을 참조하십시오. |
| LanguageSpecificAppConversion | `LanguageSpecificAppConversionTemplate.scts` | AWS SCT 애플리케이션 변환기를 사용하여 C\$1, C\$1\$1, Java 및 Pro\$1C 애플리케이션에 포함된 SQL 코드를 변환합니다. 자세한 내용은 [애플리케이션 SQL 변환](CHAP_Converting.App.md) 단원을 참조하십시오. |
| OozieConversion | `OozieConversionTemplate.scts` | Apache Oozie 워크플로를 로 변환합니다 AWS Step Functions. 자세한 내용은 [를 사용하여 Apache Oozie 워크플로에 연결 AWS Schema Conversion Tool](CHAP_Source.Oozie.md) 단원을 참조하십시오. |
| RedshiftAgent | `DWHDataMigrationTemplate.scts` | 소스 데이터 웨어하우스 스키마를 변환하고 변환된 코드를 대상 Amazon Redshift 데이터베이스에 적용합니다. 그런 다음, 데이터 추출 에이전트를 등록하고 데이터 마이그레이션 작업을 생성한 후 시작합니다. 자세한 내용은 [데이터 웨어하우스에서 마이그레이션](agents.md) 단원을 참조하십시오. |
| ReportCreation | `ReportCreationTemplate.scts` | 여러 소스 데이터베이스 스키마에 대한 데이터베이스 마이그레이션 보고서를 생성합니다. 그런 다음, 이 보고서를 PDF 파일의 CSV로 저장합니다. 자세한 내용은 [평가 보고서](CHAP_AssessmentReport.md) 단원을 참조하십시오. |
| SQLScriptConversion | `SQLScriptConversionTemplate.scts` | SQL\$1Plus 또는 TSQL 스크립트를 PL/SQL로 변환하고 변환된 스크립트를 저장합니다. 또한 평가 보고서도 저장합니다. |
AWS SCT CLI 템플릿을 다운로드한 후 텍스트 편집기를 사용하여 소스 및 대상 데이터베이스에서 실행되도록 스크립트를 구성합니다. 다음으로 AWS SCT CLI 스크립트 모드를 사용하여 스크립트를 실행합니다. 자세한 내용은 [AWS SCT CLI 스크립트 모드](#CHAP_Reference.ScriptMode) 단원을 참조하십시오.
### 예제
다음 예제는 모든 템플릿을 `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](CHAP_Installing.JDBCDrivers.md) 단원을 참조하십시오.
소스 및 대상 데이터베이스의 데이터베이스 보안 인증 정보를 포함해야 합니다. 또한 변환 프로젝트의 소스-대상 페어를 설명하는 매핑 규칙을 설정해야 합니다. 자세한 내용은 [데이터 유형 매핑](CHAP_Mapping.md) 단원을 참조하십시오.
다음으로, 실행할 작업의 범위를 구성합니다. 사용하지 않는 명령을 제거하거나 새 명령을 스크립트에 추가할 수 있습니다.
예를 들어, 소스 Oracle 데이터베이스의 모든 스키마를 PostgreSQL로 변환할 계획이라고 가정해 보겠습니다. 데이터베이스 마이그레이션 평가 보고서를 PDF로 저장하고 변환된 코드를 대상 데이터베이스에 적용하도록 계획할 수 있습니다. 이 경우 `ConversionApply` 작업에 템플릿을 사용할 수 있습니다. 다음 절차에 따라 AWS SCT CLI 템플릿을 편집합니다.
**`ConversionApply` 작업에 대한 AWS SCT CLI 템플릿을 편집하려면**
1. 다운로드한 `ConversionTemplate.scts`를 엽니다. 자세한 내용은 [예제](#CHAP_Reference.Scenario.Examples) 단원을 참조하십시오.
1. **CreateFilter**, **Convert -filter**, **ApplyToTarget -filter**, **SaveTargetSQL**, **SaveTargetSQLbyStatement** 및 **SaveReportCSV** 작업을 제거합니다.
1. **SetGlobalSettings** 작업의 **oracle\$1driver\$1file**에 Oracle 드라이버의 경로를 입력합니다. 그런 다음, **postgresql\$1driver\$1file**에 PostgreSQL 드라이버의 경로를 입력합니다.
다른 데이터베이스 엔진을 사용하는 경우에는 설정에 해당 이름을 사용합니다. **SetGlobalSettings** 작업에서 설정할 수 있는 전체 전역 설정 목록은 [참조 자료](#CHAP_Reference.Download)에서 **전역 설정 매트릭스**를 참조합니다.
1. (선택 사항) **CreateProject**에 프로젝트 이름과 로컬 프로젝트 파일 위치를 입력합니다. 기본값을 사용하여 작업을 진행하는 경우 AWS SCT 는 관리자 권한을 요청하지 않고도 `C:\temp` 폴더에 파일을 생성할 수 있어야 합니다.
1. **AddSource**에 소스 데이터베이스 서버의 IP 주소를 입력합니다. 또한 소스 데이터베이스 서버에 연결할 사용자 이름, 암호 및 포트를 입력합니다.
1. **AddTarget**에 대상 데이터베이스 서버의 IP 주소를 입력합니다. 또한 대상 데이터베이스 서버에 연결할 사용자 이름, 암호 및 포트를 입력합니다.
1. (선택 사항) 매핑 규칙에 추가할 소스 및 대상 데이터베이스 객체를 **AddServerMapping**에 입력합니다. `sourceTreePath` 및 `targetTreePath` 파라미터를 사용하여 데이터베이스 객체의 경로를 지정할 수 있습니다. 선택적으로 `sourceNamePath` 및 `targetNamePath`를 사용하여 데이터베이스 객체의 이름을 지정할 수 있습니다. 자세한 내용은 [참조 자료](#CHAP_Reference.Download)에서 **서버 매핑 명령**을 참조하세요.
**AddServerMapping** 작업의 기본값은 모든 소스 스키마를 대상 데이터베이스에 매핑합니다.
1. 파일을 저장한 다음, 스크립트 모드를 사용하여 해당 파일을 실행합니다. 자세한 내용은 [스크립트 모드](#CHAP_Reference.ScriptMode) 단원을 참조하십시오.
## 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\$1path*를 스크립트가 있는 파일 경로로 바꿉니다.
AWS SCT CLI 스크립트를 실행하려면 Linux에서 다음 명령을 사용합니다.
```
RunSCTBatch.sh --pathtoscts "file_path"
```
이전 예제에서 *file\$1path*를 스크립트가 있는 파일 경로로 바꿉니다.
이 명령에 데이터베이스 보안 인증 정보, 콘솔 출력의 세부 정보 수준 등과 같은 선택적 파라미터를 제공할 수 있습니다. 자세한 내용은에서 AWS SCT 명령줄 인터페이스 참조를 다운로드하세요[참조 자료](#CHAP_Reference.Download).
### 예제
다음 예제는 `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 참조 자료
CLI 참조 가이드에서 AWS Schema Conversion Tool 명령줄 인터페이스(CLI)에 대한 참조 자료를 찾을 수 [AWS Schema Conversion Tool 있습니다](https://s3.amazonaws.com/publicsctdownload/AWS+SCT+CLI+Reference.pdf).