Создание файлов значений переменных (AccessToSQL)

Файл значения переменной — это XML-файл, содержащий значения параметров команд (например, имя исходного или целевого сервера), которые часто изменяются во время миграции сервера. При большом количестве миграций базы данных создается несколько файлов переменных для хранения значения каждого исходного сервера и ссылаются на них в главном файле скрипта с параметром -v в командной строке. Это поведение помогает поддерживать статические значения в нескольких файлах скриптов со значениями переменных в нескольких файлах переменных.

Применяются следующие условия:

  • Имена переменных префиксируются и суффиксируются символом $ (доллар). Если переменная не назначена в файле значений переменной, возникает ошибка во время синтаксического анализа файла скрипта, что приведет к остановке процесса выполнения консоли.

  • Escape-символ для $ — это $$. Если значение переменной или статического значения параметра содержит $ символ (доллар), $$ необходимо указать его как символ вместо переменной.

  • В целях обеспечения поддержки переменные можно объявлять внутри '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 .

Связанный контент

  • Last updated on