Az Indexelő gyakori hibáinak és figyelmeztetéseinek elhárítása az Azure AI Keresésben

Ez a cikk információkat és megoldásokat tartalmaz az Azure AI Keresésben az indexelés és az AI-bővítés során előforduló gyakori hibákra és figyelmeztetésekre.

Az indexelés leáll, ha a hibaszám meghaladja a maxFailedItems értéket. Ha azt szeretné, hogy az indexelők kihagyják a sikertelen dokumentumokat, konfigurálja a maxFailedItemsandmaxFailedItemsPerBatch parancsot.

A figyelmeztetések nem hagyják abba az indexelést, de olyan feltételeket jeleznek, amelyek váratlan eredményeket eredményezhetnek. Az adatoktól és a forgatókönyvtől függ, hogy műveletet hajt-e végre vagy sem.

Hol találhat konkrét indexelőhibákat?

Az indexelő állapotának ellenőrzése és a hibák azonosítása:

1. Nyissa meg a keresési szolgáltatást az Azure Portalon.

2. A bal oldalon bontsa ki a Kereséskezelési>indexelőket , és válasszon ki egy indexelőt.

3. A Végrehajtási előzmények csoportban válassza ki az állapotot. Minden állapot, beleértve a sikert is, rendelkezik a végrehajtással kapcsolatos részletekkel.

4. Ha hiba történt, vigye az egérmutatót a hibaüzenet fölé. Megjelenik egy panel a képernyő jobb oldalán, amely részletes információkat jelenít meg a hibáról.

Átmeneti hibák

Különböző okokból, például az átmeneti hálózati kommunikáció megszakadása, a hosszú ideig futó folyamatok időtúllépései vagy a dokumentumok adott árnyalatai miatt gyakori, hogy átmeneti hibák vagy figyelmeztetések jelennek meg az indexelő futtatása során. Ezek a hibák azonban ideiglenesek, és az indexelő későbbi futtatásakor meg kell oldani őket.

A hibák hatékony kezelése érdekében javasoljuk, hogy az indexelőt ütemezze, például öt percenként fusson, ahol a következő futtatás öt perccel az első futtatás befejezése után kezdődik, és betartja a szolgáltatás maximális futásidejű korlátját . A rendszeresen ütemezett futtatások segítenek az átmeneti hibák vagy figyelmeztetések kijavításában.

Ha egy hiba több indexelő futtatása során is fennáll, az valószínűleg nem átmeneti probléma. Ilyen esetekben a lehetséges megoldásokért tekintse meg az alábbi listát.

Hibatulajdonságok

Error: Could not read document

Az indexelő nem tudta beolvasni a dokumentumot az adatforrásból. Ez a következő esetekben fordulhat elő:

Error: Could not extract content or metadata from your document

A Blob-adatforrással rendelkező indexelő nem tudta kinyerni a dokumentum tartalmát vagy metaadatait (például EGY PDF-fájlt). Ez a következő esetekben fordulhat elő:

Error: Could not parse document

Az indexelő beolvassa a dokumentumot az adatforrásból, de hiba történt a dokumentum tartalmának a megadott mezőleképezési sémává alakításával. Ez a következő esetekben fordulhat elő:

Error: Could not map output field 'xyz' to search index due to deserialization problem while applying mapping function 'abc'

Előfordulhat, hogy a kimeneti leképezés meghiúsult, mert a kimeneti adatok nem megfelelő formátumban vannak a használt leképezési függvényhez. A leképezési függvény bináris adatokra való Base64Encode alkalmazása például ezt a hibát eredményezi. A probléma megoldásához futtassa újra az indexelőt leképezési függvény megadása nélkül, vagy győződjön meg arról, hogy a leképezési függvény kompatibilis a kimeneti mező adattípusával. Részletekért lásd a Kimeneti mező leképezése című témakört.

Error: Could not execute skill

Az indexelő nem tudott egy funkciót futtatni a képességek között.

Error: Could not execute skill because the Web API request failed

A képesség végrehajtása meghiúsult, mert a Webes API hívása sikertelen volt. Ez a hibaosztály általában egyéni képességek használatakor fordul elő, ebben az esetben az egyéni kód hibakeresésére van szükség a probléma megoldásához. Ha a hiba egy beépített képességből származik, a hiba megoldásához tekintse meg a hibaüzenetet.

