Veelvoorkomende indexeerfouten en -waarschuwingen in Azure AI Zoeken oplossen

Dit artikel bevat informatie en oplossingen voor veelvoorkomende fouten en waarschuwingen die kunnen optreden tijdens indexering en AI-verrijking in Azure AI Zoeken.

Indexering stopt wanneer het aantal fouten groter is dan maxFailedItems. Als u indexeerders mislukte documenten wilt laten overslaan, configureert u maxFailedItemsandmaxFailedItemsPerBatch.

Waarschuwingen stoppen niet met indexeren, maar geven wel aan dat er voorwaarden zijn die kunnen leiden tot onverwachte resultaten. Of u nu actie onderneemt of niet afhankelijk is van de gegevens en uw scenario.

Waar vindt u specifieke indexeerfouten?

De status van een indexeerfunctie controleren en fouten identificeren:

1. Ga naar uw zoekservice in Azure Portal.

2. Klik links op Zoekbeheer> en Indexeerders uitvouwen en selecteer een indexeerder.

3. Selecteer onder Uitvoeringsgeschiedenis de status. Alle statussen, inclusief Geslaagd, bevatten details over de uitvoering.

4. Als er een fout optreedt, plaatst u de muisaanwijzer op het foutbericht. Aan de rechterkant van het scherm wordt een deelvenster weergegeven met gedetailleerde informatie over de fout.

Tijdelijke fouten

Om verschillende redenen, zoals tijdelijke onderbrekingen van netwerkcommunicatie, time-outs van langlopende processen of specifieke documentnuances, is het gebruikelijk om tijdelijke fouten of waarschuwingen te tegenkomen tijdens uitvoeringen van de indexeerfunctie. Deze fouten zijn echter tijdelijk en moeten worden opgelost in volgende uitvoeringen van de indexeerfunctie.

Als u deze fouten effectief wilt beheren, raden we u aan uw indexeerfunctie in een schema te plaatsen, bijvoorbeeld om elke vijf minuten uit te voeren, waarbij de volgende uitvoering vijf minuten begint na het voltooien van de eerste uitvoering, waarbij de maximale runtimelimiet voor uw service wordt bereikt. Regelmatig geplande uitvoeringen helpen tijdelijke fouten of waarschuwingen op te lossen.

Als een fout zich blijft voordoen bij meerdere indexeerfuncties, is dit waarschijnlijk geen tijdelijk probleem. Raadpleeg in dergelijke gevallen de onderstaande lijst voor mogelijke oplossingen.

Fouteigenschappen

Error: Could not read document

Indexeerfunctie kan het document niet lezen uit de gegevensbron. Dit kan gebeuren vanwege:

Error: Could not extract content or metadata from your document

Indexeerfunctie met een Blob-gegevensbron kan de inhoud of metagegevens niet ophalen uit het document (bijvoorbeeld een PDF-bestand). Dit kan gebeuren vanwege:

Error: Could not parse document

Indexeerfunctie leest het document uit de gegevensbron, maar er is een probleem opgetreden bij het converteren van de documentinhoud naar het opgegeven schema voor veldtoewijzing. Dit kan gebeuren vanwege:

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

De uitvoertoewijzing is mogelijk mislukt omdat de uitvoergegevens de verkeerde indeling hebben voor de toewijzingsfunctie die u gebruikt. Als u bijvoorbeeld de toewijzingsfunctie Base64Encode op binaire gegevens toepast, kan deze fout optreden. U kunt het probleem oplossen door de indexeerfunctie opnieuw uit te voeren zonder de toewijzingsfunctie op te geven of ervoor te zorgen dat de toewijzingsfunctie compatibel is met het gegevenstype van het uitvoerveld. Zie Uitvoerveldtoewijzing voor details.

Error: Could not execute skill

De indexeerfunctie kon geen vaardigheid uitvoeren in de vaardighedenset.

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

