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 или более поздней версии |
Категория задач | Развертывание |