Adatok indexelése az Azure Blob Storage-ból

A blobindexelő importálja a tartalmat az Azure Blob Storage-ból, és kereshetővé teszi az Azure AI Keresésben. Az indexelő bemenetként egy tárolóban fogadja a blobokat. A kimenet egy keresési index, amely a kereshető tartalmakat és metaadatokat az egyes mezőkben tárolja.

Ez a cikk a Search Service REST API-jait használja az indexelő konfigurálásához és futtatásához. A következőket is használhatja:

• Azure SDK-csomag (bármely verzió)
• Adatok importálása varázsló az Azure Portalon

Előfeltételek

• Azure Blob Storage, Standard teljesítmény (általános célú v2).

• A hozzáférési szintek közé tartozik a gyakori elérésű, a ritka elérésű, a hideg, és az archiválási. Az indexelők lekérhetik a blobokat gyakori, ritka elérésű és hideg hozzáférési szinteken.

• Szöveges tartalmat és metaadatokat biztosító blobok. Ha a blobok bináris tartalmat vagy strukturálatlan szöveget tartalmaznak, érdemes lehet AI-bővítést hozzáadni a kép- és természetes nyelvi feldolgozáshoz. A blobtartalmak nem léphetik túl a tarifacsomag indexelőkorlátait .

  A blobindexelő korlátai a blob maximális méretét és a blobból kinyert Azure AI Keresés karakterek számát fedik le. Készségkészlet használata esetén az egyes képességek bemeneti vagy szolgáltatási korlátja külön-külön érvényes a dokumentum feltörése után.

• Támogatott hálózati konfiguráció és adathozzáférés. Legalább olvasási engedélyekre van szüksége az Azure Storage-ban. A hozzáférési kulcsot tartalmazó tárolási kapcsolati sztring olvasási hozzáférést biztosít a tártartalmakhoz. Ha ehelyett Microsoft Entra-bejelentkezéseket és szerepköröket használ, győződjön meg arról, hogy a keresési szolgáltatás felügyelt identitása rendelkezik Storage Blob Data Reader-engedélyekkel .

  Alapértelmezés szerint a keresés és a tárolás is fogadja a nyilvános IP-címekről érkező kéréseket. Ha a hálózati biztonság nem azonnali probléma, akkor csak a kapcsolati sztring és olvasási engedélyek használatával indexelheti a blobadatokat. Ha készen áll a hálózati védelem hozzáadására, tekintse meg az Indexelő azure-beli hálózati biztonsági funkciókkal védett tartalmakhoz való hozzáférését az adathozzáféréssel kapcsolatos útmutatásért.

• REST-ügyfél használatával a cikkben bemutatottakhoz hasonló REST-hívásokat hozhat létre.

Támogatott tevékenységek

Ezt az indexelőt a következő feladatokhoz használhatja:

• Adatindexelés és növekményes indexelés: Az indexelő képes a blobtárolókból és mappákból származó fájlok és kapcsolódó metaadatok indexelésével. Az új és frissített fájlokat és metaadatokat a beépített változásészlelés segítségével észleli. Az adatfrissítést ütemezés szerint vagy igény szerint konfigurálhatja.

• Törlésészlelés: Az indexelő natív helyreállítható törléssel vagy egyéni metaadatokkal észlelheti a törléseket.

• Alkalmazott AI készségkészleteken keresztül: Az indexelő teljes mértékben támogatja a készségkészleteket. Ez a támogatás olyan kulcsfontosságú funkciókat tartalmaz, mint az integrált vektorizálás, amely adattömböket és beágyazást ad hozzá.

• Elemzési módok: Az indexelő támogatja a JSON-elemzési módokat , ha JSON-tömböket vagy sorokat szeretne elemezni az egyes keresési dokumentumokban. Támogatja a Markdown-elemzési módot is.

