Delen via

Indexeerfuncties, vaardigheden of documenten uitvoeren of opnieuw instellen

In Azure AI Search zijn er verschillende manieren om een indexeerfunctie uit te voeren:

In dit artikel wordt uitgelegd hoe u indexeerfuncties op aanvraag uitvoert, met en zonder opnieuw instellen. Ook worden de uitvoering, duur en gelijktijdigheid van de indexeerfunctie beschreven.

Hoe indexeerfuncties verbinding maken met Azure-resources

Indexeerfuncties zijn een van de weinige subsystemen die uitgaande aanroepen naar andere Azure-resources maken. Afhankelijk van de externe gegevensbron kunt u sleutels of rollen gebruiken om de verbinding te verifiëren.

In termen van Azure-rollen hebben indexeerfuncties geen afzonderlijke identiteiten: een verbinding van de zoekmachine naar een andere Azure-resource wordt gemaakt met behulp van de door het systeem of de gebruiker toegewezen beheerde identiteit van een zoekservice, plus een roltoewijzing voor de Azure-doelresource. Als de indexeerfunctie verbinding maakt met een Azure-resource in een virtueel netwerk, moet u een gedeelde privékoppeling voor die verbinding maken.

Uitvoering van indexeerfunctie

Een zoekservice voert één indexeertaak per zoekeenheid uit. Elke zoekservice begint met één zoekeenheid, maar elke nieuwe partitie of replica verhoogt de zoekeenheden van uw service. U kunt het aantal zoekeenheden controleren in de sectie Essential van Azure Portal van de pagina Overzicht . Als u gelijktijdige verwerking nodig hebt, moet u ervoor zorgen dat uw zoekeenheden voldoende replica's bevatten. Indexers worden niet op de achtergrond uitgevoerd, dus u kunt meer querythrottling ervaren dan normaal als de service onder druk staat.

In de volgende schermopname ziet u het aantal zoekeenheden, waarmee wordt bepaald hoeveel indexeerfuncties tegelijk kunnen worden uitgevoerd.

Schermopname van de sectie Essentials van de overzichtspagina met zoekeenheden.

Zodra de uitvoering van de indexeerfunctie is gestart, kunt u deze niet onderbreken of stoppen. De uitvoering van de indexeerfunctie stopt wanneer er geen documenten meer zijn om te laden of te vernieuwen, of wanneer de maximale uitvoeringstijdslimiet is bereikt.

U kunt meerdere indexeerfuncties tegelijk uitvoeren, ervan uitgaande dat er voldoende capaciteit is, maar elke indexeerfunctie zelf is één exemplaar. Als u een nieuw exemplaar start terwijl de indexeerfunctie al in uitvoering is, wordt deze fout gegenereerd: "Failed to run indexer "<indexer name>" error: "Another indexer invocation is currently in progress; concurrent invocations are not allowed."

Uitvoeringsomgeving voor indexeerfunctie

Een indexeertaak wordt uitgevoerd in een beheerde uitvoeringsomgeving. Er zijn momenteel twee omgevingen:

  • Een privé-uitvoeringsomgeving wordt uitgevoerd op zoekclusters die specifiek zijn voor uw zoekservice.

  • Een multitenant-omgeving heeft inhoudsprocessors die zonder extra kosten worden beheerd en beveiligd door Microsoft. Deze omgeving wordt gebruikt voor het offloaden van rekenintensieve verwerking, waardoor servicespecifieke resources beschikbaar blijven voor routinebewerkingen. Waar mogelijk worden de meeste vaardigheden uitgevoerd in een multi-tenant omgeving. Dit is de standaardinstelling.

    Rekenintensieve verwerking verwijst naar vaardighedensets die worden uitgevoerd op inhoudsprocessors en indexeerfuncties die een groot aantal documenten of documenten van grote grootte verwerken. Verwerking van niet-vaardigheidsgerelateerde processen op de processors voor multitenant-inhoud wordt bepaald door heuristiek en systeeminformatie en valt niet onder controle van de klant.

