Azure MCP 伺服器讓您能管理 Azure SQL Database 資源，包括建立、刪除、更新及列出資料庫，並搭配自然語言提示。
Azure SQL Database 是 Microsoft Azure 雲端中的關聯式資料庫服務，提供高可用性、可擴展性與安全性。 欲了解更多資訊，請參閱 Azure SQL Database documentation。
Note
Tool 參數：Azure MCP 伺服器工具為完成任務所需的資料定義參數。 其中一些參數是每個工具特有的，並記載於下方。 其他參數是全局參數，並由所有工具共用。 如需詳細資訊，請參閱 工具參數。
建立 SQL Database
在現有的 SQL Server 上建立一個新的 Azure SQL Database。 建立一個可設定效能層級、大小限制及其他設定的資料庫。 它會回傳新建立的資料庫資訊，包括設定細節。
範例提示包括：
- 「在伺服器 'my-sql-server' 建立一個名為 'my-database' 的 SQL 資料庫，使用 SKU 等級的 Premium 版本。」
- 「在伺服器 'my-sql-server' 的資源群組 'my-resource-group' 中建立一個名為 'products-db' 的新 SQL 資料庫。」
- 「在伺服器 'my-sql-server' 中建立一個最大 2GB 的 SQL 資料庫 'reports-db'。」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資料庫名稱 | Required | Azure SQL Database 名稱。 |
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
| 排序規則 | 可選 | 資料庫的定序 （例如 SQL_Latin1_General_CP1_CI_AS）。 |
| 彈性集區名稱 | 可選 | 要指派資料庫的彈性集區名稱。 |
| 最大位元組數 | 可選 | 資料庫的大小上限 （以位元組為單位）。 |
| 讀取比例 | 可選 | 資料庫的讀取縮放選項（啟用或停用）。 |
| SKU 容量 | 可選 | 資料庫的 SKU 容量（DTU 或 vCore 計數）。 |
| SKU 名稱 | 可選 | 資料庫的 SKU 名稱 （例如 Basic， ， S0P1， ， GP_Gen5_2）。 |
| SKU 層級 | 可選 | 資料庫的 SKU 層 （例如 Basic、 、 StandardPremiumGeneralPurpose、 ）。 |
| 區域備援 | 可選 | 資料庫是否需要具備區域冗餘功能。 |
破壞性： ✅ |冪等： ❌ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
建立 SQL Server
在指定的資源群組和位置建立一個新的 Azure SQL 伺服器。 伺服器已使用提供的管理員憑證及可選設定進行配置。 該指令會回傳建立的伺服器及其屬性，包括完整限定的網域名稱。
範例提示包括：
- 「在 'eastus' 位置建立一台名為 'my-sql-server' 的 Azure SQL 伺服器，管理員登入為 'sqladmin'。」
- 「在資源群組 'my-resource-group' 中設置一個名為 'prod-sql-server' 的新 SQL 伺服器，並使用你的管理員密碼。」
- 「在資源群組 'dev-resource-group' 中建立一個位於 'westus2' 的名為 'dev-sql-server' 的 SQL 伺服器。」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 系統管理員登入 | Required | SQL Server 的系統管理員登入名稱。 |
| 管理員密碼 | Required | SQL Server 的系統管理員密碼。 |
| 地點 | Required | Azure 區域，SQL 伺服器將在此建立。 |
| 資源群組 | Required | Azure 資源群組的名稱，是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
| 公用網路存取 | 可選 | 是否已啟用 SQL Server 的公用網路存取 （Enabled 或 Disabled）。 |
| 版本 | 可選 | SQL Server 要創建的版本（目前只支援 12.0）。 |
破壞性： ✅ |冪等： ❌ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
建立 SQL Server 防火牆規則
為 Azure SQL Server 建立防火牆規則。 防火牆規則控制哪些 IP 位址可以連接到 SQL Server。 你可以指定單一 IP 位址（將起始與結束 IP 設為相同值），或是多個 IP 位址範圍。 此指令會回傳已建立的防火牆規則及其屬性。
範例提示包括：
- 「為資源群組 'my-resource-group' 中的 SQL Server 'my-sql-server' 建立一條名為 'allow-office-ip' 的防火牆規則。」
- 「為 SQL Server 'my-sql-server' 新增防火牆規則，允許 IP 範圍 '203.0.113.0' 到 '203.0.113.255'。」
- 「為 Azure SQL Server 'prod-sql-server' 建立一條新的防火牆規則，IP 限制範圍從 '198.51.100.0' 到 '198.51.100.255'.”
| Parameter | 必要或選用 | Description |
|---|---|---|
| 終端 IP 位址 | Required | 防火牆規則範圍的終端 IP 位址。 |
| 防火牆規則名稱 | Required | 防火牆規則的名稱。 |
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
| 起始 IP 位址 | Required | 防火牆規則範圍的起始 IP 位址。 |
破壞性： ✅ |冪等： ❌ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
刪除 SQL Database
從 Azure SQL Server 刪除資料庫。 此冪등運算會將指定的資料庫從伺服器移除，若資料庫不存在或Deleted = false成功移除則返回Deleted = true。
範例提示包括：
- 「從伺服器 'my-sql-server' 刪除 SQL 資料庫 'my-database'。」
- 將資料庫 'old-database' 從伺服器 'my-sql-server' 上的資源群組 'my-resource-group' 中移除。
- 從 SQL 伺服器 'dev-sql-server' 中刪除資料庫 'test-database'。
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資料庫名稱 | Required | Azure SQL Database 名稱。 |
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
刪除 SQL Server
從你的 Azure 訂閱中移除指定的 Azure SQL 伺服器，包括所有相關的資料庫。 此操作會永久刪除所有伺服器資料，且無法逆轉。 用 force 來繞過確認程序。
範例提示包括：
- 「刪除資源群組 'my-resource-group' 中的 SQL 伺服器 'my-sql-server'。」
- 「從我的資源群組移除 Azure SQL 伺服器 'old-sql-server'。」
- 「未經確認永久刪除 SQL 伺服器 'test-sql-server'。」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
| 力 | 可選 | 強制刪除伺服器，沒有確認提示。 |
破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
刪除 SQL Server 防火牆規則
從 Azure SQL Server 刪除防火牆規則。 此操作移除了指定的防火牆規則，該規則可能限制先前該規則允許的 IP 位址存取。 此運算為冪등 運算;若不存在該規則，則不會回傳錯誤。
範例提示包括：
- 「在 SQL Server 'my-sql-server' 中刪除資源群組 'my-resource-group' 中的防火牆規則 'allow-office-ip'。」
- 移除 SQL 伺服器 'my-sql-server' 及其資源群組 'my-resource-group' 的防火牆規則 'temp-access-rule'。
- 從我的 SQL 伺服器「dev-sql-server」中刪除防火牆規則「old-firewall-rule」。
| Parameter | 必要或選用 | Description |
|---|---|---|
| 防火牆規則名稱 | Required | 防火牆規則的名稱。 |
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
取得 Azure SQL 資料庫詳細資訊
在 SQL Server 中取得有關 Azure SQL 資料庫的資訊。 你可以以名稱顯示特定 Azure SQL 資料庫的詳細資訊，或列出指定 SQL Server 內的所有 Azure SQL 資料庫。 此工具提供資料庫資訊，包括設定細節及當前狀態。
範例提示包括：
- 「列出伺服器『my-server』資源群組 'my-rg' 中的所有資料庫。」
- 「取得資源群組 'my-rg' 中 Azure SQL 資料庫 'my-database' 與伺服器 'my-server' 的詳細資料。」
- 「顯示伺服器『my-server』資源群組 'my-rg' 中所有Azure SQL資料庫。」
- 「從伺服器『my-server』的資源群組『my-rg』中取得Azure SQL資料庫『my-database』。」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
| 資料庫名稱 | 可選 | Azure SQL Database的名稱。 |
破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌
取得彈性池列表
列出 Azure SQL Server 中所有 SQL 彈性池，包括它們的 SKU、容量、狀態及資料庫限制。 您可以查看彈性池庫存、檢查池使用率、比較池組態，或尋找可供資料庫放置的池。 工具會回傳一個包含完整設定細節的彈性池 JSON 陣列。
範例提示包括：
- 「列出 SQL 伺服器 'my-sql-server' 資源群組中的所有彈性池。」
- 「請給我看 SQL 伺服器 'prod-sql-server' 資源群組 'prod-resource-group' 中的彈性池。」
- 「在我的 SQL 伺服器 'dev-sql-server' 資源群組 'dev-resource-group' 下，有哪些彈性池存在？
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌
取得防火牆規則清單
取得 Azure SQL Server 的防火牆規則清單。 此指令會擷取所有為指定 SQL 伺服器設定的防火牆規則，包括其 IP 位址範圍與規則名稱。 它會回傳一組防火牆規則物件及其屬性。
範例提示包括：
- 「列出資源群組 'my-resource-group' 中所有防火牆規則，適用於 SQL 伺服器 'my-sql-server'。」
- 「請在資源群組 'prod-resource-group' 中顯示 SQL 伺服器 'prod-sql-server' 的防火牆規則。」
- 「資源群組 'dev-resource-group' 中 SQL 伺服器 'dev-sql-server' 設定了哪些防火牆規則？」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 的名稱。 |
破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌
取得 SQL 伺服器資訊
取得資源群組中 Azure SQL 伺服器的詳細資訊。 以名稱顯示特定 Azure SQL 伺服器的資訊，或列出指定資源群組內所有 Azure SQL 伺服器。 它會回傳完整的伺服器資訊，包括設定細節及當前狀態。
範例提示包括：
- 列出資源群組「my-resource-group」中的所有 Azure SQL 伺服器。
- 「顯示我在資源群組 'prod-resource-group' 中的每一個 Azure SQL 伺服器。」
- 「請給我看 Azure SQL 伺服器 'my-sql-server' 的詳細資料。」
- 取得 Azure SQL 伺服器 'prod-sql-server' 的資訊。
- 顯示 Azure SQL 伺服器 'dev-sql-server' 的屬性。
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | 可選 | Azure SQL 伺服器名稱。 |
破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌
列出 Microsoft Entra ID 管理員
列出為 SQL 伺服器設定的 Microsoft Entra ID 管理員。 此指令可取得所有 Entra ID 管理員，包括其顯示名稱、物件 ID 及租戶資訊。
範例提示包括：
- 在資源群組「prod-resource-group」中列出 SQL 伺服器「prod-sql-server」的 Microsoft Entra ID 管理員。
- 「顯示在資源群組 'dev-resource-group' 中為 SQL 伺服器 'dev-sql-server' 設定的 Entra ID 管理員。」
- 「我的 SQL 伺服器 'analytics-sql-server' 在資源群組 'data-resource-group' 中，有哪些 Microsoft Entra ID 管理員被設定了？」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資源群組 | Required | Azure 資源群組的名稱。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱（例如 prod-sql-server）。 |
破壞性： ❌ |冪等： ✅ |開放世界： ❌ |只讀： ✅ |秘密： ❌ |本地要求： ❌
重新命名 SQL 資料庫
在同一 SQL Server 內將現有的 Azure SQL Database 重新命名為新名稱。 此指令會改變資料庫資源的識別碼，同時保留其設定與資料。 它會回傳具有新名稱的更新資料庫資訊。
範例提示包括：
- 「將伺服器 'my-sql-server' 的資料庫名稱改為資源群組 'my-resource-group' 中的 'my-database-v2'。」
- 「在伺服器『prod-sql-server』上，將我的 SQL 資料庫 'old-database' 改名為'new-database'。」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資料庫名稱 | Required | Azure SQL Database 的名稱。 |
| 新的資料庫名稱 | Required | Azure SQL Database 的新名稱。 |
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
破壞性： ✅ |冪等： ❌ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌
更新 SQL 資料庫
擴展並配置 Azure SQL Database 效能設定。 更新現有資料庫的 SKU、運算層級、儲存容量或冗餘選項，以因應不斷變化的效能需求。 此指令會回傳更新後的資料庫設定，包括已套用的縮放變更。
範例提示包括：
- 更改資源群組 'my-resource-group' 中伺服器 'my-sql-server' 的 SQL 資料庫 'my-database' 的排序規則。
- 「將伺服器 'my-sql-server' 上的 SQL 資料庫 'my-database' 更新為最大 2GB。」
| Parameter | 必要或選用 | Description |
|---|---|---|
| 資料庫名稱 | Required | Azure SQL Database 名稱。 |
| 資源群組 | Required | Azure 資源群組的名稱。 這是一個用於 Azure 資源的邏輯容器。 |
| 伺服器名稱 | Required | Azure SQL Server 名稱。 |
| 排序規則 | 可選 | 資料庫的定序 （例如 SQL_Latin1_General_CP1_CI_AS）。 |
| 彈性集區名稱 | 可選 | 要指派資料庫的彈性集區名稱。 |
| 最大位元組數 | 可選 | 資料庫的大小上限 （以位元組為單位）。 |
| 讀取比例 | 可選 | 資料庫的讀取縮放選項（啟用或停用）。 |
| SKU 容量 | 可選 | 資料庫的 SKU 容量（DTU 或 vCore 計數）。 |
| SKU 名稱 | 可選 | 資料庫的 SKU 名稱 （例如 Basic， ， S0P1， ， GP_Gen5_2）。 |
| SKU 層級 | 可選 | 資料庫的 SKU 層 （例如 Basic、 、 StandardPremiumGeneralPurpose、 ）。 |
| 區域備援 | 可選 | 資料庫是否需設為區域冗餘。 |
破壞性： ✅ |冪等： ✅ |開放世界： ❌ |只讀： ❌ |秘密： ❌ |本地要求： ❌