De uitvoering van de vaardigheid is mislukt omdat de aanroep van de web-API is mislukt. Deze foutklasse treedt meestal op wanneer aangepaste vaardigheden worden gebruikt. In dat geval moet u fouten opsporen in uw aangepaste code om het probleem op te lossen. Als de fout afkomstig is van een ingebouwde vaardigheid, raadpleegt u het foutbericht voor hulp bij het oplossen van het probleem.

Let bij het oplossen van dit probleem op eventuele invoerwaarschuwingen voor vaardigheden voor deze vaardigheid. Uw web-API-eindpunt kan mislukken omdat de indexeerfunctie deze onverwachte invoer doorgeeft.

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

De uitvoering van de vaardigheid is mislukt omdat de aanroep van de web-API een ongeldig antwoord heeft geretourneerd. Deze foutklasse treedt meestal op wanneer aangepaste vaardigheden worden gebruikt. In dat geval moet u fouten opsporen in uw aangepaste code om het probleem op te lossen. Als in plaats daarvan de fout afkomstig is van een ingebouwde vaardigheid, dient u een ondersteuningsticket in om hulp te krijgen.

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

Als uw gegevensbron een veld met een ander gegevenstype heeft dan het veld dat u probeert toe te wijzen in uw index, kan deze fout optreden. Controleer de gegevenstypen van uw gegevensbronveld en zorg ervoor dat deze correct zijn toegewezen aan uw indexgegevenstypen.

Error: Skill did not execute within the time limit

Er zijn twee gevallen waarin u dit foutbericht kunt tegenkomen, die allemaal anders moeten worden behandeld. Volg de onderstaande instructies, afhankelijk van de vaardigheid die deze fout bij u veroorzaakte.

Ingebouwde Vaardigheden van Foundry Tools

Veel van de ingebouwde cognitieve vaardigheden, zoals taaldetectie, entiteitsherkenning of OCR, worden ondersteund door een Foundry Tools API-eindpunt. Soms zijn er tijdelijke problemen met deze eindpunten en treedt er een time-out op voor een aanvraag. Voor tijdelijke problemen is er geen oplossing, behalve om te wachten en het opnieuw te proberen. Als mitigatie kunt u overwegen om uw indexeerder in te stellen om op een schema te draaien. Geplande indexering hervat waar het was gebleven. Ervan uitgaande dat tijdelijke problemen worden opgelost, moeten indexering en verwerking van cognitieve vaardigheden kunnen doorgaan tijdens de volgende geplande uitvoering.

Als u deze fout blijft zien in hetzelfde document voor een ingebouwde cognitieve vaardigheid, dient u een ondersteuningsticket in om hulp te krijgen, omdat dit niet wordt verwacht.

Aangepaste vaardigheden

Als er een time-out-fout optreedt bij een aangepaste vaardigheid, zijn er een aantal dingen die u kunt proberen. Controleer eerst uw aangepaste vaardigheid en zorg ervoor dat deze niet vastloopt in een oneindige lus en dat het een resultaat consistent retourneert. Nadat u hebt bevestigd dat een resultaat wordt geretourneerd, controleert u de duur van de uitvoering. Als u niet expliciet een timeout waarde hebt ingesteld voor uw aangepaste vaardigheidsdefinitie, is de standaardwaarde timeout 30 seconden. Als 30 seconden niet lang genoeg is om uw vaardigheid uit te voeren, kunt u een hogere timeout waarde opgeven voor uw aangepaste vaardigheidsdefinitie. Hier volgt een voorbeeld van een aangepaste vaardigheidsdefinitie waarbij de time-out is ingesteld op 90 seconden:

  {
        "@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"
          }
        ]
      }