U kunt voorkomen dat de multitenantomgeving wordt gebruikt bij Standard2 of hoger diensten door een indexeerder en vaardighedenset exclusief aan uw zoekclusters te koppelen. Stel de executionEnvironment parameter in de definitie van de indexeerfunctie in om altijd een indexeerfunctie uit te voeren in de privé-uitvoeringsomgeving.

IP-firewalls blokkeren de omgeving met meerdere tenants, dus als u een firewall hebt, maakt u een regel waarmee multitenantprocessorverbindingen zijn toegestaan.

De limieten voor indexeerfuncties variëren voor elke omgeving:

Workload Maximale duur Maximum aantal taken Uitvoeringsomgeving
Privé-uitvoering 24 uur Eén indexeertaak per zoekeenheid1. Indexering wordt niet op de achtergrond uitgevoerd. In plaats daarvan worden met de zoekservice alle indexeringstaken in balans met lopende query's en objectbeheeracties (zoals het maken of bijwerken van indexen). Bij het uitvoeren van indexeerfuncties kunt u enige vertraging bij query's verwachten als de volumes die geïndexeerd worden groot zijn.
Multitenant 2 uur 2 Onbepaald 3 Omdat het cluster voor inhoudsverwerking meerdere tenants is, worden inhoudsprocessors toegevoegd om aan de vraag te voldoen. Als u een vertraging ondervindt in on-demand of geplande uitvoering, komt dit waarschijnlijk doordat het systeem processors toevoegt of wacht tot er een beschikbaar is.

1 Zoekeenheden kunnen flexibele combinaties van partities en replica's zijn, maar indexeertaken zijn niet gekoppeld aan een of meer. Met andere woorden, als u 12 eenheden hebt, kunt u 12 indexeerfuncties tegelijk uitvoeren in privé-uitvoering, ongeacht hoe de zoekeenheden worden geïmplementeerd.

2 Als er meer dan twee uur nodig zijn om alle gegevens te verwerken, schakelt u wijzigingsdetectie in en plant u dat de indexeerfunctie met intervallen van vijf minuten wordt uitgevoerd om de indexering snel te hervatten als deze stopt vanwege een time-out. Zie Indexering van een grote gegevensset voor meer strategieën.

3 "Onbepaald" betekent dat de limiet niet wordt gekwantificeerd door het aantal taken. Sommige werkbelastingen, zoals het verwerken van vaardighedensets, kunnen parallel worden uitgevoerd, wat kan leiden tot veel taken, ook al is er slechts één indexeerfunctie betrokken. Hoewel de omgeving geen beperkingen oplegt, zijn er nog steeds indexeerlimieten voor uw zoekservice van toepassing.

Uitvoeren zonder opnieuw instellen

Een Run Indexer-bewerking detecteert en verwerkt alleen wat nodig is om de zoekindex te synchroniseren met wijzigingen in de onderliggende gegevensbron. Incrementele indexering begint met het zoeken naar een interne hoogwatermarkering om het laatst bijgewerkte zoekdocument te vinden. Dit wordt het startpunt voor het uitvoeren van de indexeerfunctie voor nieuwe en bijgewerkte documenten in de gegevensbron.

Wijzigingsdetectie is essentieel voor het bepalen wat er nieuw of bijgewerkt is in de gegevensbron. Indexeerfuncties gebruiken de mogelijkheden voor wijzigingsdetectie van de onderliggende gegevensbron om te bepalen wat er nieuw of bijgewerkt is in de gegevensbron.

  • Azure Storage heeft ingebouwde wijzigingsdetectie via de eigenschap LastModified.

  • Andere gegevensbronnen, zoals Azure SQL of Azure Cosmos DB, moeten worden geconfigureerd voor wijzigingsdetectie voordat de indexeerfunctie nieuwe en bijgewerkte rijen kan lezen.

Als de onderliggende inhoud ongewijzigd is, heeft een uitvoeringsbewerking geen effect. In dit geval geeft 0\0 de uitvoeringsgeschiedenis van de indexeerfunctie documenten aan die zijn verwerkt.

U moet de indexeerfunctie opnieuw instellen, zoals wordt uitgelegd in de volgende sectie, om deze volledig opnieuw te verwerken.

Indexeerfuncties opnieuw instellen

Na de eerste uitvoering houdt een indexeerder bij welke zoekdocumenten worden geïndexeerd via een interne hoogwatermark. De markering wordt nooit weergegeven, maar intern weet de indexeerfunctie waar deze voor het laatst is gestopt.

Als u een index geheel of gedeeltelijk opnieuw wilt bouwen, gebruikt u Reset-API's die beschikbaar zijn op afnemende niveaus in de objecthiërarchie:

Volg na het opnieuw instellen de opdracht Uitvoeren om nieuwe en bestaande documenten opnieuw te verwerken. Zwevende zoekdocumenten zonder tegenhanger in de gegevensbron kunnen niet worden verwijderd via opnieuw instellen/uitvoeren. Als u documenten wilt verwijderen, raadpleegt u in plaats daarvan Documenten - Index .

Note

Tabellen kunnen niet leeg zijn. Als u TRUNCATE TABLE gebruikt om rijen te wissen, worden de bijbehorende zoekdocumenten niet verwijderd door het opnieuw instellen en opnieuw uitvoeren van de indexeerfunctie. Om verweesde zoekdocumenten te verwijderen, moet u ze indexeren met een verwijderactie.

Indexeerfuncties opnieuw instellen en uitvoeren

De reset wist het hoogwatermerk. Alle documenten in de zoekindex worden gemarkeerd voor volledig overschrijven, zonder inline-updates of samenvoeging in bestaande inhoud. Voor indexeerders met een vaardigheidsset en verrijkingscaching wordt de index ook impliciet opnieuw ingesteld, evenals de vaardigheidsset.

De werkelijke hoeveelheid werk vindt plaats wanneer u een reset volgt met de opdracht Uitvoeren:

  • Alle nieuwe documenten die de onderliggende bron hebben gevonden, worden toegevoegd aan de zoekindex.
  • Alle documenten in zowel de gegevensbron als de zoekindex worden overschreven in de zoekindex.
  • Verrijkte inhoud die is gemaakt op basis van vaardigheden, wordt opnieuw opgebouwd. De verrijkingscache, als deze is ingeschakeld, wordt vernieuwd.

Zoals eerder vermeld, is opnieuw instellen een passieve bewerking: u moet een Run-aanvraag volgen om de index opnieuw te bouwen.

Reset-/uitvoeringsbewerkingen zijn van toepassing op een zoekindex of een kennisarchief, op specifieke documenten of projecties en op verrijkingen in de cache als een reset expliciet of impliciet vaardigheden bevat.

Opnieuw instellen is ook van toepassing op het maken en bijwerken van bewerkingen. Het zal niet leiden tot het verwijderen of opschonen van verweesde documenten in de zoekindex. Zie Documenten - Index voor meer informatie over het verwijderen van documenten.

Nadat u een indexeerfunctie opnieuw hebt ingesteld, kunt u de actie niet ongedaan maken.

  1. Meld u aan bij Azure Portal en open de zoekservicepagina.

  2. Selecteer op de pagina Overzicht het tabblad Indexeerfuncties .

  3. Selecteer een indexeerfunctie.

  4. Selecteer de opdracht Opnieuw instellen en selecteer vervolgens Ja om de actie te bevestigen.

  5. Vernieuw de pagina om de status weer te geven. U kunt het item selecteren om de details ervan weer te geven.

  6. Selecteer Uitvoeren om de verwerking van de indexeerfunctie te starten of wacht op de volgende geplande uitvoering.

    Schermopname van de portalpagina voor de uitvoering van de indexeerfunctie, met de opdracht Opnieuw instellen gemarkeerd.

Hoe vaardigheden opnieuw instellen (preview)

