Gegevens indexeren uit Azure Blob Storage

De blob-indexeerfunctie importeert inhoud uit Azure Blob Storage en maakt het doorzoekbaar in Azure AI Zoeken. De indexeerfunctie ontvangt blobs in één container als invoer. De uitvoer is een zoekindex waarin doorzoekbare inhoud en metagegevens in afzonderlijke velden worden opgeslagen.

In dit artikel worden de REST API's van de Search Service gebruikt om te laten zien hoe u de indexeerfunctie configureert en uitvoert. U kunt echter ook het volgende gebruiken:

• Een Azure SDK-pakket (elke versie)
• Wizard Gegevens Importeren in Azure Portal

Vereiste voorwaarden

• Azure Blob Storage, Standaardprestaties (algemeen gebruik v2).

• Toegangslagen zijn dynamisch, statisch, koud en archief. Indexeerfuncties kunnen blobs ophalen op hete, koele en koude toegangslagen.

• Blobs die tekstinhoud en metagegevens leveren. Als blobs binaire inhoud of ongestructureerde tekst bevatten, kunt u OVERWEGEN AI-verrijking toe te voegen voor afbeeldings- en natuurlijke taalverwerking. Blob-inhoud kan de indexeerlimieten voor uw prijscategorie niet overschrijden.

  De limieten voor de blobindexeerfunctie hebben betrekking op de maximale blobgrootte en het aantal tekens dat Azure AI Zoeken uit een blob haalt. Als u een vaardighedenset gebruikt, wordt de invoer- of servicelimiet van elke vaardigheid afzonderlijk toegepast na het kraken van documenten.

• Een ondersteunde netwerkconfiguratie en gegevenstoegang. U hebt minimaal leesmachtigingen nodig in Azure Storage. Een opslag verbindingsreeks met een toegangssleutel geeft u leestoegang tot opslaginhoud. Als u in plaats daarvan Microsoft Entra-aanmeldingen en -rollen gebruikt, moet u ervoor zorgen dat de beheerde identiteit van de zoekservice machtigingen heeft voor opslagblobgegevenslezer.

  Standaard accepteren zowel zoekopdrachten als opslag aanvragen van openbare IP-adressen. Als de netwerkbeveiliging geen onmiddellijk probleem is, kunt u blobgegevens indexeren met behulp van alleen de verbindingsreeks- en leesmachtigingen. Wanneer u klaar bent om netwerkbeveiligingen toe te voegen, raadpleegt u de indexer voor toegang tot inhoud die wordt beveiligd door Azure-netwerkbeveiligingsfuncties voor hulp bij gegevenstoegang.

• Gebruik een REST-client om REST-aanroepen te formuleren die vergelijkbaar zijn met de aanroepen die in dit artikel worden weergegeven.

Ondersteunde taken

U kunt deze indexeerfunctie gebruiken voor de volgende taken:

• Gegevensindexering en incrementele indexering: de indexeerfunctie kan bestanden en bijbehorende metagegevens indexeren uit blobcontainers en -mappen. Er worden nieuwe en bijgewerkte bestanden en metagegevens gedetecteerd via ingebouwde wijzigingsdetectie. U kunt gegevensvernieuwing configureren volgens een planning of op aanvraag.

• Verwijderingsdetectie: de indexeerfunctie kan verwijderingen detecteren via systeemeigen voorlopig verwijderen of via aangepaste metagegevens.

• Toegepaste AI via vaardighedensets: De indexeerfunctie biedt volledige ondersteuning voor vaardighedensets. Deze ondersteuning omvat belangrijke functies zoals geïntegreerde vectorisatie, waarmee gegevenssegmentering en insluiting worden toegevoegd.

• Parseringsmodi: de indexeerfunctie ondersteunt JSON-parseringsmodi als u JSON-matrices of regels wilt parseren in afzonderlijke zoekdocumenten. Het biedt ook ondersteuning voor de parseermodus van Markdown.

