Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Действие SqlPackage DeployReport создает XML-отчет об изменениях, которые будут сделаны действием публикации. Действие SqlPackage DriftReport создает XML-отчет об изменениях, внесенных в зарегистрированную базу данных с момента последней регистрации.
Note
идентификатор Microsoft Entra ID ранее был известен как Azure Active Directory (Azure AD).
Синтаксис командной строки
SqlPackage инициирует действия, указанные с помощью параметров, свойств и переменных SQLCMD, указанных в командной строке.
SqlPackage {parameters}{properties}{SQLCMD Variables}
Параметры действия DeployReport
| Parameter | Краткая форма | Value | Description |
|---|---|---|---|
| /Action: | /a: | DeployReport | Указывает действие, которое необходимо выполнить. |
| /AccessToken: | /at: | {string} | Указывает маркер доступа на основе проверки подлинности, используемый при подключении к целевой базе данных. |
| /Diagnostics: | /d: | {True|False} | Указывает, выводится ли ведение журнала диагностики в консоль. По умолчанию False. |
| /DiagnosticsFile: | /df: | {string} | Указывает файл для хранения журналов диагностики. |
| /MaxParallelism: | /mp: | {int} | Указывает степень параллелизма для параллельных операций, выполняемых в базе данных. Значение по умолчанию — 8. |
| /OutputPath: | /op: | {string} | Указывает путь к файлу, в котором создаются выходные файлы. |
| /OverwriteFiles: | /of: | {True|False} | Указывает, должен ли SqlPackage перезаписать существующие файлы. Указание false приводит к прерыванию действия SqlPackage, если обнаружен существующий файл. Значение по умолчанию — True. |
| /Profile: | /pr: | {string} | Указывает путь к файлу профиля публикации DAC. Профиль определяет коллекцию свойств и переменных, используемых при создании выходных данных. |
| /Properties: | /p: | {PropertyName}={Value} | Задает пару значений имени для свойства , зависящее от действия,; {PropertyName}={Value}. |
| /Quiet: | /q: | {True|False} | Указывает, подавляется ли подробный отзыв. По умолчанию False. |
| /SourceFile: | /sf: | {string} | Указывает исходный файл, который будет использоваться в качестве источника действия вместо базы данных. Если этот параметр используется, другой исходный параметр не должен быть допустимым. |
| /SourceConnectionString: | /scs: | {string} | Указывает действительную строку подключения SQL Server или Azure к исходной базе данных. Если этот параметр указан, он должен использоваться исключительно из всех остальных исходных параметров. |
| /SourceDatabaseName: | /sdn: | {string} | Определяет имя исходной базы данных. |
| /SourceEncryptConnection: | /sec: | {Optional|Mandatory|Strict|True|False} | Указывает, следует ли использовать шифрование SQL для подключения к исходной базе данных. Значение по умолчанию — True. |
| /SourceHostNameInCertificate: | /shnic: | {string} | Указывает значение, используемое для проверки исходного TLS/SSL-сертификата SQL Server, когда уровень обмена данными шифруется с помощью TLS. |
| /SourcePassword: | /sp: | {string} | Для сценариев проверки подлинности SQL Server определяет пароль, используемый для доступа к исходной базе данных. |
| /SourceServerName: | /ssn: | {string} | Определяет имя сервера, на котором размещена исходная база данных. |
| /SourceTimeout: | /st: | {int} | Указывает время ожидания для установления подключения к исходной базе данных в секундах. |
| /SourceTrustServerCertificate: | /stsc: | {True|False} | Указывает, следует ли использовать TLS для шифрования подключения к исходной базе данных и обхода цепочки сертификатов для проверки доверия. Значение по умолчанию — False. |
| /SourceUser: | /su: | {string} | Для сценариев проверки подлинности SQL Server определяет пользователя SQL Server, который будет использоваться для доступа к исходной базе данных. |
| /TargetFile: | /tf: | {string} | Указывает целевой файл (то есть DACPAC-файл), который будет использоваться в качестве целевого объекта действия вместо базы данных. Если этот параметр используется, другой целевой параметр не должен быть допустимым. Этот параметр недействителен для действий, поддерживающих только целевые объекты базы данных. |
| /TargetConnectionString: | /tcs: | {string} | Указывает действительную строку подключения SQL Server/Azure для целевой базы данных. Если этот параметр указан, он должен использоваться исключительно из всех остальных целевых параметров. |
| /TargetDatabaseName: | /tdn: | {string} | Определяет переопределение имени базы данных, являющейся целью действия SqlPackage. |
| /TargetEncryptConnection: | /tec: | {Optional|Mandatory|Strict|True|False} | Указывает, следует ли использовать шифрование SQL для подключения к целевой базе данных. Значение по умолчанию — True. |
| /TargetHostNameInCertificate: | /thnic: | {string} | Указывает значение, используемое для проверки целевого TLS/SSL-сертификата SQL Server при шифровании уровня связи с помощью TLS. |
| /TargetPassword: | /tp: | {string} | Для сценариев проверки подлинности SQL Server определяет пароль, используемый для доступа к целевой базе данных. |
| /TargetServerName: | /tsn: | {string} | Определяет имя сервера, на котором размещена целевая база данных. |
| /TargetTimeout: | /tt: | {int} | Указывает время ожидания для установления подключения к целевой базе данных в секундах. Для идентификатора Microsoft Entra рекомендуется, чтобы это значение было больше или равно 30 секундам. |
| /TargetTrustServerCertificate: | /ttsc: | {True|False} | Указывает, следует ли использовать TLS для шифрования подключения к целевой базе данных и обхода цепочки сертификатов для проверки доверия. Значение по умолчанию — False. |
| /TargetUser: | /tu: | {string} | Для сценариев проверки подлинности SQL Server определяет пользователя SQL Server, который будет использоваться для доступа к целевой базе данных. |
| /TenantId: | /tid: | {string} | Представляет идентификатор клиента Microsoft Entra или доменное имя. Этот параметр необходим для поддержки гостевых или импортированных пользователей Microsoft Entra, а также учетных записей Майкрософт, таких как outlook.com, hotmail.com или live.com. Если этот параметр опущен, будет использоваться идентификатор клиента по умолчанию для идентификатора Microsoft Entra, предполагая, что прошедший проверку подлинности пользователь является собственным пользователем для этого клиента. Однако в этом случае любые гостевые или импортированные пользователи и /или учетные записи Майкрософт, размещенные в этом идентификаторе Microsoft Entra, не поддерживаются, и операция завершится ошибкой. Дополнительные сведения см. в статье универсальная проверка подлинности с помощью базы данных SQL и поддержки Azure Synapse Analytics (поддержка SSMS для MFA). |
| /UniversalAuthentication: | /ua: | {True|False} | Указывает, следует ли использовать универсальную проверку подлинности. Если задано значение True, интерактивный протокол проверки подлинности активируется с поддержкой MFA. Этот параметр также можно использовать для проверки подлинности Microsoft Entra без MFA, используя интерактивный протокол, требующий от пользователя ввод имени пользователя и пароля или встроенной проверки подлинности (учетные данные Windows). Если для параметра /UniversalAuthentication задано значение True, аутентификация Microsoft Entra не может быть использована в SourceConnectionString (/scs). Если для параметра /UniversalAuthentication задано значение False, необходимо указать проверку подлинности Microsoft Entra в SourceConnectionString (/scs). Для получения дополнительной информации см. универсальную аутентификацию с базой данных SQL и Azure Synapse Analytics (поддержка SSMS для MFA). |
| /Variables: | /v: | {PropertyName}={Value} | Указывает пару значений имени для переменной, определенной для действия; {VariableName}={Value}. Файл DACPAC содержит список допустимых переменных SQLCMD. Произойдет ошибка, если значение не указано для каждой переменной. |
Свойства действия DeployReport
| Property | Value | Description |
|---|---|---|
| /p: | AdditionalDeploymentContributorArguments=(STRING) | Определяет дополнительные аргументы для участников развертывания. Это должен быть список значений с разделителями с запятой. |
| /p: | AdditionalDeploymentContributors=(STRING) | Указывает дополнительных компонентов развертывания, которые должны выполняться при развертывании dacpac. Это должен быть разделенный точкой с запятой список полных имен участников сборки или идентификаторов. |
| /p: | AdditionalDeploymentContributorPaths=(STRING) | Задает пути для загрузки дополнительных компонентов развертывания. Это должен быть список значений с разделителями с запятой. |
| /p: | AllowDropBlocking Assemblies=(BOOLEAN) | Это свойство используется развертыванием SqlClr для удаления всех блокирующих сборок в рамках плана развертывания. По умолчанию любые блокирующие или ссылающиеся сборки блокируют обновление сборки, если необходимо удалить сборку со ссылкой. |
| /p: | AllowIncompatiblePlatform=(BOOLEAN) | Указывает, следует ли пытаться выполнить действие, несмотря на несовместимые платформы SQL Server. |
| /p: | AllowUnsafeRowLevelSecurityDataMovement=(BOOLEAN) | Не блокируйте перемещение данных в таблице с безопасностью на уровне строк, если это свойство имеет значение true. Значение по умолчанию — false. |
| /p: | BackupDatabaseBeforeChanges=(BOOLEAN) | Резервное копирование базы данных перед развертыванием любых изменений. |
| /p: | BlockOnPossibleDataLoss=(BOOLEAN 'Истина') | Указывает, что операция будет прекращена во время шага проверки схемы, если результирующая схема может привести к потере данных, в том числе из-за уменьшения точности данных или изменения типа данных, требующего операции приведения. Значение по умолчанию (True) приводит к прекращению операции независимо от того, содержит ли целевая база данных данные. Выполнение со значением False для BlockOnPossibleDataLoss по-прежнему может завершиться ошибкой во время выполнения плана развертывания, если на целевом объекте имеются данные, которые не могут быть преобразованы в новый тип столбца. |
| /p: | BlockWhenDriftDetected=(BOOLEAN 'True') | Указывает, следует ли блокировать обновление базы данных, схема которой больше не соответствует его регистрации или не зарегистрирована. |
| /p: | CommandTimeout=(INT32 '60') | Указывает время ожидания команды в секундах при выполнении запросов к SQL Server. |
| /p: | CommentOutSetVarDeclarations=(BOOLEAN) | Указывает, следует ли закомментировать объявление переменных SETVAR в сгенерированном скрипте для публикации. Это можно сделать, если вы планируете указать значения в командной строке при публикации с помощью средства, например SQLCMD.EXE. |
| /p: | CompareUsingTargetCollation=(BOOLEAN) | Этот параметр определяет способ обработки сортировки базы данных во время развертывания; По умолчанию параметры сортировки целевой базы данных будут обновлены, если он не соответствует параметрам сортировки, указанным источником. Если этот параметр задан, следует использовать сортировку целевой базы данных (или сервера). |
| /p: | CreateNewDatabase=(BOOLEAN) | Указывает, следует ли обновлять целевую базу данных или удалять и повторно создавать ее при публикации в базе данных. |
| /p: | DatabaseEdition=({ Базовый | Стандартный | Премиум | Хранилище данных | Общего назначения | Критически важный для бизнеса | Гипермасштабирование | По умолчанию } «По умолчанию») | Определяет выпуск базы данных SQL Azure. См. уровни обслуживания базы данных SQL Azure. |
| /p: | DatabaseLockTimeout=(INT32 '60') | Указывает время ожидания блокировки базы данных в секундах при выполнении запросов к SQLServer. Используйте -1, чтобы ждать неограниченное время. |
| /p: | DatabaseMaximumSize=(INT32) | Определяет максимальный размер в ГБ базы данных SQL Azure. |
| /p: | DatabaseServiceObjective=(STRING) | Определяет уровень производительности базы данных SQL Azure, например P0 или S1. |
| /p: | DeployDatabaseInSingleUserMode=(BOOLEAN) | Если true, перед развертыванием база данных устанавливается в режим одного пользователя. |
| /p: | ОтключениеИПовторноеВключениеDdlТриггеров=(ЛОГИЧЕСКИЙ 'True') | Указывает, отключены ли триггеры языка определения данных (DDL) в начале процесса публикации и повторно включены в конце действия публикации. |
| /p: | DoNotAlterChangeDataCaptureObjects=(ЛОГИЧЕСКИЙ 'Истина') | Если значение true, объекты отслеживания измененных данных не изменяются. |
| /p: | DoNotAlterReplicatedObjects=(булевый 'Истина') | Указывает, определяются ли реплицируемые объекты при проверке. |
| /p: | DoNotDropObjectType=(STRING) | Тип объекта, который не следует удалять, если значение DropObjectsNotInSource имеет значение true. Допустимые имена типов объектов: Агрегаты, Роли приложений, Сборки, Ассиметричные ключи, Приоритеты брокеров, Сертификаты, Ключи шифрования столбцов, Основные ключи столбцов, Контракты, Роли баз данных, Триггеры баз данных, Значения по умолчанию, Расширенные свойства, Внешние источники данных, Внешние форматы файлов, Внешние таблицы, Группы файлов, Таблицы файлов, Полнотекстовые каталоги, Полнотекстовые стоп-листы, Типы сообщений, Партиционные функции, Партиционные схемы, Разрешения, Очереди, Связи удаленных служб, Членство в ролях, Правила, Скалярные функции, Списки свойств поиска, Политики безопасности, Последовательности, Службы, Подписи, Хранимые процедуры, Симметричные ключи, Синонимы, Таблицы, Таблицы с функций возращающих таблицу, Пользовательские типы данных, Пользовательские типы таблиц, Пользовательские типы Clr, Пользователи, Представления, Коллекции XML-схем, Аудиты, Учетные данные, Криптографические поставщики, Спецификации аудита базы данных, Учетные данные в контексте базы данных, Конечные точки, Сообщения об ошибках, Уведомления о событиях, Сессии событий, Входы на присоединенные серверы, Присоединенные серверы, Логины, Маршруты, Спецификации аудита сервера, Членство в ролях сервера, Роли сервера, Триггеры сервера. Это свойство может быть указано несколько раз, чтобы указать несколько параметров. |
| /p: | DoNotDropObjectTypes=(STRING) | Список типов объектов, разделенных точкой с запятой, который не должен быть удален, если DropObjectsNotInSource имеет значение true. Допустимые имена типов объектов: Агрегаты, Роли приложений, Сборки, Ассиметричные ключи, Приоритеты брокеров, Сертификаты, Ключи шифрования столбцов, Основные ключи столбцов, Контракты, Роли баз данных, Триггеры баз данных, Значения по умолчанию, Расширенные свойства, Внешние источники данных, Внешние форматы файлов, Внешние таблицы, Группы файлов, Таблицы файлов, Полнотекстовые каталоги, Полнотекстовые стоп-листы, Типы сообщений, Партиционные функции, Партиционные схемы, Разрешения, Очереди, Связи удаленных служб, Членство в ролях, Правила, Скалярные функции, Списки свойств поиска, Политики безопасности, Последовательности, Службы, Подписи, Хранимые процедуры, Симметричные ключи, Синонимы, Таблицы, Таблицы с функций возращающих таблицу, Пользовательские типы данных, Пользовательские типы таблиц, Пользовательские типы Clr, Пользователи, Представления, Коллекции XML-схем, Аудиты, Учетные данные, Криптографические поставщики, Спецификации аудита базы данных, Учетные данные в контексте базы данных, Конечные точки, Сообщения об ошибках, Уведомления о событиях, Сессии событий, Входы на присоединенные серверы, Присоединенные серверы, Логины, Маршруты, Спецификации аудита сервера, Членство в ролях сервера, Роли сервера, Триггеры сервера. |
| /p: | DropConstraintsNotInSource=(BOOLEAN 'Истина') | Указывает, будут ли исключены из целевой базы данных ограничения, которые отсутствуют в файле моментального снимка (.dacpac), если они не существуют при публикации в базу данных. |
| /p: | DropDmlTriggersNotInSource=(BOOLEAN 'True') | Указывает, будут ли триггеры DML, которые отсутствуют в файле моментального снимка базы данных (.dacpac), удалены из целевой базы данных при публикации базы данных. |
| /p: | DropExtendedPropertiesNotInSource=(BOOLEAN 'Истина') | Указывает, будут ли удалены расширенные свойства из целевой базы данных, если они не существуют в файле моментального снимка базы данных (.dacpac), при публикации в базу данных. |
| /p: | DropIndexesNotInSource=(BOOLEAN 'Истина') | Указывает, будут ли удалены индексы, которые отсутствуют в файле моментального снимка базы данных (.dacpac), из целевой базы данных, когда вы публикуете в базу данных. |
| /p: | DropObjectsNotInSource=(BOOLEAN) | Указывает, следует ли удалять объекты, которые не существуют в файле моментального снимка базы данных (.dacpac), из целевой базы данных при публикации в неё. Это значение имеет приоритет над DropExtendedProperties. |
| /p: | DropPermissionsNotInSource=(BOOLEAN) | Указывает, будут ли разрешения, которые отсутствуют в файле моментального снимка базы данных (.dacpac), удалены из целевой базы данных при публикации обновлений в базу данных. |
| /p: | DropRoleMembersNotInSource=(BOOLEAN) | Указывает, будут ли члены роли, которые не определены в файле моментального снимка базы данных (.dacpac), удалены из целевой базы данных при публикации обновлений в базу данных. |
| /p: | DropStatisticsNotInSource=(BOOLEAN 'Истина') | Указывает, будет ли статистика, которая не существует в файле моментального снимка базы данных (DACPAC), удалена из целевой базы данных при публикации в целевую базу данных. |
| /p: | ExcludeObjectType=(STRING) | Тип объекта, который следует игнорировать во время развертывания. Допустимые имена типов объектов: Агрегаты, Роли приложений, Сборки, Ассиметричные ключи, Приоритеты брокеров, Сертификаты, Ключи шифрования столбцов, Основные ключи столбцов, Контракты, Роли баз данных, Триггеры баз данных, Значения по умолчанию, Расширенные свойства, Внешние источники данных, Внешние форматы файлов, Внешние таблицы, Группы файлов, Таблицы файлов, Полнотекстовые каталоги, Полнотекстовые стоп-листы, Типы сообщений, Партиционные функции, Партиционные схемы, Разрешения, Очереди, Связи удаленных служб, Членство в ролях, Правила, Скалярные функции, Списки свойств поиска, Политики безопасности, Последовательности, Службы, Подписи, Хранимые процедуры, Симметричные ключи, Синонимы, Таблицы, Таблицы с функций возращающих таблицу, Пользовательские типы данных, Пользовательские типы таблиц, Пользовательские типы Clr, Пользователи, Представления, Коллекции XML-схем, Аудиты, Учетные данные, Криптографические поставщики, Спецификации аудита базы данных, Учетные данные в контексте базы данных, Конечные точки, Сообщения об ошибках, Уведомления о событиях, Сессии событий, Входы на присоединенные серверы, Присоединенные серверы, Логины, Маршруты, Спецификации аудита сервера, Членство в ролях сервера, Роли сервера, Триггеры сервера. |
| /p: | ExcludeObjectTypes=(STRING) | Список типов объектов с запятой, которые следует игнорировать во время развертывания. Допустимые имена типов объектов: Агрегаты, Роли приложений, Сборки, Ассиметричные ключи, Приоритеты брокеров, Сертификаты, Ключи шифрования столбцов, Основные ключи столбцов, Контракты, Роли баз данных, Триггеры баз данных, Значения по умолчанию, Расширенные свойства, Внешние источники данных, Внешние форматы файлов, Внешние таблицы, Группы файлов, Таблицы файлов, Полнотекстовые каталоги, Полнотекстовые стоп-листы, Типы сообщений, Партиционные функции, Партиционные схемы, Разрешения, Очереди, Связи удаленных служб, Членство в ролях, Правила, Скалярные функции, Списки свойств поиска, Политики безопасности, Последовательности, Службы, Подписи, Хранимые процедуры, Симметричные ключи, Синонимы, Таблицы, Таблицы с функций возращающих таблицу, Пользовательские типы данных, Пользовательские типы таблиц, Пользовательские типы Clr, Пользователи, Представления, Коллекции XML-схем, Аудиты, Учетные данные, Криптографические поставщики, Спецификации аудита базы данных, Учетные данные в контексте базы данных, Конечные точки, Сообщения об ошибках, Уведомления о событиях, Сессии событий, Входы на присоединенные серверы, Присоединенные серверы, Логины, Маршруты, Спецификации аудита сервера, Членство в ролях сервера, Роли сервера, Триггеры сервера. |
| /p: | GenerateSmartDefaults=(BOOLEAN) | Автоматически предоставляет значение по умолчанию при обновлении таблицы, содержащей данные с столбцом, который не разрешает значения NULL. |
| /p: | IgnoreAnsiNulls=(BOOLEAN 'Истина') | Указывает, следует ли игнорировать или обновлять различия в параметре ANSI NULLS при публикации в базе данных. |
| /p: | IgnoreAuthorizer=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в авторизаторе при публикации в базу данных. |
| /p: | IgnoreColumnCollation=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в параметрах сортировки столбцов при публикации в базе данных. |
| /p: | IgnoreColumnOrder=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в порядке столбцов таблицы при публикации в базе данных. |
| /p: | IgnoreComments=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в комментариях при публикации в базе данных. |
| /p: | IgnoreCryptographicProviderFilePath=(BOOLEAN 'Истина') | Указывает, следует ли игнорировать или обновлять различия в пути к файлу для криптографического провайдера, когда вы публикуете в базу данных. |
| /p: | IgnoreDdlTriggerOrder=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в порядке триггеров языка определения данных (DDL) при публикации в базе данных или сервере. |
| /p: | IgnoreDdlTriggerState=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в включенном или отключенном состоянии триггеров языка определения данных (DDL) при публикации в базе данных. |
| /p: | IgnoreDefaultSchema=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в схеме по умолчанию при публикации в базе данных. |
| /p: | IgnoreDmlTriggerOrder=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в порядке триггеров языка обработки данных (DML) при публикации в базе данных. |
| /p: | IgnoreDmlTriggerState=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в включенном или отключенном состоянии триггеров DML при публикации в базе данных. |
| /p: | IgnoreExtendedProperties=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в расширенных свойствах при публикации в базе данных. |
| /p: | ПропуститьФайлИПутьКЛогу=(БУЛЕВОЕ 'True') | Указывает, следует ли игнорировать или обновлять различия в путях для файлов и файлов журнала при публикации в базе данных. |
| /p: | IgnoreFilegroupPlacement=(BOOLEAN 'Истина') | Указывает, следует ли игнорировать или обновлять различия в размещении объектов в FILEGROUPs при публикации в базе данных. |
| /p: | ИгнорироватьРазмерФайла=(ЛОГИЧЕСКОЕ 'Истина') | Указывает, следует ли игнорировать различия в размерах файлов или следует ли выдавать предупреждение при публикации в базе данных. |
| /p: | IgnoreFillFactor=(BOOLEAN 'Истина') | Указывает, следует ли игнорировать различия в коэффициенте заполнения для хранилища индексов или следует ли выдавать предупреждение при публикации в базе данных. |
| /p: | IgnoreFullTextCatalogFilePath=(BOOLEAN 'True') | Указывает, следует ли игнорировать различия в пути к файлу для полнотекстового каталога или следует ли выдавать предупреждение при публикации в базе данных. |
| /p: | IgnoreIdentitySeed=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в значении начального числа для столбца идентичности при публикации обновлений в базе данных. |
| /p: | IgnoreIncrement=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять изменения в приросте идентификаторного столбца при публикации в базу данных. |
| /p: | IgnoreIndexOptions=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в параметрах индекса при публикации в базе данных. |
| /p: | IgnoreIndexPadding=(BOOLEAN 'Истина') | Указывает, следует ли игнорировать или обновлять различия в заполнении индекса при публикации в базе данных. |
| /p: | ИгнорироватьРегистрКлючевыхСлов=(BOOLEAN 'Истина') | Указывает, нужно ли игнорировать или обновлять различия в регистре ключевых слов при публикации в базу данных. |
| /p: | IgnoreLockHintsOnIndexes=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в указаниях блокировки индексов при публикации в базе данных. |
| /p: | ИгнорироватьLoginSids=(BOOLEAN 'True') | Указывает, следует ли игнорировать или обновлять различия в идентификационном номере безопасности (SID) при публикации в базе данных. |
| /p: | IgnoreNotForReplication=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять параметры не для репликации при публикации в базе данных. |
| /p: | IgnoreObjectPlacementOnPartitionScheme=(BOOLEAN 'True') | Указывает, следует ли игнорировать или обновлять размещение объекта в схеме секционирования при публикации в базе данных. |
| /p: | IgnorePartitionSchemes=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в схемах и функциях секционирования при публикации в базе данных. |
| /p: | IgnorePermissions=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в разрешениях при публикации в базе данных. |
| /p: | IgnorePostDeployScript=(BOOLEAN 'False') | Если установлено значение true, скрипт после развертывания из файла .dacpac не будет присоединен к плану развертывания. |
| /p: | IgnorePreDeployScript=(BOOLEAN 'False') | Если установлено значение true, скрипт предварительного развертывания из .dacpac не будет добавлен к плану развертывания. |
| /p: | IgnoreQuotedIdentifiers=(BOOLEAN 'Истина') | Указывает, следует ли игнорировать или обновлять различия в настройках кавычных идентификаторов при публикации в базу данных. |
| /p: | IgnoreRoleMembership=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в членстве логинов в ролях при публикации в базе данных. |
| /p: | IgnoreRouteLifetime=(BOOLEAN 'True') | Указывает, следует ли игнорировать или обновлять различия во времени, в течение которого SQL Server сохраняет маршрут в таблице маршрутизации, при публикации в базу данных. |
| /p: | ИгнорироватьТочкуСЗапятойМеждуОператорами=(BOOLEAN 'True') | Указывает, будут ли различия в использовании точек с запятой между операторами T-SQL игнорироваться или обновляться при публикации в базе данных. |
| /p: | IgnoreTableOptions=(BOOLEAN) | Указывает, будут ли различия в параметрах таблицы игнорироваться или обновляться при публикации в базе данных. |
| /p: | IgnoreTablePartitionOptions=(BOOLEAN) | Указывает, будут ли различия в параметрах секционирования таблицы игнорироваться или обновляться при публикации в базе данных. Этот параметр применяется только к базам данных хранилища данных Azure Synapse Analytics. |
| /p: | IgnoreUserSettingsObjects=(BOOLEAN) | Указывает, будут ли различия в объектах параметров пользователя игнорироваться или обновляться при публикации в базе данных. |
| /p: | IgnoreWhitespace=(BOOLEAN 'True') | Указывает, будут ли различия в пробелах игнорироваться или обновляться при публикации в базе данных. |
| /p: | IgnoreWithNocheckOnCheckConstraints=(BOOLEAN) | Указывает, будут ли различия в значении предложения WITH NOCHECK для ограничений проверки игнорироваться или обновляться при публикации в базе данных. |
| /p: | IgnoreWithNocheckOnForeignKeys=(BOOLEAN) | Указывает, будут ли различия в значении предложения WITH NOCHECK для внешних ключей игнорироваться или обновляться при публикации в базе данных. |
| /p: | IncludeCompositeObjects=(BOOLEAN) | Включите все составные элементы с той же базой данных в рамках одной операции публикации. |
| /p: | IncludeTransactionalScripts=(BOOLEAN) | Указывает, следует ли использовать операторы транзакций, если это возможно при публикации в базе данных. |
| /p: | LongRunningCommandTimeout=(INT32 '0') | Указывает длительное время ожидания команды в секундах при выполнении запросов к SQL Server. Используйте 0, чтобы ждать неограниченное время. |
| /p: | NoAlterStatementsToChangeClrTypes=(BOOLEAN) | Указывает, что публикация всегда должна удалять и повторно создавать сборку, если существует разница вместо выдачи инструкции ALTER ASSEMBLY. |
| /p: | PerformIndexOperationsOnline=(BOOLEAN 'Ложь') | Указывает, следует ли выполнять операции индексов в сети во время развертывания. |
| /p: | ЗаполнениеFilesOnFileGroups=(BOOLEAN 'True') | Указывает, создается ли новый файл при создании новой файловой группы в целевой базе данных. |
| /p: | RegisterDataTierApplication=(BOOLEAN) | Указывает, зарегистрирована ли схема на сервере базы данных. |
| /p: | RunDeploymentPlanExecutors=(BOOLEAN) | Указывает, должны ли участники DeploymentPlanExecutor выполняться при выполнении других операций. |
| /p: | ScriptDatabaseCollation=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в сортировке базы данных при публикации в базе данных. |
| /p: | ScriptDatabaseCompatibility=(BOOLEAN) | Указывает, следует ли игнорировать или обновлять различия в совместимости базы данных при публикации в базе данных. |
| /p: | ScriptDatabaseOptions=(BOOLEAN 'True') | Указывает, следует ли задавать или обновлять свойства целевой базы данных в рамках действия публикации. |
| /p: | ScriptDeployStateChecks=(BOOLEAN) | Указывает, создаются ли инструкции в скрипте публикации, чтобы убедиться, что имя базы данных и имя сервера совпадают с именами, указанными в проекте базы данных. |
| /p: | ScriptFileSize=(BOOLEAN) | Определяет, указан ли размер при добавлении файла в файловую группу. |
| /p: | ScriptNewConstraintValidation=(BOOLEAN 'True') | В конце публикации все ограничения будут проверены совокупностью, избегая ошибок данных, вызванных проверкой ограничений или ограничениями внешнего ключа в середине публикации. Если задано значение False, ограничения публикуются без проверки соответствующих данных. |
| /p: | ScriptRefreshModule=(BOOLEAN 'True') | Включите инструкции обновления в конец скрипта публикации. |
| /p: | Storage=({File|Memory}) | Указывает, как элементы хранятся при создании модели базы данных. По соображениям производительности значение по умолчанию — InMemory. Для больших баз данных может потребоваться резервное хранилище файлов и доступно только для версии SqlPackage .NET Framework. |
| /p: | TreatVerificationErrorsAsWarnings=(BOOLEAN) | Указывает, должны ли ошибки, возникающие во время проверки публикации, рассматриваться как предупреждения. Проверка выполняется в отношении созданного плана развертывания перед его выполнением в целевой базе данных. Проверка плана обнаруживает такие проблемы, как потеря целевых объектов (например, индексов), которые необходимо удалить, чтобы внести изменения. Проверка также обнаруживает ситуации, когда зависимости (например, таблица или представление) существуют из-за ссылки на составной проект, но не существуют в целевой базе данных. Это можно сделать, чтобы получить полный список всех проблем, а не остановить действие публикации при первой ошибке. |
| /p: | UnmodifiableObjectWarnings=(BOOLEAN 'Истина') | Указывает, следует ли создавать предупреждения при обнаружении различий в объектах, которые не могут быть изменены, например, если размер файла или пути к файлу были разными. |
| /p: | VerifyCollationCompatibility=(BOOLEAN 'Истина') | Указывает, проверяется ли совместимость параметров сортировки. |
| /p: | VerifyDeployment=(BOOLEAN 'Истина') | Указывает, следует ли выполнять проверки перед публикацией, которая остановит действие публикации, если проблемы присутствуют, которые могут блокировать успешную публикацию. Например, действие публикации может остановиться, если у вас есть внешние ключи в целевой базе данных, которая не существует в проекте базы данных, и это приводит к ошибкам при публикации. |
Примеры DeployReport
# example deploy report using a source .dacpac file and a target connection string (Azure SQL)
SqlPackage /Action:DeployReport /SourceFile:"C:\AdventureWorksLT.dacpac" \
/TargetConnectionString:"Server=tcp:{yourserver}.database.windows.net,1433;Initial Catalog=DW;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;" \
/DeployReportPath:"C:\AdventureWorksLTDeployReport.xml"
Параметры действия DriftReport
| Parameter | Краткая форма | Value | Description |
|---|---|---|---|
| /Action: | /a: | DriftReport | Указывает действие, которое необходимо выполнить. |
| /AccessToken: | /at: | {string} | Указывает маркер доступа на основе проверки подлинности, используемый при подключении к целевой базе данных. |
| /Diagnostics: | /d: | {True|False} | Указывает, выводится ли ведение журнала диагностики в консоль. По умолчанию False. |
| /DiagnosticsFile: | /df: | {string} | Указывает файл для хранения журналов диагностики. |
| /MaxParallelism: | /mp: | {int} | Указывает степень параллелизма для параллельных операций, выполняемых в базе данных. Значение по умолчанию — 8. |
| /OutputPath: | /op: | {string} | Указывает путь к файлу, в котором создаются выходные файлы. |
| /OverwriteFiles: | /of: | {True|False} | Указывает, должен ли SqlPackage перезаписать существующие файлы. Указание false приводит к прерыванию действия SqlPackage, если обнаружен существующий файл. Значение по умолчанию — True. |
| /Quiet: | /q: | {True|False} | Указывает, подавляется ли подробный отзыв. По умолчанию False. |
| /TargetConnectionString: | /tcs: | {string} | Указывает допустимую строку подключения SQL Server или Azure к целевой базе данных. Если этот параметр указан, он должен использоваться исключительно из всех остальных целевых параметров. |
| /TargetDatabaseName: | /tdn: | {string} | Определяет переопределение имени базы данных, являющейся целью действия SqlPackage. |
| /TargetEncryptConnection: | /tec: | {Optional|Mandatory|Strict|True|False} | Указывает, следует ли использовать шифрование SQL для подключения к целевой базе данных. Значение по умолчанию — True. |
| /TargetHostNameInCertificate: | /thnic: | {string} | Указывает значение, используемое для проверки целевого TLS/SSL-сертификата SQL Server при шифровании уровня связи с помощью TLS. |
| /TargetPassword: | /tp: | {string} | Для сценариев проверки подлинности SQL Server определяет пароль, используемый для доступа к целевой базе данных. |
| /TargetServerName: | /tsn: | {string} | Определяет имя сервера, на котором размещена целевая база данных. |
| /TargetTimeout: | /tt: | {int} | Указывает время ожидания для установления подключения к целевой базе данных в секундах. Для идентификатора Microsoft Entra рекомендуется, чтобы это значение было больше или равно 30 секундам. |
| /TargetTrustServerCertificate: | /ttsc: | {True|False} | Указывает, следует ли использовать TLS для шифрования подключения к целевой базе данных и обхода цепочки сертификатов для проверки доверия. Значение по умолчанию — False. |
| /TargetUser: | /tu: | {string} | Для сценариев проверки подлинности SQL Server определяет пользователя SQL Server, который будет использоваться для доступа к целевой базе данных. |
| /TenantId: | /tid: | {string} | Представляет идентификатор клиента Microsoft Entra или доменное имя. Этот параметр необходим для поддержки гостевых или импортированных пользователей Microsoft Entra, а также учетных записей Майкрософт, таких как outlook.com, hotmail.com или live.com. Если этот параметр опущен, будет использоваться идентификатор клиента по умолчанию для идентификатора Microsoft Entra, предполагая, что прошедший проверку подлинности пользователь является собственным пользователем для этого клиента. Однако в этом случае любые гостевые или импортированные пользователи и /или учетные записи Майкрософт, размещенные в этом идентификаторе Microsoft Entra, не поддерживаются, и операция завершится ошибкой. Для получения дополнительной информации см. универсальную аутентификацию с базой данных SQL и Azure Synapse Analytics (поддержка SSMS для MFA). |
| /UniversalAuthentication: | /ua: | {True|False} | Указывает, следует ли использовать универсальную проверку подлинности. Если задано значение True, интерактивный протокол проверки подлинности активируется с поддержкой MFA. Этот параметр также можно использовать для проверки подлинности Microsoft Entra без MFA, используя интерактивный протокол, требующий от пользователя ввод имени пользователя и пароля или встроенной проверки подлинности (учетные данные Windows). Если для параметра /UniversalAuthentication задано значение True, аутентификация Microsoft Entra не может быть использована в SourceConnectionString (/scs). Если для параметра /UniversalAuthentication задано значение False, необходимо указать проверку подлинности Microsoft Entra в SourceConnectionString (/scs). Для получения дополнительной информации см. универсальную аутентификацию с базой данных SQL и Azure Synapse Analytics (поддержка SSMS для MFA). |
Примеры DriftReport
# example drift report using a target connection string (Azure SQL)
SqlPackage /Action:DriftReport \
/TargetConnectionString:"Server=tcp:{yourserver}.database.windows.net,1433;Initial Catalog=AdventureWorksLT;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;" \
/OutputPath:"C:\AdventureWorksLT.DriftReport.xml"
Дальнейшие шаги
- Дополнительные сведения о SqlPackage