共用方式為

Azure SQL 受控執行個體的受控 API 參考

  • 發行項

適用於：Azure SQL 受控執行個體

您可以使用 Azure 入口網站、PowerShell、Azure CLI、REST API 和 Transact-SQL，來建立和設定 Azure SQL Database 受控執行個體的受控執行個體。 在本文中，您可以概略了解建立和設定受控執行個體的函數和 API。

Azure 入口網站：建立受控執行個體

如需示範如何建立受控執行個體的快速入門，請參閱快速入門：建立受控執行個體。

PowerShell：建立和設定受控執行個體

注意

本文使用 Azure Az PowerShell 模組，這是與 Azure 互動時建議使用的 PowerShell 模組。 若要開始使用 Az PowerShell 模組，請參閱安裝 Azure PowerShell。 若要瞭解如何遷移至 Az PowerShell 模組，請參閱將 Azure PowerShell 從 AzureRM 遷移至 Az。

重要

PowerShell Azure Resource Manager （AzureRM） 模組已於 2024 年 2 月 29 日淘汰。 所有未來的開發都應該使用 Az.Sql 模組。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。 不再維護或支援 AzureRM 模組。 Az PowerShell 模組和 AzureRM 模組中命令的自變數基本上完全相同。 如需相容性的詳細資訊，請參閱 新 Az PowerShell 模組簡介。

若要使用 Azure PowerShell 建立和管理受控執行個體，請使用下列 PowerShell 指令程式。 如果您需要安裝或升級 PowerShell，請參閱安裝 Azure PowerShell 模組。

提示

如需 PowerShell 範例指令碼，請參閱快速入門指令碼：使用 PowerShell 程式庫建立受控執行個體。

Cmdlet 描述
New-AzSqlInstance 建立受控執行個體。
Get-AzSqlInstance 傳回受控執行個體的相關資訊。
Set-AzSqlInstance 設定受控執行個體的屬性。
Remove-AzSqlInstance 移除受控執行個體。
Get-AzSqlInstanceOperation 取得在受控執行個體或特定作業上執行的管理作業清單。
Stop-AzSqlInstanceOperation 取消在受控執行個體上執行的特定管理操作。
New-AzSqlInstanceDatabase 建立 SQL 受控執行個體資料庫。
Get-AzSqlInstanceDatabase 傳回 SQL Database 受控執行個體資料庫的相關資訊。
Remove-AzSqlInstanceDatabase 移除 SQL 受控執行個體資料庫。
Restore-AzSqlInstanceDatabase 還原 SQL 受控執行個體資料庫。

Azure CLI：建立和設定受控執行個體

若要使用 Azure CLI 建立和設定受控執行個體，請使用下列適用於 SQL 受控執行個體的 Azure CLI 命令。 使用 Azure Cloud Shell 在您的瀏覽器中執行 Azure CLI，或在 macOS、Linux 或 Windows 中進行安裝。

提示

如需 Azure CLI 快速入門，請參閱使用 Azure CLI 處理 SQL 受控執行個體。

Cmdlet 描述
az sql mi create 建立受控執行個體。
az sql mi list 列出可用的受控執行個體。
az sql mi show 取得受控執行個體的詳細資料。
az sql mi update 更新受控執行個體。
az sql mi delete 移除受控執行個體。
az sql mi op list 取得在受控執行個體上執行的管理作業清單。
az sql mi op show 取得在受控執行個體上執行的特定管理操作。
az sql mi op cancel 取消在受控執行個體上執行的特定管理操作。
az sql midb create 建立受控資料庫。
az sql midb list 列出可用的受控資料庫。
az sql midb restore 還原受控資料庫。
az sql midb delete 移除受控資料庫。

Transact-SQL：建立和設定執行個體資料庫

若要在建立受控執行個體後建立和設定執行個體資料庫，請使用下列 T-SQL 命令。 您可以使用 Azure 入口網站、SQL Server Management Studio、Azure Data Studio、Visual Studio Code，或任何可連線至伺服器並傳遞 Transact-SQL 命令的其他程式來發出這些命令。

提示

如需示範如何使用 Microsoft Windows 上的 SQL Server Management Studio 來設定和連線至受控執行個體的快速入門，請參閱快速入門：設定 Azure VM 以連線至 Azure SQL 受控執行個體和快速入門：設定從內部部署至 Azure SQL 的點對站連線。

重要

您無法使用 Transact-SQL 建立或刪除受控執行個體。

命令 描述
CREATE DATABASE 在 SQL 受控執行個體中建立新的執行個體資料庫。 您必須連線至 master 資料庫，才能建立新的資料庫。
ALTER DATABASE 在 SQL 受控執行個體中修改執行個體資料庫。

REST API：建立和設定受控執行個體

若要建立和設定受控執行個體，請使用下列 REST API 要求。

命令 描述
SQL 受控執行個體 - 建立或更新 建立或更新受控執行個體。
SQL 受控執行個體 - 刪除 刪除受控執行個體。
SQL 受控執行個體 - 取得 取得受控執行個體。
SQL 受控執行個體 - 停止 停止受控執行個體。
SQL 受控執行個體 - 啟動 啟動受控執行個體
SQL 受控執行個體 - 清單 傳回訂用帳戶中受控執行個體的清單。
受控執行個體 - 依資源群組列出 傳回資源群組中受控執行個體的清單。
SQL 受控執行個體 - 更新 更新受控執行個體。
SQL 受控執行個體作業 - 依受控執行個體列出 取得在受控執行個體上執行的管理作業清單。
SQL 受控執行個體作業 - 取得 取得在受控執行個體上執行的特定管理操作。
SQL 受控執行個體作業 - 取消 取消在受控執行個體上執行的特定管理操作。
SQL 受控執行個體 - 啟動/停止排程 - 建立或更新 建立或更新啟動和停止受控執行個體排程。
SQL 受控執行個體 - 開始/停止排程 - 取得 取得現有啟動和停止受控執行個體排程。
SQL 受控執行個體 - 開始/停止排程 - 刪除 刪除現有啟動和停止受控執行個體排程。

下一步