De maximumwaarde die u voor de timeout parameter kunt instellen, is 230 seconden. Als uw aangepaste vaardigheid niet consistent binnen 230 seconden kan worden uitgevoerd, kunt u overwegen om de batchSize aangepaste vaardigheid te verminderen, zodat deze minder documenten bevat die binnen één uitvoering moeten worden verwerkt. Als u de waarde al hebt ingesteld op batchSize 1, moet u de vaardigheid herschrijven om deze in minder dan 230 seconden uit te voeren of op een andere manier te splitsen in meerdere aangepaste vaardigheden, zodat de uitvoeringstijd voor elke aangepaste vaardigheid maximaal 230 seconden is. Raadpleeg de documentatie voor aangepaste vaardigheden voor meer informatie.

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

Het document is gelezen en verwerkt, maar de indexeerfunctie kan het niet toevoegen aan de zoekindex. Dit kan gebeuren vanwege:

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

Het document is gelezen en verwerkt door de indexeerfunctie, maar vanwege een niet-overeenkomende configuratie van de indexvelden en de gegevens die door de indexeerfunctie zijn geëxtraheerd en verwerkt, kan het niet worden toegevoegd aan de zoekindex. Dit kan gebeuren vanwege:

In al deze gevallen raadpleegt u Ondersteunde gegevenstypen en toewijzing van gegevenstypen voor indexeerfuncties om ervoor te zorgen dat u het indexschema correct bouwt en de juiste indexeerfunctieveldtoewijzingen hebt ingesteld. Het foutbericht bevat details waarmee de bron van de niet-overeenkomende gegevens kan worden bijgehouden.

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

Dit is van toepassing op SQL-tabellen en gebeurt meestal wanneer de sleutel is gedefinieerd als een samengestelde sleutel of wanneer de tabel een unieke geclusterde index heeft gedefinieerd (zoals in een SQL-index, niet als een Azure Search-index). De belangrijkste reden is dat het sleutelkenmerk wordt gewijzigd in een samengestelde primaire sleutel in een unieke geclusterde index. Zorg er in dat geval voor dat uw SQL-tabel geen unieke geclusterde index heeft of dat u het sleutelveld toe wijst aan een veld dat gegarandeerd geen dubbele waarden heeft.

Error: Could not process document within indexer max run time

Deze fout treedt op wanneer de indexeerfunctie het verwerken van één document niet kan voltooien vanuit de gegevensbron binnen de toegestane uitvoeringstijd. De maximale uitvoeringstijd is korter wanneer vaardigheden worden gebruikt. Wanneer deze fout optreedt, als u maxFailedItems hebt ingesteld op een andere waarde dan 0, wordt het document door de indexeerfunctie overgeslagen bij toekomstige uitvoeringen, zodat indexering kan worden voortgezet. Als u het zich niet kunt veroorloven om een document over te slaan of als u deze fout consistent ziet, kunt u overwegen documenten in kleinere documenten op te delen, zodat gedeeltelijke voortgang binnen één indexeerfunctie kan worden uitgevoerd.

Error: Could not project document

Deze fout treedt op wanneer de indexeerfunctie probeert gegevens te projecteren in een kennisarchief en er een fout is opgetreden bij de poging. Deze fout kan consistent en herstelbaar zijn, of het kan een tijdelijke fout zijn met de sink van de projectieuitvoer die u mogelijk moet wachten en opnieuw moet proberen om het probleem op te lossen. Hier volgt een set bekende foutstatussen en mogelijke oplossingen.

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

De uitvoering van vaardigheden is mislukt omdat de aanroep van Foundry Tools is beperkt. Deze foutklasse treedt meestal op wanneer er te veel vaardigheden parallel worden uitgevoerd. Als u de clientbibliotheek Microsoft.Search.Documents gebruikt om de indexeerfunctie uit te voeren, kunt u de SearchIndexingBufferedSender gebruiken om automatisch opnieuw te proberen bij mislukte stappen. Anders kunt u de indexeerfunctie opnieuw instellen en opnieuw uitvoeren.

Error: Expected IndexAction metadata

