Bővítési gyorsítótár konfigurálása (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.

Ez a cikk bemutatja, hogyan vehet fel gyorsítótárazást egy képességkészlet-folyamathoz, hogy minden alkalommal teljes újraépítés nélkül módosíthassa az alsóbb rétegbeli bővítés lépéseit. A dúsítási gyorsítótárazáshoz (előzetes verzió) egy előzetes verziójú REST API szükséges. Alapértelmezés szerint a képességkészlet állapot nélküli, és összetételének bármely részének módosítása az indexelő teljes újrafuttatását igényli. A bővítési gyorsítótárral az indexelő meghatározza, hogy a dokumentumfa mely részeit kell frissíteni a képességkészlet vagy az indexelő definíciójának változásai alapján. Az indexelő lehetőség szerint megőrzi és újra felhasználja a meglévő feldolgozott kimenetet.

A gyorsítótárazott tartalmat az Ön által megadott kapcsolati sztring használatával helyezheti el az Azure Storage-ban. Az indexelő futáskor létrehozza ezeket az objektumokat. Tekintse a gazdagítási gyorsítótárat a keresőszolgáltatás által kezelt belső összetevőnek, amelyet nem módosíthat.

Fontos

A bővítési gyorsítótár nem a képességkészlet kimenetéről, az indexelő állapotáról vagy az indexelt dokumentumokról készít biztonsági másolatot. Nem követi nyomon, hogy mely dokumentumok feldolgozása fejeződött be. Nagy adatforrások esetén a gyorsítótárazás engedélyezése előtt tekintse át a Korlátozások szakaszt.

Egy tároló neve ms-az-search-indexercache-<alpha-numeric-string>
Elnevezett táblázatok MsAzSearchIndexerCacheIndex<alpha-numeric-string>

Előfeltételek

Azure Storage gyorsítótárba helyezett adatbővítések tárolására. A tárfióknak általános célú v2-nek kell lennie.
Csak blobindexelés esetén, ha szinkronizált dokumentum eltávolítására van szüksége mind a gyorsítótárból, mind az indexből, amikor blobokat töröl az adatforrásból, engedélyezze a törlési szabályzatot az indexelőben. A szabályzat nélkül a gyorsítótárból való dokumentumtörlés nem támogatott.

Ismernie kell az indexelők és a készségkészletek beállítását. Kezdje az indexelő áttekintésével , majd folytassa a készségkészletekkel a bővítési folyamatok megismeréséhez.

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. Ez a viselkedés elvárható, nem pedig hiba.

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. A particionálási mintával kapcsolatos útmutatásért tekintse meg a nagyméretű adatkészletek indexelését .

Engedélyek

Egy Azure AI Keresés identitásnak írási hozzáférésre van szüksége a Azure Storage:

Tárolási blobadatok közreműködője
Storage Table Data Közreműködő

A kapcsolati karakterlánc szintaxis határozza meg, hogy rendszer által hozzárendelt vagy felhasználó által hozzárendelt identitás van-e használatban. További információkat a következő témában talál: Felügyelt identitással való kapcsolódás az Azure Storage-hoz.

A gyorsítótár tulajdonság beállítása

Ezt az eljárást az új és a meglévő indexelők esetében is használhatja.

Az indexelő definíciójában állítsa be cache a következőt:

(Kötelező) storageConnectionString egy Azure Storage kapcsolat karakterláncra van beállítva.
(Nem kötelező) enableReprocessing (true alapértelmezés szerint). Állítsa false értékre, hogy ideiglenesen felfüggessze a növekményes bővítést, majd később váltson vissza true értékre.

Azure portál
REST

A bal oldalon válassza az Indexelők lehetőséget.
Válassza az Indexelő hozzáadása lehetőséget egy új indexelő létrehozásához, vagy nyisson meg egy meglévőt JSON szerkesztési módban.
Engedélyezze a növekményes bővítést, állítsa be a bővítési gyorsítótár tárfiókot, és mentse az indexelőt.
Állítsa alaphelyzetbe az indexelőt, ha már létezik.
Futtassa az indexelőt. Ez az egyszeri teljes újraépítés feltölti a gyorsítótárat. A betöltést követően az inkrementális újrahasználat a későbbi futtatások során érvényesül.

Ha egy meglévő indexelőt szerkeszt, a GET Indexer használatával kérje le az aktuális konfigurációt.

Használja a legújabb előzetes verziójú API-t az Indexelő létrehozásához vagy frissítéséhez.

PUT https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]?api-version=2026-08-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
    {
        "name": "<YOUR-INDEXER-NAME>",
        "targetIndexName": "<YOUR-INDEX-NAME>",
        "dataSourceName": "<YOUR-DATASOURCE-NAME>",
        "skillsetName": "<YOUR-SKILLSET-NAME>",
        "cache": {
            "storageConnectionString": "<YOUR-STORAGE-ACCOUNT-CONNECTION-STRING>",
            "enableReprocessing": true
        },
        "fieldMappings": [],
        "outputFieldMappings": [],
        "parameters": []
    }

