DACPAC¶

DACPAC (сокращение от Data-tier Application Component Package) — это формат файла, используемый в экосистеме Microsoft SQL Server для упаковки, развёртывания и обновления схемы базы данных, а также данных, содержащихся в ней. Файл DACPAC представляет собой архивный пакет, который содержит определение структуры базы данных (таблицы, представления, хранимые процедуры, функции, типы данных, пользователи, роли и другие объекты), но, как правило, не включает сами пользовательские данные. DACPAC является основным средством для реализации непрерывной интеграции и доставки (CI/CD) для баз данных SQL Server, позволяя автоматизировать развёртывание изменений схемы между средами разработки, тестирования и эксплуатации.

¶История и происхождение

Формат DACPAC был впервые представлен корпорацией Microsoft в составе SQL Server 2008 R2 (версия 10.50) в рамках пакета SQL Server Data Tools (SSDT). Изначально он задумывался как средство для упрощения управления жизненным циклом баз данных (Database Lifecycle Management, DLM). До появления DACPAC разработчики и администраторы баз данных (DBA) часто использовали скрипты на языке Transact-SQL (T-SQL) для создания и обновления схемы, что было подвержено ошибкам, особенно при ручном выполнении. DACPAC позволил унифицировать процесс: разработчик создаёт проект базы данных в Visual Studio, компилирует его в DACPAC, а затем этот файл можно развернуть на любом экземпляре SQL Server (включая Azure SQL Database) с помощью стандартных инструментов.

В последующих версиях SQL Server (2012, 2014, 2016, 2017, 2019, 2022) поддержка DACPAC была расширена и улучшена. В частности, в SQL Server 2012 появилась возможность развёртывания DACPAC с помощью утилиты командной строки sqlpackage.exe. В SQL Server 2016 была добавлена поддержка развёртывания на базы данных SQL Azure. В SQL Server 2017 и 2018 были внедрены возможности для работы с DACPAC в контейнерах Docker и средах Linux.

¶Структура и содержимое файла DACPAC

Файл DACPAC представляет собой ZIP-архив, который можно открыть любым архиватором (например, 7-Zip, WinRAR). Внутри архива находятся следующие основные компоненты:

model.xml — основной файл, содержащий полное описание схемы базы данных в формате XML. Он включает определения всех объектов: таблиц, столбцов, индексов, ограничений, внешних ключей, представлений, хранимых процедур, функций, пользовательских типов данных, схем, ролей и т.д.
Origin.xml — файл, содержащий метаданные о происхождении пакета: версию SQL Server, имя исходной базы данных, время создания пакета и другую служебную информацию.
[Content_Types].xml — стандартный файл, определяющий типы содержимого внутри архива (Open Packaging Conventions).
Checksum.xml — файл, содержащий контрольную сумму (хеш) для проверки целостности пакета.

В отличие от формата BACPAC (Data-tier Application Package), который включает как схему, так и пользовательские данные, DACPAC по умолчанию содержит только схему. Однако в некоторых случаях (например, при использовании параметра ExtractAllTableData в утилите sqlpackage.exe) можно включить в DACPAC данные из определённых таблиц, но это не является стандартным сценарием.

¶Классификация и виды DACPAC

DACPAC можно классифицировать по способу создания и назначению:

Извлечённый DACPAC (Extracted DACPAC) — создаётся из существующей базы данных с помощью утилиты sqlpackage.exe (команда Extract). Этот тип используется для создания резервной копии схемы или для переноса схемы на другую среду.
Скомпилированный DACPAC (Compiled DACPAC) — создаётся из проекта базы данных в SQL Server Data Tools (SSDT) в Visual Studio. Разработчик пишет код на T-SQL в виде скриптов, а затем компилирует проект в DACPAC. Этот тип используется для разработки и развёртывания изменений.
Инкрементальный DACPAC — не является отдельным форматом, а представляет собой DACPAC, содержащий только изменения по сравнению с предыдущей версией. Однако стандартный DACPAC всегда содержит полную схему, а инкрементальное развёртывание реализуется на уровне утилиты sqlpackage.exe (команда Publish), которая сравнивает текущую схему базы данных с целевой схемой из DACPAC и генерирует скрипт изменений.

¶Применение и сценарии использования

DACPAC широко применяется в следующих областях:

¶Разработка и CI/CD

DACPAC является ключевым компонентом в конвейерах непрерывной интеграции и доставки (CI/CD) для баз данных. Разработчики могут хранить проект базы данных в системе управления версиями (например, Git), а при сборке (build) создавать DACPAC. Затем этот DACPAC развёртывается на тестовую, стейджинговую и, наконец, на продуктивную среду. Это позволяет автоматизировать процесс обновления схемы и минимизировать человеческие ошибки.