• Compatibiliteit met andere functies: De indexeerfunctie werkt naadloos samen met andere indexeerfuncties, zoals foutopsporingssessies, indexeercache voor incrementele verrijkingen (preview) en kennisarchief.

Ondersteunde documentindelingen

De blob-indexeerfunctie kan tekst extraheren uit de volgende documentindelingen:

• CSV (zie CSV-blobs indexeren)
• EML
• EPUB
• GZ
• HTML
• JSON (zie JSON-blobs indexeren)
• KML (XML voor geografische weergaven)
• Markdown
• Microsoft Office-indelingen: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (e-mailberichten van Outlook), XML (zowel 2003 als 2006 WORD XML)
• Open Document-indelingen: ODT, ODS, ODP
• PDF
• Tekstbestanden zonder opmaak (zie ook Indexering van tekst zonder opmaak)
• RTF
• XML
• ZIP-bestand

Bepalen welke blobs moeten worden geïndexeerd

Voordat u indexering instelt, controleert u de brongegevens om te bepalen of u wijzigingen moet aanbrengen. Een indexeerfunctie kan inhoud van één container tegelijk indexeren. Standaard verwerkt de indexeerfunctie alle blobs in de container. U hebt verschillende opties voor meer selectieve verwerking:

• Plaats blobs in een virtuele map. Een definitie van een indexeerfunctiegegevensbron bevat een query parameter die een virtuele map kan overnemen. Als u een virtuele map opgeeft, indexeert de indexeerfunctie alleen die blobs in de map.

• Blobs opnemen of uitsluiten op bestandstype. De lijst met ondersteunde documentindelingen kan u helpen bepalen welke blobs moeten worden uitgesloten. U kunt bijvoorbeeld afbeeldings- of audiobestanden uitsluiten die geen doorzoekbare tekst bieden. U kunt deze mogelijkheid beheren via configuratie-instellingen in de indexeerfunctie.

• Willekeurige blobs opnemen of uitsluiten. Als u een specifieke blob wilt overslaan, voegt u de volgende metagegevenseigenschappen en -waarden toe aan blobs in Azure Blob Storage. Wanneer een indexeerfunctie deze eigenschap tegenkomt, wordt de blob of de inhoud ervan in de indexeringsuitvoering overgeslagen.

  Naam van de eigenschap	Eigenschapswaarde	Explanation
  AzureSearch_Skip	true	Hiermee geeft u de blob-indexeerfunctie de opdracht om de blob volledig over te slaan. De indexeerfunctie probeert geen metagegevens of inhoud te extraheren. Deze eigenschap is handig wanneer een bepaalde blob herhaaldelijk mislukt en het indexeringsproces onderbreekt.
  AzureSearch_SkipContent	true	De indexeerfunctie slaat inhoud over en extraheert alleen de metagegevens. Deze eigenschap is gelijk aan de "dataToExtract": "allMetadata" instelling die wordt beschreven in de configuratie-instellingen, maar is beperkt tot een bepaalde blob.

Als u geen insluitings- of uitsluitingscriteria instelt, rapporteert de indexeerfunctie een niet-in aanmerking komende blob als een fout en gaat verder. Als er voldoende fouten optreden, kan de verwerking stoppen. U kunt fouttolerantie opgeven in de configuratie-instellingen van de indexeerfunctie.

Een indexeerfunctie maakt doorgaans één zoekdocument per blob, waarbij de tekstinhoud en metagegevens worden vastgelegd als doorzoekbare velden in een index. Als blobs hele bestanden zijn, kunt u ze mogelijk parseren in meerdere zoekdocumenten. U kunt bijvoorbeeld rijen in een CSV-bestand parseren om één zoekdocument per rij te maken.