Állítsa vissza az indexelőt , ha az már létezik.
Indexálót futtat. Ez az egyszeri teljes újraépítés feltölti a gyorsítótárat. A betöltést követően az inkrementális újrahasználat a későbbi futtatások során érvényesül.
```
POST https://[YOUR-SEARCH-SERVICE].search.windows.net/indexers/[YOUR-INDEXER-NAME]/run?api-version=2026-08-01-preview
    Content-Type: application/json
    api-key: [YOUR-ADMIN-KEY]
```

Ha most újabb GET kérést ad ki az indexelőre, a szolgáltatás válasza tartalmaz egy ID tulajdonságot a gyorsítótár-objektumban. A sztring hozzá van fűzve a tároló nevéhez, amely tartalmazza az indexelő által feldolgozott összes dokumentum összes gyorsítótárazott eredményét és köztes állapotát. Az azonosítóval egyedileg nevezhető el a gyorsítótár a Blob Storage-ban.

    "cache": {
        "ID": "<ALPHA-NUMERIC STRING>",
        "enableReprocessing": true,
        "storageConnectionString": "DefaultEndpointsProtocol=https;AccountName=<YOUR-STORAGE-ACCOUNT>;AccountKey=<YOUR-STORAGE-KEY>;EndpointSuffix=core.windows.net"
    }

Gyorsítótárazott kimenet ellenőrzése

Jelentkezzen be a Azure portálra, és keresse meg Azure Storage fiókját.
Tárolók és táblák áttekintése a Storage Browser használatával.
- A tároló neve ms-az-search-indexercache-<some-alphanumeric-string>.
- A táblanevek a következők MsAzSearchIndexerCacheIndex<alpha-numeric-string>: .

Az indexelő gyorsítótárat hoz létre és használ. Tartalma nem olvasható ember számára.

Annak ellenőrzéséhez, hogy a gyorsítótár működik-e, módosítsa a képességkészletet, és futtassa az indexelőt, majd hasonlítsa össze a végrehajtási idő és a dokumentumszám előtti és utáni metrikákat.

A képelemzést és a beolvasott dokumentumok optikai karakterfelismerését (OCR) tartalmazó készségkészletek jó teszteseteket tesznek lehetővé. Ha módosít egy alsóbb rétegbeli szövegkészséget, vagy bármilyen olyan készséget, amely nem képpel kapcsolatos, az indexelő lekérheti a korábban feldolgozott kép- és OCR-tartalmakat a gyorsítótárból, és csak a szöveggel kapcsolatos módosításokat dolgozza fel a módosításokból. Kevesebb dokumentumra számíthat az indexelő végrehajtási számában, rövidebb végrehajtási időkben és alacsonyabb költségekben.

A fájlkészlet a cog-search-demo oktatóanyagokban egy hasznos teszteset, mert 14 fájlt tartalmaz különböző formátumokban: JPG, PNG, HTML, DOCX, PPTX és más típusokban. en A növekményes bővítés megvalósíthatósági teszteléséhez váltson es át vagy másik nyelvre a szövegfordítási jártasságban.

Gyakori hibák

A következő hiba akkor fordul elő, ha elfelejtette megadni az előzetes verziójú API-verziót a kérelemben:

"The request is invalid. Details: indexer : A resource without a type name was found, but no expected type was specified. To allow entries without type information, the expected type must also be specified when the model is specified."

400 Bad Request hiba akkor is előfordul, ha hiányzik egy indexelőre vonatkozó követelmény. A hibaüzenet megadja a hiányzó függőségeket.

Következő lépés

A képességkészleteket tartalmazó indexelők növekményes bővítését használhatja, így az indexekhez és a tudástárakhoz is felhasználhatja a tartalmakat. A gyorsítótár-kezeléssel kapcsolatos további információkért tekintse meg a következő cikket:

Bővítési gyorsítótár kezelése

Visszajelzés

Hasznosnak találta ezt az oldalt?

Utolsó frissítés időpontja: 2026-09-17