SqlDacpacDeploymentOnMachineGroup@0 - SQL Server数据库部署 v0 任务

使用此任务使用 DACPAC 或 SQL 脚本部署SQL Server数据库。

语法

# 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 Server的 SQL 登录名。 仅当已选择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数据库部署的精细控制。
指定目标计算机或 UNC 共享上可由计算机管理员凭据访问的发布配置文件 XML 文件的路径。

AdditionalArguments - 其他参数
string. 可选。 在 时 TaskType = dacpac使用 。

指定在部署SQL Server数据库时将应用的其他SqlPackage.exe参数，如 /p:IgnoreAnsiNulls=True 或 /p:IgnoreComments=True。 如果) 提供，这些参数将替代发布配置文件 XML 文件中 (的设置。

AdditionalArgumentsSql - 其他参数
string. 可选。 在 时 TaskType = sqlQuery || TaskType = sqlInline使用 。

指定在部署SQL Server数据库时应用的其他Invoke-Sqlcmd参数。

任务控件选项

除任务输入外，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

要求

要求	说明
管道类型	经典版本
运行平台	Agent、DeploymentGroup
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	Any
可设置的变量	Any
代理版本	1.102.0 或更高版本
任务类别	部署