Az Azure AI Keresés index kezelése

Note

Azure AI Keresés a Azure portálon, REST API-kon és Azure SDK-k keresztül érhető el. Emellett a Foundry IQ-t is támogatja, amely a vállalati tartalmakat újrafelhasználható, engedélytudatos tudásbázisokká alakítja át az Microsoft Foundry portálon található ügynökök számára.

Miután létrehozott egy indexet, a Azure portál használatával hozzáférhet a statisztikáihoz és definíciójához, vagy eltávolíthatja azt a keresési szolgáltatásból.

Miután létrehozott egy indexet a Azure AI Keresés REST API-k használatával hozzáférhet a statisztikáihoz és definíciójához, vagy eltávolíthatja azt a keresési szolgáltatásból.

Miután létrehozott egy indexet, a Azure SDK .NET, Java, JavaScript vagy Python esetében használhatja a statisztikáinak és definícióinak eléréséhez, illetve a keresési szolgáltatásból való eltávolításához.

Ez a cikk azt ismerteti, hogyan kezelheti az indexet anélkül, hogy az hatással van a tartalmára. Az indexdefiníciók módosításáról a A Azure AI Keresés indexek feltöltése vagy újraépítése című témakörben talál útmutatást.

Korlátozások

A keresési szolgáltatás tarifacsomagja határozza meg az indexek, mezők és dokumentumok maximális számát és méretét. További információ: Szolgáltatások korlátai Azure AI Keresés.

Ellenkező esetben a következő korlátozások vonatkoznak az indexkezelésre:

Karbantartás céljából nem lehet offline állapotba helyezni az indexet. Az indexek mindig elérhetők keresési műveletekhez.
Nem másolhat vagy duplikálhat közvetlenül egy indexet a keresési szolgáltatásokon belül vagy a keresési szolgáltatások között. A biztonsági mentési és visszaállítási mintát azonban használhatja .NET vagy Python hasonló funkciók eléréséhez.

Az összes index megtekintése

Az összes index megtekintése:

Nyissa meg a keresőszolgáltatást a Azure portálon.
A bal oldali panelen válassza a Kereséskezelési>indexek lehetőséget.

Alapértelmezés szerint az indexek név szerint növekvő sorrendben vannak rendezve. A megfelelő oszlopfejléc kiválasztásával rendezheti a név, a dokumentumszám, a vektorindex kvótahasználata vagy a teljes tárterület mérete szerint.

Az Indexek – Lista (REST API) használatával lekérheti a keresési szolgáltatás összes indexét.

### List all indexes
GET https://[service name].search.windows.net/indexes?api-version=[api version]
    Content-Type: application/json
    api-key: [admin key]

Használja a preferált Azure SDK-t a keresési szolgáltatás összes indexének lekérdezéséhez.

A .NET Azure SDK GetIndexesAsync biztosít ehhez a feladathoz.

// 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);
}

A Java-hoz készült Azure SDK biztosítja ezt a feladatot a SearchIndexAsyncClient osztályban .

// Create a SearchIndexAsyncClient
String endpoint = "[service endpoint]";
String adminKey = "[admin key]";
SearchIndexAsyncClient searchIndexAsyncClient = new SearchIndexClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(adminKey))
    .buildAsyncClient();

// List all indexes
searchIndexAsyncClient.listIndexes()
    .subscribe(
        index -> System.out.println(index.getName())
    );

A JavaScripthez készült Azure SDK a listIndexes osztályban biztosít ehhez a feladathoz.

// Create a SearchIndexClient
const endpoint = "[service endpoint]";
const adminKey = "[admin key]";
const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
);

// List all indexes
(async () => {
    for await (const index of client.listIndexes()) {
        console.log(index.name);
    }
})();

A Python Azure SDK list_indexes a SearchIndexClient osztályt biztosítja ehhez a feladathoz.

# Create a SearchIndexClient
endpoint = "[service endpoint]"
admin_key = AzureKeyCredential("[admin key]")
client = SearchIndexClient(endpoint=endpoint, credential=admin_key)

# List all indexes
for index in client.list_indexes():
    print(index.name)

Index statisztikáinak megtekintése

Az indexlapon a portál a következő statisztikákat nyújtja:

Az indexben lévő dokumentumok száma.
Az index által használt tárterület.
Az index által használt vektoros tárterület.
A keresési szolgáltatás minden indexének maximális tárterülete, amely a tarifacsomagtól függ. Ez az érték nem az index számára jelenleg elérhető teljes tárterületet jelöli.

Indexek használata – Statisztikák lekérése (REST API) az index dokumentumszámának, tárhasználatának és vektoros tárterület-használatának lekéréséhez.

### 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]

Az előnyben részesített Azure SDK használatával lekérheti egy index dokumentumszámát, tárterület-használatát és vektoros tárterület-használatát.

A .NET Azure SDK GetIndexStatisticsAsync biztosít ehhez a feladathoz.

// 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");

A Java-hoz készült Azure SDK biztosítja ezt a feladatot a SearchIndexAsyncClient osztályban .

// Create a SearchIndexAsyncClient
String endpoint = "[service endpoint]";
String adminKey = "[admin key]";
SearchIndexAsyncClient searchIndexAsyncClient = new SearchIndexClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(adminKey))
    .buildAsyncClient();

// Get index statistics
SearchIndexStatistics stats = searchIndexAsyncClient.getIndexStatistics("[index name]").block();
System.out.println("Number of documents: " + stats.getDocumentCount());
System.out.println("Storage consumed by index: " + stats.getStorageSize() + " bytes");
System.out.println("Storage consumed by vectors: " + stats.getVectorIndexSize() + " bytes");

A JavaScripthez készült Azure SDK a getIndexStatistics osztályban biztosít ehhez a feladathoz.

// Create a SearchIndexClient
const endpoint = "[service endpoint]";
const adminKey = "[admin key]";
const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
);

// Get index statistics
(async () => {
    const stats = await client.getIndexStatistics("[index name]");
    console.log(`Number of documents: ${stats.documentCount}`);
    console.log(`Storage consumed by index: ${stats.storageSize} bytes`);
    console.log(`Storage consumed by vectors: ${stats.vectorIndexSize} bytes`);
})();

A Python Azure SDK get_index_statistics biztosít ehhez a feladathoz.

# Create a SearchIndexClient
endpoint = "[service endpoint]"
admin_key = AzureKeyCredential("[admin key]")
client = SearchIndexClient(endpoint=endpoint, credential=admin_key)

# Get index statistics
stats = client.get_index_statistics("[index name]")
print(f"Number of documents: {stats['document_count']}")
print(f"Storage consumed by index: {stats['storage_size']} bytes")
print(f"Storage consumed by vectors: {stats['vector_index_size']} bytes")

Index definíciójának megtekintése

Minden indexet mezők és választható összetevők határoznak meg, amelyek javítják a keresési képességeket, például elemzők, normalizálók, tokenizerek és szinonimatérképek. Ez a definíció határozza meg az index struktúráját és viselkedését az indexelés és a lekérdezés során.

Az indexlapon válassza a JSON szerkesztése lehetőséget a teljes definíció megtekintéséhez.

Indexek – Get (REST API) használata az index JSON-definíciójának lekéréséhez.

### 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]

Használja a preferált Azure SDK-t az index JSON-definíciójának lekéréséhez.

A .NET Azure SDK GetIndexAsync biztosít ehhez a feladathoz.

// 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);

A Java-hoz készült Azure SDK biztosítja ezt a feladatot a SearchIndexAsyncClient osztályban .

// Create a SearchIndexAsyncClient
String endpoint = "[service endpoint]";
String adminKey = "[admin key]";
SearchIndexAsyncClient searchIndexAsyncClient = new SearchIndexClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(adminKey))
    .buildAsyncClient();

// Get index definition
searchIndexAsyncClient.getIndex("[index name]")
    .subscribe(index -> {
        try {
            String prettyJson = new ObjectMapper()
                .writerWithDefaultPrettyPrinter()
                .writeValueAsString(index);
            System.out.println(prettyJson);
        } catch (Exception e) {
            e.printStackTrace();
        }
    });

A JavaScripthez készült Azure SDK a getIndex osztályban biztosít ehhez a feladathoz.

// Create a SearchIndexClient
const endpoint = "[service endpoint]";
const adminKey = "[admin key]";
const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
);

// Get index definition
(async () => {
    const index = await client.getIndex("[index name]");
    console.log(JSON.stringify(index, null, 2));
})();

A Python Azure SDK get_index a SearchIndexClient osztályt biztosítja ehhez a feladathoz.

# Create a SearchIndexClient
endpoint = "[service endpoint]"
admin_key = AzureKeyCredential("[admin key]")
client = SearchIndexClient(endpoint=endpoint, credential=admin_key)

# Get index definition
index = client.get_index("[index name]")
print(json.dumps(index.as_dict(), indent=2, sort_keys=True, ensure_ascii=False))

Index törlése

Figyelmeztetés

Az index törlését nem vonhatja vissza. A folytatás előtt győződjön meg arról, hogy véglegesen el szeretné távolítani az indexet és annak dokumentumait a keresési szolgáltatásból.

Az indexlapon válassza a Törlés lehetőséget a törlési folyamat elindításához.

A portál kéri, hogy erősítse meg a törlést. A Törlés lehetőség kiválasztása után ellenőrizze az értesítéseket, hogy a törlés sikeres volt-e.

Indexek – Törlés (REST API) használata egy index végleges törléséhez.

### 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]

Ha az indexet sikeresen törölték, akkor meg kell kapnia a(z) HTTP/1.1 204 No Content választ.

Az előnyben részesített Azure SDK használatával véglegesen törölhet egy indexet.

A .NET Azure SDK DeleteIndexAsync biztosít ehhez a feladathoz.

// 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.");

A Java-hoz készült Azure SDK biztosítja ezt a feladatot a SearchIndexAsyncClient osztályban .

// Create a SearchIndexAsyncClient
String endpoint = "[service endpoint]";
String adminKey = "[admin key]";
SearchIndexAsyncClient searchIndexAsyncClient = new SearchIndexClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(adminKey))
    .buildAsyncClient();

// Delete the index
searchIndexAsyncClient.deleteIndex("[index name]")
    .subscribe(
        unused -> System.out.println("Index deleted successfully.")
    );

A JavaScripthez készült Azure SDK a deleteIndex osztályban biztosít ehhez a feladathoz.

// Create a SearchIndexClient
const endpoint = "[service endpoint]";
const adminKey = "[admin key]";
const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
);

// Delete the index
(async () => {
    await client.deleteIndex("[index name]");
    console.log("Index deleted successfully.");
})();

A Python Azure SDK delete_index a SearchIndexClient osztályt biztosítja ehhez a feladathoz.

# Create a SearchIndexClient
endpoint = "[service endpoint]"
admin_key = AzureKeyCredential("[admin key]")
client = SearchIndexClient(endpoint=endpoint, credential=admin_key)

# Delete the index
client.delete_index("[index name]")
print("Index deleted successfully.")

Visszajelzés

Hasznosnak találta ezt az oldalt?

Utolsó frissítés időpontja: 2026-07-03

Az Azure AI Keresés index kezelése

Korlátozások

Az összes index megtekintése

Index statisztikáinak megtekintése

Index definíciójának megtekintése

Index törlése

Kapcsolódó tartalom

Visszajelzés

További források