Bővítési gyorsítótár kezelése (előzetes verzió)

Note

Azure AI Keresés a Azure portálon, REST API-kon és Azure SDK-k keresztül érhető el. Emellett a Foundry IQ-t is támogatja, amely a vállalati tartalmakat újrafelhasználható, engedélytudatos tudásbázisokká alakítja át az Microsoft Foundry portálon található ügynökök számára.

Fontos

Az (előzetes verzióban) megjelölt funkciókra, képességekre vagy tulajdonságokra nem vonatkozik szolgáltatási szintű szerződés, nem ajánlott éles számítási feladatokhoz, és az általános elérhetővé válásuk előtt változhatnak vagy korlátozhatók. Az Azure AI Keresés előzetes verziójú kifejezések az összes előzetes verziós funkcióra vonatkoznak, függetlenül attól, hogy önálló vagy egy általánosan elérhető funkció része.

A dúsítási gyorsítótár (előzetes verzió) olyan választható funkció, amely a képességkészlet végrehajtása során létrehozott dúsított tartalmat tárolja. Megőrzi a futtatások közötti tartalmat, így csak a megváltozott készségek és dokumentumok igényelnek újrafeldolgozást. Ez nem a készségkészletek kimeneteinek, az indexelők állapotának vagy az indexelt dokumentumoknak a biztonsági mentése.

A bővítési gyorsítótárat a Azure Storage hozza létre. A gyorsítótár tartalmazza a dokumentumtörésből származó kimenetet, valamint az egyes képességek kimeneteit minden dokumentumhoz. Bár a gyorsítótárazás számlázható (Azure Storage használ), a bővítés teljes költsége csökken, mivel a tárolási költségek kisebbek, mint a képek kinyerése és az AI-feldolgozás.

Ha bővítőgyorsítótárat konfigurál, ez a cikk bemutatja, hogyan kezelheti a képesség- és adatforrás-frissítéseket, hogy a gyorsítótárazott bővítésekből a lehető legnagyobb hasznossághoz jusson.

Előfeltételek

Korlátozások

Figyelem

Ha az SharePoint indexelőt (előzetes verzió) használja, kerülje a növekményes bővítést. Bizonyos körülmények között a gyorsítótár érvénytelenné válik. Az újratöltéshez végezze el az indexelő alaphelyzetbe állítását és teljes újraépítését.

A nagy adatforrások további gyorsítótár-korlátozásokkal rendelkeznek.

Figyelem

Nagy adatforrások esetén a dúsítási gyorsítótár növelheti a teljes újrafeldolgozási időt, ha hosszú futási idejű készségek, ismétlődő megszakítások vagy gyakori készséghibák fordulnak elő. Az indexelő rangsorolja a helyességet az újrafeldolgozás minimalizálása során, így az ismétlődő megszakítások gyorsítótár-hátraléka felerősíti az újrapróbálkozási viselkedést.

A növekvő gyorsítótár-hátralékból való helyreállításhoz particionálja az adatforrást kisebb tárolókba vagy virtuális mappákba. Ezután használjon párhuzamos indexelőket ugyanarra az indexre mutatva. A gyorsítótár társításának megszüntetéséhez állítsa a cache tulajdonságot null értékre az indexelőben.

Gyorsítótár konfigurálása

A gyorsítótár fizikailag egy blobtárolóban és a Azure Storage-fiók tábláiban van tárolva, indexelőnként egyet. Minden indexelőhöz egyedi és nem módosítható gyorsítótár-azonosító tartozik, amely megfelel a használt tárolónak.

A gyorsítótár akkor jön létre, amikor megadja a cache tulajdonságot, és futtatja az indexelőt. Csak a gazdagított tartalom gyorsítótárazható. Ha az indexelő nem rendelkezik csatolt képességkészletekkel, akkor a gyorsítótárazás nem alkalmazható.

Az alábbi példa egy gyorsítótárazással engedélyezett indexelő eszközt mutat be. A teljes útmutatásért tekintse meg a bővítési gyorsítótárazás konfigurálását ismertető cikket.

POST https://[YOUR-SEARCH-SERVICE-NAME].search.windows.net/indexers?api-version=2026-08-01-preview
    {
        "name": "myIndexerName",
        "targetIndexName": "myIndex",
        "dataSourceName": "myDatasource",
        "skillsetName": "mySkillset",
        "cache" : {
            "storageConnectionString" : "<Your storage account connection string>",
            "enableReprocessing": true
        },
        "fieldMappings" : [],
        "outputFieldMappings": [],
        "parameters": []
    }

Gyorsítótár-kezelés

Az indexelő kezeli a gyorsítótár életciklusát. Ha töröl egy indexelőt, akkor a gyorsítótárát is törli. Ha null értékűre állítja az indexelő tulajdonságátcache, vagy módosítja a kapcsolati karakterlánc, a meglévő gyorsítótár a következő indexelő futtatásakor törlődik.

Bár a növekményes bővítés úgy lett kialakítva, hogy beavatkozás nélkül észlelje és reagáljon a változásokra, beállíthat paramétereket adott viselkedések meghívására:

Új dokumentumok rangsorolása

A cache tulajdonság tartalmaz egy paramétert enableReprocessing , amely szabályozza, hogy a gyorsítótárazott tartalom újrafeldolgozva van-e. Ha az értéke true (alapértelmezett), az indexelő újrafeldolgozza a gyorsítótárazott dokumentumokat az újbóli futtatásakor, ha egy képesség frissítése érinti azokat.

Ha hamis, az indexelő nem dolgozza fel újra a meglévő dokumentumokat, ami rangsorolja az új tartalmakat. Csak ideiglenesen állítsa be enableReprocessing hamisra. Ha az idő nagy részében igaz marad, akkor az új és a meglévő dokumentumok is érvényesek maradnak az aktuális képességkészlet-definícióra.

A készségek kiértékelésének megkerülése

A képesség módosítása általában kéz a kézben jár a képesség újrafeldolgozásával. A képesség egyes módosításai azonban nem válthatnak ki újrafeldolgozást. Például egy egyéni képesség üzembe helyezése egy új helyen vagy egy új hozzáférési kulccsal. Ezek a változások általában olyan periférikus módosítások, amelyek nem befolyásolják a képesség kimenetének lényegét.

Ha tudja, hogy a képesség módosítása felületes, felülbírálja a képesség kiértékelését a disableCacheReprocessingChangeDetection paraméter igaz értékre állításával:

  1. Hívja meg az Update Skillsetet , és módosítsa a készségkészlet definícióját.
  2. Fűzze hozzá a disableCacheReprocessingChangeDetection=true paramétert a kérelemhez.
  3. Küldje el a módosítást.

A paraméter beállításakor csak a képességkészlet definíciójának frissítése lesz véglegesített. A rendszer nem értékeli ki a módosítást a meglévő gyorsítótárra gyakorolt hatások szempontjából. Használjon 2020-06-30-Preview vagy újabb előzetes verziójú API-t. Használja a legújabb előzetes verziójú API-t.

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2026-08-01-preview&disableCacheReprocessingChangeDetection

Adatforrás-ellenőrzési ellenőrzések megkerülése

Az adatforrásdefiníció legtöbb módosítása érvényteleníti a gyorsítótárat. Olyan forgatókönyvek esetén azonban, amelyekben tudja, hogy egy módosítás nem érvényteleníti a gyorsítótárat – például egy kapcsolati karakterlánc módosítása vagy a tárfiók kulcsának elforgatása – fűzze hozzá a ignoreResetRequirement paramétert a adatforrás frissítéséhez. Állítsa ezt a paramétert igaz értékre, hogy a véglegesítés végighaladjon anélkül, hogy alaphelyzetbe állítási feltételt aktiválna, amely az összes objektum újraépítését és feltöltését eredményezné.

PUT https://[search service].search.windows.net/datasources/[data source name]?api-version=2026-08-01-preview&ignoreResetRequirement

Képességek értékelésének kényszerítése

A gyorsítótár célja a szükségtelen feldolgozás elkerülése. Tegyük fel azonban, hogy módosít egy olyan készséget, amelyet az indexelő nem észlel (például módosít valamit a külső kódban, például egy egyéni képességben).

Ebben az esetben a Reset Skills API használatával kényszerítse egy adott képesség újrafeldolgozását, beleértve azokat az alsóbb rétegbeli készségeket is, amelyek függenek az adott képesség kimenetétől. Ez az API elfogad egy POST kérést, amely tartalmazza azokat a képességeket, amelyeket érvényteleníteni kell, és meg kell jelölni újrafeldolgozásra. Az Alaphelyzetbe állítási képességek után kövesse az Indexelő futtatása kérést a folyamat feldolgozásának meghívásához.

Konkrét dokumentumok gyorsítótárba helyezése

Ha alaphelyzetbe állít egy indexelőt, a keresési korpuszban lévő összes dokumentum újrafeldolgozva lesz.

Olyan esetekben, amikor csak néhány dokumentumot kell újra feldolgozni, a Dokumentumok alaphelyzetbe állítása (előzetes verzió) használatával kényszerítheti bizonyos dokumentumok újrafeldolgozását. Amikor visszaállít egy dokumentumot, az indexelő érvényteleníti a dokumentum gyorsítótárát. Az indexelő ezután az adatforrásból beolvassa a dokumentumot. További információ: Indexelők, készségek és dokumentumok futtatása vagy alaphelyzetbe állítása.

Adott dokumentumok alaphelyzetbe állításához adja meg a kérelem keresési indexéből beolvasott dokumentumkulcsok listáját. Ha a kulcs a külső adatforrás egyik mezőjére van leképezve, használja a keresési indexben szereplő értéket.

Az API meghívásától függően a kérés hozzáfűzi, felülírja vagy várólistára állítja a kulcslistát:

  • Az API többszöri meghívása különböző kulcsokkal hozzáfűzi az új kulcsokat a visszaállítandó dokumentumkulcsok listájához.

  • Az API meghívása úgy, hogy a overwrite lekérdezési karakterlánc-paraméter értéke true legyen, a visszaállítandó dokumentumkulcsok aktuális listáját a kérés hasznos adataiban megadott listával írja felül.

  • Az API meghívása hozzáadja a dokumentumkulcsokat az indexelő által végzett munkasorhoz. Amikor az indexelő következő meghívása ütemezett vagy igény szerint történik, rangsorolja az alaphelyzetbe állítási dokumentumkulcsok feldolgozását az adatforrás egyéb módosításai előtt.

Az alábbi példa egy visszaállítási dokumentumkérést szemléltet:

POST https://[search service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2026-08-01-preview
    {
        "documentKeys" : [
            "key1",
            "key2",
            "key3"
        ]
    }

A gyorsítótárat érvényteleníteni kívánt módosítások

Amikor engedélyezi a gyorsítótárat, az indexelő ellenőrzi a folyamatösszeállítás módosításait, hogy eldöntse, melyik tartalmat használhatja újra, és mely tartalmakat kell újra feldolgozni. Ez a szakasz felsorolja a gyorsítótárat érvényteleníteni kívánt módosításokat, majd a növekményes feldolgozást kiváltó módosításokat.

Az érvénytelenítő módosítás az, ahol a teljes gyorsítótár érvénytelenné válik. Az adatforrás frissítése például érvénytelenítő módosítás. Az indexelő folyamat bármely olyan részén végrehajtott módosítások teljes listája, amely érvényteleníti a gyorsítótárat:

  • Az adatforrás típusának módosítása
  • Adatforrástároló módosítása
  • Adatforrás hitelesítő adatainak módosítása
  • Az adatforrás változásészlelési szabályzatának módosítása
  • Adatforrás törlésészlelési szabályzatának módosítása
  • Indexelő mezőleképezéseinek módosítása
  • Indexelőparaméterek módosítása:
    • Elemzési mód
    • Kizárt fájlnévkiterjesztések
    • Indexelt fájlnévkiterjesztések
    • Tár metaadatainak indexelése csak túlméretezett dokumentumokhoz
    • Határolt szövegfejlécek
    • Elhatárolt szöveghatárolás
    • Dokumentumgyökér
    • Képművelet (A képek kinyerésének változásai)

Növekményes feldolgozást kiváltó módosítások

A növekményes feldolgozás kiértékeli a képességkészlet definícióját, és meghatározza, hogy mely készségeket kell újrafuttatnia. Szelektíven frissíti a dokumentumfa érintett részeit. A növekményes bővítést eredményező módosítások teljes listája:

  • A képesség típusának módosítása (a képesség OData-típusának frissítése)
  • Képességspecifikus paraméterek, például URL-címek, alapértelmezett értékek vagy egyéb paraméterek frissítése
  • Képességkimenetek módosítása, például ha a képesség további vagy eltérő kimeneteket ad vissza
  • Eltérő származást vagy képességláncolást eredményező képességbemenetek módosítása
  • Bármely felsőbb rétegbeli képesség érvénytelenítése, ha frissít egy olyan képességet, amely bemenetet biztosít ehhez a képességhez
  • A tudástár vetítési helyének frissítése, amely a dokumentumok ismételt kivetítését eredményezi
  • A tudástár-előrejelzések módosítása, amely a dokumentumok ismételt kivetítését eredményezi
  • A kimeneti mező-hozzárendelések módosítása az indexelőn, ami a dokumentumok indexbe történő újbóli kivetítését eredményezi

Gyorsítótárazáshoz használt API-k

Az előzetes verziójú API-k további tulajdonságokat biztosítanak az indexelők számára. Használja a legújabb előzetes verziójú API-t.

Használja az általánosan elérhető verziót készségkészletekhez és adatforrásokhoz. A referenciadokumentáció mellett, a műveletek sorrendjével kapcsolatos részletekért, olvassa el a cikket, amely a gyorsítótárazás inkrementális gazdagításának konfigurálását ismerteti.

  • Utolsó frissítés időpontja: