使用受控識別來設定 Azure SQL 受控執行個體的索引子連線

Note

Foundry IQ(Azure AI 搜尋服務)提供直接的索引與查詢 API,並搭配高階知識來源與知識庫 API 用於受控檢索。 使用 Azure 入口網站、REST API 或 Azure SDK 來設定這些功能,或將代理連線到 Microsoft Foundry 入口網站 中的知識庫。

本文說明如何使用管理身份設定 Foundry IQ(Azure AI 搜尋服務)索引器連線至 SQL 受管理執行個體,而非在 連接字串 中提供憑證。

你可以使用系統指派的管理身份或使用者指派的管理身份。 受管理身份是 Microsoft Entra 登入,且需要 Azure 角色指派才能存取 SQL 受管理執行個體 中的資料。

在你進一步了解這個功能之前,你應該先了解什麼是索引器,以及如何為你的資料來源設定索引器。 如需更多資訊,請參閱 Foundry IQ 中的索引器以及 Azure SQL Database 中的索引資料。

先決條件

指派讀取資料庫的權限

請依照以下步驟,指派 Foundry IQ 服務的系統指派受控識別讀取 SQL 受控執行個體資料庫的權限。

  1. 透過以下任一方法,透過 SQL Server Management Studio(SSMS)連接您的 SQL 受管理執行個體:

  2. 請使用您的 Microsoft Entra 帳號進行驗證。

    顯示「連線至伺服器」對話方塊的螢幕擷圖。

  3. 從左側窗格找到你用作索引資料來源的 SQL 資料庫,然後右鍵點擊它。 選擇 新查詢。

    顯示新 SQL 查詢的螢幕截圖。

  4. 在 T-SQL 視窗中,複製以下指令,並在 Foundry IQ 服務名稱周圍加上括號。 選擇 執行。

    CREATE USER [insert your search service name here or user-assigned managed identity name] FROM EXTERNAL PROVIDER;
    EXEC sp_addrolemember 'db_datareader', [insert your search service name here or user-assigned managed identity name];
    

    顯示執行 SQL 查詢的截圖。

如果您在指派權限後更改 Foundry IQ 服務系統識別碼,必須移除角色成員資格並在 SQL 資料庫中移除使用者,然後重複權限指派。 要移除角色成員身份和使用者,請執行以下指令:

sp_droprolemember 'db_datareader', [insert your search service name or user-assigned managed identity name];

DROP USER IF EXISTS [insert your search service name or user-assigned managed identity name];

新增角色分配

在此步驟中,您授權 Foundry IQ 服務從您的 SQL 受管理執行個體 讀取資料。

  1. 在 Azure 入口網站,前往你的 SQL 受管理執行個體 頁面。

  2. 選擇存取控制(IAM)。

  3. 選擇 新增>角色分配。

    存取控制 頁面的螢幕擷取畫面。

  4. 選擇 讀者 角色。

  5. 將 [存取權指派對象] 保留為 [Microsoft Entra 使用者、群組或服務主體]。

  6. 如果您使用的是系統指派的受控識別,請搜尋您的 Foundry IQ 服務,然後選取它。 如果你使用的是使用者指派的管理身份,請搜尋該受管理身份的名稱並選擇它。 選擇 儲存。

    這裡有一個使用 SQL 受管理執行個體 系統分配的受管理識別的範例:

    顯示成員角色指派的截圖。

建立資料來源

建立資料來源並提供系統指派的管理身份。

系統指派的管理識別

REST API、Azure入口網站,以及 .NET SDK 支援系統指派的管理身份。

當你使用系統指派的管理身份連接時,資料來源定義唯一的改變就是「憑證」屬性的格式。 您提供初始目錄或資料庫名稱,以及沒有帳戶金鑰或密碼的 ResourceId。 ResourceId 必須包含 SQL 受管理執行個體 的訂閱 ID、SQL Managed instance 的資源群組,以及 SQL 資料庫名稱。

以下是一個範例,說明如何使用 Create Data Source REST API 和受管理的身份連線字串,建立一個能從 SQL 受管理執行個體索引資料的資料來源。 REST API、.NET SDK 和 Azure 入口的受控身份識別連接字串格式相同。

POST https://[service name].search.windows.net/datasources?api-version=2026-10-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-mi-datasource",
    "type" : "azuresql",
    "credentials" : { 
        "connectionString" : "Database=[SQL database name];ResourceId=/subscriptions/[subscription ID]/resourcegroups/[resource group name]/providers/Microsoft.Sql/managedInstances/[SQL Managed Instance name];Connection Timeout=100;"
    },
    "container" : { 
        "name" : "my-table" 
    }
} 

建立索引

索引指定文件中的欄位、屬性及其他塑造搜尋體驗的結構。

這裡有一個可搜尋欄位的 booktitle REST API 呼叫:

POST https://[service name].search.windows.net/indexes?api-version=2026-10-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "my-target-index",
    "fields": [
        { "name": "id", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "booktitle", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false }
    ]
}

建立索引器

索引器將資料來源與目標搜尋索引連結,並提供自動資料更新的排程。 建立索引和資料來源後,再建立索引器。

這裡有一個 Create Indexer REST API 呼叫,並定義了 Azure SQL indexer。 索引器會在你提交請求時執行。

POST https://[service name].search.windows.net/indexers?api-version=2026-10-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-mi-indexer",
    "dataSourceName" : "sql-mi-datasource",
    "targetIndexName" : "my-target-index"
}

故障排除

如果你在索引器嘗試連接資料來源時遇到錯誤,顯示客戶端無法存取伺服器,請參考 常見的索引器錯誤。

您也可以在有無限制的情況下嘗試連線,以排除任何防火牆問題。

參見