Een samengesteld of ingesloten document (zoals een ZIP-archief, een Word-document met ingesloten Outlook-e-mail met bijlagen of een . MSG-bestand met bijlagen) wordt ook geïndexeerd als één document. Bijvoorbeeld alle afbeeldingen die zijn geëxtraheerd uit de bijlagen van een . MSG-bestand wordt geretourneerd in het normalized_images veld. Als u afbeeldingen hebt, kunt u overwegen AI-verrijking toe te voegen om meer zoekfunctionaliteit uit die inhoud te halen.

De indexeerfunctie extraheert de tekstuele inhoud van een document in een tekenreeksveld met de naam content. U kunt ook standaard en door de gebruiker gedefinieerde metagegevens extraheren.

Blobmetagegevens indexeren

U kunt blobmetagegevens naast inhoud indexeren. De indexeerfunctie extraheert metagegevenseigenschappen en slaat deze op in indexvelden, wat handig is voor het maken van filters en query's.

Definieer velden in uw zoekindex voor de metagegevenseigenschappen die u wilt vastleggen. U hoeft niet elke beschikbare standaard- of aangepaste metagegevenseigenschap te definiëren. Leg gewoon de eigenschappen vast die u nodig hebt voor uw toepassing.

Op dit moment biedt deze indexeerfunctie geen ondersteuning voor het indexeren van blobindextags.

Eigenschappen van standaardblobmetagegevens

Definieer voor standaardblobmetagegevens velden in uw index met dezelfde onderstrepingstekens. Zie Zoekvelden toevoegen aan een index voor stapsgewijze velddefinitievoorbeelden.

Zie dataToExtract, inclusief de instelling waarmee wordt bepaald welke metagegevens moeten worden opgehaald.

De indexeerfunctie herkent en kan deze standaardmetagegevenseigenschappen toewijzen als u de bijbehorende velden in uw index definieert:

• metadata_storage_name (Edm.String) is de bestandsnaam van de blob. Als u bijvoorbeeld een blob /my-container/my-folder/subfolder/resume.pdfhebt, is resume.pdfde waarde van dit veld.

• metadata_storage_path (Edm.String) is de volledige URI van de blob, inclusief het opslagaccount. Bijvoorbeeld: https://myaccount.blob.core.windows.net/my-container/my-folder/subfolder/resume.pdf. Gebruik deze eigenschap om blob-URL's op te nemen in zoekresultaten voor navigatie of bronvermelding.

• metadata_storage_content_type (Edm.String) is het inhoudstype dat is opgegeven door de code die u hebt gebruikt om de blob te uploaden. Bijvoorbeeld: application/octet-stream.

• metadata_storage_last_modified (Edm.DateTimeOffset) is de laatst gewijzigde tijdstempel voor de blob. Azure AI Zoeken deze tijdstempel gebruikt om gewijzigde blobs te identificeren en te voorkomen dat alles opnieuw wordt geïndexeerde na de eerste indexering.

• metadata_storage_size (Edm.Int64) is de grootte van de blob in bytes.

• metadata_storage_content_md5 (Edm.String) is de MD5-hash van de blob-inhoud, indien beschikbaar.

• metadata_storage_sas_token (Edm.String) is een tijdelijk SAS-token dat aangepaste vaardigheden kunnen gebruiken om toegang te krijgen tot de blob. Sla dit token niet op voor later gebruik, omdat het mogelijk verloopt.

Aangepaste en inhoudsspecifieke metagegevens

Voor aangepaste of door de gebruiker gedefinieerde blobmetagegevens definieert u een veld met exact dezelfde naam als de metagegevenssleutel van de blob. Als uw blobs bijvoorbeeld een metagegevenssleutel Sensitivity met waarde Highhebben, definieert u een veld met de naam Sensitivity van het type Edm.String in uw index.

U kunt ook metagegevenseigenschappen vertegenwoordigen die specifiek zijn voor de documentindeling van de blobs die u indexeert. Zie eigenschappen voor metagegevens van inhoud voor meer informatie.