Een fout 'Verwachte IndexAction-metagegevens' betekent dat wanneer de indexeerfunctie heeft geprobeerd het document te lezen om te bepalen welke actie moet worden ondernomen, er geen bijbehorende metagegevens in het document zijn gevonden. Deze fout treedt meestal op wanneer de indexeerfunctie een aantekeningscache heeft toegevoegd of verwijderd zonder de indexeerfunctie opnieuw in te instellen. Om dit te verhelpen, moet u de indexeerfunctie opnieuw instellen en opnieuw uitvoeren.

Warning: Skill input was invalid

Er ontbreekt een invoer voor de vaardigheid, had het verkeerde type of was anderszins ongeldig. Mogelijk ziet u de volgende informatie:

• Could not execute skill

• Skill executed but may have unexpected results

Cognitieve vaardigheden hebben vereiste invoer en optionele invoer. De vaardigheid sleuteltermextractie heeft bijvoorbeeld twee vereiste invoerwaarden texten languageCodegeen optionele invoer. Aangepaste vaardigheidsinvoeren worden allemaal beschouwd als optionele invoeren.

Als noodzakelijke invoergegevens ontbreken of als de invoer niet van het juiste type is, wordt de functionaliteit overgeslagen en wordt er een waarschuwing gegenereerd. Overgeslagen vaardigheden genereren geen uitvoer. Als downstreamvaardigheden de uitvoer van de overgeslagen vaardigheid verbruiken, kunnen ze andere waarschuwingen genereren.

Als een optionele invoer ontbreekt, wordt de vaardigheid nog steeds uitgevoerd, maar kan dit onverwachte uitvoer opleveren vanwege de ontbrekende invoer.

In beide gevallen wordt deze waarschuwing veroorzaakt door de vorm van uw gegevens. Als u bijvoorbeeld een document hebt met informatie over personen met de velden firstName, middleNameen lastName, hebt u mogelijk enkele documenten waarvoor geen vermelding middleNameis. Als u middleName als invoer doorgeeft aan een vaardigheid in de pijplijn, mag het voorkomen dat deze vaardigheidsinvoer soms ontbreekt. U moet uw gegevens en scenario evalueren om te bepalen of er al dan niet actie is vereist als gevolg van deze waarschuwing.

Als u een standaardwaarde wilt opgeven voor een ontbrekende invoer, kunt u de voorwaardelijke vaardigheid gebruiken om een standaardwaarde te genereren en vervolgens de uitvoer van de voorwaardelijke vaardigheid te gebruiken als vaardigheidsinvoer.

{
    "@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.

Een of meer van de waarden die naar de optionele languageCode invoer van een downstream-skill worden doorgegeven, worden niet ondersteund. Dit kan gebeuren als u de uitvoer van languageDetectionSkill doorgeeft aan volgende vaardigheden en de uitvoer uit meer talen bestaat dan wordt ondersteund in deze downstreamvaardigheden.

Houd er rekening mee dat u ook een waarschuwing kunt krijgen die vergelijkbaar is met deze als er een ongeldige countryHint invoer wordt doorgegeven aan languageDetectionSkill. Als dat het geval is, controleert u of het veld dat u gebruikt uit uw gegevensbron voor die invoer geldige ISO 3166-1 alfa-2 landcodes bevat. Als sommige geldig zijn en sommige ongeldig zijn, gaat u verder met de volgende richtlijnen, maar vervangt u languageCode door countryHint en defaultLanguageCode door defaultCountryHint om aan te sluiten bij uw gebruikssituatie.

Als u weet dat uw gegevensset allemaal in één taal staat, moet u de LanguageDetectionSkill en de invoer van de languageCode vaardigheid verwijderen en in plaats daarvan de defaultLanguageCode vaardigheidsparameter voor die vaardigheid gebruiken, ervan uitgaande dat de taal wordt ondersteund voor die vaardigheid.

Als u weet dat uw gegevensset meerdere talen bevat en u de LanguageDetectionSkill en languageCode invoer nodig hebt, kunt u een ConditionalSkill toevoegen om de tekst te filteren met talen die niet worden ondersteund voordat u de tekst doorgeeft aan de downstream-vaardigheid. Hier volgt een voorbeeld van hoe dit eruit kan zien voor de EntityRecognitionSkill:

{
    "@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" } ]
}

