共用方式為


將 Azure 表格儲存體中的資料編製索引

在本文中,了解如何設定索引子,以從 Azure 表格儲存體匯入內容,並將內容變成可在 Azure AI 搜尋服務中搜尋。 索引子的輸入是您在單一資料表中的實體。 輸出是搜尋索引,且各欄位中儲存可搜尋的內容和中繼資料。

本文提供從 Azure 表格儲存體編制索引的特定資訊,以補充建立索引子。 它會使用 Azure 入口網站 和 REST API 來示範所有索引器通用的三部分工作流程:建立數據源、建立索引、建立索引器。 提交建立索引子要求時會擷取資料。

必要條件

  • Azure 資料表儲存體

  • 包含文字的資料表。 如果您使用二進位資料,請考慮使用影像分析的 AI 擴充

  • Azure 儲存體的讀取權限。 「完整存取」連接字串 包含可存取內容的金鑰,但如果您使用 Azure 角色,請確定搜尋服務受控識別具有讀取者和數據訪問許可權

若要完成本文中的範例,您需要 Azure 入口網站 或 REST 用戶端。 如果您使用 Azure 入口網站,請確定已啟用所有公用網路的存取權。 建立 Azure 數據表索引器的其他方法包括 Azure SDK。

嘗試使用範例數據

使用這些指示在 Azure 儲存體 中建立數據表以供測試之用。

  1. 登入 Azure 入口網站,流覽至您的記憶體帳戶,然後建立名為hotels數據表。

  2. 安裝 Azure 儲存體 Explorer

  3. 從 GitHub 下載HotelsData_toAzureSearch.csv 。 此檔案是內建旅館範例數據集的子集。 它會省略會議室集合、翻譯的描述和地理座標。

  4. 在 [Azure 儲存體 總管] 中,登入 Azure、選取您的訂用帳戶,然後選取您的記憶體帳戶。

  5. 開啟 [數據表 ],然後選取 [旅館]。

  6. 選取命令行上的 [ 入],然後選取 HotelsData_toAzureSearch.csv 檔案。

  7. 接受預設值。 選取 [ 入] 以載入數據。

數據表中應該有 50 筆旅館記錄,其中包含自動產生的 partitionKey、rowKey 和時間戳。 您現在可以使用此內容在 Azure 入口網站、REST 用戶端或 Azure SDK 中編製索引。

[描述] 欄位提供最詳細的內容。 您應該將此欄位設為全文搜索和選擇性向量查詢的目標。

使用 Azure 入口網站

您可以使用 [ 匯入數據 精靈] 或 [匯入及向量化數據 精靈],從 SQL 資料庫數據表或檢視表自動編制索引。 這兩個精靈的數據源組態很類似。

  1. 啟動精靈。

  2. 在 [連接到您的數據] 上,選取或確認數據源類型為 Azure 數據表記憶體,或數據選取欄位提示資料表。

    數據源名稱是指 Azure AI 搜尋服務中的數據源連接物件。 如果您使用向量精靈,則會使用精靈工作流程結尾指定的自定義前置詞自動產生數據源名稱。

  3. 指定記憶體帳戶和數據表名稱。 查詢是選擇性的。 如果您有想要匯入的特定數據行,這會很有用。

  4. 指定驗證方法,可以是受控識別或內建 API 金鑰。 如果您未指定受控識別連線,Azure 入口網站 會使用密鑰。

    如果您將 Azure AI 搜尋設定為使用受控識別,並在授與讀取者和數據存取權給身分識別的 Azure 儲存體 上建立角色指派,您的索引器可以使用 Microsoft Entra ID 和角色來連線到數據表記憶體。

  5. 針對 [ 匯入和向量化數據 精靈],您可以指定刪除偵測的選項,

    刪除偵測需要您在數據表中具有可做為虛刪除旗標的既有欄位。 它應該是布爾值欄位(您可以將它命名為 IsDeleted)。 指定 true 為虛刪除值。 在搜尋索引中,新增名為 IsDeleted的 對應搜尋欄位,以擷取和篩選。

  6. 繼續進行其餘步驟以完成精靈:

使用 REST API

本節示範建立數據源、索引和索引器之 REST API 呼叫。

定義資料來源

