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

  • 아티클

Microsoft는 SSMA 활동을 실행하고 제어하는 강력한 명령줄 옵션 집합을 제공합니다. 이어지는 섹션에서 이 내용을 자세히 설명합니다.

SSMA 콘솔의 명령줄 옵션

여기에 설명된 콘솔 명령 옵션은 다음과 같습니다.

이 섹션에서는 '옵션'이라는 용어를 '스위치'라고도 합니다.

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

  • 옵션을 지정하면 해당 선택적 매개 변수를 지정해야 합니다.

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

    구문 예제:

    C:\> SSMAforOracleConsole.EXE -s scriptfile

    C:\> SSMAforOracleConsole.EXE -s "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \AssessmentReportGenerationSample.xml" -v "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \VariableValueFileSample.xml" -c "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \ServersConnectionFileSample.xml"

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

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

스크립트 파일 옵션: -s/script

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

구문 예제:

C:\>SSMAforOracleConsole.EXE -s "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \ConversionAndDataMigrationSample.xml"

변수 값 파일 옵션: -v/variable

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

구문 예제:

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

    C:\>SSMAforOracleConsole.EXE -s

    "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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는 스크립트 파일에서 사용되며 별도의 서버 연결 파일에 정의됩니다. 서버 연결 파일은 변수 값 파일에 정의된 변수를 사용합니다.

    C:\>SSMAforOracleConsole.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \ConversionAndDataMigrationSample.xml" -v

    c:\SsmaProjects\myvaluefile1.xml -c

    c:\SsmaProjects\myserverconnectionsfile1.xml

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

    C:\>SSMAforOracleConsole.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \ConversionAndDataMigrationSample.xml"

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

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

xmloutput, viz..,에 사용할 수 있는 두 가지 옵션이 있습니다.

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

    구문 예제:

    C:\>SSMAforOracleConsole.EXE -s

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

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

    구문 예제:

    C:\>SSMAforOracleConsole.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \ConversionAndDataMigrationSample.xml" -xmloutput

로그 파일 옵션: -l/log

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

구문 예제:

C:\>SSMAforOracleConsole.EXE

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

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

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

구문 예제:

C:\>SSMAforOracleConsole.EXE -s

"C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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를 지정할 수 있습니다.

도움말 옵션: -?/Help

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

C:\>SSMAforOracleConsole.EXE -?

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

SecurePassword 도움말 옵션: -securepassword -?/Help

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

C:\>SSMAforOracleConsole.EXE -securepassword -?

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

다음 단계

다음 단계는 프로젝트 요구 사항에 따라 달라집니다.