SqlDacpacDeploymentOnMachineGroup@0 - SQL Server資料庫部署 v0 工作
使用此工作可以使用 DACPAC 或 SQL 腳本來部署SQL Server資料庫。
Syntax
# 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
- 在執行腳本時取得獨佔應用程式鎖定, (s)
boolean
. 選擇性。 使用 時 ExecuteInTransaction = true
。 預設值:false
。
在執行腳本時取得獨佔應用程式鎖定, (s) 。
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資料庫部署的精細控制。
指定目的機器上發行設定檔 XML 檔案的路徑,或在電腦系統管理員認證可存取的 UNC 共用上。
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 |
要求 | 無 |
Capabilities | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 任意 |
可設定變數 | 任意 |
代理程式版本 | 1.102.0 或更新版本 |
工作類別 | 部署 |
需求 | 描述 |
---|---|
管線類型 | 傳統版本 |
在 上執行 | DeploymentGroup |
要求 | 無 |
Capabilities | 此工作不符合作業中後續工作的任何需求。 |
命令限制 | 任意 |
可設定變數 | 任意 |
代理程式版本 | 1.102.0 或更新版本 |
工作類別 | 部署 |