Gegevens laden in een zoekindex in Azure AI Search

In dit artikel wordt uitgelegd hoe u inhoud in een vooraf gedefinieerde zoekindex importeert, vernieuwt en beheert. In Azure AI Search wordt eerst een zoekindex gemaakt, met gegevensimport als een tweede stap. De uitzondering is de wizard Gegevens importeren en indexeerpijplijnen, waarmee een index in één werkstroom wordt gemaakt en geladen.

Een zoekservice importeert en indexeert tekst en vectoren in JSON, die wordt gebruikt in zoekopdrachten in volledige tekst, vectorzoekopdrachten, hybride zoekopdrachten en kennisanalysescenario's. Tekstinhoud kan worden verkregen uit alfanumerieke velden in de externe gegevensbron, metagegevens die nuttig zijn in zoekscenario's of verrijkte inhoud die is gemaakt door een vaardighedenset (vaardigheden kunnen tekstuele beschrijvingen extraheren of afleiden uit afbeeldingen en ongestructureerde inhoud). Vectorinhoud wordt gevectoriseerd met behulp van een extern insluitmodel of geïntegreerde vectorisatie (preview).

Zodra gegevens zijn geïndexeerd, worden de fysieke gegevensstructuren van de index vergrendeld. Zie Een index neerzetten en opnieuw samenstellen voor hulp bij wat wel en niet kan worden gewijzigd.

Indexering is geen achtergrondproces. Een zoekservice zorgt voor een balans tussen indexering en queryworkloads, maar als de querylatentie te hoog is, kunt u capaciteit toevoegen of perioden met een lage queryactiviteit identificeren voor het laden van een index.

Documenten laden

Een zoekservice accepteert JSON-documenten die voldoen aan het indexschema.

U kunt deze documenten zelf voorbereiden, maar als inhoud zich in een ondersteunde gegevensbron bevindt, kan het uitvoeren van een indexeerfunctie of de wizard Gegevens importeren het ophalen van documenten, JSON-serialisatie en indexering automatiseren.

Azure-portal

Gebruik in Azure Portal de wizards Gegevens importeren om indexen in een naadloze werkstroom te maken en te laden. Als u een bestaande index wilt laden, kiest u een alternatieve benadering.

1. Meld u met uw Azure-account aan bij Azure Portal.

2. Zoek uw zoekservice en selecteer op de pagina Overzicht gegevens importeren of Gegevens importeren en vectoriseren op de opdrachtbalk om een zoekindex te maken en te vullen. U kunt deze koppelingen volgen om de werkstroom te bekijken: Quickstart: Een Azure AI Search-index en quickstart: Geïntegreerde vectorisatie (preview).

   

Als indexeerfuncties al zijn gedefinieerd, kunt u een indexeerfunctie opnieuw instellen en uitvoeren vanuit Azure Portal. Dit is handig als u velden incrementeel toevoegt. Opnieuw instellen zorgt ervoor dat de indexeerfunctie opnieuw wordt gestart, zodat alle velden uit alle brondocumenten worden opgehaald.

REST

Documenten - Index (REST) is de methode waarmee u gegevens in een zoekindex kunt importeren. De @search.action parameter bepaalt of documenten volledig of gedeeltelijk worden toegevoegd in termen van nieuwe of vervangende waarden voor specifieke velden.

Quickstart: Tekst zoeken met REST legt de stappen uit. Het volgende voorbeeld is een gewijzigde versie van het voorbeeld. De waarde is ingekort en de eerste HotelId-waarde is gewijzigd om te voorkomen dat een bestaand document wordt overschreven.