A probléma hibakeresése során ügyeljen arra, hogy mindenképpen figyeljen az adott képességhez tartozó készségbemeneti figyelmeztetésekre . Előfordulhat, hogy a webes API-végpont meghiúsul, mert az indexelő váratlan bemenetet ad át.

Error: Could not execute skill because Web API skill response is invalid

A képesség végrehajtása meghiúsult, mert a Webes API-ra irányuló hívás érvénytelen választ adott vissza. Ez a hibaosztály általában egyéni képességek használatakor fordul elő, ebben az esetben az egyéni kód hibakeresésére van szükség a probléma megoldásához. Ha a hiba egy beépített képességből származik, küldjön egy támogatási jegyet a segítségért.

Error: Type of value has a mismatch with column type. Couldn't store in 'xyz' column. Expected type is 'abc'

Ha az adatforrás olyan mezővel rendelkezik, amelynek adattípusa eltér az indexben leképezendő mezőétől, ez a hiba jelenhet meg. Ellenőrizze az adatforrásmező adattípusait, és ellenőrizze, hogy megfelelően vannak-e megfeleltetve az index adattípusaihoz.

Error: Skill did not execute within the time limit

Két esetben jelenhet meg ez a hibaüzenet, amelyek mindegyikét másképp kell kezelni. Kövesse az alábbi utasításokat attól függően, hogy milyen képesség adott vissza önnek ezt a hibát.

Beépített öntödei eszközökkel kapcsolatos ismeretek

Számos beépített kognitív képességet, például a nyelvfelismerést, az entitásfelismerést vagy az OCR-t egy Foundry Tools API-végpont támogatja. Néha átmeneti problémák lépnek fel ezekkel a végpontokkal, és a kérés időtúllépést okozhat. Az átmeneti problémák esetén nincs más megoldás, mint várni és újra próbálkozni. Kockázatcsökkentésként érdemes úgy beállítani az indexelőt, hogy ütemezés szerint fusson. Az ütemezett indexelés ott folytatja, ahol abbahagyta. Feltételezve, hogy az átmeneti problémák megoldódnak, az indexelés és a kognitív feldolgozás folytatódhat a következő ütemezett futtatás során.

Ha továbbra is ugyanazt a hibát látja ugyanazon a dokumentumban egy beépített kognitív képesség esetében, küldjön támogatási jegyet a segítségért, mivel ez nem várható.

Egyéni készségek

Ha egy egyéni funkciónál időtúllépési hibát tapasztal, néhány dolgot kipróbálhat. Először ellenőrizze az egyéni képességet, és győződjön meg arról, hogy nem akad el egy végtelen ciklusban, valamint hogy következetesen visszatérít egy eredményt. Miután meggyőződött arról, hogy az eredmény vissza lett adva, ellenőrizze a végrehajtás időtartamát. Ha nem adott meg timeout explicit módon értéket az egyéni képességdefinícióban, akkor az alapértelmezett érték timeout 30 másodperc. Ha 30 másodperc nem elég a képesség végrehajtásához, megadhat egy magasabb timeout értéket az egyéni képességdefinícióban. Íme egy példa egy egyéni képességdefinícióra, ahol az időtúllépés 90 másodpercre van állítva:

  {
        "@odata.type": "#Microsoft.Skills.Custom.WebApiSkill",
        "uri": "<your custom skill uri>",
        "batchSize": 1,
        "timeout": "PT90S",
        "context": "/document",
        "inputs": [
          {
            "name": "input",
            "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "output",
            "targetName": "output"
          }
        ]
      }

A paraméterhez timeout beállítható maximális érték 230 másodperc. Ha az egyéni képesség 230 másodpercen belül nem tudja következetesen végrehajtani a műveletet, érdemes lehet csökkentenie az batchSize egyéni készségét, hogy kevesebb dokumentumot dolgozzon fel egyetlen végrehajtáson belül. Ha már beállította az batchSize 1 értéket, át kell írnia a képességet, hogy 230 másodperc alatt végre lehessen hajtani, vagy más módon fel kell osztania több egyéni képességre, hogy az egyéni képességek végrehajtási ideje legfeljebb 230 másodperc legyen. További információért tekintse át az egyéni készség dokumentációját .

Error: Could not 'MergeOrUpload' | 'Delete' document to the search index

