AzureMysqlDeployment@1 - 適用於 MySQL 的 Azure 資料庫部署 v1 工作

使用此工作來執行腳本，並在適用於 MySQL 的 Azure 資料庫中對資料庫進行變更。 適用於 MySQL 的 Azure 資料庫部署工作僅適用於 適用於 MySQL 的 Azure 資料庫單一伺服器。

語法

# Azure Database for MySQL deployment v1
# Run your scripts and make changes to your Azure Database for MySQL.
- task: AzureMysqlDeployment@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription. 
  # DB Details
    ServerName: # string. Required. Host Name. 
    #DatabaseName: # string. Database Name. 
    SqlUsername: # string. Required. Server Admin Login. 
    SqlPassword: # string. Required. Password. 
  # Deployment Package
    #TaskNameSelector: 'SqlTaskFile' # 'SqlTaskFile' | 'InlineSqlTask'. Type. Default: SqlTaskFile.
    SqlFile: # string. Required when TaskNameSelector = SqlTaskFile. MySQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline MySQL Script. 
    #SqlAdditionalArguments: # string. Additional MySQL Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

輸入

azureSubscription - Azure 訂用帳戶
輸入別名：ConnectedServiceName。 string。 必須的。

若要連線到您的 Azure 帳戶，需要有此專案。

若要設定新的服務連線，請從清單中選取 Azure 訂用帳戶，然後按兩下 [Authorize]。

如果您的訂用帳戶未列出，或您想要使用現有的服務主體，您可以使用 Add 或 Manage 按鈕來設定 Azure 服務連線。

ServerName - 主機名
string。 必須的。

適用於 MySQL 伺服器的 Azure 資料庫名稱。

範例：fabrikam.mysql.database.azure.com

伺服器名稱會在適用於 MySQL 的 Azure 資料庫伺服器資源的 [概觀] 刀鋒視窗上，於 Azure 入口網站中提供。

當您使用 MySQL Workbench 進行連線時，這個值與 Parameters中用於 Hostname 的值相同。

DatabaseName - 資料庫名稱
string。

選擇性。 資料庫的名稱。 如果資料庫名稱不存在，腳本將會建立資料庫名稱。

如果未指定，請確定在提供的 SQL 檔案或內嵌 SQL 中參考資料庫，視需要。

注意：MySQL 資料庫名稱區分大小寫。

SqlUsername - 伺服器管理員登入
string。 必須的。

適用於 MySQL 的 Azure 資料庫伺服器支援原生 MySQL 驗證。 您可以利用伺服器的管理員登入來連接和驗證伺服器。 範例： bbo1@fabrikam.

當您使用 MySQL Workbench 進行連線時，這個值與 Parameters中用於 Username 的值相同。

SqlPassword - 密碼
string。 必須的。

適用於 MySQL 的 Azure 資料庫的系統管理員密碼。 如果您不記得密碼，您可以從 azure 入口網站 變更密碼。

此字串可以使用管線中的變數來定義。 範例： $(password).

此外，您可以將變數類型標示為 secret 來保護它。

TaskNameSelector - 類型
string。 允許的值：SqlTaskFile （MySQL 腳本檔案），InlineSqlTask （內嵌 MySQL 腳本）。 預設值：SqlTaskFile。

選擇性。 選取 [腳本檔案] & [內嵌腳本] 之間的其中一個選項。

• SqlTaskFile （預設值），以搭配 SqlFile 自變數使用
• InlineSqlTask，以搭配 SqlInline 自變數使用。

注意：這些值會區分大小寫。

SqlFile - MySQL 腳本
string。 TaskNameSelector = SqlTaskFile時為必要項。

自動化代理程式上腳本檔案的完整路徑，或自動化代理程式可存取的 UNC 路徑。 例如： \BudgetIT\DeployBuilds\script.sql 。

您可以在這裡使用預先定義的系統變數，例如 $(agent.releaseDirectory)，以及包含 SQL 語句的檔案。

注意：MySQL 用戶端偏好 Unix 樣式路徑，因此從 1.183.0 版開始，工作會將 Windows 樣式路徑轉換成 Unix 樣式路徑。 範例：從 c:\foo\bar\myscript.sql 到 c:/foo/bar/myscript.sql。

在Linux平臺上使用工作時，路徑會保持不變。 不需要逸出路徑中的特殊字元。

SqlInline - 內嵌 MySQL 腳本
string。 TaskNameSelector = InlineSqlTask時為必要項。

輸入 MySQL 腳本，以在上面選取的資料庫上執行。

SqlAdditionalArguments - 其他 MySQL 自變數
string。

選擇性。 MySQL 用戶端支援的其他選項。 在適用於 MySQL 的 Azure 資料庫上執行指定的檔案時，會套用這些選項。

範例：您可以將 變更為預設索引標籤分隔輸出格式、HTML，或甚至變更為 XML 格式。 其他範例包括：

• --comments 移除從用戶端傳送到伺服器的批注。
• --quick 以防止結果快取。
• --xml 將結果輸出為 XML。

MySQL 用戶端檔中會說明所有可用的選項。

IpDetectionMethod - 使用 指定防火牆規則
string。 必須的。 允許的值：AutoDetect、IPAddressRange。 預設值：AutoDetect。

若要順利執行工作，我們需要讓系統管理員從自動化代理程式的IP位址存取適用於 MySQL 的 Azure 資料庫伺服器。

藉由選取自動偵測，您可以針對自動化代理程式可能IP位址的範圍自動新增防火牆例外狀況，也可以明確指定範圍。

接受的值：

• AutoDetect 自動偵測自動化代理程式的公用IP位址。
• IPAddressRange 明確指定要設定的IP位址範圍。 使用 StartIpAddress 和 EndIpAddress 參數來設定IP位址範圍。

附注：這些值會區分大小寫。

StartIpAddress - 起始IP位址
string。 IpDetectionMethod = IPAddressRange時為必要項。

自動化代理程式計算機集區的起始IP位址。 例如： 196.21.30.50 。

EndIpAddress - 結束IP位址
string。 IpDetectionMethod = IPAddressRange時為必要項。

自動化代理程式計算機集區的結束IP位址。 例如： 196.21.30.65 。

在工作結束之後 DeleteFirewallRule - 刪除規則
boolean。 預設值：true。

選擇性。 如果選取，將會針對對應的「適用於 MySQL 的 Azure 資料庫」移除自動化代理程式的 IP 位址新增例外狀況。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

沒有。

備註

使用此工作來執行腳本，並在適用於 MySQL 的 Azure 資料庫中對資料庫進行變更。 請注意，這是預覽版本。 適用於 MySQL 的 Azure 資料庫部署工作僅適用於 適用於 MySQL 的 Azure 資料庫單一伺服器。

需求

要求	說明
管線類型	YAML、傳統組建、傳統版本
執行於	代理
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	1.100.0 或更新
工作類別	部署