De gegevensbron definiëren

De definitie van de gegevensbron geeft de gegevens op die moeten worden geïndexeerde, referenties en beleidsregels voor het identificeren van wijzigingen in de gegevens. Een gegevensbron wordt gedefinieerd als een onafhankelijke resource, zodat deze kan worden gebruikt door meerdere indexeerfuncties.

1. Een gegevensbron maken of bijwerken om de definitie ervan in te stellen:

   {
       "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. Stel type in op azureblob (vereist).

3. Stel credentials in op een Azure Storage-verbindingstekenreeks. In de volgende sectie worden de ondersteunde indelingen beschreven.

4. Stel container in voor de blobcontainer en gebruik query om eventuele submappen op te geven.

U kunt ook beleidsregels voor voorlopig verwijderen opnemen in een gegevensbrondefinitie als u wilt dat de indexeerfunctie een zoekdocument verwijdert wanneer het brondocument wordt gemarkeerd voor verwijdering.

Ondersteunde referenties en verbindingsreeksen

Indexeerfuncties kunnen verbinding maken met een blobcontainer met behulp van de volgende verbindingen.

Zoekvelden toevoegen aan een index

Voeg in een zoekindex velden toe om de inhoud en metagegevens van uw Azure-blobs te accepteren.

1. Een index maken of bijwerken om zoekvelden te definiëren waarmee blobinhoud en metagegevens worden opgeslagen:

   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. Maak een documentsleutelveld ("key": true). Voor blob-inhoud zijn de beste kandidaten metagegevenseigenschappen.

   • metadata_storage_path (standaard) is het volledige pad naar het object of bestand. Het sleutelveld (ID in dit voorbeeld) wordt gevuld met waarden uit metadata_storage_path omdat dit de standaardwaarde is.

   • metadata_storage_name is alleen bruikbaar als namen uniek zijn. Als u dit veld als sleutel wilt gebruiken, verplaats "key": true naar de definitie van dit veld.

   • Een aangepaste metagegevenseigenschap die u toevoegt aan blobs. Deze optie vereist dat uw blobuploadproces die metagegevenseigenschap toevoegt aan alle blobs. Omdat de sleutel een vereiste eigenschap is, kunnen blobs die een waarde missen, niet worden geïndexeerd. Als u een aangepaste metagegevenseigenschap als sleutel gebruikt, moet u geen wijzigingen aanbrengen in die eigenschap. Indexeerfuncties voegen dubbele documenten toe voor dezelfde blob als de sleuteleigenschap wordt gewijzigd.

   Metagegevenseigenschappen bevatten vaak tekens, zoals / en -, die ongeldig zijn voor documentsleutels. De indexeerder codeert echter automatisch de belangrijke metadata-eigenschap, zonder dat er configuratie of veldtoewijzing is vereist.

3. Voeg een content veld toe om geëxtraheerde tekst uit elk bestand op te slaan via de content eigenschap van de blob. U hoeft deze naam niet te gebruiken, maar door deze te gebruiken, kunt u gebruikmaken van impliciete veldtoewijzingen.

4. Voeg velden toe voor standaardmetagegevenseigenschappen. De indexeerfunctie kan aangepaste metagegevenseigenschappen, standaardmetagegevenseigenschappen en inhoudsspecifieke metagegevenseigenschappen lezen.

De blobindexeerfunctie configureren en uitvoeren

Nadat u de index en gegevensbron hebt gemaakt, maakt u de indexeerfunctie. De configuratie van de indexeerfunctie geeft de invoer, parameters en eigenschappen op waarmee runtimegedrag wordt bepaald. U kunt ook opgeven welke delen van een blob u wilt indexeren.

1. Maak of werk een indexeerfunctie bij door deze een naam te geven en te verwijzen naar de gegevensbron en doelindex:

   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. Stel batchSize in als de standaardwaarde (10 documenten) de beschikbare resources onderbenut of overbelast. Standaard batchgrootten zijn gegevensbronspecifiek. Blob-indexering stelt de batchgrootte in op 10 documenten in de herkenning van de grotere gemiddelde documentgrootte.

3. Bepaal onder configuration welke blobs worden geïndexeerd op basis van bestandstype of laat het niet opgegeven voor het ophalen van alle blobs.

   Geef indexedFileNameExtensions een door komma's gescheiden lijst met bestandsextensies op (met een punt aan het begin). Doe hetzelfde om excludedFileNameExtensions aan te geven welke extensies de indexeerfunctie moet overslaan. Als dezelfde extensie zich in beide lijsten bevindt, sluit de indexeerfunctie deze uit van indexering.

4. configuration Stel onder dataToExtractin om te bepalen welke onderdelen van de blobs worden geïndexeerd:

   • contentAndMetadata geeft aan dat de indexeerfunctie alle metagegevens en tekstuele inhoud indexeert die uit de blob is geëxtraheerd. Dit is de standaardwaarde.

   • storageMetadata geeft aan dat de indexeerfunctie alleen de standaard-blobeigenschappen en door de gebruiker opgegeven metagegevens indexeert.

   • allMetadata geeft aan dat de indexeerfunctie inhoud uit de blob haalt en indexeert, en dat standaard-blobeigenschappen en metagegevens voor gevonden inhoudstypen worden geïndexeerd.

   • Zie Blob-metagegevens indexeren voor een volledige lijst met beschikbare standaardmetagegevenseigenschappen en de bijbehorende veldtypen.

5. Stel in configurationparsingMode in. De standaardparseermodus is één zoekdocument per blob. Als blobs tekst zonder opmaak zijn, kunt u beter presteren door de parsingmethode te wijzigen naar tekst zonder opmaak. Als u gedetailleerdere parsering nodig hebt waarmee blobs worden toegewezen aan meerdere zoekdocumenten, geeft u een andere modus op. Een-op-veel-parsering wordt ondersteund voor blobs die bestaan uit:

   • JSON-documenten
   • CSV-bestanden

6. Geef veldtoewijzingen op als er verschillen zijn in veldnaam of -type, of als u meerdere versies van een bronveld in de zoekindex nodig hebt.

   Bij het indexeren van blobs kunt u veldtoewijzingen vaak weglaten omdat de indexeerfunctie ingebouwde ondersteuning heeft voor het toewijzen van de content eigenschappen en metagegevens aan velden met vergelijkbare namen en getypte velden in een index. Voor eigenschappen van metagegevens vervangt de indexeerfunctie automatisch afbreekstreepjes door onderstrepingstekens - in de zoekindex.

7. Zie Een indexeerfunctie maken voor meer informatie over andere eigenschappen. Zie REST API voor de volledige lijst met parameterbeschrijvingen.

Een indexeerfunctie wordt automatisch uitgevoerd wanneer deze wordt gemaakt. U kunt deze actie voorkomen door disabled op waarheid in te stellen. Als u de uitvoering van de indexeerfunctie wilt beheren, voert u een indexeerfunctie op aanvraag uit of plaatst u deze in een schema.

Gegevens van meerdere Azure Blob-containers indexeren naar één index

Houd er rekening mee dat een indexeerfunctie alleen gegevens uit één container kan indexeren. Als u gegevens uit meerdere containers wilt indexeren en deze wilt samenvoegen in één AI Search-index, configureert u meerdere indexeerfuncties die allemaal naar dezelfde index verwijzen. Houd rekening met het maximum aantal indexeerfuncties dat beschikbaar is per SKU.

U kunt bijvoorbeeld twee indexeerfuncties gebruiken om gegevens op te halen uit twee verschillende gegevensbronnen met de naam my-blob-datasource1 en my-blob-datasource2. Elke gegevensbron verwijst naar een afzonderlijke Azure Blob-container, maar beide rechtstreeks naar dezelfde index met de naam my-search-index.

Voorbeeld van definitie van eerste indexeerfunctie:

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" : [ ]
}

