Création de fichiers de valeur de variable (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 commutateur -v sur la 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.
Note
- 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.
- Caractère d’échappement pour $ lequel 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.
Exemples :
Exemple 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>
Exemple 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>
Validation du fichier de valeurs variables
L’utilisateur peut facilement valider son fichier de valeur variable par rapport au fichier de définition de schéma ConsoleScriptVariablesSchema.xsd disponible dans le dossier « Schemas ».
Étape suivante
L’étape suivante dans l’exploitation de la console consiste à créer les fichiers de connexion de serveur (AccessToSQL)