Поделиться через


SqlDacpacDeploymentOnMachineGroup@0 — задача развертывания базы данных SQL Server версии 0

Эта задача предназначена для развертывания базы данных SQL Server с помощью DACPAC или скриптов SQL.

Синтаксис

# This task is supported on classic release pipelines only.
# Use the classic designer to add and configure this task in a classic release pipeline.
# See the following Inputs section for details on the inputs that this task supports.

Входные данные

TaskType - Развертывание SQL с помощью
string. Обязательный. Допустимые значения: dacpac (Sql Dacpac), sqlQuery (файл запроса SQL), sqlInline (встроенный sql). Значение по умолчанию: dacpac.

Указывает способ развертывания базы данных: с помощью Dacpac или скриптов SQL.


DacpacFile - DACPAC-файл
string. Требуется при .TaskType = dacpac

Указывает расположение DACPAC-файла на целевых компьютерах или по UNC-пути, например \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. UNC-путь должен быть доступен для учетной записи администратора компьютера. Также поддерживаются переменные среды, такие как $env:windir, $env:systemrootили $env:windir\FabrikamFibre\DB. Можно использовать подстановочные знаки. Например, **/*.dacpac для файла DACPAC, который присутствует во всех вложенных папках.


SqlFile - Файл SQL
string. Требуется при .TaskType = sqlQuery

Указывает расположение SQL-файла в целевом объекте. Укажите разделенный точкой с запятой список файлов скриптов SQL для выполнения нескольких файлов. Скрипты SQL выполняются в указанном порядке. Расположение также может быть UNC-путем, например \\BudgetIT\Web\Deploy\FabrikamDB.sql. UNC-путь должен быть доступен для учетной записи администратора компьютера. Также поддерживаются переменные среды, такие как $env:windir, $env:systemrootили $env:windir\FabrikamFibre\DB. Можно использовать подстановочные знаки. Например, для SQL-файла, **/*.sql присутствующего во всех вложенных папках.


ExecuteInTransaction - Выполнение в транзакции
boolean. Необязательный элемент. Используйте при TaskType = sqlQuery. Значение по умолчанию: false.

Выполняет скрипты SQL в транзакции.


ExclusiveLock - Получение монопольной блокировки приложения при выполнении скриптов
boolean. Необязательный элемент. Используйте при ExecuteInTransaction = true. Значение по умолчанию: false.

Получает монопольную блокировку приложения при выполнении скриптов.


AppLockName - Имя блокировки приложения
string. Требуется при .ExclusiveLock = true

Указывает имя блокировки приложения.


InlineSql - Встроенный sql
string. Требуется при .TaskType = sqlInline

Указывает встроенные SQL-запросы.


TargetMethod - Указание SQL с помощью
string. Требуется при .TaskType = dacpac Допустимые значения: server, connectionString (строка подключения), publishProfile (профиль публикации). Значение по умолчанию: server.

Указывает параметр для подключения к целевой базе данных SQL Server. Вы можете указать сведения о базе данных SQL Server, строку подключения SQL Server или XML-файл профиля публикации.


ServerName - Имя сервера
string. Требуется при .TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline Значение по умолчанию: localhost.

Задает имя SQL Server, например machinename\FabriakmSQL,1433, localhostили .\SQL2012R2. При указании localhost будет подключаться к экземпляру SQL Server по умолчанию на компьютере.


DatabaseName - Имя базы данных
string. Требуется при .TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline

Указывает имя базы данных SQL Server.


AuthScheme - Проверки подлинности
string. Требуется при .TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline Допустимые значения: windowsAuthentication (проверка подлинности Windows), sqlServerAuthentication (SQL Server проверка подлинности). Значение по умолчанию: windowsAuthentication.

Указывает режим проверки подлинности для подключения к SQL Server. В режиме проверка подлинности Windows для подключения к SQL Server используется учетная запись, используемая для настройки агента развертывания. В SQL Server режиме проверки подлинности имя входа и пароль SQL должны быть указаны в приведенных ниже параметрах.


SqlUsername - Имя пользователя SQL
string. Требуется при .AuthScheme = sqlServerAuthentication

Указывает имя входа SQL для подключения к SQL Server. Этот параметр доступен, только если выбран SQL Server режим проверки подлинности.


SqlPassword - Пароль SQL
string. Требуется при .AuthScheme = sqlServerAuthentication

Указывает пароль имени входа SQL. Этот параметр доступен, только если выбран SQL Server режим проверки подлинности.


ConnectionString - Строка подключения
string. Требуется при .TargetMethod = connectionString

Задает строку подключения SQL Server, например Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.


PublishProfile - Профиль публикации
string. Необязательный элемент. Используйте при TaskType = dacpac.

Обеспечивает детальный контроль над развертываниями SQL Server баз данных.
Указывает путь к XML-файлу профиля публикации на целевом компьютере или в общей папке UNC, доступной с помощью учетных данных администратора компьютера.


AdditionalArguments - Дополнительные аргументы
string. Необязательный элемент. Используйте при TaskType = dacpac.

Указывает дополнительные SqlPackage.exe аргументы, которые будут применяться при развертывании базы данных SQL Server, например /p:IgnoreAnsiNulls=True или /p:IgnoreComments=True. Эти аргументы переопределяют параметры в XML-файле профиля публикации (если они указаны).


AdditionalArgumentsSql - Дополнительные аргументы
string. Необязательный элемент. Используйте при TaskType = sqlQuery || TaskType = sqlInline.

Указывает дополнительные Invoke-Sqlcmd аргументы, применяемые при развертывании базы данных SQL Server.


Параметры управления задачами

Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Требования

Требование Описание
Типы конвейеров Классический выпуск
Выполняется в Агент, DeploymentGroup
Требования Нет
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.102.0 или более поздней версии
Категория задач Развернуть
Требование Описание
Типы конвейеров Классический выпуск
Выполняется в DeploymentGroup
Требования Нет
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.102.0 или более поздней версии
Категория задач Развертывание