SSMA コンソールのコマンド ライン オプション (MySQLToSQL)

  • [アーティクル]

Microsoft には、SSMA アクティビティを実行と制御するための堅牢なコマンド ライン オプションが用意されています。 その後のセクションの詳細は同じです。

SSMA コンソールのコマンド ライン オプション

ここでは、コンソール コマンド オプションについて説明します。

このセクションでは、「オプション」という用語を「スイッチ」とも呼びます。

オプションでは大文字と小文字が区別されず、'-' または '/' 文字で始まる場合があります。

オプションが指定されている場合は、対応するオプション パラメーターを指定することが必須です。

オプション パラメーターは、オプション文字から空白で区切る必要があります。

構文の例:

C:\> SSMAforMySQLConsole.EXE -s scriptfile

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

スペースを含むフォルダー名またはファイル名は、二重引用符で囲む必要があります。

コマンド ライン エントリとエラー メッセージの出力は、STDOUT または指定されたファイルに格納されます。

スクリプト ファイル オプション: -s/script

必須スイッチ、スクリプト ファイルのパス/名前は、SSMA によって実行されるコマンド シーケンスのスクリプトを指定します。

構文の例:

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

変数値ファイル オプション: -v/variable

このファイルは、スクリプト ファイルで使用される変数で構成されます。 これはオプションのスイッチです。 変数が変数ファイルで宣言されておらず、スクリプト ファイルで使用されている場合、アプリケーションはエラーを生成し、コンソールの実行を終了します。

構文の例:

複数の変数値ファイルで定義されている変数(既定値を持つ変数と、該当する場合はインスタンス固有の値を持つ変数)。 変数が重複している場合は、コマンド ライン引数で指定された最後の変数ファイルが優先されます。

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\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:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v

c:\SsmaProjects\myvaluefile1.xml -c

c:\SsmaProjects\myserverconnectionsfile1.xml

サーバー定義はスクリプト ファイルに埋め込まれています。

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

XML 出力オプション: -x/xmloutput [xmloutputfile]

このコマンドは、コンソールまたは xml ファイルに xml 形式でコマンド出力メッセージを出力するために使用されます。

xmloutput には、次の 2 つのオプションがあります。

  • xmloutput スイッチの後にファイルパスが指定されている場合、出力はファイルにリダイレクトされます。

    構文の例:

    C:\>SSMAforMySQLConsole.EXE -s

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

  • xmloutput スイッチの後にファイルパスが指定されていない場合、xmlout はコンソール自体に表示されます。

    構文の例:

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

ログ ファイル オプション: -l/log

コンソール アプリケーションのすべての SSMA 操作がログ ファイルに記録されます。 これはオプションのスイッチです。 コマンド ラインでログ ファイルとそのパスを指定すると、指定した場所にログが生成されます。 それ以外の場合は、既定の場所で生成されます。

構文の例:

C:\>SSMAforMySQLConsole.EXE

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

プロジェクト環境フォルダー オプション: -e/projectenvironment

これは、現在の SSMA プロジェクトのプロジェクト環境設定フォルダーを表します。 このスイッチはオプションです。

構文の例:

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\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:\>SSMAforMySQLConsole.EXE -?

SSMA コンソールのコマンド ライン オプションの表形式の表示については、「付録 1 (MySQLToSQL)」を参照してください。

SecurePassword ヘルプ オプション: -securepassword -?/Help

SSMA コンソール オプションの構文の概要を表示します。

C:\>SSMAforMySQLConsole.EXE -securepassword -?

SSMA コンソールのコマンド ライン オプションの表形式の表示については、「付録 1 (MySQLToSQL)」を参照してください。

次の手順

次の手順は、プロジェクトの要件によって異なります。