• Kompatibilitás más funkciókkal: Az indexelő zökkenőmentesen működik más indexelő funkciókkal, például hibakeresési munkamenetekkel, indexelő gyorsítótárral növekményes bővítésekhez (előzetes verzió) és tudástárhoz.

Támogatott dokumentumformátumok

A blobindexelő a következő dokumentumformátumokból tud szöveget kinyerni:

• CSV (lásd : CSV-blobok indexelése)
• EML
• EPUB
• GZ
• HTML
• JSON (lásd : JSON-blobok indexelése)
• KML (XML földrajzi ábrázolásokhoz)
• Markdown
• Microsoft Office-formátumok: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (Outlook-e-mailek), XML (2003 és 2006 WORD XML)
• Dokumentumformátumok megnyitása: ODT, ODS, ODP
• PDF
• Egyszerű szöveges fájlok (lásd még : Egyszerű szöveg indexelése)
• Rich Text Formátum (RTF)
• XML
• ZIP

Az indexelendő blobok meghatározása

Az indexelés beállítása előtt tekintse át a forrásadatokat, és állapítsa meg, hogy szükség van-e módosításokra. Az indexelők egyszerre egyetlen tárolóból is indexelhetik a tartalmat. Alapértelmezés szerint az indexelő feldolgozza a tárolóban lévő összes blobot. A szelektív feldolgozás több lehetőséggel is rendelkezik:

• Helyezze a blobokat egy virtuális mappába. Az indexelő adatforrás-definíciója tartalmaz egy olyan paramétert query , amely képes virtuális mappát venni. Ha virtuális mappát ad meg, az indexelő csak a mappában lévő blobokat indexeli.

• Blobok belefoglalása vagy kizárása fájltípus szerint. A támogatott dokumentumformátumok listája segít meghatározni, hogy mely blobokat kell kizárni. Előfordulhat például, hogy ki szeretné zárni azokat a kép- vagy hangfájlokat, amelyek nem nyújtanak kereshető szöveget. Ezt a képességet az indexelő konfigurációs beállításaival szabályozhatja.

• Tetszőleges blobok belefoglalása vagy kizárása. Egy adott blob kihagyásához adja hozzá az alábbi metaadat-tulajdonságokat és értékeket az Azure Blob Storage-blobokhoz. Amikor egy indexelő találkozik ezzel a tulajdonságmal, kihagyja a blobot vagy annak tartalmát az indexelési futtatás során.

  Tulajdonság megnevezése	Tulajdonságérték	Explanation
  AzureSearch_Skip	true	Utasítja a blobindexelőt, hogy hagyja ki teljesen a blobot. Az indexelő nem próbál metaadatokat vagy tartalmakat kinyerni. Ez a tulajdonság akkor hasznos, ha egy adott blob ismétlődően meghiúsul, és megszakítja az indexelési folyamatot.
  AzureSearch_SkipContent	true	Az indexelő kihagyja a tartalmat, és csak a metaadatokat nyeri ki. Ez a tulajdonság megegyezik a "dataToExtract": "allMetadata"konfigurációs beállításokban leírt beállítással, de hatóköre egy adott blobra terjed ki.

Ha nem állít be befogadási vagy kizárási feltételeket, az indexelő hibaként jelent egy nem jogosult blobot, és továbblép. Ha elegendő hiba történik, a feldolgozás leállhat. Az indexelő konfigurációs beállításaiban megadhatja a hibatűrést.

Az indexelők általában blobonként egy keresési dokumentumot hoznak létre, ahol a szöveges tartalom és a metaadatok kereshető mezőkként vannak rögzítve egy indexben. Ha a blobok teljes fájlok, akkor őket több keresési dokumentumba is elemezheti. Elemezheti például egy CSV-fájl sorait, hogy soronként egy keresési dokumentumot hozzon létre.