A dokumentum olvasása és feldolgozása megtörtént, de az indexelő nem tudta hozzáadni a keresési indexhez. Ez a következő esetekben fordulhat elő:

Error: Could not index document because some of the document's data was not valid

A dokumentumot az indexelő olvasta és feldolgozta, de az indexmezők konfigurációjának eltérése és az indexelő által kinyert és feldolgozott adatok nem adhatók hozzá a keresési indexhez. Ez a következő esetekben fordulhat elő:

Ezekben az esetekben tekintse meg az indexelők támogatott adattípusait és adattípus-leképezését , hogy biztosan helyesen hozza létre az indexsémát, és megfelelő indexelőmező-leképezéseket állítson be. A hibaüzenet olyan részleteket tartalmaz, amelyek segíthetnek az eltérés forrásának nyomon követésében.

Error: Integrated change tracking policy cannot be used because table has a composite primary key

Ez az SQL-táblákra vonatkozik, és általában akkor fordul elő, ha a kulcs összetett kulcsként van definiálva, vagy ha a tábla egyedi fürtözött indexet definiált (mint egy SQL-indexben, és nem egy Azure Search-indexben). Ennek fő oka, hogy a kulcsattribútum összetett elsődleges kulcsként van módosítva egy egyedi fürtözött indexben. Ebben az esetben győződjön meg arról, hogy az SQL-tábla nem rendelkezik egyedi fürtözött indexel, vagy hogy a kulcsmezőt egy olyan mezőhöz rendeli, amely garantáltan nem tartalmaz duplikált értékeket.

Error: Could not process document within indexer max run time

Ez a hiba akkor fordul elő, ha az indexelő nem tudja befejezni egyetlen dokumentum feldolgozását az adatforrásból az engedélyezett végrehajtási időn belül. A maximális futási idő rövidebb a képességkészletek használatakor. Ha ez a hiba jelentkezik, és a maxFailedItems értéke nem 0, akkor az indexelő kihagyja a dokumentumot a jövőbeli futtatások során, hogy az indexelés folytatódhasson. Ha nem engedheti meg magának, hogy kihagyjon egy dokumentumot, vagy ha ezt a hibát következetesen látja, fontolja meg a dokumentumok kisebb dokumentumokra való törítését, hogy részleges előrehaladást lehessen végrehajtani egyetlen indexelő végrehajtásán belül.

Error: Could not project document

Ez a hiba akkor fordul elő, amikor az indexelő adatokat próbál kivetíteni egy tudástárba , és hiba történt a kísérlet során. Ez a hiba állandó és javítható lehet, vagy lehet egy átmeneti hiba a kimeneti fogadóval, melynek megoldása érdekében várnia kell, és újra kell próbálkoznia. Az alábbiakban ismert hibaállapotokat és lehetséges megoldásokat talál.

Error: The cognitive service for skill '<skill-name>' has been throttled

A képesség végrehajtása meghiúsult, mert a Foundry Tools hívása leterheltség miatt korlátozva lett. Ez a hibaosztály általában akkor fordul elő, ha túl sok képesség fut párhuzamosan. Ha a Microsoft.Search.Documents ügyfélkódtárat használja az indexelő futtatásához, a SearchIndexingBufferedSender használatával automatikus újrapróbálkozást végezhet a sikertelen lépéseken. Ellenkező esetben alaphelyzetbe állíthatja és újra futtathatja az indexelőt.

Error: Expected IndexAction metadata

A "Várt IndexAction metaadatok" hiba azt jelenti, hogy amikor az indexelő megpróbálta elolvasni a dokumentumot, hogy azonosítsa a végrehajtandó műveletet, nem talált megfelelő metaadatokat a dokumentumon. Ez a hiba általában akkor fordul elő, ha az indexelőhöz hozzáad vagy eltávolít egy jegyzet-gyorsítótárat az indexelő alaphelyzetbe állítása nélkül. Ennek kezeléséhez alaphelyzetbe kell állítania és újra kell futtatnia az indexelőt.

Warning: Skill input was invalid

A képesség egyik bemenete hiányzott, hibás típusú volt, vagy egyébként érvénytelen volt. A következő információk jelenhetnek meg:

• Could not execute skill

• Skill executed but may have unexpected results