Hier volgen enkele verwijzingen voor de momenteel ondersteunde talen voor elk van de vaardigheden die dit foutbericht kunnen produceren:

• Ondersteunde talen voor EntityRecognitionSkill
• Ondersteunde talen voor EntityLinkingSkill
• Ondersteunde talen voor KeyPhraseExtractionSkill
• Ondersteunde talen voor de taalherkenningsvaardigheid
• Ondersteunde talen voor PIIDetectionSkill
• Ondersteunde talen voor SentimentSkill
• Ondersteunde talen van Translator
• Ondersteunde talen voor Text SplitSkill : da, de, en, es, fi, fr, it, ko, pt

Warning: Skill input was truncated

Cognitieve vaardigheden beperken de lengte van tekst die tegelijkertijd kan worden geanalyseerd. Als de tekstinvoer de limiet overschrijdt, wordt de tekst afgekapt voordat deze wordt verrijkt. De vaardigheid wordt uitgevoerd, maar niet over al uw gegevens.

In het onderstaande voorbeeld LanguageDetectionSkill kan dit 'text' waarschuwingsveld worden geactiveerd als de invoer de tekenlimiet overschrijdt. Invoerlimieten vindt u in de referentiedocumentatie voor vaardigheden.

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

Als u ervoor wilt zorgen dat alle tekst wordt geanalyseerd, kunt u overwegen de vaardigheid Splitsen te gebruiken.

Warning: Web API skill response contains warnings

De indexer heeft de functie uitgevoerd in de functieset, maar het antwoord van het web API-verzoek geeft aan dat er waarschuwingen zijn. Bekijk de waarschuwingen om te begrijpen hoe uw gegevens worden beïnvloed en of verdere actie is vereist.

Warning: The current indexer configuration does not support incremental progress

Deze waarschuwing treedt alleen op voor Azure Cosmos DB-gegevensbronnen.

Incrementele voortgang tijdens het indexeren zorgt ervoor dat als de uitvoering van de indexeerder wordt onderbroken door tijdelijke fouten of een limiet aan de uitvoeringstijd, de indexeerder de volgende keer dat het wordt uitgevoerd, verder kan gaan vanaf het punt waar het was gebleven, in plaats van dat de volledige verzameling helemaal opnieuw moet worden geïndexeerd. Dit is vooral belangrijk bij het indexeren van grote verzamelingen.

De mogelijkheid om een niet-voltooide indexeringstaak te hervatten, is gebaseerd op het sorteren van documenten in de _ts kolom. De indexeerfunctie gebruikt de tijdstempel om te bepalen welk document het volgende moet worden opgehaald. Als de _ts-kolom ontbreekt of als de indexeerder niet kan bepalen of er een aangepaste query op deze kolom is geordend, begint de indexeerder vanaf het begin en ziet u deze waarschuwing.

Het is mogelijk dit gedrag te overschrijven, incrementele voortgang in te schakelen en deze waarschuwing te onderdrukken met behulp van de assumeOrderByHighWaterMarkColumn configuratie-eigenschap.

Zie Incrementele voortgang en aangepaste query's voor meer informatie.

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

De Table Storage-service heeft limieten voor hoe grote entiteitseigenschappen kunnen zijn. Tekenreeksen kunnen 32.000 tekens of minder bevatten. Als een rij met een tekenreekseigenschap langer dan 32.000 tekens wordt geprojecteerd, blijven alleen de eerste 32.000 tekens behouden. Vermijd het projecteren van rijen met tekenreekseigenschappen langer dan 32.000 tekens om dit probleem te omzeilen.

Warning: Truncated extracted text to X characters

