在 Foundry IQ(Azure AI 搜尋服務)中排程索引器

附註

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

設定 schedule 屬性,將索引子設定為依排程執行。 索引器排程在以下情境下非常有用:

  • 來源資料會隨時間改變,你希望索引器能自動處理差異。
  • 來源資料非常大,您需要週期性排程才能編製所有內容的索引。
  • 索引會使用多個索引子,從多個來源填入資料,而您想要錯開這些作業以減少衝突。

使用定期排程來發現新的或變更的來源內容。 另外,搜尋可以在 內容處理執行時間停止後,自動繼續未完成的擷取。 只要您的資料來源支援 變更偵測,後續執行即可從已儲存的進度繼續進行。

一旦你把索引器放進排程,它就會一直留在排程上,直到你清除區間、開始時間,或設定 disabled 為 true。 如果排程索引器突然停止觸發,請參考 排程行為常見問題 解答以了解復原步驟。 即使沒有任何項目需要處理,讓索引器維持排程執行也不會影響系統效能。 檢查變更的內容是相對快速的作業。

先決條件

  • 使用資料來源和索引設定的有效索引子。

  • 資料來源中的變更偵測。 Azure 儲存體和 SharePoint 已內建變更偵測。 對於其他資料來源,如 Azure SQL 和 Azure Cosmos DB,你必須手動啟用變更偵測。

因執行時間限制而停止後自動繼續

當內容處理索引器的執行達到每次執行的執行時間配額且仍有符合條件的工作項目時,搜尋會自動將續作排隊。 此系統產生的延續與您設定的輪詢排程是分開的。

例如,索引知識來源可以每 24 小時輪詢一次變更。 如果其產生的索引器在初始或增量擷取時達到執行時間配額,符合資格的未完成工作會被排隊繼續進行,而非等待下一次每日輪詢。 你不需要僅為了繼續這項工作而縮短輪詢間隔。

接續作業會移至內容處理佇列的末端。 這不是立即重啟,且佇列需求可能會延遲執行。 下一次執行會從已儲存的進度繼續,而非重置索引器。 最後儲存檢查點之後的工作可以再次處理。 大型匯入作業可能需要多個執行時窗。

前次執行結果 可以期待什麼
執行時間已達配額,且尚有符合條件的工作。 搜尋佇列的延續工作,視佇列可用性而定。
正常完成。 沒有未完成的工作需要延續配額。 未來的來源變更會在已設定的排程中被發現。
取消、持續失敗或設定無效。 不要指望靠配額續用機制來恢復。 解決原因並使用適當的執行或排程程序。

延續不會變更您設定的輪詢間隔,也不允許同一個索引器同時有兩個並行執行個體。 排程與隨選請求仍依照正常排 程行為進行。 不要一再手動提交執行以繞過排隊。

自動繼續並不會消除執行限制或保證完成時間。 反覆失敗可能導致排程退避。 如果執行一次又一次中斷且沒有進展,請調查來源、文件大小和技能處理,而不是假設會無限期地重複直到成功。 請參閱 「排除未完成擷取問題」。

使用 執行歷程來監視配額停止情況及後續進度。 此處描述的單次執行停止限制與 S3 HD 及無伺服器服務的 整個服務範圍的累計執行時間配額 不同。 接續執行並不能繞過那個配額。

排程定義

排程是索引子定義的一部分。 若省略 schedule 屬性,索引器將不會有定期輪詢排程;請在需要時啟動索引器。 符合條件的自動接續與設定定期輪詢是分開的。 此屬性具有兩個部分。

屬性 描述
"interval" (必要) 兩個連續索引子開始執行的時間量。 最短間隔為5分鐘,最長為1,440分鐘(24小時)。 將其格式化為 XSD "dayTimeDuration" 值 (ISO 8601 持續時間值的受限子集)。

此值的格式為:P(nD)(T(nH)(nM))。

例如: PT15M 每 15 分鐘一次,每 PT2H 兩小時一次。
"startTime" (可選)請以協調世界時(UTC)指定開始時間。 若省略此值,則使用當前時間。 開始時間可以設定為過去的時間,在這種情況下,可以假設索引子從原始開始時間已持續執行一段時間,以排定第一次執行的時間。

下列範例是一個排程,從 1 月 1 日午夜開始,每隔兩小時執行一次。

{
    "dataSourceName" : "hotels-ds",
    "targetIndexName" : "hotels-idx",
    "schedule" : { "interval" : "PT2H", "startTime" : "2024-01-01T00:00:00Z" }
}

設定排程

在索引器定義中指定排程。 要設定排程,請使用 Azure 入口網站、REST API 或 Azure SDK。

  1. 前往 Azure 入口網站中的 Foundry IQ 服務。
  2. 在左窗格中,選取 [索引器]。
  3. 開啟索引子。
  4. 選取 [Settings] \(設定) 。
  5. 往下滑到 排程,然後選擇每 小時、 每日或 自訂 ,以設定特定日期、時間或自訂間隔。