A kognitív képességekhez szükséges bemenetek és opcionális bemenetek szükségesek. A kulcskifejezések kinyerésének készsége például két szükséges bemenettel rendelkezik: text, languageCode, és nincsenek opcionális bemenetek. Az egyéni készségbemenetek mind opcionális bemenetnek minősülnek.

Ha a szükséges bemenetek hiányoznak, vagy ha a bemenet nem a megfelelő típus, a program kihagyja a képességet, és figyelmeztetést hoz létre. A kihagyott készségek nem hoznak létre kimeneteket. Ha az alsóbb rétegbeli készségek felhasználják a kihagyott képesség kimeneteit, más figyelmeztetéseket is generálhatnak.

Ha hiányzik egy opcionális bemenet, a képesség továbbra is fut, de a hiányzó bemenet miatt váratlan kimenetet eredményezhet.

Ez a figyelmeztetés mindkét esetben az adatok alakjának köszönhető. Ha például van egy olyan dokumentuma, amely adatokat tartalmaz a firstName, middleName és lastName mezőkkel rendelkező személyekről, lehet, hogy vannak olyan dokumentumok is, amelyekhez nincs bejegyzés a middleName mezőre. Ha middleName bemenetként van átadva egy készségnek a folyamatban, akkor várható, hogy a készség bemenet időnként hiányzik. Ki kell értékelnie az adatokat és a forgatókönyvet annak megállapításához, hogy szükség van-e valamilyen műveletre a figyelmeztetés eredményeként.

Ha alapértelmezett értéket szeretne megadni egy hiányzó bemenethez, a Feltételes képesség használatával létrehozhat egy alapértelmezett értéket, majd a feltételes képesség kimenetét használhatja a képesség bemeneteként.

{
    "@odata.type": "#Microsoft.Skills.Util.ConditionalSkill",
    "context": "/document",
    "inputs": [
        { "name": "condition", "source": "= $(/document/language) == null" },
        { "name": "whenTrue", "source": "= 'en'" },
        { "name": "whenFalse", "source": "= $(/document/language)" }
    ],
    "outputs": [ { "name": "output", "targetName": "languageWithDefault" } ]
}

Warning: Skill input 'languageCode' has the following language codes 'X,Y,Z', at least one of which is invalid.

Az alsóbb rétegbeli készségek opcionális languageCode bemenetébe átadott értékek közül legalább egy nem támogatott. Ez akkor fordulhat elő, ha a LanguageDetectionSkill kimenetét átadja a következő készségeknek, és a kimenet több nyelvből áll, mint amennyit az alsóbb rétegbeli készségek támogatnak.

Vegye figyelembe, hogy az ehhez hasonló figyelmeztetést is kaphat, ha érvénytelen countryHint bemenetet ad át a LanguageDetectionSkillnek. Ha ez történik, ellenőrizze, hogy az adatforrásból használt mező érvényes ISO 3166-1 alfa-2 kétbetűs országkódokat tartalmaz-e. Ha néhány érvényes, és némelyik érvénytelen, folytassa az alábbi útmutatással, de cserélje le a languageCode-t countryHint-re és a defaultLanguageCode-t defaultCountryHint-ra, hogy illeszkedjen a használati esethez.

Ha tudja, hogy az adatkészlet egy nyelven van, távolítsa el a LanguageDetectionSkillt és a languageCode készségbemenetet, és használja helyette az defaultLanguageCode adott képesség képességparaméterét, feltéve, hogy a nyelv támogatott az adott képességhez.

Ha tudja, hogy az adatkészlet több nyelvet tartalmaz, és ezért szüksége van a LanguageDetectionSkillre és languageCode a bemenetre, fontolja meg egy FeltételeSkill hozzáadását, hogy kiszűrje a szöveget olyan nyelvekkel, amelyek nem támogatottak, mielőtt továbbadja a szöveget az alsóbb rétegbeli készségnek. Íme, hogyan nézhet ki egy példa az EntityRecognitionSkill készségre vonatkozóan:

{
    "@odata.type": "#Microsoft.Skills.Util.ConditionalSkill",
    "context": "/document",
    "inputs": [
        { "name": "condition", "source": "= $(/document/language) == 'de' || $(/document/language) == 'en' || $(/document/language) == 'es' || $(/document/language) == 'fr' || $(/document/language) == 'it'" },
        { "name": "whenTrue", "source": "/document/content" },
        { "name": "whenFalse", "source": "= null" }
    ],
    "outputs": [ { "name": "output", "targetName": "supportedByEntityRecognitionSkill" } ]
}

Íme néhány hivatkozás a jelenleg támogatott nyelvekre az egyes képességekhez, amelyek képesek létrehozni ezt a hibaüzenetet:

• EntityRecognitionSkill által támogatott nyelvek
• EntityLinkingSkill által támogatott nyelvek
• KeyPhraseExtractionSkill által támogatott nyelvek
• LanguageDetectionSkill által támogatott nyelvek
• PIIDetectionSkill által támogatott nyelvek
• A SentimentSkill által támogatott nyelvek
• A Translator által támogatott nyelvek
• A Text SplitSkill által támogatott nyelvek: da, de, en, es, fi, fr, it, ko, pt

Warning: Skill input was truncated

A kognitív képességek korlátozzák az egyszerre elemezhető szövegek hosszát. Ha a bevitt szöveg meghaladja a korlátot, a szöveg csonkolásra kerül, mielőtt gazdagítanák. A funkció végrehajtásra kerül, de nem az összes adatára vonatkozik.

Az alábbi példában LanguageDetectionSkill a beviteli mező aktiválhatja ezt a 'text' figyelmeztetést, ha a bemenet túllépi a karakterkorlátot. A bemeneti korlátokat a készségek referenciadokumentációjában találja.

 {
    "@odata.type": "#Microsoft.Skills.Text.LanguageDetectionSkill",
    "inputs": [
      {
        "name": "text",
        "source": "/document/text"
      }
    ],
    "outputs": [...]
  }

Ha gondoskodni szeretne arról, hogy az összes szöveg elemezve legyen, fontolja meg a Felosztási készség használatát.

Warning: Web API skill response contains warnings

Az indexelő a skillkészletben futtatta a skillt, de a web API-kérés eredménye azt jelzi, hogy vannak figyelmeztetések. Tekintse át a figyelmeztetéseket, hogy megismerje az adatok hatását, és hogy szükség van-e további műveletekre.

Warning: The current indexer configuration does not support incremental progress

Ez a figyelmeztetés csak az Azure Cosmos DB-adatforrásokra vonatkozik.

Az indexelés növekményes előrehaladása biztosítja, hogy ha az indexelő végrehajtását átmeneti hibák vagy végrehajtási időkorlát szakítja meg, az indexelő a következő futtatáskor ott folytathatja, ahol abbahagyta, ahelyett, hogy újra kellene indexelnie a teljes gyűjteményt. Ez különösen fontos a nagy gyűjtemények indexelése során.

A befejezetlen indexelési feladatok folytatásának lehetősége attól függ, hogy a dokumentumok az _ts oszlop alapján vannak rendezve. Az indexelő az időbélyeg használatával határozza meg, hogy melyik dokumentumot vegye fel a következő lépésként. Ha az _ts oszlop hiányzik, vagy ha az indexelő nem tudja megállapítani, hogy egy egyéni lekérdezést rendelt-e, az indexelő az elején kezdődik, és megjelenik ez a figyelmeztetés.

Ezt a viselkedést felülbírálhatja, lehetővé téve a növekményes előrehaladást, és letilthatja ezt a figyelmeztetést a assumeOrderByHighWaterMarkColumn konfigurációs tulajdonság használatával.

További információ: Növekményes folyamat és egyéni lekérdezések.

Warning: Some data was lost during projection. Row 'X' in table 'Y' has string property 'Z' which was too long.

A Table Storage szolgáltatás korlátozza a nagy entitástulajdonságok számát . A sztringek legfeljebb 32 000 karakterből állhatnak. Ha egy 32 000 karakternél hosszabb sztringtulajdonságú sor van kivetítve, csak az első 32 000 karakter marad meg. A probléma megoldásához kerülje a 32 000 karakternél hosszabb sztringtulajdonságú sorok kivetítését.

Warning: Truncated extracted text to X characters

Az indexelők korlátozzák, hogy egy dokumentumból mennyi szöveg nyerhető ki. Ez a korlát a tarifacsomagtól függ: 32 000 karakter ingyenes szint esetén, 64 000 az alapszintű, 4 millió a Standard, 8 millió a Standard S2 és 16 millió a Standard S3 esetében. A csonkolt szöveg nem lesz indexelve. A figyelmeztetés elkerülése érdekében próbálja meg szétválasztani a nagy mennyiségű szöveget tartalmazó dokumentumokat több, kisebb dokumentumra.

További információkért tekintse meg az Indexelő korlátait.

Warning: Could not map output field 'X' to search index

A nem létező/null értékű adatokra hivatkozó kimeneti mezőleképezések minden dokumentumra figyelmeztetést hoznak létre, és üres indexmezőt eredményeznek. A probléma megoldásához ellenőrizze duplán a kimeneti mezőleképezés forrásútvonalait a lehetséges elírásokhoz, vagy állítson be egy alapértelmezett értéket a Feltételes képesség használatával. Részletekért lásd a Kimeneti mező leképezése című témakört.

Warning: The data change detection policy is configured to use key column 'X'

Az adatváltozás-észlelési szabályzatok speciális követelményekkel rendelkeznek a változások észleléséhez használt oszlopokra vonatkozóan. Ezen követelmények egyike, hogy ez az oszlop minden alkalommal frissül, amikor a forráselem módosul. Egy másik követelmény, hogy az oszlop új értéke nagyobb, mint az előző érték. A kulcsoszlopok nem teljesítik ezt a követelményt, mert nem változnak minden frissítésen. A probléma megoldásához válasszon egy másik oszlopot a változásészlelési szabályzathoz.

Warning: Document text appears to be UTF-16 encoded, but is missing a byte order mark

Az indexelő elemzési módjainak az elemzés előtt tudniuk kell, hogyan van kódolva a szöveg. A szöveg kódolásának két leggyakoribb módja az UTF-16 és az UTF-8. Az UTF-8 egy változó hosszúságú kódolás, amelyben minden karakter 1 bájt és 4 bájt hosszú. Az UTF-16 egy rögzített hosszúságú kódolás, amelyben minden karakter 2 bájt hosszú. Az UTF-16 két különböző változata van: big endian és little endian. A szövegkódolást a byte order markszöveg előtti bájtok sorozata határozza meg.

Ha nincs bájtsorrendjel, a rendszer feltételezi, hogy a szöveg UTF-8 formátumban van kódolva.

A figyelmeztetés megkerüléséhez határozza meg, hogy mi a blob szövegkódolása, és adja hozzá a megfelelő bájtsorrendjelet.

Warning: Azure Cosmos DB collection 'X' has a Lazy indexing policy. Some data may be lost

A lusta indexelési szabályzatokkal rendelkező gyűjtemények nem kérdezhetők le következetesen, ami azt eredményezi, hogy az indexelő hiányzó adatokat tartalmaz. A figyelmeztetés megkerüléséhez módosítsa az indexelési szabályzatot konzisztensre.

Warning: The document contains very long words (longer than 64 characters). These words may result in truncated and/or unreliable model predictions.

Ezt a figyelmeztetést az Foundry Tools nyelvi szolgáltatása továbbítja. Bizonyos esetekben nyugodtan figyelmen kívül hagyhatja ezt a figyelmeztetést, például ha a hosszú karakterlánc csupán egy hosszú URL-cím. Vegye figyelembe, hogy ha egy szó 64 karakternél hosszabb, 64 karakterre csonkolja, ami hatással lehet a modell előrejelzésére.

Error: Cannot write more bytes to the buffer than the configured maximum buffer size

Az indexelők dokumentumméretkorlátokkal rendelkeznek. Győződjön meg arról, hogy az adatforrás dokumentumai kisebbek a támogatott méretkorlátnál, ahogyan azt a szolgáltatásszinten dokumentálta.

Error: Failed to compare value 'X' of type M to value 'Y' of type N.

Ez a hiba általában akkor fordul elő az Azure SQL-indexelőkben, ha a forrásoszlop dataChangeDetectionPolicy típusa nem felel meg az indexelő által vártnak, különösen ha convertHighWaterMarkToRowVersion be van kapcsolva.

Ha például a változásészleléshez használt oszlop dátum/idő típusú, de az indexelő sorverziós típust vár, mert a convertHighWaterMarkToRowVersion engedélyezve van, az eltérés hibát fog okozni.

