Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Можно создать участников развертывания для выполнения специализированных действий при развертывании проекта SQL.Предусмотрена возможность создать участников DeploymentPlanModifier и DeploymentPlanExecutor.Используйте DeploymentPlanModifier для изменения плана до его выполнения и DeploymentPlanExecutor для осуществления операций в ходе выполнения плана.В данном пошаговом руководстве будет создан DeploymentPlanExecutor с именем DeploymentUpdateReportContributor, который будет формировать отчет о действиях, выполненных при развертывании проекта.Поскольку данный участник сборки принимает параметр, управляющий формированием отчета, необходимо выполнить дополнительное действие.
В этом пошаговом руководстве показано выполнение следующих основных задач:
Создание участника развертывания типа DeploymentPlanExecutor
Установка участника развертывания
Тестирование применяемого участника развертывания
Обязательные компоненты
Для выполнения этого пошагового руководства требуются следующие компоненты:
Необходимо установить версию Visual Studio, которая включает SQL Server Data Tools (SSDT) и поддерживает разработку VB или C#.
Необходимо иметь проект SQL, который содержит объекты SQL.
Экземпляр SQL Server, на котором можно развернуть проект базы данных.
.jpeg "System_CAPS_note") Примечание |
|---|
Это пошаговое руководство предназначено для пользователей, уже знакомых с функциями SQL пакета SSDT.Предполагается также знакомство с основными средствами Visual Studio, такими как создание библиотеки классов и использование редактора кода для добавления кода к классу. |
Создание участника развертывания
Для создания участника развертывания необходимо выполнить следующие задачи:
Создать проект библиотеки классов и добавить необходимые ссылки.
Определить класс с именем DeploymentUpdateReportContributor, который наследует от DeploymentPlanExecutor.
Переопределить метод OnExecute.
Добавить закрытый вспомогательный класс.
Построить результирующую сборку.
Создание проекта библиотеки классов
Создайте проект библиотеки классов Visual C# или Visual Basic с именем MyDeploymentContributor.
Переименуйте файл Class1.cs в DeploymentUpdateReportContributor.cs.
В обозревателе решений щелкните правой кнопкой мыши узел проекта, затем нажмите Добавить ссылку.
Выберите System.ComponentModel.Composition на вкладке «Платформы».
Добавьте необходимые ссылки SQL — щелкните правой кнопкой мыши узел проекта, затем нажмите Добавить ссылку.Щелкните Обзор и перейдите к папке C:\Program Files (x86)\Microsoft SQL Server\110\DAC\Bin.Выберите записи Microsoft.SqlServer.Dac.dll, Microsoft.SqlServer.Dac.Extensions.dll и Microsoft.Data.Tools.Schema.Sql.dll и щелкните Добавить, затем нажмите кнопку ОК.
После этого приступите к добавлению кода к классу.
Определение класса DeploymentUpdateReportContributor
В редакторе кода обновите файл DeploymentUpdateReportContributor.cs для согласования со следующими инструкциями using:
using System; using System.IO; using System.Text; using System.Xml; using Microsoft.SqlServer.Dac.Deployment; using Microsoft.SqlServer.Dac.Extensibility; using Microsoft.SqlServer.Dac.Model;Обновите определение класса для согласования со следующим:
/// <summary> /// An executor that generates a report detailing the steps in the deployment plan. Will only run /// if a "GenerateUpdateReport=true" contributor argument is set in the project file, in a targets file or /// passed as an additional argument to the DacServices API. To set in a project file, add the following: /// /// <PropertyGroup> /// <ContributorArguments Condition="'$(Configuration)' == 'Debug’”> /// $(ContributorArguments);DeploymentUpdateReportContributor.GenerateUpdateReport=true; /// </ContributorArguments> /// <PropertyGroup> /// /// </summary> [ExportDeploymentPlanExecutor("MyDeploymentContributor.DeploymentUpdateReportContributor", "1.0.0.0")] public class DeploymentUpdateReportContributor : DeploymentPlanExecutor { }Тем самым определен участник развертывания, который наследует от DeploymentPlanExecutor.В ходе сборки и развертывания специализированные участники загружаются из каталога стандартных расширений.Участники в выполнении плана развертывания обозначаются атрибутом ExportDeploymentPlanExecutor.
Этот атрибут требуется для обнаружения участников.Экран будет выглядеть примерно так:
[ExportDeploymentPlanExecutor("MyDeploymentContributor.DeploymentUpdateReportContributor", "1.0.0.0")]В данном случае первый параметр атрибута должен быть уникальным идентификатором — он будет использоваться для идентификации участника в файлах проекта.Рекомендуется объединить пространство имен библиотеки (в данном пошаговом руководстве это MyDeploymentContributor) с именем класса (здесь это DeploymentUpdateReportContributor) для создания идентификатора.
Далее добавьте следующий член, который позволит поставщику принимать параметр командной строки:
public const string GenerateUpdateReport = "DeploymentUpdateReportContributor.GenerateUpdateReport";Данный член позволяет пользователю указать, должен ли отчет формироваться с параметром GenerateUpdateReport.
Затем необходимо переопределить метод OnExecute для добавления кода, который должен быть выполнен при развертывании проекта базы данных.
Переопределение метода OnExecute
Добавьте следующий метод к применяемому классу DeploymentUpdateReportContributor:
/// <summary> /// Override the OnExecute method to perform actions when you execute the deployment plan for /// a database project. /// </summary> protected override void OnExecute(DeploymentPlanContributorContext context) { // determine whether the user specified a report is to be generated bool generateReport = false; string generateReportValue; if (context.Arguments.TryGetValue(GenerateUpdateReport, out generateReportValue) == false) { // couldn't find the GenerateUpdateReport argument, so do not generate generateReport = false; } else { // GenerateUpdateReport argument was specified, try to parse the value if (bool.TryParse(generateReportValue, out generateReport)) { // if we end up here, the value for the argument was not valid. // default is false, so do nothing. } } if (generateReport == false) { // if user does not want to generate a report, we are done return; } // We will output to the same directory where the deployment script // is output or to the current directory string reportPrefix = context.Options.TargetDatabaseName; string reportPath; if (string.IsNullOrEmpty(context.DeploymentScriptPath)) { reportPath = Environment.CurrentDirectory; } else { reportPath = Path.GetDirectoryName(context.DeploymentScriptPath); } FileInfo summaryReportFile = new FileInfo(Path.Combine(reportPath, reportPrefix + ".summary.xml")); FileInfo detailsReportFile = new FileInfo(Path.Combine(reportPath, reportPrefix + ".details.xml")); // Generate the reports by using the helper class DeploymentReportWriter DeploymentReportWriter writer = new DeploymentReportWriter(context); writer.WriteReport(summaryReportFile); writer.IncludeScripts = true; writer.WriteReport(detailsReportFile); string msg = "Deployment reports ->" + Environment.NewLine + summaryReportFile.FullName + Environment.NewLine + detailsReportFile.FullName; ExtensibilityError reportMsg = new ExtensibilityError(msg, Severity.Message); base.PublishMessage(reportMsg); } /// <summary> /// Override the OnExecute method to perform actions when you execute the deployment plan for /// a database project. /// </summary> protected override void OnExecute(DeploymentPlanContributorContext context) { // determine whether the user specified a report is to be generated bool generateReport = false; string generateReportValue; if (context.Arguments.TryGetValue(GenerateUpdateReport, out generateReportValue) == false) { // couldn't find the GenerateUpdateReport argument, so do not generate generateReport = false; } else { // GenerateUpdateReport argument was specified, try to parse the value if (bool.TryParse(generateReportValue, out generateReport)) { // if we end up here, the value for the argument was not valid. // default is false, so do nothing. } } if (generateReport == false) { // if user does not want to generate a report, we are done return; } // We will output to the same directory where the deployment script // is output or to the current directory string reportPrefix = context.Options.TargetDatabaseName; string reportPath; if (string.IsNullOrEmpty(context.DeploymentScriptPath)) { reportPath = Environment.CurrentDirectory; } else { reportPath = Path.GetDirectoryName(context.DeploymentScriptPath); } FileInfo summaryReportFile = new FileInfo(Path.Combine(reportPath, reportPrefix + ".summary.xml")); FileInfo detailsReportFile = new FileInfo(Path.Combine(reportPath, reportPrefix + ".details.xml")); // Generate the reports by using the helper class DeploymentReportWriter DeploymentReportWriter writer = new DeploymentReportWriter(context); writer.WriteReport(summaryReportFile); writer.IncludeScripts = true; writer.WriteReport(detailsReportFile); string msg = "Deployment reports ->" + Environment.NewLine + summaryReportFile.FullName + Environment.NewLine + detailsReportFile.FullName; DataSchemaError reportMsg = new DataSchemaError(msg, ErrorSeverity.Message); base.PublishMessage(reportMsg); }Методу OnExecute передается объект DeploymentPlanContributorContext, который предоставляет доступ ко всем указанным аргументам, модели базы данных-источника и целевой базы данных, свойствам сборки и файлам расширения.В данном примере мы получаем модель, затем вызываем вспомогательные функции, чтобы вывести сведения о модели.Мы используем вспомогательный метод базового класса для отчета о всех произошедших ошибках.
Дополнительные интересующие нас типы и методы: TSqlModel, ModelComparisonResult, DeploymentPlanHandle и SqlDeploymentOptions.
Далее определяем вспомогательный класс, который работает с планом развертывания.
Добавление вспомогательного класса, формирующего текст отчета
Добавьте вспомогательный класс и его методы из следующего кода:
/// <summary> /// This class is used to generate a deployment /// report. /// </summary> private class DeploymentReportWriter { readonly TSqlModel _sourceModel; readonly ModelComparisonResult _diff; readonly DeploymentStep _planHead; /// <summary> /// The constructor accepts the same context info /// that was passed to the OnExecute method of the /// deployment contributor. /// </summary> public DeploymentReportWriter(DeploymentPlanContributorContext context) { if (context == null) { throw new ArgumentNullException("context"); } // save the source model, source/target differences, // and the beginning of the deployment plan. _sourceModel = context.Source; _diff = context.ComparisonResult; _planHead = context.PlanHandle.Head; } /// <summary> /// Property indicating whether script bodies /// should be included in the report. /// </summary> public bool IncludeScripts { get; set; } /// <summary> /// Drives the report generation, opening files, /// writing the beginning and ending report elements, /// and calling helper methods to report on the /// plan operations. /// </summary> internal void WriteReport(FileInfo reportFile) {// Assumes that we have a valid report file if (reportFile == null) { throw new ArgumentNullException("reportFile"); } // set up the XML writer XmlWriterSettings xmlws = new XmlWriterSettings(); // Indentation makes it a bit more readable xmlws.Indent = true; FileStream fs = new FileStream(reportFile.FullName, FileMode.Create, FileAccess.Write, FileShare.ReadWrite); XmlWriter xmlw = XmlWriter.Create(fs, xmlws); try { xmlw.WriteStartDocument(true); xmlw.WriteStartElement("DeploymentReport"); // Summary report of the operations that // are contained in the plan. ReportPlanOperations(xmlw); // You could add a method call here // to produce a detailed listing of the // differences between the source and // target model. xmlw.WriteEndElement(); xmlw.WriteEndDocument(); xmlw.Flush(); fs.Flush(); } finally { xmlw.Close(); fs.Dispose(); } } /// <summary> /// Writes details for the various operation types /// that could be contained in the deployment plan. /// Optionally writes script bodies, depending on /// the value of the IncludeScripts property. /// </summary> private void ReportPlanOperations(XmlWriter xmlw) {// write the node to indicate the start // of the list of operations. xmlw.WriteStartElement("Operations"); // Loop through the steps in the plan, // starting at the beginning. DeploymentStep currentStep = _planHead; while (currentStep != null) { // Report the type of step xmlw.WriteStartElement(currentStep.GetType().Name); // based on the type of step, report // the relevant information. // Note that this procedure only handles // a subset of all step types. if (currentStep is SqlRenameStep) { SqlRenameStep renameStep = (SqlRenameStep)currentStep; xmlw.WriteAttributeString("OriginalName", renameStep.OldName); xmlw.WriteAttributeString("NewName", renameStep.NewName); xmlw.WriteAttributeString("Category", GetElementCategory(renameStep.RenamedElement)); } else if (currentStep is SqlMoveSchemaStep) { SqlMoveSchemaStep moveStep = (SqlMoveSchemaStep)currentStep; xmlw.WriteAttributeString("OrignalName", moveStep.PreviousName); xmlw.WriteAttributeString("NewSchema", moveStep.NewSchema); xmlw.WriteAttributeString("Category", GetElementCategory(moveStep.MovedElement)); } else if (currentStep is SqlTableMigrationStep) { SqlTableMigrationStep dmStep = (SqlTableMigrationStep)currentStep; xmlw.WriteAttributeString("Name", GetElementName(dmStep.SourceTable)); xmlw.WriteAttributeString("Category", GetElementCategory(dmStep.SourceElement)); } else if (currentStep is CreateElementStep) { CreateElementStep createStep = (CreateElementStep)currentStep; xmlw.WriteAttributeString("Name", GetElementName(createStep.SourceElement)); xmlw.WriteAttributeString("Category", GetElementCategory(createStep.SourceElement)); } else if (currentStep is AlterElementStep) { AlterElementStep alterStep = (AlterElementStep)currentStep; xmlw.WriteAttributeString("Name", GetElementName(alterStep.SourceElement)); xmlw.WriteAttributeString("Category", GetElementCategory(alterStep.SourceElement)); } else if (currentStep is DropElementStep) { DropElementStep dropStep = (DropElementStep)currentStep; xmlw.WriteAttributeString("Name", GetElementName(dropStep.TargetElement)); xmlw.WriteAttributeString("Category", GetElementCategory(dropStep.TargetElement)); } // If the script bodies are to be included, // add them to the report. if (this.IncludeScripts) { using (StringWriter sw = new StringWriter()) { currentStep.GenerateBatchScript(sw); string tsqlBody = sw.ToString(); if (string.IsNullOrEmpty(tsqlBody) == false) { xmlw.WriteCData(tsqlBody); } } } // close off the current step xmlw.WriteEndElement(); currentStep = currentStep.Next; } xmlw.WriteEndElement(); } /// <summary> /// Returns the category of the specified element /// in the source model /// </summary> private string GetElementCategory(TSqlObject element) { return element.ObjectType.Name; } /// <summary> /// Returns the name of the specified element /// in the source model /// </summary> private static string GetElementName(TSqlObject element) { StringBuilder name = new StringBuilder(); if (element.Name.HasExternalParts) { foreach (string part in element.Name.ExternalParts) { if (name.Length > 0) { name.Append('.'); } name.AppendFormat("[{0}]", part); } } foreach (string part in element.Name.Parts) { if (name.Length > 0) { name.Append('.'); } name.AppendFormat("[{0}]", part); } return name.ToString(); } } /// <summary> /// This class is used to generate a deployment /// report. /// </summary> private class DeploymentReportWriter { /// <summary> /// The constructor accepts the same context info /// that was passed to the OnExecute method of the /// deployment contributor. /// </summary> public DeploymentReportWriter(DeploymentPlanContributorContext context) { } /// <summary> /// Property indicating whether script bodies /// should be included in the report. /// </summary> public bool IncludeScripts { get; set; } /// <summary> /// Drives the report generation, opening files, /// writing the beginning and ending report elements, /// and calling helper methods to report on the /// plan operations. /// </summary> internal void WriteReport(FileInfo reportFile) { } /// <summary> /// Writes details for the various operation types /// that could be contained in the deployment plan. /// Optionally writes script bodies, depending on /// the value of the IncludeScripts property. /// </summary> private void ReportPlanOperations(XmlWriter xmlw) { } /// <summary> /// Returns the category of the specified element /// in the source model /// </summary> private string GetElementCategory(IModelElement element) { } /// <summary> /// Returns the name of the specified element /// in the source model /// </summary> private string GetElementName(IModelElement element) { } }Сохраните изменения в файле класса.Во вспомогательном классе есть обращение к нескольким полезным типам.
Область кода
Полезные типы
Члены класса
Метод WriteReport
XmlWriter и XmlWriterSettings
Метод ReportPlanOperations
Интересующие нас типы: DeploymentStep, SqlRenameStep, SqlMoveSchemaStep, SqlTableMigrationStep, CreateElementStep, AlterElementStep, DropElementStep.
Есть и некоторые другие действия — см. полный список в документации API.
GetElementCategory
GetElementName
Затем необходимо выполнить сборку библиотеки классов.
Подписание и построение сборки
В меню Проект выберите пункт Свойства MyDeploymentContributor.
Откройте вкладку Подписание.
Щелкните Подписать сборку.
В окне Выбор файла ключа строгого имени щелкните <New>.
В диалоговом окне Создать ключ со строгим именем в поле Имя файла ключа введите MyRefKey.
(Необязательно) Можно указать пароль для файла ключа для строгого имени.
Нажмите кнопку ОК.
В меню Файл выберите команду Сохранить все.
В меню Сборка выберите Построить решение.
Затем необходимо установить сборку, чтобы она загружалась при сборке и развертывании проектов SQL.
Установка участника развертывания
Для установки участника развертывания необходимо скопировать сборку и связанный файл PDB в папку Extensions.
Установка сборки MyDeploymentContributor
Затем необходимо будет скопировать данные сборки в каталог Extensions.Visual Studio при запуске идентифицирует все расширения в каталоге %Program Files%\Microsoft SQL Server\110\DAC\Bin\Extensions и его подкаталогах, чтобы сделать их доступными для использования:
Скопируйте файл сборки MyDeploymentContributor.dll из выходного каталога в каталог %Program Files%\Microsoft SQL Server\110\DAC\Bin\Extensions.По умолчанию путем к cкомпилированному файлу библиотеки DLL является ПутьКВашемуРешению\ПутьКВашемуПроекту\bin\Debug или ПутьКВашемуРешению\ПутьКВашемуПроекту\bin\Release.
Тестирование участника развертывания
Для тестирования применяемого участника развертывания необходимо выполнить следующие задачи:
Добавить свойства к файлу SQLPROJ, который должен быть развернут.
Развернуть проект базы данных с использованием MSBuild и указать соответствующий параметр.
Добавление свойств к файлу проекта SQL (SQLPROJ)
Необходимо всегда обновлять файл проекта SQL для указания идентификаторов участников, которые намечены для выполнения.Также, поскольку участник ожидает аргумент GenerateUpdateReport, он должен быть указан как аргумент участника.
Это можно сделать одним из двух способов.Можно изменить файл SQLPROJ вручную для добавления требуемых аргументов.Этот вариант является предпочтительным, если применяемый участник не имеет каких-либо аргументов участника, требуемых для настройки, или если вы не намереваетесь повторно использовать участника сборки в большом количестве проектов.Если выбран этот вариант, введите следующие инструкции в файл SQLPROJ после первого узла Import в файле:
<PropertyGroup>
<DeploymentContributors>$(DeploymentContributors); MyDeploymentContributor.DeploymentUpdateReportContributor</DeploymentContributors>
<ContributorArguments Condition="'$(Configuration)' == 'Debug'">$(ContributorArguments);DeploymentUpdateReportContributor.GenerateUpdateReport=true;</ContributorArguments>
</PropertyGroup>
Второй метод предусматривает создание целевого файла, содержащего требуемые аргументы участника.Это удобно, если один и тот же участник используется в нескольких проектах и имеются требуемые аргументы участника, поскольку он включает значения по умолчанию.В этом случае создайте целевой файл в пути расширений MSBuild.
Перейдите в каталог %Program Files%\MSBuild.
Создайте папку MyContributors для сохранения своих целевых файлов.
Создайте в этом каталоге файл MyContributors.targets, введите в него следующий текст и сохраните файл:
<?xml version="1.0" encoding="utf-8"?> <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003"> <PropertyGroup> <DeploymentContributors>$(DeploymentContributors);MyDeploymentContributor.DeploymentUpdateReportContributor</DeploymentContributors> <ContributorArguments Condition="'$(Configuration)' == 'Debug'">$(ContributorArguments); DeploymentUpdateReportContributor.GenerateUpdateReport=true;</ContributorArguments> </PropertyGroup> </Project>В файле SQLPROJ каждого проекта, в котором вы хотите запускать участников, импортируйте файл TARGETS, добавив следующую инструкцию в файл SQLPROJ после узла <Import Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\SSDT\Microsoft.Data.Tools.Schema.SqlTasks.targets" />:
<Import Project="$(MSBuildExtensionsPath)\MyContributors\MyContributors.targets " />
После реализации одного из этих подходов можно использовать MSBuild для передачи параметров для командной строки сборки.
| Примечание |
|---|
Необходимо всегда обновлять свойство DeploymentContributors для указания идентификатора применяемого участника.Это тот же идентификатор, который используется в атрибуте ExportDeploymentPlanExecutor в файле исходного кода участника.Без этого требуемый участник не будет вызываться на выполнение при сборке проекта.Свойство ContributorArguments необходимо обновлять, только если для вызова участника на выполнение требуются аргументы. |
Развертывание проекта базы данных
Как правило, проект может быть опубликован или развернут в Visual Studio.Просто откройте решение, содержащее ваш проект SQL, и выберите пункт «Опубликовать...»контекстного меню для проекта или используйте клавишу F5 для отладки развертывания в LocalDB.В этом примере мы будем использовать диалоговое окно «Опубликовать...»для создания скрипта развертывания.
Развертывание проекта SQL и создание отчета о развертывании
Откройте Visual Studio и вызовите решение, содержащее проект SQL.
Выберите свой проект и нажмите кнопку F5, чтобы выполнить отладочное развертывание.Поскольку элемент ContributorArguments включается, только если задана конфигурация «Отладка», на данный момент отчет формируется только для отладочных развертываний.Чтобы изменить это, уберите инструкцию Condition="'$(Configuration)' == 'Debug'" из определения ContributorArguments.
В окне вывода должно быть примерно следующее:
------ Deploy started: Project: Database1, Configuration: Debug Any CPU ------ Finished verifying cached model in 00:00:00 Deployment reports -> C:\Users\UserName\Documents\Visual Studio 2012\Projects\MyDatabaseProject\MyDatabaseProject\sql\debug\MyTargetDatabase.summary.xml C:\Users\UserName\Documents\Visual Studio 2012\Projects\MyDatabaseProject\MyDatabaseProject\sql\debug\MyTargetDatabase.details.xml Deployment script generated to: C:\Users\UserName\Documents\Visual Studio 2012\Projects\MyDatabaseProject\MyDatabaseProject\sql\debug\MyDatabaseProject.sqlОткройте файл MyTargetDatabase.summary.xml и изучите его содержимое.В файле будет отображено новое развертывание базы данных:
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <DeploymentReport> <Operations> <DeploymentScriptStep /> <DeploymentScriptDomStep /> <DeploymentScriptStep /> <DeploymentScriptDomStep /> <DeploymentScriptStep /> <DeploymentScriptStep /> <DeploymentScriptStep /> <DeploymentScriptStep /> <DeploymentScriptDomStep /> <DeploymentScriptDomStep /> <DeploymentScriptDomStep /> <DeploymentScriptDomStep /> <DeploymentScriptStep /> <DeploymentScriptDomStep /> <BeginPreDeploymentScriptStep /> <DeploymentScriptStep /> <EndPreDeploymentScriptStep /> <SqlBeginPreservationStep /> <SqlEndPreservationStep /> <SqlBeginDropsStep /> <SqlEndDropsStep /> <SqlBeginAltersStep /> <SqlPrintStep /> <CreateElementStep Name="Sales" Category="Schema" /> <SqlPrintStep /> <CreateElementStep Name="Sales.Customer" Category="Table" /> <SqlPrintStep /> <CreateElementStep Name="Sales.PK_Customer_CustID" Category="Primary Key" /> <SqlPrintStep /> <CreateElementStep Name="Sales.Orders" Category="Table" /> <SqlPrintStep /> <CreateElementStep Name="Sales.PK_Orders_OrderID" Category="Primary Key" /> <SqlPrintStep /> <CreateElementStep Name="Sales.Def_Customer_YTDOrders" Category="Default Constraint" /> <SqlPrintStep /> <CreateElementStep Name="Sales.Def_Customer_YTDSales" Category="Default Constraint" /> <SqlPrintStep /> <CreateElementStep Name="Sales.Def_Orders_OrderDate" Category="Default Constraint" /> <SqlPrintStep /> <CreateElementStep Name="Sales.Def_Orders_Status" Category="Default Constraint" /> <SqlPrintStep /> <CreateElementStep Name="Sales.FK_Orders_Customer_CustID" Category="Foreign Key" /> <SqlPrintStep /> <CreateElementStep Name="Sales.CK_Orders_FilledDate" Category="Check Constraint" /> <SqlPrintStep /> <CreateElementStep Name="Sales.CK_Orders_OrderDate" Category="Check Constraint" /> <SqlPrintStep /> <CreateElementStep Name="Sales.uspCancelOrder" Category="Procedure" /> <SqlPrintStep /> <CreateElementStep Name="Sales.uspFillOrder" Category="Procedure" /> <SqlPrintStep /> <CreateElementStep Name="Sales.uspNewCustomer" Category="Procedure" /> <SqlPrintStep /> <CreateElementStep Name="Sales.uspPlaceNewOrder" Category="Procedure" /> <SqlPrintStep /> <CreateElementStep Name="Sales.uspShowOrderDetails" Category="Procedure" /> <SqlEndAltersStep /> <DeploymentScriptStep /> <BeginPostDeploymentScriptStep /> <DeploymentScriptStep /> <EndPostDeploymentScriptStep /> <DeploymentScriptDomStep /> <DeploymentScriptDomStep /> <DeploymentScriptDomStep /> </Operations> </DeploymentReport>ПримечаниеПри развертывании проекта базы данных, которая идентична целевой базе данных, результирующий отчет не является слишком содержательным.Для получения более содержательных результатов разверните изменения в базе данных или новую базу данных.
Откройте файл MyTargetDatabase.details.xml и изучите его содержимое.Небольшой раздел файла сведений содержит записи и скрипт для создания схемы Sales, вывода сообщения о создании таблицы и самого фактического создания таблицы.
<CreateElementStep Name="Sales" Category="Schema"><![CDATA[CREATE SCHEMA [Sales] AUTHORIZATION [dbo]; ]]></CreateElementStep> <SqlPrintStep><![CDATA[PRINT N'Creating [Sales].[Customer]...'; ]]></SqlPrintStep> <CreateElementStep Name="Sales.Customer" Category="Table"><![CDATA[CREATE TABLE [Sales].[Customer] ( [CustomerID] INT IDENTITY (1, 1) NOT NULL, [CustomerName] NVARCHAR (40) NOT NULL, [YTDOrders] INT NOT NULL, [YTDSales] INT NOT NULL ); ]]></CreateElementStep>Анализируя план развертывания по мере его выполнения, можно отслеживать любые сведения, содержащиеся в развертывании, и выполнять дополнительные действия на основе шагов данного плана.
Следующие шаги
Можно создать дополнительные средства для обработки выходных XML-файлов.Это лишь один пример для DeploymentPlanExecutor.Также можно создать DeploymentPlanModifier для изменения плана развертывания до его выполнения.
См. также
Пошаговое руководство. Расширение сборки проекта базы данных для формирования статистики модели
Пошаговое руководство. Расширение процесса развертывания проекта базы данных для изменения плана развертывания
Изменение процесса сборки и развертывания базы данных с помощью участников сборки и развертывания