Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Note
Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.
Nadat u een index heeft gemaakt, kunt u het Azure-portaal gebruiken om toegang te krijgen tot de statistieken en definitie ervan of om deze te verwijderen uit uw zoekservice.
Nadat u een index heeft gemaakt, kunt u de Azure AI Zoeken REST-API's gebruiken om toegang te krijgen tot de statistieken en de definitie, of om deze te verwijderen uit uw zoekservice.
Nadat u een index hebt maken, u kunt de Azure SDK gebruiken voor .NET, Java, JavaScript of Python om de bijbehorende statistieken en definities te openen of te verwijderen uit uw zoekservice.
In dit artikel wordt beschreven hoe u een index beheert zonder dat dit van invloed is op de inhoud ervan. Zie Update of herbouw een index in Azure AI Zoeken voor hulp bij het wijzigen van een indexdefinitie.
Beperkingen
De prijscategorie van uw zoekservice bepaalt het maximum aantal en de grootte van uw indexen, velden en documenten. Zie Servicelimieten in Azure AI Zoeken voor meer informatie.
Anders gelden de volgende beperkingen voor indexbeheer:
U kunt een index niet offline halen voor onderhoud. Indexen zijn altijd beschikbaar voor zoekbewerkingen.
U kunt een index niet rechtstreeks kopiƫren of dupliceren binnen of in zoekservices. U kunt echter het voorbeeld voor back-up en herstel gebruiken voor .NET of Python om vergelijkbare functionaliteit te bereiken.
Alle indexen weergeven
Alle indexen weergeven:
Ga naar uw zoekservice in de Azure portal.
Selecteerzoekbeheerindexen> in het linkerdeelvenster.
De indexen worden standaard gesorteerd op naam in oplopende volgorde. U kunt sorteren op naam, aantal documenten, het quotumgebruik van vectorindexen of de totale opslaggrootte door de bijbehorende kolomkop te selecteren.
Gebruik Indexen - Lijst (REST API) om alle indexen in uw zoekservice op te halen.
### List all indexes
GET https://[service name].search.windows.net/indexes?api-version=[api version]
Content-Type: application/json
api-key: [admin key]
Gebruik de gewenste Azure SDK om alle indexen op uw zoekservice op te halen.
De Azure SDK voor .NET biedt GetIndexesAsync voor deze taak.
// Create a SearchIndexClient
var endpoint = new Uri("[service endpoint]");
var credential = new AzureKeyCredential("[admin key]");
var indexClient = new SearchIndexClient(endpoint, credential);
// List all indexes
await foreach (var index in indexClient.GetIndexesAsync())
{
Console.WriteLine(index.Name);
}
Statistieken van een index weergeven
Op de indexpagina bevat de portal de volgende statistieken:
- Aantal documenten in de index.
- Opslagruimte die wordt gebruikt door de index.
- Vectoropslagruimte die door de index wordt gebruikt.
- Maximale opslagruimte voor elke index in uw zoekservice, die afhankelijk is van uw prijscategorie. Deze waarde vertegenwoordigt niet de totale opslag die momenteel beschikbaar is voor de index.
Gebruik Indexen - Statistieken ophalen (REST API) om het aantal documenten, het opslaggebruik en het vectoropslaggebruik van een index op te halen.
### Get index statistics
GET https://[service name].search.windows.net/indexes/[index name]/stats?api-version=[api version]
Content-Type: application/json
api-key: [admin key]
Gebruik de gewenste Azure SDK om het aantal documenten, het opslaggebruik en het vectoropslaggebruik van een index op te halen.
De Azure SDK voor .NET biedt GetIndexStatisticsAsync voor deze taak.
// Create a SearchIndexClient
var endpoint = new Uri("[service endpoint]");
var credential = new AzureKeyCredential("[admin key]");
var indexClient = new SearchIndexClient(endpoint, credential);
// Get index statistics
var statsResponse = await indexClient.GetIndexStatisticsAsync("[index name]");
var stats = statsResponse.Value;
Console.WriteLine($"Number of documents: {stats.DocumentCount:N0}");
Console.WriteLine($"Storage consumed by index: {stats.StorageSize:N0} bytes");
Console.WriteLine($"Storage consumed by vectors: {stats.VectorIndexSize:N0} bytes");
De definitie van een index weergeven
Elke index wordt gedefinieerd door velden en optionele onderdelen die de zoekmogelijkheden verbeteren, zoals analyses, normalizers, tokenizers en synoniemenkaarten. Deze definitie bepaalt de structuur en het gedrag van de index tijdens het indexeren en opvragen.
Gebruik Indexen - Ophalen (REST API) om de JSON-definitie van een index op te halen.
### Get index definition
GET https://[service name].search.windows.net/indexes/[index name]?api-version=[api version]
Content-Type: application/json
api-key: [admin key]
Gebruik de gewenste Azure SDK om de JSON-definitie van een index op te halen.
De Azure SDK voor .NET biedt GetIndexAsync voor deze taak.
// Create a SearchIndexClient
var endpoint = new Uri("[service endpoint]");
var credential = new AzureKeyCredential("[admin key]");
var indexClient = new SearchIndexClient(endpoint, credential);
// Get index definition
var index = await indexClient.GetIndexAsync("[index name]");
string indexJson = JsonSerializer.Serialize(index.Value, new JsonSerializerOptions { WriteIndented = true });
Console.WriteLine(indexJson);
Een index verwijderen
Waarschuwing
U kunt een indexverwijdering niet ongedaan maken. Voordat u verdergaat, moet u ervoor zorgen dat u de index en de bijbehorende documenten definitief uit uw zoekservice wilt verwijderen.
Selecteer Verwijderen op de indexpagina om het verwijderingsproces te starten.
In de portal wordt u gevraagd om de verwijdering te bevestigen. Nadat u Verwijderen hebt geselecteerd, controleert u uw meldingen om te bevestigen dat de verwijdering is geslaagd.
Gebruik Indexen - Verwijderen (REST API) om een index permanent te verwijderen.
### Delete an index
DELETE https://[service name].search.windows.net/indexes/[index name]?api-version=[api version]
Content-Type: application/json
api-key: [admin key]
Als de index succesvol is verwijderd, ontvangt u een HTTP/1.1 204 No Content-antwoord.
Gebruik de gewenste Azure SDK om een index permanent te verwijderen.
De Azure SDK voor .NET biedt DeleteIndexAsync voor deze taak.
// Create a SearchIndexClient
var endpoint = new Uri("[service endpoint]");
var credential = new AzureKeyCredential("[admin key]");
var indexClient = new SearchIndexClient(endpoint, credential);
// Delete the index
await indexClient.DeleteIndexAsync("[index name]");
Console.WriteLine("Index deleted successfully.");