資料來源定義會指定要編製索引的資料、認證,以及變更偵測的原則。 資料來源是獨立的資源,可供多個索引子使用。

  1. 建立或更新資料來源以設定其定義:

     POST https://[service name].search.windows.net/datasources?api-version=2024-07-01 
     {
         "name": "my-table-storage-ds",
         "description": null,
         "type": "azuretable",
         "subtype": null,
         "credentials": {
            "connectionString": "DefaultEndpointsProtocol=https;AccountName=<account name>"
         },
         "container": {
            "name": "my-table-in-azure-storage",
            "query": ""
         },
         "dataChangeDetectionPolicy": null,
         "dataDeletionDetectionPolicy": null,
         "encryptionKey": null,
         "identity": null
     }
    
  2. 將 "type" 設定為 "azuretable" (必要)。

  3. 將 "credentials" 設定為 Azure 儲存體連接字串。 下一節說明支援的格式。

  4. 將 "container" 設定為資料表的名稱。

  5. 選擇性地將 "query" 設定為 PartitionKey 上的篩選條件。 設定此屬性是改善效能的最佳做法。 如果 "query" 為 null,索引子會執行完整資料表掃描,如果資料表很大,則會導致效能不佳。

如果您希望索引子在來源文件標幟為刪除時,刪除時刪除搜尋文件,資料來源定義也可以包含虛刪除原則

支援的認證和連接字串

索引子可以使用下列連線來連線到資料表。

完整存取儲存體帳戶連接字串
{ "connectionString" : "DefaultEndpointsProtocol=https;AccountName=<your storage account>;AccountKey=<your account key>;" }
您可以在 Azure 入口網站中,從 [儲存體帳戶] 頁面的左側瀏覽窗格,選取 [存取金鑰] 取得連接字串。 請務必選取完整的連接字串,而不只是金鑰。
受控識別連接字串
{ "connectionString" : "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.Storage/storageAccounts/<your storage account name>/;" }
此連接字串不需要帳戶金鑰,但您之前必須將搜尋服務設為使用受控識別連線
儲存體帳戶共用存取簽章** (SAS) 連接字串
{ "connectionString" : "BlobEndpoint=https://<your account>.blob.core.windows.net/;SharedAccessSignature=?sv=2016-05-31&sig=<the signature>&spr=https&se=<the validity end time>&srt=co&ss=b&sp=rl;" }
SAS 在資料表和實體上應該具有列出和讀取權限。
容器共用存取簽章
{ "connectionString" : "ContainerSharedAccessUri=https://<your storage account>.blob.core.windows.net/<container name>?sv=2016-05-31&sr=c&sig=<the signature>&se=<the validity end time>&sp=rl;" }
SAS 對於容器應該擁有列出和讀取權限。 如需詳細資訊,請參閱使用共用存取簽章

注意

如果您使用 SAS 認證,您必須使用更新的簽章定期更新資料來源認證以防止其到期。 當 SAS 認證過期時,索引子會失敗並出現錯誤訊息,如「連接字串提供的認證無效或過期」。

分割以改善效能

Azure AI 搜尋服務預設使用下列內部查詢篩選條件,以追蹤上次執行後已更新的來源實體:Timestamp >= HighWaterMarkValue。 因為 Azure 資料表的 Timestamp 欄位沒有次要索引,這種類型的查詢需要完整的資料表掃描,因此若是大型資料表就會變慢。

若要避免完整掃描,您可以使用資料表分割區來縮小每個索引子作業的範圍。

  • 如果您的資料可以自然分割成幾個分割範圍,請為每個分割範圍建立資料來源及對應的索引子。 每個索引子現在可以只處理某個特定資料分割範圍,進而提升查詢效能。 如果需要編製索引的資料有少量的固定資料分割,那更好:每個索引子只要執行一次資料分割掃描。

    例如,若要建立資料來源以處理具有金鑰 000100 的分割範圍,請使用如下查詢︰"container" : { "name" : "my-table", "query" : "PartitionKey ge '000' and PartitionKey lt '100' " }

  • 如果資料依時間分割 (例如,您每日或每週建立新的分割區),請考慮下列做法︰

    • 在資料來源定義中,指定類似下列範例的查詢:(PartitionKey ge <TimeStamp>) and (other filters)

    • 使用 Get Indexer Status API 監視索引子進度,並根據最新成功的上限標準值定期更新查詢的 <TimeStamp> 條件。

    • 採取此做法時,如果您需要觸發完整重新編製索引,請重設資料來源查詢,並重設索引子

