Partager via

Options de ligne de commande dans la console SSMA (MySQLToSQL)

  • Article

Microsoft vous fournit des options de ligne de commande robustes pour exécuter et contrôler les activités SSMA. Les sections suivantes les détaillent.

Options de ligne de commande dans la console SSMA

Les options de commande de console sont décrites ici.

Dans le cadre de cette section, le terme « option » est également appelé « commutateur ».

Les options ne respectent pas la casse et peuvent commencer par un caractère « - » ou « / ».

Si des options sont spécifiées, il est obligatoire de spécifier les paramètres d’option correspondants.

Les paramètres d’option doivent être séparés du caractère d’option par un espace blanc.

Exemples de syntaxe :

C:\> SSMAforMySQLConsole.EXE -s scriptfile

C:\> SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ServersConnectionFileSample.xml"

Les noms de dossier ou de fichier contenant des espaces doivent être spécifiés entre guillemets doubles.

La sortie des entrées de ligne de commande et les messages d’erreur sont stockés dans STDOUT, ou dans un fichier spécifié.

Option de fichier script : -s/script

Un commutateur obligatoire, le chemin/nom du fichier de script spécifie le script de séquences de commandes à exécuter avec SSMA.

Exemples de syntaxe :

C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Option de fichier de valeurs de variable : -v/variable

Ce fichier comprend des variables utilisées dans le fichier script. Ce commutateur est facultatif. Si les variables ne sont pas déclarées dans le fichier de variables et utilisées dans le fichier de script, l’application génère une erreur et met fin à l’exécution de la console.

Exemples de syntaxe :

Variables définies dans plusieurs fichiers de valeurs de variable, éventuellement une avec une valeur par défaut et une autre avec une valeur spécifique à une instance le cas échéant. Le dernier fichier de variables spécifié dans les arguments de ligne de commande est prioritaire, au cas où il existerait une duplication des variables :

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v c:\migration

projects\global_variablevaluefile.xml -v "c:\migrationprojects\instance_variablevaluefile.xml"

Option de fichier de connexion au serveur : -c/serverconnection

Ce fichier contient les informations de connexion au serveur pour chaque serveur. Chaque définition de serveur est identifiée par un ID de serveur unique. Les ID de serveur sont référencés dans le fichier script pour les commandes associées à la connexion.

La définition de serveur peut faire partie du fichier de connexion au serveur et/ou du fichier script. L’ID de serveur dans le fichier script est prioritaire sur le fichier de connexion au serveur, en cas de duplication de l’ID de serveur.

Exemples de syntaxe :

Les ID de serveur sont utilisés dans le fichier script et sont définis dans un fichier de connexion au serveur distinct. Le fichier de connexion au serveur utilise les variables définies dans le fichier de valeurs de variable :

C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v

c:\SsmaProjects\myvaluefile1.xml -c

c:\SsmaProjects\myserverconnectionsfile1.xml

La définition du serveur est incorporée dans le fichier script :

C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Option de sortie XML : -x/xmloutput [xmloutputfile]

Cette commande est utilisée pour émettre les messages de sortie de commande dans un format xml dans la console ou dans un fichier xml.

Il existe deux options disponibles pour xmloutput, viz.., :

  • Si le chemin de fichier est fourni après le commutateur xmloutput, la sortie est redirigée vers le fichier.

    Exemple de syntaxe :

    C:\>SSMAforMySQLConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml

  • Si aucun chemin de fichier n’est fourni après le commutateur xmloutput, la sortie xml s’affiche sur la console elle-même.

    Exemple de syntaxe :

    C:\>SSMAforMySQLConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Option de fichier journal : -l/log

Toutes les opérations SSMA dans l’application console sont enregistrées dans un fichier journal. Ce commutateur est facultatif. Si un fichier journal et son chemin d’accès sont spécifiés en ligne de commande, le journal est généré à l’emplacement spécifié. Sinon, il est généré à son emplacement par défaut.

Exemple de syntaxe :

C:\>SSMAforMySQLConsole.EXE

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l c:\SsmaProjects\migration1.log

Option de dossier d’environnement de projet : -e/projectenvironment

Indique le dossier des paramètres d’environnement du projet pour le projet SSMA actuel. Ce commutateur est facultatif.

Exemple de syntaxe :

C:\>SSMAforMySQLConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for MySQL\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e c:\SsmaProjects\CommonEnvironment

Option de mot de passe sécurisé : -p/securepassword

Cette option indique le mot de passe chiffré pour les connexions au serveur. Elle diffère de toutes les autres options : l’option n’exécute aucun script et n’aide dans aucune activité liée à la migration, mais permet de gérer le chiffrement de mot de passe pour les connexions serveur utilisées dans le projet de migration.

Vous ne pouvez pas entrer d’autre option ou de mot de passe en tant que paramètre de ligne de commande. Sinon, cela génère une erreur. Pour plus d’informations, consultez la section Gestion des mots de passe.

Les options suivantes ne sont pas prises en charge pour -p/securepassword :

  • Pour ajouter un mot de passe au stockage protégé pour un ID de serveur spécifié ou pour tous les ID de serveur définis dans le fichier de connexion au serveur. L’option -overwrite, ci-dessous, met à jour le mot de passe s’il existe déjà :

    -p|-securepassword -a|add {"<server_id>[, .n]"|all} -c|-serverconnection <server-connection-file> [-v|variable <variable-value-file>]``[-o|overwrite]

    -p|-securepassword -a|add {"<server_id>[, .n]"|all}``-s|-script <server-connection-file> [-v|variable <variable-value-file>] [-o|overwrite]

  • Pour supprimer le mot de passe chiffré du stockage protégé de l’ID de serveur spécifié ou pour tous les ID de serveur :

    -p/securepassword -r/remove {<server_id> [, ...n] | all}

  • Pour afficher la liste des ID de serveur pour lesquels le mot de passe est chiffré :

    -p/securepassword -l/list

  • Pour exporter les mots de passe stockés dans un stockage protégé vers un fichier chiffré. Ce fichier est chiffré avec la phrase spécifiée par l’utilisateur.

    -p/securepassword -e/export {<server-id> [, ...n] | all} <encrypted-password -file>

  • Le fichier chiffré qui a été exporté précédemment est importé dans le stockage protégé local à l’aide de la phrase secrète spécifiée par l’utilisateur. Une fois le fichier déchiffré, il est stocké dans un nouveau fichier, qui à son tour est chiffré sur l’ordinateur local.

    -p/securepassword -i/import {<server-id> [, ...n] | all} <encrypted-password -file>

    Plusieurs ID de serveur peuvent être spécifiés à l’aide de virgules de séparation.

Option d’aide : -?/Help

Affiche le résumé de la syntaxe des options de la console SSMA :

C:\>SSMAforMySQLConsole.EXE -?

Pour un affichage tabulaire des options de ligne de commande de la console SSMA, reportez-vous à l’Annexe - 1 (MySQLToSQL).

Option d’aide SecurePassword : -securepassword -?/Help

Affiche le résumé de la syntaxe des options de la console SSMA :

C:\>SSMAforMySQLConsole.EXE -securepassword -?

Pour un affichage tabulaire des options de ligne de commande de la console SSMA, reportez-vous à l’Annexe - 1 (MySQLToSQL)

étape suivante

L’étape suivante dépend des exigences de votre projet :