Indexeerfuncties beperken hoeveel tekst uit elk document kan worden geëxtraheerd. Deze limiet is afhankelijk van de prijscategorie: 32.000 tekens voor gratis laag, 64.000 voor Basic, 4 miljoen voor Standard, 8 miljoen voor Standard S2 en 16 miljoen voor Standard S3. Tekst die is afgekapt, wordt niet geïndexeerd. Probeer documenten met grote hoeveelheden tekst op te splitsen in meerdere, kleinere documenten om deze waarschuwing te voorkomen.

Zie Indexeerlimieten voor meer informatie.

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

Uitvoerveldtoewijzingen die verwijzen naar niet-bestaande/null-gegevens, produceren waarschuwingen voor elk document en resulteren in een leeg indexveld. Als u dit probleem wilt omzeilen, controleert u de bronpaden voor de uitvoerveldtoewijzing op mogelijke typefouten of stelt u een standaardwaarde in met behulp van de vaardigheid Voorwaardelijk. Zie Uitvoerveldtoewijzing voor details.

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

Beleidsregels voor gegevenswijzigingsdetectie hebben specifieke vereisten voor de kolommen die ze gebruiken om wijzigingen te detecteren. Een van deze vereisten is dat deze kolom telkens wordt bijgewerkt wanneer het bronitem wordt gewijzigd. Een andere vereiste is dat de nieuwe waarde voor deze kolom groter is dan de vorige waarde. Sleutelkolommen voldoen niet aan deze vereiste omdat ze niet worden gewijzigd bij elke update. Als u dit probleem wilt omzeilen, selecteert u een andere kolom voor het wijzigingsdetectiebeleid.

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

De parseringsmodi van de indexeerfunctie moeten weten hoe tekst wordt gecodeerd voordat deze wordt geparseerd. De twee meest voorkomende manieren om tekst te coderen zijn UTF-16 en UTF-8. UTF-8 is een codering met variabele lengte waarbij elk teken tussen 1 byte en 4 bytes lang is. UTF-16 is een codering met vaste lengte waarbij elk teken 2 bytes lang is. UTF-16 heeft twee verschillende varianten, big endian en little endian. Tekstcodering wordt bepaald door een reeks bytes byte order mark vóór de tekst.

Als er geen bytevolgordemarkering aanwezig is, wordt ervan uitgegaan dat de tekst wordt gecodeerd als UTF-8.

Als u deze waarschuwing wilt omzeilen, bepaalt u wat de tekstcodering voor deze blob is en voegt u het juiste bytevolgordeteken toe.

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

Verzamelingen met Lazy indexeringsbeleid kunnen niet consistent worden opgevraagd, wat leidt tot vermiste gegevens in uw indexering. Als u deze waarschuwing wilt omzeilen, wijzigt u het indexeringsbeleid in Consistent.

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

Deze waarschuwing wordt doorgegeven vanuit de Taalservice van Foundry Tools. In sommige gevallen is het veilig om deze waarschuwing te negeren, bijvoorbeeld als de lange tekenreeks slechts een lange URL is. Houd er rekening mee dat wanneer een woord langer is dan 64 tekens, het wordt afgekapt tot 64 tekens, wat van invloed kan zijn op modelvoorspellingen.

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

Indexeerfuncties hebben limieten voor documentgrootte. Zorg ervoor dat de documenten in uw gegevensbron kleiner zijn dan de ondersteunde groottelimiet, zoals beschreven voor uw servicelaag.

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

Deze fout treedt meestal op in Azure SQL-indexeerfuncties wanneer het bronkolomtype dat wordt gebruikt dataChangeDetectionPolicy , niet overeenkomt met wat de indexeerfunctie verwacht, met name als convertHighWaterMarkToRowVersion dit is ingeschakeld.

Als de kolom die wordt gebruikt voor wijzigingsdetectie bijvoorbeeld van het type datetime is, maar de indexeerder een rowversion-type verwacht omdat convertHighWaterMarkToRowVersion is ingeschakeld, zal er een fout optreden.

Controleer het gegevenstype voor de 'High Water Mark'-kolom in de bron en werk de indexer-configuratie dienovereenkomstig bij. Nadat de indexeerfunctie is geverifieerd en bijgewerkt, stelt u deze opnieuw in en voert u deze opnieuw uit om de kolomwaarden te verwerken.