Tweede indexeerfunctiedefinitie die parallel wordt uitgevoerd:

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" : [ ]
}

De status van de indexeerfunctie controleren

Als u de status en uitvoeringsgeschiedenis van de indexeerfunctie wilt controleren, verzendt u een get-indexeerstatusaanvraag :

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

Het antwoord bevat de status en het aantal verwerkte items. Het moet er ongeveer uitzien als in het volgende voorbeeld:

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

De uitvoeringsgeschiedenis bevat maximaal 50 van de laatst voltooide uitvoeringen. De vermeldingen worden in omgekeerde chronologische volgorde gesorteerd, dus de meest recente uitvoering komt als eerste.

Troubleshooting

Gebruik deze sectie om ontbrekende metagegevenswaarden en veelvoorkomende blobindexeringsfouten vast te stellen.

Metagegevensvelden zijn null in zoekresultaten

Als u null- of lege waarden ziet voor metagegevensvelden in de zoekresultaten, gebruikt u deze controlelijst:

1. Controleer of het veld bestaat in het indexschema: Controleer of u een veld hebt gedefinieerd voor elke metagegevenseigenschap die u wilt vastleggen. Voer een GET-aanvraag uit op uw index om te bevestigen dat het veld aanwezig is.

2. Gebruik de juiste veldnaam: Voor standaard-blobeigenschappen gebruikt u de onderstrepingstekennaam, zoals metadata_storage_path in plaats van metadata-storage-path. Voor aangepaste metagegevens moet de veldnaam exact overeenkomen met de metagegevenssleutel van de blob.