Ellenőrizze a forrás "Magas vízjel" oszlopának adattípusát, és ennek megfelelően frissítse az indexelő konfigurációját. Miután ellenőrizte és frissítette, állítsa alaphelyzetbe és futtassa újra az indexelőt az oszlopértékek feldolgozásához.

Error: Access denied to Virtual Network/Firewall rules

Ez a hiba általában az alábbiak valamelyike miatt fordul elő:

• Az indexelő által igényelt Azure-erőforrások tűzfalkorlátozásai a konfigurációtól függően. Ezek az erőforrások a következők lehetnek: az adatforrás, az Azure Storage-fiók ( hibakeresési munkamenetekhez, növekményes bővítéshez vagy tudástárhoz), Az Azure-függvény ( a webes API egyéni készségeihez használatos), vagy a Microsoft Foundry AI-bővítés során használt üzembe helyezései.
• Privát végpontkonfigurációk, amelyek blokkolják az indexelő hozzáférését ezekhez az erőforrásokhoz.

Győződjön meg arról, hogy az indexelő hozzáfér a beállítási összetevőkhöz az erőforrás-konfigurációk áttekintésével, hogy meggyőződjön arról, hogy engedélyezik az összes szükséges szolgáltatás felé történő forgalmat:

• Tűzfal- és IP-korlátozási beállítások
• Megosztott privát hivatkozás beállítása

Error: Credentials provided in the connection string are invalid or have expired

Ez a hiba akkor fordul elő, ha az Azure AI Keresés indexelője nem tud hitelesítést végezni a megadott kapcsolati sztring használatával, vagy problémákat tapasztal a tárfiókhoz való hozzáféréssel a hitelesítő adatok ellenőrzéséhez.

Error: Invalid AAD tenant

Ez az üzenet akkor jelenhet meg, ha a Microsoft 365-ben működő SharePoint-indexelő nem tudja hitelesíteni magát annál a Microsoft Entra-bérlőnél, amelyhez a SharePoint-webhely tartozik. TenantId nem kötelező a SharePoint-adatforrás kapcsolati sztringjében, de a megadott értéknek az adott webhely Microsoft Entra-bérlőazonosítójának (GUID) kell lennie. Ez a bérlő nem feltétlenül a keresési szolgáltatáshoz társított Microsoft Entra bérlő.

A hiba elhárításához használja az alábbi útmutatást:

• Bérlők közötti SharePoint-kapcsolat esetén adja meg a SharePoint-webhely Microsoft Entra-bérlőazonosítóját a kapcsolati sztringben a(z) TenantId értékeként.
• Ugyanazon Microsoft Entra bérlőn belüli kapcsolat esetén adja meg a SharePoint webhely bérlőazonosítóját, vagy engedélyezze a keresési szolgáltatás rendszer által hozzárendelt felügyelt identitását. Ha kihagyjaTenantId, az indexelő az identitáshoz társított Microsoft Entra erőforrás-bérlőt használja.
• Ha sem explicit módon megadott TenantId, sem erőforrás-bérlői környezet nem érhető el, az indexelő a következőt jelzi: Ensure service managed identity is enabled for your service, or TenantId is specified in your kapcsolati karakterlánc.

A nem GUID formátumú hibás értékek hibát okozhatnak az adatforrás létrehozásakor vagy frissítésekor. A nem megfelelő Microsoft Entra-bérlőhöz tartozó, jól formázott azonosító átmehet az adatforrás-ellenőrzésen, de meghiúsulhat, amikor az indexelő hitelesít. Végrehajtási hibák esetén nyissa meg a keresési szolgáltatást a Azure portálon, válassza a Kereséskezelési>indexelőzmények lehetőséget, válassza ki az indexelőzményt, és tekintse át a végrehajtási előzményeket és az állapotadatokat.

A kapcsolati karakterlánc formátumairól, valamint a SharePoint-webhely Microsoft Entra-bérlőazonosítójának megkeresésére vonatkozó útmutatásért lásd: A SharePoint konfigurálása a Microsoft 365-indexelőben.

Error: Error detecting index schema from data source

Az indexelő konfigurálásához használt Azure Portal-felület nem tudta lekérni a sémaadatokat az adatforrásból. Ez átmeneti csatlakozási problémák vagy olyan hálózati konfigurációs korlátozások miatt fordulhat elő, amelyek megakadályozzák, hogy az Azure AI Keresés hozzáférjen a forráshoz.