Configurer les paramètres pour Assistant Migration de données

Important

L’Assistant Migration de données (DMA) est déconseillé. Pour les options de migration des données de SQL Server vers Azure SQL, consultez Options de migration pour SQL Server vers Azure SQL.

Vous pouvez affiner le comportement de Assistant Migration de données en définissant des valeurs de configuration dans le fichier dma.exe.config. Cet article décrit les valeurs de configuration de clé.

Vous trouverez le fichier dma.exe.config pour l’application de bureau Assistant Migration de données et l’utilitaire de ligne de commande, dans les dossiers suivants sur votre ordinateur.

  • Application de bureau

    %ProgramFiles%\Microsoft Data Migration Assistant\dma.exe.config

  • Utilitaire de ligne de commande

    %ProgramFiles%\Microsoft Data Migration Assistant\dmacmd.exe.config

Veillez à enregistrer une copie du fichier de configuration d’origine avant d’apporter des modifications. Après avoir apporté des modifications, redémarrez Assistant Migration de données pour que les nouvelles valeurs de configuration prennent effet.

Nombre de bases de données à évaluer en parallèle

Assistant Migration de données évalue plusieurs bases de données en parallèle. Pendant l’évaluation Assistant Migration de données extrait l’application de couche données (dacpac) pour comprendre le schéma de base de données. Cette opération peut expirer si plusieurs bases de données sur le même serveur sont évaluées en parallèle.

À compter de Assistant Migration de données v2.0, vous pouvez le contrôler en définissant la valeur de configuration parallelDatabases. La valeur par défaut est 8.

<advisorGroup>
<workflowSettings>
<assessment parallelDatabases="8" />
</workflowSettings>
</advisorGroup>

Nombre de bases de données à migrer en parallèle

Assistant Migration de données migre plusieurs bases de données en parallèle avant de migrer des connexions. Lors de la migration, Assistant Migration de données effectuera une sauvegarde de la base de données source, copiez éventuellement la sauvegarde, puis restaurez-la sur le serveur cible. Vous pourriez rencontrer des échecs de délai d’expiration lorsque plusieurs bases de données sont sélectionnées pour la migration.

À compter de Assistant Migration de données v2.0, si vous rencontrez ce problème, vous pouvez réduire la valeur de configuration parallelDatabases. Vous pouvez augmenter la valeur pour réduire le temps de migration global.

<advisorGroup>
<workflowSettings>
<migration parallelDatabases="8″ />
</workflowSettings>
</advisorGroup>

Paramètres DacFX

Pendant l’évaluation, Assistant Migration de données extrait l’application de couche données (dacpac) pour comprendre le schéma de base de données. Cette opération peut échouer avec des délais d’expiration pour les bases de données volumineuses ou si le serveur est en cours de chargement. À partir de Data Migration v1.0, vous pouvez modifier les valeurs de configuration suivantes pour éviter les erreurs.

Remarque

L’entrée entière <dacfx> est commentée par défaut. Supprimez les commentaires, puis modifiez la valeur en fonction des besoins.

  • commandTimeout

    Ce paramètre définit la propriété IDbCommand.CommandTimeout en secondes. (Default=60)

  • databaseLockTimeout

    Ce paramètre équivaut à SET LOCK_TIMEOUT en millisecondes. (Default=5000)

  • maxDataReaderDegreeOfParallelism

    Ce paramètre définit le nombre de connexions de pool de connexions SQL à utiliser. (Default=8)

<advisorGroup>
<advisorSettings>
<dacFx commandTimeout="60" databaseLockTimeout="5000" maxDataReaderDegreeOfParallelism="8"/>
</advisorSettings>
</advisorGroup>

Stretch Database : seuil de recommandation

Important

Stretch Database est déprécié dans SQL Server 2022 (16.x) et Azure SQL Database. Cette fonctionnalité sera supprimée dans une version future de moteur de base de données. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

Avec SQL Server Stretch Database, vous pouvez étendre dynamiquement les données transactionnelles chaudes et froides de Microsoft SQL Server 2016 vers Azure. La recommandation Stretch Database n’est plus disponible en tant qu’option d’assistant.

Délai de connexion SQL

Vous pouvez contrôler le délai de connexion SQL pour les instances source et cible lors de l’exécution d’une évaluation ou d’une migration, en définissant la valeur de délai d’expiration de connexion sur un nombre spécifié de secondes. La valeur par défaut est de 15 secondes.

<appSettings>
<add key="ConnectionTimeout" value="15" />
</appSettings>

Ignorer les codes d'erreur

Chaque règle a un code d’erreur dans son titre. Si vous n’avez pas besoin de règles et que vous souhaitez les ignorer, utilisez la propriété ignoreErrorCodes. Vous pouvez spécifier d’ignorer une seule erreur ou plusieurs erreurs. Pour ignorer plusieurs erreurs, utilisez un point-virgule, par exemple ignoreErrorCodes="46010;71501". La valeur par défaut est 71501, qui est associée à des références non résolues identifiées lorsqu’un objet référence des objets système tels que les procédures, les vues, etc.

<workflowSettings>
<assessment parallelDatabases="8" ignoreErrorCodes="71501" />
</workflowSettings>