¶Развёртывание в облачных средах

DACPAC поддерживается в Azure SQL Database, Azure SQL Managed Instance и SQL Server на виртуальных машинах Azure. Утилита sqlpackage.exe может напрямую подключаться к облачным базам данных и развёртывать пакеты. Это делает DACPAC удобным инструментом для миграции схемы в облако и синхронизации сред.

¶Управление версиями схемы

DACPAC позволяет поддерживать версионность схемы базы данных. Каждый DACPAC имеет версию (указывается в свойствах проекта), что позволяет отслеживать изменения во времени и при необходимости откатываться к предыдущей версии.

¶Резервное копирование схемы

Хотя DACPAC не заменяет полноценное резервное копирование базы данных (так как не содержит данные), он может использоваться для сохранения точной копии схемы на определённый момент времени. Это полезно для аудита или для восстановления схемы после случайных изменений.

¶Инструменты для работы с DACPAC

Основные инструменты для создания, развёртывания и управления DACPAC:

SQL Server Data Tools (SSDT) — расширение для Visual Studio, позволяющее создавать проекты баз данных, компилировать их в DACPAC, а также развёртывать и сравнивать схемы.
Утилита командной строки sqlpackage.exe — основной инструмент для автоматизации. Поддерживает команды Extract (извлечение DACPAC из базы), Publish (развёртывание DACPAC на базу), Export (создание BACPAC), Import (восстановление BACPAC), DriftReport (отчёт о расхождениях) и другие.
SQL Server Management Studio (SSMS) — начиная с версии 18.0, SSMS имеет встроенную поддержку развёртывания DACPAC через мастер «Deploy Data-tier Application».
Azure Data Studio — кроссплатформенный инструмент от Microsoft, который также поддерживает развёртывание DACPAC.
PowerShell — модуль SqlServer содержит командлеты для работы с DACPAC, такие как Publish-DacPackage и Extract-DacPackage.

¶Преимущества и ограничения

¶Преимущества

Автоматизация — позволяет полностью автоматизировать развёртывание изменений схемы.
Декларативный подход — разработчик описывает конечное состояние схемы, а инструмент сам вычисляет необходимые изменения (сравнение с текущим состоянием).
Переносимость — DACPAC не зависит от версии SQL Server (в пределах поддерживаемых версий) и может быть развёрнут на любой совместимой среде.
Версионность — поддерживает управление версиями и откат изменений.

¶Ограничения

Отсутствие данных — DACPAC не содержит пользовательских данных, что ограничивает его использование для полного восстановления базы.
Сложность с зависимостями — если база данных использует внешние объекты (например, связанные серверы, интеграционные службы), DACPAC может не обработать их корректно.
Проблемы с обратной совместимостью — развёртывание DACPAC, созданного в более новой версии SQL Server, на более старую версию может быть невозможным.
Необходимость в инструментах — для работы с DACPAC требуются специальные утилиты (SSDT, sqlpackage.exe), которые могут быть не установлены в среде.

¶Сравнение с другими форматами

DACPAC часто сравнивают с BACPAC и скриптами T-SQL:

BACPAC — это формат, который включает как схему, так и данные. Он используется для миграции баз данных между средами (например, из локального SQL Server в Azure SQL Database). BACPAC больше подходит для полного переноса, а DACPAC — для обновления схемы.
Скрипты T-SQL — традиционный способ развёртывания. Скрипты дают полный контроль над процессом, но требуют ручного написания и тестирования. DACPAC автоматизирует этот процесс, но может быть менее гибким в сложных сценариях (например, при необходимости выполнения специфических действий до или после развёртывания).

¶Интересные факты

DACPAC может быть использован для развёртывания не только на SQL Server, но и на Azure SQL Database, Azure SQL Managed Instance и даже на локальные экземпляры SQL Server, работающие в контейнерах Docker.
При развёртывании DACPAC с помощью sqlpackage.exe можно указать параметры, такие как BlockOnPossibleDataLoss (блокировать развёртывание, если возможна потеря данных) и DropObjectsNotInSource (удалять объекты, отсутствующие в DACPAC).
Внутренний формат DACPAC основан на стандарте Open Packaging Conventions (OPC), который также используется в файлах Office Open XML (например, .docx, .xlsx).

¶Источники

Microsoft Docs: Data-tier Applications (DAC) — Overview
Microsoft Docs: SqlPackage.exe — Command-line utility for SQL Server data-tier applications
Microsoft Docs: SQL Server Data Tools (SSDT) — Project-oriented database development
Microsoft Docs: DACPAC and BACPAC — Differences and use cases
Microsoft Docs: Deploy a database by using a DAC package