Valider un package DAC
Il est conseillé d'examiner le contenu d'un package DAC avant de le déployer en production et de valider les actions de mise à niveau avant de mettre à niveau une DAC existante. Ceci tout particulièrement lors du déploiement de packages qui n'ont pas été développés dans votre organisation.
Avant de commencer : Conditions préalables
Pour mettre à niveau une DAC, à l'aide de : Afficher le contenu d'une DAC, Afficher les modifications de base de données, Afficher les actions de mise à niveau, Comparer des DAC
Conditions préalables
Nous vous recommandons de ne pas déployer un package DAC provenant de sources inconnues ou non approuvées. Ces DAC peuvent contenir du code malveillant susceptible d'exécuter un code Transact-SQL indésirable ou de provoquer des erreurs en modifiant le schéma. Avant d'utiliser une DAC provenant d'une source inconnue ou non approuvée, déployez-la sur une instance de test isolée du Moteur de base de données, exécutez DBCC CHECKDB (Transact-SQL) sur la base de données et examinez le code, comme les procédures stockées ou tout autre code défini par l'utilisateur, contenu dans la base de données.
[Haut de la page]
Afficher le contenu d'une DAC
Il existe deux mécanismes d'affichage du contenu d'un package d'application de la couche Données (DAC). Vous pouvez importer le package DAC vers un projet DAC dans les outils de développement de SQL Server. Vous pouvez décompresser le contenu du package dans un dossier.
Afficher une DAC dans les outils de développement de SQL Server
Dans le menu Fichier, sélectionnez Nouveau, puis Projet.
Sélectionnez le modèle de projet SQL Server, puis spécifiez un Nom, un Emplacement et un Nom de solution.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud de projet, puis sélectionnez Propriétés.
Sous l'onglet Paramètres du projet, dans la section Type de sortie, activez la case à cocher de Application de la couche Données (fichier .dacpac), puis fermez la boîte de dialogue de propriétés.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet et sélectionnez Importer une application de la couche Données.
Utilisez l'Explorateur de solutions pour ouvrir tous les fichiers de la DAC, tels que la stratégie de sélection du serveur et les scripts de pré- et post-déploiement.
Utilisez le Mode schéma pour examiner tous les objets du schéma, en particulier le code des objets, comme les fonctions ou les procédures stockées.
[Haut de la page]
Afficher une DAC dans un dossier
Décompressez le package DAC dans un dossier en suivant les instructions fournies dans Décompresser un package DAC.
Affichez le contenu des scripts Transact-SQL en les ouvrant dans l'Éditeur de requête du Moteur de base de données dans Management Studio.
Affichez le contenu des fichiers texte dans des outils tels que le Bloc-notes.
[Haut de la page]
Afficher les modifications de base de données
Après la version actuelle de la DAC déployée en production, des modifications ont pu être apportées directement à la base de données associée qui peuvent être en conflit avec le schéma défini dans une nouvelle version de la DAC. Avant la mise à niveau vers une nouvelle version de la DAC, vérifiez si de telles modifications ont été apportées à la base de données.
Afficher les modifications de base de données à l'aide d'un Assistant
Exécutez l'Assistant Mettre à niveau une application de la couche Données, en spécifiant la DAC actuellement déployée et le package de DAC qui contient la nouvelle version de la DAC.
Sur la page de Détecter les modifications, examinez le rapport des modifications apportées à la base de données.
Sélectionnez Annuler si vous ne souhaitez pas poursuivre la mise à niveau.
Pour plus d'informations sur l'utilisation de l'Assistant, consultez Mettre à niveau une application de la couche Données.
Afficher les modifications de base de données à l'aide de PowerShell
Créez un objet serveur SMO et définissez-le sur l'instance qui contient la DAC à afficher.
Ouvrez un objet ServerConnection et connectez-vous à la même instance.
Spécifiez le nom de la DAC dans une variable.
Utilisez la méthode GetDatabaseChanges() pour récupérer un objet ChangeResults, et redirigez l'objet vers un fichier texte pour générer un rapport simple des objets nouveaux, supprimés et modifiés.
[Haut de la page]
Afficher une exemple de modifications de base de données (PowerShell)
Afficher une exemple de modifications de base de données (PowerShell)
L'exemple suivant signale toutes les modifications de base de données qui ont été apportées dans une DAC déployée nommée MyApplication.
## Set a SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$srv = get-item .
## Open a Common.ServerConnection to the same instance.
$serverconnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($srv.ConnectionContext.SqlConnectionObject)
$serverconnection.Connect()
$dacstore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverconnection)
## Specify the DAC instance name.
$dacName = "MyApplication"
## Generate the change list and save to file.
$dacChanges = $dacstore.GetDatabaseChanges($dacName) | Out-File -Filepath C:\DACScripts\MyApplicationChanges.txt
[Top]
Afficher les actions de mise à niveau
Avant d'utiliser une nouvelle version d'un package DAC en vue de mettre à niveau une DAC déployée à partir d'une version antérieure d'un package DAC, vous pouvez générer un rapport contenant les instructions Transact-SQL qui seront exécutées durant la mise à niveau, puis passer en revue ces instructions.
Signaler les actions de mise à niveau à l'aide d'un Assistant
Exécutez l'Assistant Mettre à niveau une application de la couche Données, en spécifiant la DAC actuellement déployée et le package de DAC qui contient la nouvelle version de la DAC.
Sur la page Résumé, examinez le rapport des actions de mise à niveau.
Sélectionnez Annuler si vous ne souhaitez pas poursuivre la mise à niveau.
Pour plus d'informations sur l'utilisation de l'Assistant, consultez Mettre à niveau une application de la couche Données.
[Haut de la page]
Signaler les actions de mise à niveau à l'aide de PowerShell
Créez un objet serveur SMO et définissez-le sur l'instance qui contient la DAC déployée.
Ouvrez un objet ServerConnection et connectez-vous à la même instance.
Utilisez System.IO.File pour charger le fichier de package DAC.
Spécifiez le nom de la DAC dans une variable.
Utilisez la méthode GetIncrementalUpgradeScript() pour obtenir la liste des instructions Transact-SQL qui seraient exécutées par une mise à niveau et redirigez cette liste vers un fichier texte.
Fermez le flux de fichier utilisé pour lire le fichier de package DAC.
[Haut de la page]
Afficher un exemple d'actions de mise à niveau (PowerShell)
Afficher un exemple d'actions de mise à niveau (PowerShell)
L'exemple suivant signale les instructions Transact-SQL qui seraient exécutées pour mettre à niveau une DAC nommée MyApplication vers le schéma défini dans un fichier MyApplicationVNext.dacpac.
## Set a SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$srv = get-item .
## Open a Common.ServerConnection to the same instance.
$serverconnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($srv.ConnectionContext.SqlConnectionObject)
$serverconnection.Connect()
$dacstore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverconnection)
## Load the DAC package file.
$dacpacPath = "C:\MyDACs\MyApplicationVNext.dacpac"
$fileStream = [System.IO.File]::Open($dacpacPath,[System.IO.FileMode]::OpenOrCreate)
$dacType = [Microsoft.SqlServer.Management.Dac.DacType]::Load($fileStream)
## Specify the DAC instance name.
$dacName = "MyApplication"
## Generate the upgrade script and save to file.
$dacstore.GetIncrementalUpgradeScript($dacName, $dacType) | Out-File -Filepath C:\DACScripts\MyApplicationUpgrade.sql
## Close the filestream to the new DAC package.
$fileStream.Close()
[Haut de la page]
Comparer des DAC
Avant de mettre à niveau une DAC, il est conseillé d'examiner les différences dans la base de données et les objets au niveau de l'instance entre les DAC actuelles et nouvelles. Si vous ne disposez pas d'une copie du package de la DAC actuelle, vous pouvez extraire un package de la base de données actuelle.
Si vous importez les deux packages DAC dans des projets DAC dans les outils de développement de SQL Server, vous pouvez utiliser l'outil Comparaison de schémas pour analyser les différences entre les deux DAC.
Ou bien, décompressez les DAC dans des dossiers distincts. Vous pouvez ensuite utiliser un outil de comparaison, tel que l'utilitaire WinDiff, pour analyser les différences.
[Haut de la page]
Voir aussi
Concepts
Applications de la couche Données