Valider un package DAC

Article
03/06/2017

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, using :View the Contents of a DAC, View Database Changes, View Upgrade Actions, Compare DACs

Prérequis

Nous vous recommandons de ne pas déployer un package DAC provenant de sources inconnues ou non approuvées. De telles 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, puis exécutez DBCC CHECKDB (Transact-SQL) sur la base de données et examinez également le code (par exemple les procédures stockées ou tout autre code défini par l’utilisateur) contenu dans la base de données.

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 Emplacementet 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 , cochez la case 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.

Afficher une DAC dans un dossier

Décompressez le package DAC dans un dossier en suivant les instructions fournies dans Unpack a DAC Package.
Affichez le contenu des scripts Transact-SQL en les ouvrant dans le Moteur de base de données Éditeur de requête dans Management Studio.
Affichez le contenu des fichiers texte dans des outils tels que le Bloc-notes.

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 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.

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

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 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.

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.

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()

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.

Voir aussi

Applications de la couche Données
Déployer une application de la couche Données
Mettre à niveau une application de la couche Données

Partager via