Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Utilisez l’interface CLI Moderniser pour évaluer les dépendances locales ou locales SQL Server dans le cadre d’un parcours de modernisation d’application et de base de données de bout en bout. L’évaluation permet d’évaluer l’état de préparation à la migration vers Azure SQL Database Hyperscale et d’identifier les problèmes de compatibilité ainsi que les efforts nécessaires pour moderniser la charge de travail.
L’outil CLI peut détecter les points de terminaison SQL Server à partir de la configuration de l’application ou évaluer une instance que vous indiquez. Vous pouvez également demander des recommandations de dimensionnement à partir de données de performances existantes.
Azure SQL Managed Instance et SQL Server sur les machines virtuelles Azure restent des chemins de migration alternatifs lorsque vous choisissez ces cibles en fonction des besoins de votre charge de travail.
Important
L’évaluation de SQL Server dans Modernize CLI est disponible en préversion publique. Ce flux de travail évalue l’état de préparation ; il ne migre pas les bases de données, ne provisionne pas de ressources Azure et ne collecte pas de nouvelles données de performances. Exécutez-le localement sur Windows, et non par le biais de la délégation d’agent cloud.
Prerequisites
- Modernize CLI et ses prérequis d’authentification GitHub.
- Une copie locale d’application avec des dépendances SQL Server.
- Une machine Windows qui peut atteindre le SQL Server source.
- PowerShell 7.
- Azure CLI version 2.75.0 ou ultérieure, avec l’extension
datamigrationdéjà installée. Consultez Installer le Azure CLI. - Une configuration d’identité ou de connexion protégée existante avec l’autorisation d’évaluer le SQL Server source.
La compétence d’évaluation SQL Server télécharge le package d’évaluation SQL ; vous n’avez pas besoin de le télécharger séparément.
Préparez les autres outils, extensions, informations d’identification et accès réseau requis avant de commencer. L’évaluation ne vous ouvre pas de session. Linux et macOS ne sont pas pris en charge pour ce flux de travail SQL Server, même si Modernize CLI prend en charge ces plateformes pour d'autres scénarios.
Évaluer les dépendances des applications à SQL Server
L’évaluation de base de données s’exécute en tant que compétence d’évaluation supplémentaire avec l’analyse complète. Le paramètre Problème uniquement par défaut ne l’exécute pas.
Mode interactif (TUI)
À partir de votre répertoire d’application, exécutez l’agent de modernisation :
modernizeSélectionnez Évaluer dans le menu principal.
Sélectionnez Dossier actuel pour évaluer votre application ou entrée manuelle pour entrer un chemin d’accès d’application local.
Sélectionnez les domaines d’évaluation pertinents pour votre application et passez à la configuration de l’évaluation.
Sous Couverture générale/Analyse, sélectionnez Analyse complète, puis Continuer.
Sélectionnez Évaluer localement. L’évaluation de SQL Server nécessite un ordinateur Windows disposant d’un accès au SQL Server source.
Entrez un chemin de sortie ou acceptez la valeur par défaut, puis démarrez l’évaluation.
L’interface CLI utilise les données probantes du dépôt pour sélectionner les compétences applicables en matière d’évaluation de base de données. Pour plus d’informations sur les écrans interactifs, consultez Batch assessment : mode interactif.
Mode non interactif
Créez un fichier de configuration d’évaluation, par exemple C:\configs\database-assessment.yml, avec le paramètre suivant :
analysisCoverage: full
Fusionnez ce paramètre avec une configuration existante plutôt que de remplacer d’autres paramètres d’évaluation. Transmettez le fichier à --assess-config, comme indiqué dans la commande suivante, en remplaçant la source, la configuration et les chemins de sortie par les vôtres :
modernize assess `
--source C:\src\sql-app `
--assess-config C:\configs\database-assessment.yml `
--output-path C:\reports\sql-app `
--format markdown `
--delegate local `
--no-tty `
--prompt 'Assess local or on-premises SQL Server dependencies for migration readiness to Azure SQL.'
Vous pouvez également mettre à jour un fichier assessment-config.yaml existant au niveau utilisateur à l’emplacement %USERPROFILE%\.modernize\assessment-config.yaml, en définissant analysisCoverage: full. Si vous utilisez ce fichier, omettez --assess-config de la commande. Un chemin explicite --assess-config est prioritaire sur le fichier au niveau de l’utilisateur.
Note
Le contexte facultatif --prompt fournit un contexte à des compétences d’évaluation de base de données supplémentaires. Cela ne modifie pas l’analyse IA intégrée de Modernize CLI. L’interface CLI sélectionne les compétences applicables dans la preuve du référentiel et ce contexte facultatif ; une mention SQL Server dans un fichier README seul n'établit pas l'applicabilité.
Découverte de la cible SQL Server
Lorsque vous ne fournissez pas d’instance, l’évaluation SQL résout les points de terminaison concrets des paramètres d’application pris en charge, notamment les paramètres de connexion et les variables d’environnement référencées. Il n’exécute pas de code d’application pour résoudre les paramètres dynamiques. Il évalue chaque point de terminaison résolu distinct plutôt que seulement le premier.
Les informations d’identification d’application disponibles sont déterminées dans le processus d’exécution local. Si aucune information d’identification prise en charge n’est disponible, le flux de travail utilise l’identité Windows actuelle. Les informations d’identification fournies ayant échoué ne déclenchent pas de nouvelle tentative avec une autre méthode d’authentification.
Si la découverte ne peut pas résoudre un point de terminaison, spécifiez une instance explicitement.
Spécifier une instance de SQL Server
Utilisez des sélecteurs non secrets dans le contexte d’évaluation :
modernize assess `
--source C:\src\sql-app `
--assess-config C:\configs\database-assessment.yml `
--output-path C:\reports\sql-app `
--format markdown `
--delegate local `
--no-tty `
--prompt 'Assess local SQL Server migration readiness. instanceName=localhost; authMode=Windows.'
Remplacez localhost par la source SQL Server source de données, y compris son instance nommée ou son port si nécessaire. Un instanceName explicite restreint la cible d’évaluation ; ce n’est ni une chaîne de connexion ni un ID de ressource Azure Arc.
instanceName, authModeet les autres sélecteurs de cet article sont un contexte d’évaluation, pas de nouveaux indicateurs CLI. N’utilisez pas d’indicateurs tels que --instanceName.
Choisir une source d’authentification existante
Pour une instance sélectionnée explicitement, omettez les deux authMode et configFilePath utilisez l’identité Windows actuelle quand une nouvelle évaluation est nécessaire. Vous pouvez à la place fournir l’une de ces sélections d’authentification dans le contexte :
| Sélection d’authentification | Contexte non secret supplémentaire | Prerequisite |
|---|---|---|
authMode=Windows |
None | L’identité Windows actuelle dispose d’un accès SQL Server. |
authMode=EntraDefault |
None | Chaîne d’informations d’identification non réactive Microsoft Entra opérationnelle prise en charge par l’outil d’évaluation installé. |
authMode=ConfigFile |
configFilePath |
Chemin absolu d’un fichier de configuration d’évaluation protégé existant. |
authMode=KeyVault |
sqlUserName, keyVaultName et secretName |
Une session Azure existante autorisée à lire le secret SQL-password. |
authMode=CredentialManager |
credentialTarget |
Module d’informations d’identification requis et entrée existante contenant le nom d’utilisateur et le mot de passe SQL. |
Les sélecteurs d’authentification explicites sont prioritaires sur les informations d’identification d’application découvertes. Les sélecteurs manquants ou en conflit arrêtent le flux de travail plutôt que de sélectionner silencieusement un autre mode.
Important
Ne placez pas les mots de passe, les jetons ou les chaînes de connexion dans --prompt, les arguments de commande ou la configuration d’évaluation versionnée dans le contrôle de code source. Utilisez une source d’informations d’identification protégée existante. La connexion à Azure n'est pas nécessaire uniquement pour utiliser l'authentification SQL intégrée à Windows.
Dimensionnement des requêtes à partir des données de performances existantes
Pour demander des recommandations de SKU ainsi que l’état de préparation, ajoutez skuRecommendation=true et un chemin absolu performanceDataPath pour les données de performances terminées de la même instance :
modernize assess `
--source C:\src\sql-app `
--assess-config C:\configs\database-assessment.yml `
--output-path C:\reports\sql-app `
--format markdown `
--delegate local `
--no-tty `
--prompt 'Assess local SQL Server migration readiness. instanceName=localhost; authMode=Windows; skuRecommendation=true; performanceDataPath=C:\sql-performance.'
Le workflow de dimensionnement associé utilise des fichiers CSV de performances spécifiques à l’instance existants. Il ne se connecte pas à SQL Server et ne collecte pas de nouvelles mesures. Les demandes de démarrage de la collection ou de spécification d’une durée de collecte ne sont pas prises en charge.
Utilisez Markdown lorsque vous avez besoin de l’état de préparation et des recommandations SKU demandées complètes dans le rapport publié. La publication HTML conserve le code HTML de préparation native et n’inclut pas de résultats SKU générés séparément. Les artefacts SKU de prise en charge restent dans le répertoire d’appel au lieu d’être copiés dans le rapport publié.
Vérifier les résultats
Ouvrez le rapport d’évaluation d’application généré et suivez le lien vers l’évaluation de la base de données. Le rapport SQL publié se trouve dans le répertoire externals\evaluate-offline-sql-migration-readiness du rapport du dépôt actuel, avec index.md ou index.html correspondant au format que vous avez demandé.
Passez en revue les résultats de compatibilité pour Azure SQL Database Hyperscale. Si vous envisagez Azure SQL Managed Instance ou SQL Server sur les machines virtuelles Azure comme alternative, passez en revue les résultats spécifiques à la cible pertinents avant de choisir une approche de migration. Les résultats de préparation ne sont pas une preuve que la validation de la migration ou de la production est terminée.
Le flux de travail peut réutiliser les résultats correspondants dans le répertoire de sortie de l’appel actuel et affiche leur heure de génération. Si vous avez besoin d’une nouvelle évaluation, demandez explicitement une nouvelle évaluation ou une actualisation dans le contexte. Les résultats non lisibles ou ambigus ne sont pas traités comme une autorisation de les remplacer.
Pour plusieurs instances découvertes, le rapport publié inclut uniquement les résultats une fois chaque cible terminée. Si le dimensionnement demandé échoue, la demande de préparation et de dimensionnement combinée n’est pas publiée comme terminée, même lorsque des artefacts de préparation existent.
Résoudre les problèmes d’évaluation
| Diagnostic | Action |
|---|---|
UNSUPPORTED_HOST |
Exécutez localement sur un ordinateur Windows pouvant se connecter à SQL Server. |
PREREQUISITE_REQUIRED |
Préparez l’outil manquant, l’extension, le package ou le contexte d’exécution requis en dehors de l’évaluation, puis réexécutez. |
MISSING_PARAMETERS |
Fournissez un instanceName spécifique lorsque la découverte ne peut pas résoudre une cible, ou renseignez les champs d’authentification explicitement sélectionnés. |
UNSUPPORTED_SCOPE |
Utilisez une source SQL Server locale ou sur site. Ce flux de travail n'évalue pas les points de terminaison Azure SQL existants et ne déduit pas les connexions locales à partir des noms de ressources Arc. |
COLLECTION_NOT_SUPPORTED |
Supprimez les demandes de collecte de données nouvelles. Pour le dimensionnement, fournissez des données de performance complètes à partir de la même instance. |
Pour les échecs de connexion ou d’authentification, vérifiez l’accessibilité et l’identité sélectionnée hors de l’évaluation. Ne pas contourner les échecs en plaçant les identifiants dans l’invite de commande.