切換至索引頂端的 [索引子定義 (JSON)] 索引標籤,可檢視 XSD 格式的排程定義。

排程行為常見問題

我可以同時執行多個索引器工作嗎?

你可以同時執行多個索引器,但每個索引器都是單一實例。 您無法同時執行相同索引子的兩個複本。

對於以文字為基礎的索引,排程器可啟動 Foundry IQ 服務所支援的所有索引器作業,而可啟動的作業數量則由 搜尋單位 的數量決定。 例如,如果服務具有三個複本和四個分割區,您可以在作用中執行內包含 12 個索引子作業,無論是視需要起始還是依排程起始都一樣。

針對以技能為基礎的編製索引,索引子會在特定的執行環境中執行。 因此,服務單位數量不會影響你能執行的技能型索引工作數量。 多個技能型索引子可以平行執行,但這樣做取決於執行環境中的內容處理器可用性。

排定的工作總是在指定時間開始嗎?

索引程序可能會排隊,且可能不會在發帖時間精確啟動,視處理工作負載及其他因素而定。 例如,如果索引器在下一次排程執行被設定為開始時仍在運行,待處理的執行會被延後到下一次排程事件,讓目前的工作得以完成。

為了讓這種行為更具體,請考慮以下範例。 假設你設定一個索引器排程,間隔為每小時,開始時間為 2024 年 1 月 1 日 UTC 上午 8:00:00。 以下是索引子執行若超過一小時,可能發生的情況:

  1. 第一次索引子執行於或約於 2024年 1 月 1 日上午 8:00 UTC 開始。 假設此執行需要 20 分鐘 (或少於 1 小時的時間量)。

  2. 第二次執行於或約於 2024 年 1 月 1 日上午 9:00 UTC 開始。 假設這個執行需要 70 分鐘——超過一小時——而且要到 UTC 上午 10:10 才完成。

  3. 第三次執行排程為從上午 10:00 UTC 開始,但先前的執行當時仍在執行中。 然後會略過此排程的執行。 索引器的下一次執行要到 UTC 上午 11:00 才開始。

在少數情況下,例如進行維護或從暫時性狀況復原時,系統會將多個索引子執行排入佇列。 當此情況發生時,索引器會在排程視窗內依序執行待處理的工作負載。 例如,如果某個索引器排定為每小時執行一次,且有數次執行延遲或被隨選觸發,這些排入佇列的作業會一個接一個地執行,直到佇列清空。 這些執行作業不是額外新增的,而是先前已排程或已要求的執行作業。 雖然此行為在大部分案例中並不常見,但索引子的設計目的是最終處理所有佇列工作,以維持一致性和資料新鮮度。

附註

如果你對索引器的執行有嚴格且時間敏感的要求,可以考慮使用 push API 模型 ,這樣你可以直接控制索引流程。

如果在同一份文件上索引反覆失敗,會發生什麼事?

如果您為索引器設定了特定排程,但它每次都在同一個文件上失敗,索引器就會開始改為以較低頻率執行(最長間隔為每 2 小時一次或每 24 小時一次,取決於不同的實作因素),直到再次成功取得進展為止。 如果你認為已經解決了根本問題,請 手動執行索引器。 若索引成功,索引器會回到其正常排程。 如果索引器在成功手動執行後仍未恢復正常排程,請參考下一個問題。

排程的索引子已停止觸發。 我該如何重置它的排程?

如果排程索引器停止運行,先停用再重新啟用以重設排程。 這是需要這種復原的徵兆:即使排程已設定且資料來源已更改,執行歷史中也沒有新的執行紀錄。

設定 disabled 為 true 則暫停排程。 將時間設回 false (或省略該屬性)後,會恢復排程,並以當前時間作為設定區間的新基準線。

  1. 前往 Azure 入口網站中的 Foundry IQ 服務。
  2. 選擇 索引器。
  3. 選擇索引器來開啟它。
  4. 選取 [Settings] \(設定) 。
  5. 將索引器設為 停用。
  6. 選取 [儲存]。
  7. 把索引器設回 啟用。
  8. 選取 [儲存]。
  9. 選擇執行 歷史 標籤,確認下一個排程內是否出現新的執行。

附註

重新啟用索引器會根據當前時間重設排程,而非原始 startTime時間。 例如,如果間隔為兩小時,且你在下午 3:15 重新啟用,下一次排定執行大約會在下午 5:15。

後續步驟

對於依排程執行的索引器,您可以從 Foundry IQ 服務擷取狀態來監視作業,或啟用資源記錄功能以取得詳細資訊。