De verzoek Vaardigheden opnieuw instellen verwerkt selectief een of meer vaardigheden tijdens de volgende indexeerbewerking. Voor indexeerfuncties met vaardighedensets kunt u afzonderlijke vaardigheden opnieuw instellen om alleen die vaardigheid opnieuw te verwerken en eventuele downstreamvaardigheden die afhankelijk zijn van de uitvoer. De verrijkingscache, als u deze hebt ingeschakeld, wordt ook vernieuwd.

Voor indexeerfuncties waarvoor caching is ingeschakeld, kunt u expliciet verwerking aanvragen voor vaardigheidsupdates die de indexeerfunctie niet kan detecteren. Als u bijvoorbeeld externe wijzigingen aanbrengt, zoals revisies in een aangepaste vaardigheid, kunt u deze API gebruiken om de vaardigheid opnieuw uit te voeren. Uitvoer, zoals een kennisarchief of zoekindex, wordt vernieuwd met herbruikbare gegevens uit de cache en nieuwe inhoud volgens de bijgewerkte vaardigheid.

We raden de nieuwste preview-API aan.

POST /skillsets/[skillset name]/resetskills?api-version=2025-11-01-preview
{
    "skillNames" : [
        "#1",
        "#5",
        "#6"
    ]
}

U kunt afzonderlijke vaardigheden opgeven, zoals aangegeven in het bovenstaande voorbeeld, maar als een van deze vaardigheden uitvoer vereist van niet-vermelde vaardigheden (#2 tot en met #4), worden niet-vermelde vaardigheden uitgevoerd, tenzij de cache de benodigde informatie kan verstrekken. Om dit waar te maken, mogen verrijkingen in de cache voor vaardigheden #2 tot en met #4 niet afhankelijk zijn van #1 (vermeld voor opnieuw instellen).

Als er geen vaardigheden zijn opgegeven, wordt de volledige vaardighedenset uitgevoerd en als caching is ingeschakeld, wordt de cache ook vernieuwd.

Vergeet niet om op te volgen met Run Indexer om de werkelijke verwerking aan te roepen.

Documenten opnieuw instellen (preview)

De indexeerfuncties - Documenten opnieuw instellen (preview) accepteert een lijst met documentsleutels, zodat u specifieke documenten kunt vernieuwen. Indien opgegeven, worden de parameters voor opnieuw instellen de enige determinant van wat wordt verwerkt, ongeacht andere wijzigingen in de onderliggende gegevens. Als er bijvoorbeeld 20 blobs zijn toegevoegd of bijgewerkt sinds de laatste indexeerfunctie, maar u slechts één document opnieuw instelt, wordt alleen dat document verwerkt.

Op documentbasis worden alle velden in het zoekdocument vernieuwd met waarden en metagegevens uit de gegevensbron. U kunt niet kiezen welke velden u wilt vernieuwen.

Als de gegevensbron Azure Data Lake Storage (ADLS) Gen2 is en de blobs zijn gekoppeld aan metagegevens van machtigingen, worden deze machtigingen ook opnieuw opgenomen in de zoekindex als machtigingen in de onderliggende gegevens veranderen. Zie ACL- en RBAC-bereik opnieuw indexeren met ADLS Gen2-indexeerfuncties voor meer informatie.

Als het document is verrijkt via een vaardighedenset en gegevens in de cache heeft, wordt de vaardighedenset alleen aangeroepen voor alleen de opgegeven documenten en wordt de cache bijgewerkt voor de opnieuw verwerkte documenten.

Wanneer u deze API voor het eerst test, kunnen de volgende API's u helpen het gedrag te valideren en te testen. We raden de nieuwste preview-API aan.

  1. Roep Indexer - Status ophalen aan met een preview-API-versie om de resetstatus en uitvoeringsstatus te controleren. U vindt informatie over de aanvraag voor opnieuw instellen aan het einde van het statusantwoord.

  2. Indexeerfuncties aanroepen : stel Docs opnieuw in met een preview-API-versie om op te geven welke documenten moeten worden verwerkt.

    POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2025-11-01-preview
{
    "documentKeys" : [
        "1001",
        "4452"
    ]
}

    • De API accepteert twee typen document-id's als invoer: documentsleutels die documenten uniek identificeren in een zoekindex en document-id's voor gegevensbronnen waarmee documenten in een gegevensbron uniek worden geïdentificeerd. De hoofdtekst moet een lijst met documentsleutels of een lijst met document-id's van de gegevensbron bevatten waarnaar de indexeerfunctie zoekt in de gegevensbron. Als u de API aanroept, worden de documentsleutels of gegevensbrondocument-id's toegevoegd die opnieuw moeten worden ingesteld op de metagegevens van de indexeerfunctie. Bij de volgende geplande of on-demand uitvoering van de indexeerfunctie verwerkt de indexer alleen de gereset documenten.

    • Als u sleutels van documenten gebruikt om documenten opnieuw in te stellen en uw documentsleutels worden verwezen in een indexeringsveldmapping, gebruikt de indexeerder veldmapping om het juiste veld in de onderliggende gegevensbron te vinden.

    • De documentsleutels in de aanvraag zijn waarden uit de zoekindex. Deze kunnen afwijken van de bijbehorende velden in de gegevensbron. Als u niet zeker weet wat de sleutelwaarde is, stuurt u een query om de waarde te retourneren. U kunt select gebruiken om alleen het document-sleutelveld te retourneren.

    • Voor blobs die worden geparseerd in meerdere zoekdocumenten (waarbij parsingMode is ingesteld op jsonLines of jsonArrays of delimitedText), wordt de documentsleutel gegenereerd door de indexeerfunctie en is deze mogelijk onbekend voor u. In dit scenario retourneert een query voor de documentsleutel de juiste waarde.

    • Als u wilt dat de indexeerfunctie stopt met het verwerken van opnieuw instellen van documenten, kunt u 'documentKeys' of 'datasourceDocumentIds' instellen op een lege lijst []. Dit resulteert in dat de indexer de standaard indexering hervat op basis van het hoogwatermerk. Ongeldige sleutels of sleutels die niet bestaan, worden genegeerd.

  3. Roep Run Indexer (elke API-versie) aan om de documenten te verwerken die u hebt opgegeven. Alleen die specifieke documenten worden geïndexeerd.

  4. Roep Run Indexer een tweede keer aan om te verwerken vanaf de laatste bovengrens.

  5. Roep Zoekdocumenten aan om te controleren op bijgewerkte waarden en om documentsleutels te retourneren als u niet zeker weet wat de waarde is. Gebruik "select": "<field names>" deze optie als u wilt beperken welke velden in het antwoord worden weergegeven.

De lijst met documentsleutels overschrijven

Bij herhaaldelijk aanroepen van de Reset Documents API met verschillende sleutels, worden de nieuwe sleutels toegevoegd aan de lijst van documentensleutels die worden gereset. Als u de API aanroept met de overwrite parameter die is ingesteld op true, wordt de huidige lijst overschreven met de nieuwe:

POST https://[service name].search.windows.net/indexers/[indexer name]/resetdocs?api-version=2025-11-01-preview
{
    "documentKeys" : [
        "200",
        "630"
    ],
    "overwrite": true
}

Indexeerfuncties opnieuw synchroniseren (preview)

Indexeerfuncties opnieuw synchroniseren is een preview-REST API waarmee een gedeeltelijke herindex van alle documenten wordt uitgevoerd. Een indexeerfunctie wordt beschouwd als gesynchroniseerd met de gegevensbron wanneer specifieke velden van alle documenten in de doelindex consistent zijn met de gegevens in de gegevensbron. Normaal gesproken bereikt een indexeerfunctie synchronisatie na een geslaagde eerste uitvoering. Als een document uit de gegevensbron wordt verwijderd, blijft de indexeerfunctie gesynchroniseerd volgens deze definitie. Tijdens de volgende uitvoering van de indexeerfunctie wordt het bijbehorende document in de doelindex echter verwijderd als bijhouden van verwijderen is ingeschakeld.

Als een document wordt gewijzigd in de gegevensbron, wordt de indexeerfunctie niet gesynchroniseerd. Over het algemeen zullen wijzigingsvolgmechanismen de indexeerder opnieuw synchroniseren tijdens de volgende uitvoering. Als u bijvoorbeeld in Azure Storage een blob wijzigt, wordt de laatste wijzigingstijd bijgewerkt, zodat deze opnieuw kan worden geïndexeerd in de volgende indexeerfunctie, omdat de bijgewerkte tijd de bovengrens overschrijdt die is ingesteld door de vorige uitvoering.

Het wijzigen van de toegangsbeheerlijsten (ACL's) van een blob voor bepaalde gegevensbronnen, zoals ADLS Gen2, verandert daarentegen niet de laatste wijzigingstijd, waardoor het bijhouden van wijzigingen niet effectief is als ACL's moeten worden opgenomen. Daarom wordt de gewijzigde blob niet opnieuw geïndexeerd in de volgende uitvoering, omdat alleen documenten die zijn gewijzigd nadat de laatste bovengrens is verwerkt, opnieuw worden geïndexeerd.

Hoewel het gebruik van 'opnieuw instellen' of 'documenten opnieuw instellen' dit probleem kan verhelpen, kan 'opnieuw instellen' tijdrovend en inefficiënt zijn voor grote gegevenssets, en 'documenten opnieuw instellen' vereist het identificeren van de documentsleutel van de blob die is bedoeld voor update.

"Resync Indexers biedt een efficiënt en handig alternatief." Gebruikers plaatsen de indexeerfunctie in de modus Voor opnieuw synchroniseren en geven de inhoud op die opnieuw moet worden gesynchroniseerd door de API voor opnieuw synchroniseren aan te roepen. In de volgende uitvoering inspecteert de indexeerfunctie alleen relevante delen van gegevens in de bron en voorkomt u onnodige verwerking die niet is gerelateerd aan de opgegeven gegevens. Ook wordt een query uitgevoerd op de bestaande documenten in de doelindex en worden alleen de documenten bijgewerkt die verschillen vertonen tussen de gegevensbron en de doelindex. Nadat de hersynchronisatie is uitgevoerd, wordt de indexer gesynchroniseerd en hersteld naar de normale modus voor volgende uitvoeringen.

Indexeerfuncties opnieuw synchroniseren en uitvoeren

  1. Indexeerfuncties aanroepen: hersynchronisatie met een preview-API-versie om op te geven welke inhoud opnieuw moet worden gesynchroniseerd.

    POST https://[service name].search.windows.net/indexers/[indexer name]/resync?api-version=2025-11-01-preview
{
    "options" : [
        "permissions"
    ]
}
    • Het veld options is vereist. Momenteel is permissionsde enige ondersteunde optie. Dat wil gezegd, alleen machtigingsfiltervelden in de doelindex worden bijgewerkt.

  2. Roep Run Indexer (elke API-versie) aan om de indexeerfunctie opnieuw te synchroniseren.

  3. Roep Run Indexer een tweede keer aan om te verwerken vanaf de laatste bovengrens.

Status 'currentState' opnieuw instellen controleren

Volg deze stappen om de status van het opnieuw instellen te controleren en te zien welke documentsleutels in de wachtrij staan voor verwerking.

  1. Roep Indexeerstatus ophalen aan met een preview-API.

    De preview-API retourneert de currentState sectie aan het einde van het antwoord.

    "currentState": {
    "mode": "indexingResetDocs",
    "allDocsInitialTrackingState": "{\"LastFullEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"LastAttemptedEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"NameHighWaterMark\":null}",
    "allDocsFinalTrackingState": "{\"LastFullEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"LastAttemptedEnumerationStartTime\":\"2021-02-06T19:02:07.0323764+00:00\",\"NameHighWaterMark\":null}",
    "resetDocsInitialTrackingState": null,
    "resetDocsFinalTrackingState": null,
    "resyncInitialTrackingState": null,
    "resyncFinalTrackingState": null,
    "resetDocumentKeys": [
        "200",
        "630"
    ]
}

  2. Controleer de 'modus':

    Voor het opnieuw instellen van vaardigheden moet de "modus" worden ingesteld op indexingAllDocs (omdat mogelijk alle documenten worden beïnvloed, in termen van de velden die zijn ingevuld via AI-verrijking).

    Voor Indexeerders opnieuw synchroniseren moet de modus worden ingesteld op indexingResync. De indexeerfunctie controleert alle documenten en richt zich op geïnteresseerde gegevens in gegevensbron en geïnteresseerde velden in de doelindex.

    Als u documenten opnieuw wilt instellen, moet de modus worden ingesteld op indexingResetDocs. De indexeerfunctie behoudt deze status totdat alle documentsleutels die zijn opgegeven in de oproep voor het opnieuw instellen van documenten, zijn verwerkt. Gedurende deze periode worden er geen andere indexeerwerkzaamheden uitgevoerd terwijl de bewerking vordert. Als u alle documenten in de lijst met documentsleutels wilt vinden, moet elk document worden doorzocht om te vinden en te matchen op de sleutel. Dit kan even duren als de dataset groot is. Als een blobcontainer honderden blobs bevat en de documenten die u opnieuw wilt instellen zich aan het einde bevinden, vindt de indexeerfunctie de overeenkomende blobs pas nadat alle andere blobs zijn gecontroleerd.

  3. Nadat de documenten opnieuw zijn verwerkt, voert u "Indexeerstatus ophalen" opnieuw uit. De indexeerfunctie keert terug naar de indexingAllDocs modus en verwerkt nieuwe of bijgewerkte documenten tijdens de volgende uitvoering.

Controleer het runtimequotum van de indexeerfunctie voor S3 HD-zoekservices

Van toepassing op zoekservices in de prijscategorie Standard 3 High Density (S3 HD).

Om u te helpen de actieve tijden van de indexeerfunctie ten opzichte van het venster van 24 uur te bewaken, retourneert u servicestatistieken ophalen en de status van de indexeerfunctie nu meer informatie in het antwoord.

Cumulatief runtimequotum bijhouden

Houd het cumulatieve runtimegebruik van de indexeerfunctie van een zoekservice bij en bepaal hoeveel runtimequotum er nog is binnen de huidige periode van 24 uur.

Verzend een GET-aanvraag naar de resourceprovider van de zoekservice. Zie Verbinding maken met een zoekservice voor hulp bij het instellen van een REST-client en het ophalen van een toegangstoken.

GET {{search-endpoint}}/servicestats?api-version=2025-11-01-preview 
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Antwoorden zijn indexersRuntime eigenschappen, met begin- en eindtijden, gebruikte seconden, resterende seconden en cumulatieve runtime binnen de afgelopen 24 uur.

Runtimequotum van indexeerfunctie bijhouden

Dezelfde informatie retourneren voor één indexeerfunctie.

GET {{search-endpoint}}/indexers/hotels-sample-indexer/search.status?api-version=2025-11-01-preview 
  Content-Type: application/json
  Authorization: Bearer {{accessToken}}

Antwoorden bevatten een runtime eigenschappen, met begin- en eindtijden, gebruikte seconden en resterende seconden.

Volgende stappen

Reset-API's worden gebruikt om het bereik van de volgende uitvoering van de indexeerfunctie te informeren. Voor de werkelijke verwerking moet u een indexeerfunctie op aanvraag aanroepen of een geplande taak toestaan om het werk te voltooien. Nadat de uitvoering is voltooid, keert de indexeerfunctie terug naar de normale verwerking, ongeacht of dat volgens een planning of verwerking op aanvraag is.

Nadat u indexeertaken opnieuw hebt ingesteld en opnieuw hebt uitgevoerd, kunt u de status van de zoekservice controleren of gedetailleerde informatie verkrijgen via resourcelogboekregistratie.

  • Last updated on