変数値ファイルは、サーバーの移行間で頻繁に変更されるコマンド (移行元または移行先サーバー名など) のパラメーター値で構成される XML ファイルです。 多数のデータベース移行が発生すると、各ソース サーバーの値を格納するための複数の変数ファイルが作成され、コマンド ラインで -v スイッチを使用してマスター スクリプト ファイルで参照されます。 この動作は、複数の変数ファイルの変数値を使用して、いくつかのスクリプト ファイル内の静的な値を維持するのに役立ちます。
注
- 変数名にはプレフィックスが付き、サフィックスに $ (ドル) 記号が付きます。 変数に変数値ファイル内の値が割り当てられない場合、スクリプト ファイルの解析中にエラーが発生し、コンソールの実行プロセスがストールします。
- $のエスケープ文字が$$。 パラメーターの変数または静的値の値に $ (ドル) 記号が含まれている場合は、変数ではなく文字として扱うために $$ を指定する必要があります。
- 保守容易性のために、ユーザー定義変数を論理的に分離するために、
'variable-group'
要素内で変数を宣言できます。 この要素の使用は必須ではありません。
例:
例 1:
<!--Sample of variable value file commands-->
<variables>
<variable-group name="ProjectSpecs">
<variable name="$type$" value="MyProject"/>
<variable name="$project_folder$" value=".\$project_name$"/>
<variable name="$project_name$" value="$type$ConsoleProject"/>
<variable name="$project_overwrite$" value="true"/>
<variable name="$project_type$" value="sql-server-2008"/>
</variable-group>
</variables>
例 2:
<!--Sample of variable value file commands-->
<variables>
<variable-group name="SQLServerParams">
<variable-group name="SqlServerConnectionParams">
<variable name="$TargetServerName$" value="xxx"/>
<variable name="$TargetDB$" value="xxx"/>
<variable name="$TargetUserName$" value="xxx"/>
<variable name="$TargetPassword$" value="xxx"/>
<variable name="$TargetIsTrusted$" value="xxx"/>
<variable name="$TrustedConnection$" value="xxx"/>
</variable-group>
<variable-group name="SqlServerObjectParams">
<variable name="$ObjectName1$" value="TestTable1"/>
<variable name="$ObjectName2$" value="TestProc1"/>
</variable-group>
</variable-group>
</variables>
変数値ファイルの検証
ユーザーは、'Schemas' フォルダーにあるスキーマ定義ファイル ConsoleScriptVariablesSchema.xsd に対して変数値ファイルを簡単に検証できます。
次のステップ
コンソールを操作する次の手順は、サーバー接続ファイルの作成 (AccessToSQL) です。