変数値ファイルは、サーバーの移行間で頻繁に変更されるコマンド (移行元または移行先サーバー名など) のパラメーター値で構成される XML ファイルです。 多数のデータベース移行が発生すると、各ソース サーバーの値を格納するための複数の変数ファイルが作成され、コマンド ラインで -v スイッチを使用してマスター スクリプト ファイルで参照されます。 この動作は、複数の変数ファイルの変数値を使用して、いくつかのスクリプト ファイル内の静的な値を維持するのに役立ちます。
次の条件が適用されます:
変数名にはプレフィックスが付き、サフィックスに $ (ドル) 記号が付きます。 変数に変数値ファイル内の値が割り当てられていない場合、スクリプト ファイルの解析中にエラーが発生し、コンソールの実行プロセスがストールします。
$のエスケープ文字が$$。 パラメーターの変数または静的値の値に$(ドル) 記号が含まれている場合は、変数ではなく文字として扱うために$$を指定する必要があります。保守容易性のために、ユーザー定義変数を論理的に分離するために、
'variable-group'要素内で変数を宣言できます。 この要素の使用は必須ではありません。
例示
例 1
変数値ファイル コマンドのサンプル:
<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-2016"/>
</variable-group>
</variables>
例 2
変数値ファイル コマンドのサンプル:
<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>
変数値ファイルの検証
ユーザーは、ConsoleScriptVariablesSchema.xsd フォルダーで使用できるスキーマ定義ファイルSchemasに対して変数値ファイルを簡単に検証できます。