3. Controleer of de indexeerfunctie juist is dataToExtract ingesteld:

   • contentAndMetadata (standaard) extraheert zowel inhoud als standaard/aangepaste metagegevens.
   • storageMetadata extraheert alleen standaardblobeigenschappen en aangepaste metagegevens.
   • allMetadata extraheert standaardeigenschappen plus inhoudstypespecifieke metagegevens.

   Controleer de configuratie van de indexeerfunctie om ervoor te zorgen dat de instelling overeenkomt met uw intentie.

4. Voer de indexeerfunctie opnieuw uit na schema-updates: Als u een nieuw veld aan uw index hebt toegevoegd, voert u de indexeerfunctie opnieuw uit zodat documenten worden verwerkt op basis van het bijgewerkte schema. Bestaande documenten moeten mogelijk opnieuw worden verwerkt voordat het nieuwe veld wordt ingevuld.

5. Controleer de uitvoeringsgeschiedenis van de indexeerfunctie: Ga naar de indexeerfunctie in de Azure-portal of gebruik De status van de indexeerfunctie (REST API) ophalen om uitvoeringsdetails en eventuele foutberichten weer te geven.

Fouten met indexeerfuncties en niet-ondersteunde inhoudstypen

De blob-indexeerfunctie wordt standaard gestopt zodra er een blob met een niet-ondersteund inhoudstype wordt weergegeven, zoals een audiobestand. U kunt de excludedFileNameExtensions parameter gebruiken om bepaalde inhoudstypen over te slaan.

Als u wilt dat indexering wordt voortgezet wanneer sommige documenten mislukken, past u de volgende parameters aan en onderzoekt u de afzonderlijke documenten later. Zie richtlijnen voor probleemoplossing voor de indexeerfunctie en fouten en waarschuwingen van de indexeerfunctie voor meer informatie.

Wanneer er fouten optreden, bepalen vijf indexeerparameters het antwoord van de indexeerfunctie:

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

Verwante inhoud

• Detectie en verwijdering van wijzigingen
• Grote gegevenssets indexeren
• Toegang voor indexeerders tot inhoud die wordt beveiligd door Azure-netwerkbeveiligingsfuncties