SSMA 콘솔의 명령줄 옵션(Db2ToSQL)

아티클
01/02/2025

SSMA(SQL Server Migration Assistant)는 Db2 작업을 실행하고 제어하는 강력한 명령줄 옵션 집합을 제공합니다. 이어지는 섹션에서 이 내용을 자세히 설명합니다.

SSMA 콘솔의 명령줄 옵션

이 섹션에서는 스위치라고도 하는 콘솔 명령 옵션에 대해 설명합니다.

옵션은 대/소문자를 구분하지 않으며 문자 또는 - / 문자로 시작할 수 있습니다.

옵션을 지정한 경우 해당 옵션 매개 변수를 지정해야 합니다.

선택적 매개 변수는 옵션 문자와 공백으로 구분해야 합니다.

구문 예제:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ServersConnectionFileSample.xml"

공백이 포함된 폴더 및 파일 이름은 큰따옴표로 지정해야 합니다.

명령줄 항목 및 오류 메시지의 출력은 STDOUT 또는 지정된 파일에 저장됩니다.

스크립트 파일 옵션: -s | 각본

필수 스위치인 스크립트 파일 경로/이름은 SSMA가 실행하는 명령 시퀀스의 스크립트를 지정합니다.

구문 예제:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

변수 값 파일 옵션: -v | 변수

이 파일은 스크립트 파일에 사용되는 변수로 구성됩니다. 이 스위치는 선택 사항입니다. 변수가 변수 파일에 선언되지 않고 스크립트 파일에 사용되는 경우 애플리케이션은 오류를 생성하고 콘솔 실행을 종료합니다.

구문 예제:

여러 변수 값 파일에 정의된 변수(기본값이 있는 변수와 해당되는 경우 인스턴스별 값이 있는 변수)입니다. 명령줄 인수에 지정된 마지막 변수 파일은 변수가 중복되는 경우 기본 설정을 사용합니다.

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migration projects\global_variablevaluefile.xml -v "C:\migrationprojects\instance_variablevaluefile.xml"

서버 연결 파일 옵션: -c | serverconnection

이 파일에는 각 서버에 대한 서버 연결 정보가 포함되어 있습니다. 각 서버 정의는 고유한 서버 ID로 식별됩니다. 서버 ID는 연결 관련 명령에 대한 스크립트 파일에서 참조됩니다.

서버 정의는 서버 연결 파일 및/또는 스크립트 파일의 일부일 수 있습니다. 서버 ID가 중복되는 경우 스크립트 파일의 서버 ID가 서버 연결 파일보다 우선합니다.

구문 예제:

서버 ID는 스크립트 파일에 사용되며 별도의 서버 연결 파일에서 정의합니다. 서버 연결 파일은 변수 값 파일에 정의된 변수를 사용합니다.

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\SsmaProjects\myvaluefile1.xml -c C:\SsmaProjects\myserverconnectionsfile1.xml

서버 정의는 스크립트 파일에 포함됩니다.

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

XML 출력 옵션: -x | xmloutput [ xmloutputfile ]

이 명령은 콘솔 또는 XML 파일에 XML 형식으로 명령 출력 메시지를 출력하는 데 사용됩니다.

예를 들어 다음과 같은 두 가지 옵션을 사용할 수 있습니다 xmloutput.

스위치 후에 파일 경로가 xmloutput 제공되면 출력이 파일로 리디렉션됩니다.

구문 예제:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml

스위치 xmlout 후에 xmloutput 파일 경로가 제공되지 않으면 콘솔 자체에 표시됩니다.

구문 예제:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

로그 파일 옵션: -l | 로그

콘솔 애플리케이션의 모든 SSMA 작업은 로그 파일에 기록됩니다. 이 스위치는 선택 사항입니다. 명령줄에서 로그 파일과 해당 경로를 지정하면 지정된 위치에 로그가 생성됩니다. 그렇지 않으면 기본 위치에 생성됩니다.

구문 예제:

SSMAforDb2Console.exe "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l C:\SsmaProjects\migration1.log

프로젝트 환경 폴더 옵션: -e | projectenvironment

현재 SSMA 프로젝트의 프로젝트 환경 설정 폴더를 표시합니다. 이 스위치는 선택 사항입니다.

구문 예제:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e C:\SsmaProjects\CommonEnvironment

보안 암호 옵션: -p | securepassword

이 옵션은 서버 연결에 대한 암호화된 암호를 나타냅니다. 다른 모든 옵션과 다릅니다. 이 옵션은 스크립트를 실행하지 않거나 마이그레이션 관련 활동에 도움이 됩니다. 대신 마이그레이션 프로젝트에 사용되는 서버 연결에 대한 암호 암호화를 관리하는 데 도움이 됩니다.

명령줄 매개 변수로 다른 옵션이나 암호를 입력할 수 없습니다. 그렇지 않으면 오류가 발생합니다. 자세한 내용은 암호 관리를 참조 하세요.

다음 하위 구성 요소가 지원됩니다.-p | securepassword

지정된 서버 ID 또는 서버 연결 파일에 정의된 모든 서버 ID에 대해 보호된 스토리지에 암호를 추가합니다. 이 -overwrite 옵션은 이미 있는 경우 암호를 업데이트합니다.

-p | -securepassword -a | add { "<server_id> [, ...n]" | all }
-c | -serverconnection <server-connection-file> [ -v | variable <variable-value-file> ]
[ -o | overwrite]

-p | -securepassword -a | add { "<server_id>[, ...n]" | all }
-s | -script <server-connection-file> [ -v | variable <variable-value-file> ]
[ -o | overwrite]

지정된 서버 ID 또는 모든 서버 ID의 보호된 스토리지에서 암호화된 암호를 제거하려면 다음을 수행합니다.
```
-p | securepassword -r | remove { <server_id> [, ...n] | all }
```
암호가 암호화된 서버 ID 목록을 표시하려면 다음을 수행합니다.
```
-p | securepassword -l | list
```
보호된 스토리지에 저장된 암호를 암호화된 파일로 내보내려면 다음을 수행합니다. 이 파일은 사용자 지정 암호구로 암호화됩니다.
```
-p | securepassword -e | export { <server-id> [, ...n] | all } <encrypted-password-file>
```
이전에 내보낸 암호화된 파일은 사용자 지정 암호구를 사용하여 로컬로 보호된 스토리지로 가져옵니다. 파일이 암호 해독되면 새 파일에 저장되고, 그러면 로컬 컴퓨터에서 암호화됩니다.
```
-p | securepassword -i | import { <server-id> [, ...n] | all } <encrypted-password-file>
```
쉼표 구분 기호를 사용하여 여러 서버 ID를 지정할 수 있습니다.

도움말 옵션: -? | 도움말

SSMA 콘솔 옵션의 구문 요약을 표시합니다.

SSMAforDb2Console.exe -?

SSMA 콘솔 명령줄 옵션의 테이블 형식 표시는 부록 1: 콘솔 명령줄 옵션을 참조 하세요.

SecurePassword 도움말 옵션: -securepassword -? | 도움말

SSMA 콘솔 옵션의 구문 요약을 표시합니다.

SSMAforDb2Console.exe -securepassword -?

SSMA 콘솔 명령줄 옵션의 테이블 형식 표시는 부록 1: 콘솔 명령줄 옵션을 참조 하세요.

다음을 통해 공유

SSMA 콘솔의 명령줄 옵션(Db2ToSQL)