Összetett vagy beágyazott dokumentum (például ZIP-archívum, mellékleteket tartalmazó beágyazott Outlook-e-maileket tartalmazó Word-dokumentum vagy . A mellékleteket tartalmazó MSG-fájl is egyetlen dokumentumként van indexelve. Például, egy .MSG fájl mellékleteiből kinyert összes kép a normalized_images mezőben lesz visszaadva. Ha rendelkezik képekkel, fontolja meg az AI-bővítés hozzáadását, hogy több keresési segédprogramot kapjon az adott tartalomból.

Az indexelő kinyeri egy dokumentum szöveges tartalmát egy sztringmezőbe.content Standard és felhasználó által definiált metaadatokat is kinyerhet.

Blob metaadatainak indexelése

A blob metaadatait a tartalom mellett indexelheti. Az indexelő kinyeri a metaadat-tulajdonságokat, és indexmezőkben tárolja őket, ami szűrők és lekérdezések létrehozásához hasznos.

Adja meg a keresési indexben a rögzíteni kívánt metaadat-tulajdonságok mezőit. Nem kell minden rendelkezésre álló standard vagy egyéni metaadat-tulajdonságot definiálnia. Csak rögzítse az alkalmazáshoz szükséges tulajdonságokat.

Ez az indexelő jelenleg nem támogatja a blobindexcímkék indexelését.

Standard blob-metaadat-tulajdonságok

A szabványos blob metaadataihoz definiáljon mezőket az indexben ugyanazokkal az alászúrt nevek használatával. Részletes meződefiníciós példákért lásd: Keresési mezők hozzáadása indexhez.

Az indexelő konfigurálásával kapcsolatban, beleértve azt a dataToExtract beállítást, amely meghatározza, hogy mely metaadatokat kell kinyerni, lásd: A blob indexelő konfigurálása és futtatása.

Az indexelő felismeri és megfeleltetheti ezeket a szabványos metaadat-tulajdonságokat, ha megfelelő mezőket határoz meg az indexben:

• metadata_storage_name (Edm.String) a blob fájlneve. Ha például egy blob /my-container/my-folder/subfolder/resume.pdf van, akkor ennek a mezőnek az értéke resume.pdf.

• metadata_storage_path (Edm.String) a blob teljes URI-ja, beleértve a tárfiókot is. Például: https://myaccount.blob.core.windows.net/my-container/my-folder/subfolder/resume.pdf. A tulajdonság használatával blob URL-címeket is felvehet a keresési eredményekbe navigáció vagy forrásmegjelölés céljából.

• metadata_storage_content_type (Edm.String) a blob feltöltéséhez használt kód által megadott tartalomtípus. Például: application/octet-stream.

• metadata_storage_last_modified (Edm.DateTimeOffset) a blob utolsó módosított időbélyege. Azure AI Keresés ezzel az időbélyegzővel azonosítja a módosított blobokat, és elkerüli a kezdeti indexelés utáni újraindexelést.

• metadata_storage_size (Edm.Int64) a blob mérete bájtban.

• metadata_storage_content_md5 (Edm.String) a blobtartalom MD5 kivonata, ha elérhető.

• metadata_storage_sas_token (Edm.String) egy ideiglenes SAS-jogkivonat, amellyel az egyéni képességek hozzáférhetnek a blobhoz. Ne tárolja ezt a jogkivonatot későbbi használatra, mert előfordulhat, hogy lejár.

Egyéni és tartalomspecifikus metaadatok

Egyéni vagy felhasználó által definiált blob metaadataihoz definiáljon egy olyan mezőt, amelynek pontosan ugyanaz a neve, mint a blob metaadatkulcsának. Ha például a blobok rendelkeznek egy Sensitivity metaadatkulccsal, amelynek értéke High, definiáljon egy Sensitivity nevű, Edm.String típusú mezőt az indexben.

Az indexelt blobok dokumentumformátumára jellemző metaadat-tulajdonságokat is megadhatja. További információ: Tartalom metaadatainak tulajdonságai.

Az adatforrás meghatározása

Az adatforrás definíciója meghatározza az indexelendő adatokat, a hitelesítő adatokat és azokat a szabályzatokat, amelyek a változások azonosítására szolgálnak az adatokban. Egy adatforrás független erőforrásként van definiálva, így több indexelő is használhatja.

1. Adatforrás létrehozása vagy frissítése a definíció beállításához:

   {
       "name" : "my-blob-datasource",
       "type" : "azureblob",
       "credentials" : { "connectionString" : "DefaultEndpointsProtocol=https;AccountName=<account name>;AccountKey=<account key>;" },
       "container" : { "name" : "my-container", "query" : "<optional-virtual-directory-name>" }
   }
   

2. Állítsa be a (kötelező) értéket typeazureblob .

3. Állítsa be credentials egy Azure Storage kapcsolati karakterláncra. A következő szakasz a támogatott formátumokat ismerteti.

4. Állítsa be container a blobtárolóként, és query használatával adja meg az almappákat.

Helyreállítható törlési szabályzatokat is hozzáadhat az adatforrás-definíciókhoz, ha azt szeretné, hogy az indexelő töröljön egy keresési dokumentumot, amikor a forrásdokumentum törlésre van megjelölve.

Támogatott hitelesítő adatok és kapcsolati karakterlánc

Az indexelők az alábbi kapcsolatokkal csatlakozhatnak egy blobtárolóhoz.

Keresési mezők hozzáadása indexhez

Egy keresési indexben adjon hozzá mezőket az Azure-blobok tartalmának és metaadatainak elfogadásához.

1. Hozzon létre vagy frissítsen egy indexet a blobtartalmakat és metaadatokat tároló keresési mezők definiálásához:

   POST https://[service name].search.windows.net/indexes?api-version=2026-04-01
   {
       "name" : "my-search-index",
       "fields": [
           { "name": "ID", "type": "Edm.String", "key": true, "searchable": false },
           { "name": "content", "type": "Edm.String", "searchable": true, "filterable": false },
           { "name": "metadata_storage_name", "type": "Edm.String", "searchable": false, "filterable": true, "sortable": true  },
           { "name": "metadata_storage_size", "type": "Edm.Int64", "searchable": false, "filterable": true, "sortable": true  },
           { "name": "metadata_storage_content_type", "type": "Edm.String", "searchable": false, "filterable": true, "sortable": true },        
       ]
   }
   

2. Dokumentumkulcsmező létrehozása ("key": true). Blobtartalmak esetén a legjobb jelöltek a metaadat-tulajdonságok.

   • metadata_storage_path (alapértelmezett) az objektum vagy fájl teljes elérési útja. A kulcsmező (ID ebben a példában) metadata_storage_path értékeivel van feltöltve, mert ez az alapértelmezett érték.

   • metadata_storage_name csak akkor használható, ha a nevek egyediek. Ha ezt a mezőt szeretné kulcsként használni, lépjen "key": true erre a meződefinícióra.

   • A blobokhoz hozzáadott egyéni metaadat-tulajdonság. Ehhez a beállításhoz a blobfeltöltési folyamatnak hozzá kell adnia ezt a metaadat-tulajdonságot az összes blobhoz. Mivel a kulcs egy kötelező tulajdonság, az érték nélküli blobokat nem lehet indexelni. Ha egyéni metaadat-tulajdonságot használ kulcsként, ne módosítsa a tulajdonságot. Az indexelők duplikált dokumentumokat adnak hozzá ugyanahhoz a blobhoz, ha a kulcstulajdonság megváltozik.

   A metaadat-tulajdonságok gyakran tartalmaznak olyan karaktereket, például / és -, amelyek érvénytelenek a dokumentumkulcsok esetében. Az indexelő azonban automatikusan kódolja a kulcs metaadat-tulajdonságát, és nincs szükség konfigurációra vagy mezőleképezésre.

3. Adjon hozzá egy content mezőt, amely az egyes fájlokból kinyert szöveget a blob tulajdonságán content keresztül tárolja. Ezt a nevet nem kell használnia, de használatával kihasználhatja az implicit mezőleképezések előnyeit.

4. Adjon hozzá mezőket a szabványos metaadat-tulajdonságokhoz. Az indexelő elolvashatja az egyéni metaadat-tulajdonságokat, a szabványos metaadat-tulajdonságokat és a tartalomspecifikus metaadat-tulajdonságokat .

A blobindexelő konfigurálása és futtatása

Az index és az adatforrás létrehozása után hozza létre az indexelőt. Az indexelő konfigurációja meghatározza a futtatókörnyezeti viselkedést vezérlő bemeneteket, paramétereket és tulajdonságokat. Megadhatja azt is, hogy a blob mely részeit indexelje.

1. Hozzon létre vagy frissítsen egy indexelőt úgy, hogy megad neki egy nevet, és hivatkozik az adatforrásra és a célindexre:

   POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
   {
     "name" : "my-blob-indexer",
     "dataSourceName" : "my-blob-datasource",
     "targetIndexName" : "my-search-index",
     "parameters": {
         "batchSize": null,
         "maxFailedItems": null,
         "maxFailedItemsPerBatch": null,
         "configuration": {
             "indexedFileNameExtensions" : ".pdf,.docx",
             "excludedFileNameExtensions" : ".png,.jpeg",
             "dataToExtract": "contentAndMetadata",
             "parsingMode": "default"
         }
     },
     "schedule" : { },
     "fieldMappings" : [ ]
   }
   

2. Adja meg batchSize , hogy az alapértelmezett (10 dokumentum) kihasználatlan-e vagy túlterheli-e a rendelkezésre álló erőforrásokat. Az alapértelmezett kötegméretek adatforrás-specifikusak. A blobindexelés a kötegméretet 10 dokumentumra állítja a nagyobb átlagos dokumentumméret elismeréseként.

3. A configurationcsoport alatt szabályozhatja, hogy mely blobok legyenek fájltípus alapján indexelve, vagy hagyja meg nem meghatározottnak az összes blob lekéréséhez.

   Ehhez indexedFileNameExtensionsadja meg a fájlkiterjesztések vesszővel tagolt listáját (vezető ponttal). Tegye ugyanezt annak jelzésére excludedFileNameExtensions , hogy az indexelő mely bővítményeket hagyja ki. Ha ugyanaz a bővítmény mindkét listában szerepel, az indexelő kizárja az indexelésből.

4. A configuration alatt állítsa be a dataToExtract-t annak meghatározására, hogy a blobok mely részei legyenek indexelve:

   • contentAndMetadata megadja, hogy az indexelő indexeli a blobból kinyert összes metaadatot és szöveges tartalmat. Ez az alapértelmezett érték.

   • storageMetadata azt határozza meg, hogy az indexelő csak a szabványos blobtulajdonságokat és a felhasználó által megadott metaadatokat indexelje.

   • allMetadata megadja, hogy az indexelő kinyeri a blob tartalmát, és indexeli a standard blobtulajdonságokat és a talált tartalomtípusok metaadatait.

   • Az elérhető standard metaadat-tulajdonságok és mezőtípusaik teljes listáját az Indexelő blob metaadatai című témakörben találja.

5. Állítsa be a(z) configuration az parsingMode alatt. Az alapértelmezett elemzési mód az, hogy minden blobhoz egy keresési dokumentum tartozik. Ha a blobok egyszerű szövegesek, jobb teljesítményt érhet el, ha egyszerű szöveges elemzésre vált. Ha részletesebb elemzésre van szüksége, amely blobokat képez le több keresési dokumentumra, adjon meg egy másik módot. Az egy-a-többhöz elemzést az alábbi blobok esetén támogatjuk:

   • JSON-dokumentumok
   • CSV-fájlok

6. Mezőleképezéseket adhat meg, ha a mezőnév vagy a típus eltérést mutat, vagy ha egy forrásmező több verziójára van szüksége a keresési indexben.

   A blobindexelés során gyakran kihagyhatja a mezőleképezéseket, mert az indexelő beépített támogatással rendelkezik a content-hez és a metaadat tulajdonságokhoz, hogy azokat hasonló nevű és típusú mezőkhöz leképezze az indexben. Metaadat-tulajdonságok esetén az indexelő automatikusan lecseréli a kötőjeleket - aláhúzásjelekre a keresési indexben.

7. További információt az egyéb tulajdonságokról az Indexelő létrehozása című témakörben talál. A paraméterleírások teljes listáját a REST API-ból tekintheti meg.

Az indexelő automatikusan fut a létrehozásakor. Ezt a műveletet a true (igaz) értékre állítással disabled akadályozhatja meg. Az indexelő végrehajtásának szabályozásához futtasson egy indexelőt igény szerint , vagy ütemezze.

Adatok indexelése több Azure Blob-tárolóból egyetlen indexbe

Ne feledje, hogy az indexelők csak egyetlen tárolóból tudják indexelni az adatokat. Ha több tároló adatait kell indexelnie, és egyetlen AI Search-indexbe kell összesítenie, konfiguráljon több indexelőt, amelyek mind ugyanarra az indexre mutatnak. Vegye figyelembe a termékváltozatonként elérhető indexelők maximális számát.

Két indexelő használatával például lekérhet adatokat két különböző, nevesített my-blob-datasource1 adatforrásból.my-blob-datasource2 Minden adatforrás egy külön Azure Blob-tárolóra mutat, de mindkettő ugyanarra az indexre irányul, amelynek neve my-search-index.

Első indexelődefiníciós példa:

POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
{
  "name" : "my-blob-indexer1",
  "dataSourceName" : "my-blob-datasource1",
  "targetIndexName" : "my-search-index",
  "parameters": {
      "batchSize": null,
      "maxFailedItems": null,
      "maxFailedItemsPerBatch": null,
      "configuration": {
          "indexedFileNameExtensions" : ".pdf,.docx",
          "excludedFileNameExtensions" : ".png,.jpeg",
          "dataToExtract": "contentAndMetadata",
          "parsingMode": "default"
      }
  },
  "schedule" : { },
  "fieldMappings" : [ ]
}

Párhuzamos példában futó második indexelődefiníció:

POST https://[service name].search.windows.net/indexers?api-version=2026-04-01
{
  "name" : "my-blob-indexer2",
  "dataSourceName" : "my-blob-datasource2",
  "targetIndexName" : "my-search-index",
  "parameters": {
      "batchSize": null,
      "maxFailedItems": null,
      "maxFailedItemsPerBatch": null,
      "configuration": {
          "indexedFileNameExtensions" : ".pdf,.docx",
          "excludedFileNameExtensions" : ".png,.jpeg",
          "dataToExtract": "contentAndMetadata",
          "parsingMode": "default"
      }
  },
  "schedule" : { },
  "fieldMappings" : [ ]
}

Az indexelő állapotának ellenőrzése

Az indexelőzmények állapotának és végrehajtási előzményeinek figyeléséhez küldjön egy indexelőzmény-lekéréses kérést:

GET https://myservice.search.windows.net/indexers/myindexer/status?api-version=2026-04-01
  Content-Type: application/json  
  api-key: [admin key]

A válasz tartalmazza az állapotot és a feldolgozott elemek számát. A következő példához hasonlóan kell kinéznie:

    {
        "status":"running",
        "lastResult": {
            "status":"success",
            "errorMessage":null,
            "startTime":"2022-02-21T00:23:24.957Z",
            "endTime":"2022-02-21T00:36:47.752Z",
            "errors":[],
            "itemsProcessed":1599501,
            "itemsFailed":0,
            "initialTrackingState":null,
            "finalTrackingState":null
        },
        "executionHistory":
        [
            {
                "status":"success",
                "errorMessage":null,
                "startTime":"2022-02-21T00:23:24.957Z",
                "endTime":"2022-02-21T00:36:47.752Z",
                "errors":[],
                "itemsProcessed":1599501,
                "itemsFailed":0,
                "initialTrackingState":null,
                "finalTrackingState":null
            },
            ... earlier history items
        ]
    }

A végrehajtási előzmények legfeljebb 50 legutóbbi végrehajtást tartalmaznak. A bejegyzések fordított időrendi sorrendben vannak rendezve, így a legújabb végrehajtás lesz az első.

Hibaelhárítás

Ebben a szakaszban diagnosztizálhatja a hiányzó metaadat-értékeket és a gyakori blobindexelési hibákat.

A metaadatmezők null értékűek a keresési eredményekben

Ha a metaadatmezők null vagy üres értékeit látja a keresési eredményekben, használja ezt az ellenőrzőlistát:

1. Ellenőrizze, hogy a mező létezik-e az indexsémában: Ellenőrizze, hogy definiált-e mezőt minden rögzíteni kívánt metaadat-tulajdonsághoz. Futtasson egy GET-kérést az indexen annak megerősítésére, hogy a mező jelen van.

2. Használja a megfelelő mezőnevet: Standard blobtulajdonságok esetén használja az alászúrt nevet, például metadata_storage_path a metadata-storage-pathhelyett. Egyéni metaadatok esetén a mező nevének pontosan meg kell egyeznie a blob metaadatkulcsával.

3. Ellenőrizze, hogy az indexelő megfelelően van-e dataToExtract beállítva:

   • contentAndMetadata (alapértelmezett) a tartalmat és a standard/egyéni metaadatokat is kinyeri.
   • storageMetadata csak a standard blobtulajdonságokat és az egyéni metaadatokat nyeri ki.
   • allMetadata standard tulajdonságokat és tartalomtípus-specifikus metaadatokat nyer ki.

   Ellenőrizze az indexelő konfigurációját, hogy a beállítás megfelel-e a szándékának.

4. Futtassa újra az indexelőt a sémafrissítések után: Ha új mezőt adott hozzá az indexhez, futtassa újra az indexelőt, hogy a dokumentumok a frissített sémán dolgozzanak fel. Előfordulhat, hogy a meglévő dokumentumokat újra kell dolgozni az új mező feltöltése előtt.

5. Ellenőrizze az indexelőzmények végrehajtási előzményeit: Nyissa meg az indexelőt a Azure portálon, vagy használja az Indexelő állapotának lekérése (REST API) lehetőséget a végrehajtás részleteinek és a hibaüzenetek megtekintéséhez.

Indexelőhibák és nem támogatott tartalomtípusok

Alapértelmezés szerint a blobindexelő leáll, amint olyan blobot talál, amely nem támogatott tartalomtípussal, például hangfájllal rendelkezik. A paraméter használatával excludedFileNameExtensions kihagyhat bizonyos tartalomtípusokat.

Ha azt szeretné, hogy az indexelés folytatódjon, ha egyes dokumentumok sikertelenek, módosítsa az alábbi paramétereket, majd vizsgálja meg az egyes dokumentumokat később. További információkért tekintse meg az Indexer hibaelhárítási útmutatóját , valamint az Indexer hibáit és figyelmeztetéseit.

Hibák esetén öt indexelőparaméter vezérli az indexelő válaszát:

PUT /indexers/[indexer name]?api-version=2026-04-01
{
  "parameters" : { 
    "maxFailedItems" : 10, 
    "maxFailedItemsPerBatch" : 10,
    "configuration" : { 
        "failOnUnsupportedContentType" : false, 
        "failOnUnprocessableDocument" : false,
        "indexStorageMetadataOnlyForOversizedDocuments": false
      }
    }
}

Kapcsolódó tartalom

• Változásészlelés és törlésészlelés
• Nagyméretű adathalmazok indexelése
• Indexelő hozzáférése az Azure hálózati biztonsági funkciói által védett tartalmakhoz