Error: Access denied to Virtual Network/Firewall rules

Deze fout treedt meestal op vanwege een van de volgende oorzaken:

• Firewallbeperkingen voor Azure-resources die door uw indexeerfunctie zijn vereist, afhankelijk van uw configuratie. Deze resources kunnen zijn: de gegevensbron, het Azure Storage-account (gebruikt voor foutopsporingssessies, incrementele verrijking of kennisarchief), De Azure-functie (gebruikt voor aangepaste vaardigheden van de web-API) of Microsoft Foundry-implementaties die worden gebruikt tijdens AI-verrijking.
• Configuraties van privé-eindpunten die de toegang van de indexeerfunctie tot deze resources blokkeren.

Zorg ervoor dat de indexeerfunctie toegang heeft tot uw installatieonderdelen door uw resourceconfiguraties te controleren om te bevestigen dat verkeer naar alle vereiste services is toegestaan:

• Instellingen voor firewall- en IP-beperking
• Gedeelde privékoppeling instellen

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

Deze fout treedt op wanneer de Azure AI Zoeken-indexeerfunctie niet kan worden geverifieerd met behulp van de opgegeven verbindingsreeks of problemen heeft met het openen van het opslagaccount om de referenties te verifiëren.

Error: Invalid AAD tenant

Dit bericht kan worden weergegeven wanneer een SharePoint in Microsoft 365 indexeerfunctie niet kan worden geverifieerd bij de Microsoft Entra tenant die eigenaar is van de SharePoint site. TenantId is optioneel in de SharePoint-gegevensbronverbindingsreeks, maar elke waarde die u opgeeft, moet de tenant-id (GUID) van Microsoft Entra voor die site zijn. Deze tenant is niet noodzakelijkerwijs de Microsoft Entra tenant die is gekoppeld aan uw zoekservice.

Gebruik de volgende richtlijnen om de fout op te lossen:

• Voor een cross-tenant SharePoint-verbinding moet u de Microsoft Entra tenant-ID van de SharePoint-site als TenantId opnemen in de verbindingsreeks.
• Voor een verbinding binnen dezelfde Microsoft Entra tenant moet u de tenant-id van de SharePoint site opnemen of de door het systeem toegewezen beheerde identiteit van de zoekservice inschakelen. Wanneer u weglaatTenantId, gebruikt de indexeerfunctie de Microsoft Entra resourcetenant die aan die identiteit is gekoppeld.
• Als noch een expliciete TenantId noch de resourcetenant beschikbaar is, meldt de indexeerfunctie: Ensure service managed identity is enabled for your service, or TenantId is specified in your verbindingsreeks.

Een waarde met een onjuiste opmaak die geen GUID is, kan leiden tot een fout wanneer u de gegevensbron maakt of bijwerkt. Een goed opgemaakte ID voor de verkeerde Microsoft Entra-tenant kan de validatie van de gegevensbron doorstaan, maar mislukken wanneer het indexeerprogramma zich probeert te verifiëren. Voor uitvoeringsfouten gaat u naar de zoekservice in de Azure-portal, selecteert uZoekbeheerindexeerfuncties>, selecteert u de indexeerfunctie en controleert u de uitvoeringsgeschiedenis en statusdetails.

Zie De SharePoint-indexeerfunctie in Microsoft 365 configureren voor indelingen van verbindingsreeksen en instructies voor het vinden van de Microsoft Entra-tenant-id van de SharePoint-site.

Error: Error detecting index schema from data source

De Azure Portal-ervaring die wordt gebruikt om de indexeerfunctie te configureren, kan geen schemagegevens ophalen uit de gegevensbron. Dit kan gebeuren vanwege tijdelijke connectiviteitsproblemen of netwerkconfiguratiebeperkingen die verhinderen dat Azure AI Zoeken toegang heeft tot de bron.