Créer des fichiers de valeurs de variables (AccessToSQL)

Un fichier de valeur de variable est un fichier XML comprenant les valeurs de paramètres des commandes (telles que le nom du serveur source ou de destination) qui changent fréquemment entre les migrations de serveur. Lorsqu’un grand nombre de migrations de base de données se produisent, plusieurs fichiers variables permettant de stocker la valeur de chaque serveur source sont créés et référencés dans un fichier de script maître avec le -v commutateur en ligne de commande. Ce comportement permet de conserver des valeurs statiques dans quelques fichiers de script avec les valeurs des variables dans plusieurs fichiers de variables.

Les conditions suivantes s'appliquent :

• Les noms de variables sont préfixés et suffixes avec un symbole $ (dollar). Si une variable n’est pas affectée à une valeur dans le fichier de valeur de variable, une erreur lors de l’analyse du fichier de script se produit, ce qui bloque le processus d’exécution de la console.

• Le caractère d'échappement pour $ est $$. Si la valeur d’une variable ou d’une valeur statique d’un paramètre contient un $ symbole (dollar), elle $$ doit être spécifiée pour la traiter comme un caractère au lieu d’une variable.

• À des fins de maintenance, les variables peuvent être déclarées à l’intérieur des 'variable-group' éléments pour la séparation logique des variables définies par l’utilisateur. L’utilisation de cet élément n’est pas obligatoire.

Examples

Exemple 1

Exemple de commandes de fichier de valeur variable :

<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>

Exemple 2

Exemple de commandes de fichier de valeur variable :

<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>

Validation du fichier de valeurs variables

L’utilisateur peut facilement valider son fichier de valeur variable par rapport au fichier ConsoleScriptVariablesSchema.xsd de définition de schéma disponible dans le Schemas dossier.

Contenu connexe

• Créer les fichiers de connexion du serveur