1. Formuleer een POST-aanroep die de indexnaam, het eindpunt docs/index en een aanvraagbody bevat die de @search.action parameter bevat.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2023-11-01
   Content-Type: application/json   
   api-key: [admin key] 
   {
       "value": [
       {
       "@search.action": "upload",
       "HotelId": "1111",
       "HotelName": "Secret Point Motel",
       "Description": "The hotel is ideally located on the main commercial artery of the city in the heart of New York. A few minutes away is Time's Square and the historic centre of the city, as well as other places of interest that make New York one of America's most attractive and cosmopolitan cities.",
       "Category": "Boutique",
       "Tags": [ "pool", "air conditioning", "concierge" ]
       },
       {
       "@search.action": "mergeOrUpload",
       "HotelId": "2",
       "HotelName": "Twin Dome Motel",
       "Description": "This is description is replacing the original one for this hotel. New and changed values overwrite the previous ones. In a comma-delimited list like Tags, be sure to provide the full list because there is no merging of values within the field itself.",
       "Category": "Boutique",
       "Tags": [ "pool", "free wifi", "concierge", "my first new tag", "my second new tag" ]
       }
     ]
   }
   

2. Zoek de documenten op die u zojuist hebt toegevoegd als validatiestap:

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2023-11-01
   

Wanneer de documentsleutel of -id nieuw is, wordt null de waarde voor een veld dat niet is opgegeven in het document. Voor acties in een bestaand document vervangen bijgewerkte waarden de vorige waarden. Velden die niet zijn opgegeven in een 'samenvoeging' of 'mergeUpload' blijven intact in de zoekindex.

.NET SDK (C#)

Azure AI Search ondersteunt de volgende API's voor eenvoudige en bulksgewijs uploaden van documenten naar een index:

• IndexDocumentsAsync (Azure SDK voor .NET)
• SearchIndexingBufferedSender

Er zijn verschillende voorbeelden die indexering illustreren in de context van eenvoudige en grootschalige indexering:

• 'Een index laden' legt de basisstappen uit.

• Voorbeelden van Azure.Search.Documents - Documenten indexeren van het Azure SDK-team voegt SearchIndexingBufferedSender toe.

• Zelfstudie: Indexeer batchindexering van gegevensparen met teststrategieën voor het bepalen van een optimale grootte.

Zwevende documenten verwijderen

Azure AI Search ondersteunt bewerkingen op documentniveau, zodat u een specifiek document afzonderlijk kunt opzoeken, bijwerken en verwijderen. In het volgende voorbeeld ziet u hoe u een document verwijdert. In een zoekservice zijn documenten niet gerelateerd, zodat het verwijderen van documenten geen invloed heeft op de rest van de index.

1. Bepaal welk veld de documentsleutel is. In de portal kunt u de velden van elke index weergeven. Documentsleutels zijn tekenreeksvelden en worden aangeduid met een sleutelpictogram om ze gemakkelijker te herkennen.

2. Controleer de waarden van het documentsleutelveld: search=*&$select=HotelId. Een eenvoudige tekenreeks is eenvoudig, maar als de index gebruikmaakt van een met base 64 gecodeerd veld of als zoekdocumenten zijn gegenereerd op basis van een parsingMode instelling, werkt u mogelijk met waarden waarmee u niet bekend bent.

3. Zoek het document op om de waarde van de document-id te controleren en de inhoud ervan te controleren voordat u het verwijdert. Geef de sleutel- of document-id op in de aanvraag. In de volgende voorbeelden ziet u een eenvoudige tekenreeks voor de voorbeeldindex Hotels en een met base 64 gecodeerde tekenreeks voor de metadata_storage_path sleutel van de cog-search-demo-index.

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2023-11-01
   

   GET https://[service name].search.windows.net/indexes/cog-search-demo/docs/aHR0cHM6Ly9oZWlkaWJsb2JzdG9yYWdlMi5ibG9iLmNvcmUud2luZG93cy5uZXQvY29nLXNlYXJjaC1kZW1vL2d1dGhyaWUuanBn0?api-version=2023-11-01
   

4. Verwijder het document om het te verwijderen uit de zoekindex.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2023-11-01
   Content-Type: application/json   
   api-key: [admin key] 
   {  
     "value": [  
       {  
         "@search.action": "delete",  
         "id": "1111"  
       }  
     ]  
   }
   

Zie ook

• Overzicht van zoekindexen
• Overzicht van gegevensimport
• Overzicht van wizard Gegevens importeren
• Overzicht van indexeerfuncties