使用此任务通过 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时是必需的。
指定目标计算机上或 UNC 路径上 DACPAC 文件的位置，例如 \\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 参数。
任务控制选项
除任务输入之外，所有任务都具有控制选项。 有关详细信息，请参阅 控件选项和常见任务属性。
输出变量
没有。