新增搜尋欄位至索引

搜尋索引中,新增欄位以接受資料表實體的內容和中繼資料。

  1. 建立或更新索引,以定義搜尋欄位來儲存實體的內容:

    POST https://[service name].search.windows.net/indexes?api-version=2024-07-01 
    {
      "name" : "my-search-index",
      "fields": [
        { "name": "Key", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "SomeColumnInMyTable", "type": "Edm.String", "searchable": true }
      ]
    }
    
  2. 建立文件索引鍵欄位 ("key": true),但允許索引子自動填入欄位。 資料表索引子會在索引鍵欄位中填入資料表中串連的分割區索引鍵和資料列索引鍵。 例如,如果資料列的 PartitionKey 為 1 且 RowKey 為 1_123,則索引鍵值為 11_123。 如果分割區索引鍵為 Null,則只會使用資料列索引鍵。

    如果您使用匯入數據精靈來建立索引,Azure 入口網站 推斷搜尋索引的「索引鍵」字段,並使用隱含字段對應來連接來源和目的地欄位。 您不必自行新增欄位,也無需設定欄位對應。

    如果您是使用 REST API 且想要隱含欄位對應,請在搜尋索引定義中建立名為 [Key] 文件索引鍵欄位,如同先前步驟所示 ({ "name": "Key", "type": "Edm.String", "key": true, "searchable": false })。 索引子會自動填入 [Key] 欄位,無需欄位對應。

    如果您不希望搜尋索引中有個名為 [Key] 的欄位,請在索引子定義中新增所需欄位名稱的明確欄位對應,並將來源欄位設為 [Key]:

     "fieldMappings" : [
       {
         "sourceFieldName" : "Key",
         "targetFieldName" : "MyDocumentKeyFieldName"
       }
    ]
    
  3. 現在可在索引中新增其他所需的實體欄位。 例如,如果實體看起來像下列範例,您的搜尋索引應該具有 HotelName、Description 和 Category 的欄位以接收這些值。

    儲存體瀏覽器中資料表內容的螢幕擷取畫面。

    使用相同的名稱和相容的資料類型,就越不需要欄位對應。 當名稱和類型相同時,索引子可自動決定資料路徑。

設定和執行資料表索引子

擁有索引與資料來源後,您就可以開始建立索引子。 索引子會設定指定輸入、參數和屬性,控制執行階段行為。

  1. 建立或更新索引子,指定其名稱並參考資料來源和目標索引:

    POST https://[service name].search.windows.net/indexers?api-version=2024-07-01
    {
        "name" : "my-table-indexer",
        "dataSourceName" : "my-table-storage-ds",
        "targetIndexName" : "my-search-index",
        "disabled": null,
        "schedule": null,
        "parameters" : {
            "batchSize" : null,
            "maxFailedItems" : null,
            "maxFailedItemsPerBatch" : null,
            "configuration" : { }
        },
        "fieldMappings" : [ ],
        "cache": null,
        "encryptionKey": null
    }
    
  2. 如果欄位名稱或類型有差異,或您需要搜尋索引中多個版本的來源欄位,請指定欄位對應。 [目標] 欄位是搜尋索引中的欄位名稱。

     "fieldMappings" : [
       {
         "sourceFieldName" : "Description",
         "targetFieldName" : "HotelDescription"
       }
    ]
    
  3. 如需其他屬性的詳細資訊,請參閱建立索引子

索引子建立後會自動執行。 您可以將「停用」設為 true 避免此情況。 若要控制索引子執行,請視需要執行索引子排程執行索引子

檢查索引子狀態

若要監視索引器狀態和執行歷程記錄,請檢查 Azure 入口網站 中的索引器執行歷程記錄,或傳送取得索引器狀態 REST APIrequest

  1. 在搜尋服務頁面上,開啟 [搜尋管理>索引器]。

  2. 選取索引器以存取組態和執行歷程記錄。

  3. 選取特定的索引器作業,以檢視詳細數據、警告和錯誤。

執行歷程記錄包含最多 50 個最近完成的執行,以顛倒的時序排序,因此最後的執行最先出現。

下一步

深入了解如何執行索引子監視狀態排程執行索引子。 下列文章適用於從 Azure 儲存體提取內容的索引子: