Exécution de la console SSMA (AccessToSQL)
Microsoft vous fournit un ensemble robuste de commandes de fichier de script et d’options de ligne de commande pour exécuter et contrôler les activités SSMA. Les sections suivantes détaillent la même chose.
Commandes de fichier de script de projet
Les commandes Project gèrent la création de projets, l’ouverture, l’enregistrement et la sortie de projets.
Commande
create-new-project : crée un projet SSMA.
Script
project-folder
indique le dossier du projet créé.project-name
indique le nom du projet. {string}overwrite-if-exists
L’attribut facultatif indique si un projet existant doit être remplacé. {boolean}project-type
est un attribut facultatif. Les options suivantes sont disponibles pour le type de projet :sql-server-2005
sql-server-2008
sql-server-2012
sql-server-2014
sql-server-2016
SQL Azure
La valeur par défaut est « sql-server-2008 ».
Exemple :
<create-new-project
project-folder="<project-folder>"
project-name="<project-name>"
overwrite-if-exists="<true/false>"
project-type="<sql-server-2008 | sql-server-2005 | sql-server-2012 | sql-server-2014 | sql-azure>"
/>
L’attribut 'overwrite-if-exists' est false par défaut.
L’attribut ' project-type' est sql-server-2008 par défaut.
Commande
open-project : ouvre un projet existant.
Script
project-folder
indique le dossier du projet créé. La commande échoue si le dossier spécifié n’existe pas. {string}project-name
indique le nom du projet. La commande échoue si le projet spécifié n’existe pas. {string}
Exemple de syntaxe :
<open-project
project-folder="<project-folder>"
project-name="<project-name>"
/>
Remarque : L’application SSMA for Access Console prend en charge la compatibilité descendante. Vous pouvez ouvrir des projets créés par la version précédente de SSMA.
Commande
save-project : enregistre le projet de migration.
Script
Exemple de syntaxe :
<save-project/>
Commande
close-project : ferme le projet de migration.
Script
Exemple de syntaxe :
<close-project
if-modified="<save/error/ignore>" (optional)
/>
L’attribut 'if-modified' est facultatif, ignoré par défaut.
Commandes de fichier de script de connexion de base de données
Les commandes de connexion de base de données aident à se connecter à la base de données.
La fonctionnalité Parcourir de l’interface utilisateur n’est pas prise en charge dans la console.
Les paramètres d’authentification windows et de port ne s’appliquent pas lors de la connexion à SQL Azure.
Pour plus d’informations sur la création de fichiers de script, consultez Création de fichiers de script (AccessToSQL).
Commande
connect-source-database
Effectue une connexion à la base de données source et charge des métadonnées de haut niveau de la base de données source, mais pas toutes les métadonnées.
Si la connexion à la source ne peut pas être établie, une erreur est générée et l’application console arrête l’exécution ultérieure
Script
La définition du serveur est récupérée à partir de l’attribut de nom défini pour chaque connexion dans la section serveur du fichier de connexion du serveur ou du fichier de script.
Exemple de syntaxe :
<connect-source-database server="<server-unique-name>"/>
Commande
load-access-database : utilisé pour charger les fichiers de base de données d’accès
Script
Exemple de syntaxe :
<load-access-database database-file="<Access-database>"/>
ou
<load-access-database>
<access-database database-file="<Access-database1>"/>
<access-database database-file="<Access-database2>"/>
</load-access-database>
Commande
force-load-source/target-database
Charge les métadonnées sources.
Utile pour travailler sur le projet de migration hors connexion.
Si la connexion à la source/cible ne peut pas être établie, une erreur est générée et l’application console arrête l’exécution ultérieure
Script
Nécessite un ou plusieurs nœuds de métabase comme paramètre de ligne de commande.
Exemple de syntaxe :
<force-load
object-name="<object-name>"
metabase="<source/target>"/>
ou
<force-load>
<metabase-object object-name="<object-name>"/>
</force-load>
Commande
reconnect-source-database
Se reconnecte à la base de données source, mais ne charge pas de métadonnées contrairement à la commande connect-source-database.
Si (re)connexion avec la source ne peut pas être établie, une erreur est générée et l’application console arrête l’exécution ultérieure.
Script
Exemple de syntaxe :
<reconnect-source-database server="<server-unique-name>"/>
Commande
connect-target-database
Se connecte à SQL Server ou SQL Azure Database cible et charge les métadonnées de haut niveau de la base de données cible, mais pas entièrement les métadonnées.
Si la connexion à la cible ne peut pas être établie, une erreur est générée et l’application console arrête l’exécution ultérieure.
Script
La définition du serveur est récupérée à partir de l’attribut de nom défini pour chaque connexion dans la section serveur du fichier de connexion du serveur ou du fichier de script
Exemple de syntaxe :
<connect-target-database server="<server-unique-name>"/>
Commande
reconnect-target-database
Se reconnecte à la base de données cible, mais ne charge pas de métadonnées, contrairement à la commande connect-target-database.
Si la (re)connexion à la cible ne peut pas être établie, une erreur est générée et l’application console arrête l’exécution ultérieure.
Script
Exemple de syntaxe :
<reconnect-target-database server="<server-unique-name>"/>
Commandes de fichier de script de rapport
Les commandes rapport génèrent des rapports sur les performances des différentes activités de la console SSMA
Commande
generate-assessment-report
Génère des rapports d’évaluation sur la base de données source.
Si la connexion de base de données source n’est pas effectuée avant d’exécuter cette commande, une erreur est générée et l’application console se ferme.
L’échec de la connexion au serveur de base de données source pendant l’exécution de la commande entraîne également la fin de l’application console.
Script
assessment-report-folder:
Spécifie le dossier dans lequel le rapport d’évaluation peut être stocké. (attribut facultatif)object-name:
Spécifie le ou les objets pris en compte pour la génération de rapport d’évaluation (il peut avoir des noms d’objets individuels ou un nom d’objet de groupe).object-type:
spécifie le type de l’objet spécifié dans l’attribut object-name (si la catégorie d’objet est spécifiée, le type d’objet sera « category »).assessment-report-overwrite:
Spécifie s’il faut remplacer le dossier du rapport d’évaluation s’il existe déjà.Valeur par défaut : false. (attribut facultatif)
write-summary-report-to:
Spécifie le chemin d’accès où le rapport sera généré.Si seul le chemin du dossier est mentionné, le fichier par nom AssessmentReport<n.XML> est créé. (attribut facultatif)
La création de rapports comporte deux sous-catégories supplémentaires :
report-errors
(="true/false », avec la valeur par défaut « false » (attributs facultatifs))verbose
(="true/false », avec la valeur par défaut « false » (attributs facultatifs))
Exemple de syntaxe :
<generate-assessment-report
object-name="ssma.Procedures"
object-type="category"
write-summary-report-to="<file>" (optional)
verbose="<true/false>" (optional)
report-errors="<true/false>" (optional)
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
/>
ou
<generate-assessment-report
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
>
<metabase-object object-name="ssma.Procedures"
object-type="category"/>
</generate-assessment-report>
Commandes de fichier de script de migration
Les commandes de migration convertissent le schéma de base de données cible en schéma source et migrent les données vers le serveur cible.
Le paramètre de sortie de la console par défaut pour les commandes de migration est le rapport de sortie « Complet » sans rapport d’erreurs détaillé : résumé uniquement au niveau du nœud racine de l’arborescence d’objets source.
Commande
convert-schema
Effectue la conversion de schéma de la source vers le schéma cible.
Si la connexion de base de données source ou cible n’est pas effectuée avant d’exécuter cette commande ou si la connexion au serveur de base de données source ou cible échoue pendant l’exécution de la commande, une erreur est générée et l’application console se ferme.
Script
conversion-report-folder:
Spécifie le dossier dans lequel le rapport d’évaluation peut être stocké. (attribut facultatif)object-name:
Spécifie le ou les objets sources pris en compte pour la conversion du schéma (il peut avoir des noms d’objets individuels ou un nom d’objet de groupe).object-type:
spécifie le type de l’objet spécifié dans l’attribut object-name (si la catégorie d’objet est spécifiée, le type d’objet sera « category »).conversion-report-overwrite:
Spécifie s’il faut remplacer le dossier du rapport d’évaluation s’il existe déjà.Valeur par défaut : false. (attribut facultatif)
write-summary-report-to:
Spécifie le chemin d’accès où le rapport sera généré.Si seul le chemin du dossier est mentionné, le fichier par nom SchemaConversionReport<n.XML> est créé. (attribut facultatif)
La création de rapports comporte deux sous-catégories supplémentaires :
report-errors
(="true/false », avec la valeur par défaut « false » (attributs facultatifs))verbose
(="true/false », avec la valeur par défaut « false » (attributs facultatifs))
Exemple de syntaxe :
<convert-schema
object-name="ssma.Procedures"
object-type="category"
write-summary-report-to="<filepath/folder>" (optional)
verbose="<true/false>" (optional)
report-errors="<true/false>" (optional)
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
/>
ou
<convert-schema
conversion-report-folder="<folder>" (optional)
conversion-report-overwrite="<true/false>" (optional)
<metabase-object object-name="ssma.Procedures"
object-type="category"/>
</convert-schema>
Commande
migrate-data
- Migre les données sources vers la cible.
Script
object-name:
Spécifie le ou les objets sources pris en compte pour la migration de données (il peut avoir des noms d’objets individuels ou un nom d’objet de groupe).object-type:
spécifie le type de l’objet spécifié dans l’attribut object-name (si la catégorie d’objet est spécifiée, le type d’objet sera « category »).write-summary-report-to:
Spécifie le chemin d’accès où le rapport sera généré.Si seul le chemin du dossier est mentionné, le fichier par nom DataMigrationReport<n.XML> est créé. (attribut facultatif)
La création de rapports comporte deux sous-catégories supplémentaires :
report-errors
(="true/false », avec la valeur par défaut « false » (attributs facultatifs))verbose
(="true/false », avec la valeur par défaut « false » (attributs facultatifs))
Exemple de syntaxe :
<migrate-data
write-summary-report-to="<filepath/folder>"
report-errors="true" verbose="true">
<metabase-object object-name="ssma.TT1"/>
<metabase-object object-name="ssma.TT2"/>
<metabase-object object-name="ssma.TT3"/>
<data-migration-connection
source-use-last-used="true"/source-server="<server-unique-name>"
target-use-last-used="true"/target-server="<server-unique-name>"/>
</migrate-data>
ou
<migrate-data
object-name="ssma.Tables"
object-type="category"
write-summary-report-to="<filepath/folder>"
report-errors="true" verbose="true"/>
Commande
link-tables : cette commande lie la table source (Access) à la table cible.
Script
Exemple de syntaxe :
<link-tables>
<metabase-object object-name="AccessDatabase.table1" object-type="Tables"/>
<metabase-object object-name="AccessDatabase.table2" object-type="Tables"/>
</link-tables>
ou
<link-tables>
<metabase-object object-name="AccessDatabase.Tables" object-type="category"/>
</link-tables>
Commande
dissocier les tables : cette commande dissocie la table source (Access) de la table cible.
Script
Exemples de syntaxe :
<unlink-tables>
<metabase-object object-name="AccessDatabase.table1" object-type="Tables"/>
<metabase-object object-name="AccessDatabase.table2" object-type="Tables"/>
</unlink-tables>
ou
<unlink-tables>
<metabase-object object-name="AccessDatabase.Tables" object-type="category"/>
</unlink-tables>
Commandes de fichier de script de préparation de la migration
La commande Préparation de la migration démarre le mappage de schéma entre les bases de données source et cible.
Commande
map-schema : mappage de schéma de la base de données source au schéma cible.
Script
source-schema
spécifie le schéma source que nous avons l’intention de migrer.sql-server-schema
spécifie le schéma cible dans lequel nous voulons qu’il soit migré.
Exemple de syntaxe :
<map-schema source-schema="source-schema"
sql-server-schema="target-schema"/>
Commandes de facilité de gestion
Les commandes de facilité de gestion permettent de synchroniser les objets de base de données cibles avec la base de données source.
Le paramètre de sortie de la console par défaut pour les commandes de migration est le rapport de sortie « Complet » sans rapport d’erreurs détaillé : résumé uniquement au niveau du nœud racine de l’arborescence d’objets source.
Commande
synchronize-target
Synchronise les objets cibles avec la base de données cible.
Si cette commande est exécutée sur la base de données source, vous obtenez une erreur.
Si la connexion de base de données cible n’est pas effectuée avant d’exécuter cette commande ou si la connexion au serveur de base de données cible échoue pendant l’exécution de la commande, une erreur est générée et l’application console se ferme.
Script
object-name:
Spécifie le ou les objets cibles pris en compte pour la synchronisation avec la base de données cible (il peut avoir des noms d’objets individuels ou un nom d’objet de groupe).object-type:
Spécifie le type de l’objet spécifié dans l’attribut object-name (si la catégorie d’objet est spécifiée, le type d’objet sera « category »).on-error:
Spécifie s’il faut spécifier des erreurs de synchronisation en tant qu’avertissements ou erreur. Options disponibles pour l’erreur :rapport-total-as-warning
rapport-each-as-warning
fail-script
report-errors-to:
Spécifie l’emplacement du rapport d’erreur pour l’opération de synchronisation (attribut facultatif) si seul le chemin du dossier est donné, le fichier par nom TargetSynchronizationReport.XML est créé.
Exemple de syntaxe :
<synchronize-target
object-name="ots_triggers.dbo"
on-error="<report-total-as-warning|
report-each-as-warning|
fail-script>" (optional)
report-errors-to="<file-name>" (optional)
/>
ou
<synchronize-target
object-name="ssma.dbo.Procedures"
object-type="category"/>
ou
<synchronize-target>
<metabase-object object-name="ssma.dbo.TT1"/>
<metabase-object object-name="ssma.dbo.TT2"/>
<metabase-object object-name="ssma.dbo.TT3"/>
</synchronize-target>
Commande
refresh-from-database
Actualise les objets sources de la base de données.
Si cette commande est exécutée sur la base de données cible, une erreur est générée.
Script
Nécessite un ou plusieurs nœuds de métabase comme paramètre de ligne de commande.
object-name:
Spécifie le ou les objets sources pris en compte pour l’actualisation à partir de la base de données source (il peut avoir des noms d’objets individuels ou un nom d’objet de groupe).object-type:
Spécifie le type de l’objet spécifié dans l’attribut object-name (si la catégorie d’objet est spécifiée, le type d’objet sera « category »).on-error:
Spécifie s’il faut spécifier des erreurs d’actualisation en tant qu’avertissements ou erreur. Options disponibles pour l’erreur :rapport-total-as-warning
rapport-each-as-warning
fail-script
report-errors-to:
Spécifie l’emplacement du rapport d’erreur pour l’opération d’actualisation (attribut facultatif) si seul le chemin du dossier est donné, le fichier par nom SourceDBRefreshReport.XML est créé.
Exemple de syntaxe :
<refresh-from-database
object-name="ssma.TT1"
on-error="<report-total-as-warning|
report-each-as-warning|
fail-script>" (optional)
report-errors-to="<file-name>" (optional)
/>
ou
<refresh-from-database
object-name="ssma.Procedures"
object-type="category"/>
ou
<refresh-from-database>
<metabase-object object-name="ssma.TT_1"/>
</refresh-from-database>
Commandes de fichier de script de génération de script
Les commandes génération de script permettent d’enregistrer la sortie de la console dans un fichier de script.
Commande
save-as-script
Utilisé pour enregistrer les scripts des objets dans un fichier mentionné lorsque metabase=target, il s’agit d’une alternative à la commande de synchronisation dans laquelle nous obtenons les scripts et nous exécutons la même opération sur la base de données cible.
Script
Nécessite un ou plusieurs nœuds de métabase comme paramètre de ligne de commande.
object-name:
Spécifie les objets dont les scripts doivent être enregistrés. (Il peut avoir des noms d’objets individuels ou un nom d’objet de groupe)object-type:
spécifie le type de l’objet spécifié dans l’attribut object-name (si la catégorie d’objet est spécifiée, le type d’objet sera « category »).metabase:
Spécifie s’il s’agit de la métabase source ou cible.destination:
Spécifie le chemin d’accès ou le dossier dans lequel le script doit être enregistré ; si le nom de fichier n’est pas donné, un nom de fichier au format (object_name valeur d’attribut).outoverwrite:
si la valeur est true, elle remplace si les mêmes noms de fichiers existent. Elle peut avoir les valeurs (true/false).
Exemple de syntaxe :
<save-as-script
metabase="<source/target>"
object-name="ssma.dbo.Procedures"
object-type="category"
destination="<file/folder>"
overwrite="<true/false>" (optional)
/>
ou
<save-as-script
metabase="<source/target>"
destination="<file/folder>"
<metabase-object object-name="ssma.dbo.Procedures"
object-type="category"/>
</save-as-script>
Étapes suivantes
Pour plus d’informations sur les options de ligne de commande, consultez Options de ligne de commande dans la console SSMA (AccessToSQL).
Pour plus d’informations sur les exemples de fichiers de script de console, consultez Utilisation des exemples de fichiers de script de console exécutant la console SSMA (AccessToSQL)
L’étape suivante dépend des exigences de votre projet :
Pour spécifier un mot de passe ou exporter/importer des mots de passe, consultez Gestion des mots de passe (AccessToSQL).
Pour générer des rapports, consultez Génération de rapports (AccessToSQL).
Pour résoudre les problèmes dans la console, consultez Résolution des problèmes (AccessToSQL)
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour