Azure Yapay Zeka Arama'da dizini yönetme

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

dizin oluşturupAzure portal kullanarak istatistiklerine ve tanımına erişebilir veya arama hizmetinizden kaldırabilirsiniz.

dizin oluşturupAzure Yapay Zeka Arama REST API kullanarak istatistiklerine ve tanımına erişebilir veya arama hizmetinizden kaldırabilirsiniz.

dizin oluşturdıktan sonra, .NET, Java, JavaScript veya Python Azure SDK kullanarak istatistiklerine ve tanımına erişebilir veya arama hizmetinizden kaldırabilirsiniz.

Bu makale, bir dizini içeriğini etkilemeden nasıl yönetebileceğinizi açıklar. Dizin tanımını değiştirme yönergeleri için bkz. Güncelleştirme veya Azure Yapay Zeka Arama dizinini yeniden derleme.

Sınırlamalar

Arama hizmetinizin fiyatlandırma katmanı dizinlerinizin, alanlarınızın ve belgelerinizin maksimum sayısını ve boyutunu belirler. Daha fazla bilgi için bkz. Azure Yapay Zeka Arama Hizmet sınırları.

Aksi takdirde, dizin yönetimi için aşağıdaki sınırlamalar geçerlidir:

  • Bakım için dizini çevrimdışına alamazsınız. Dizinler arama işlemleri için her zaman kullanılabilir.

  • Arama hizmetleri içinde veya genelinde bir dizini doğrudan kopyalayamaz veya çoğaltamazsınız. Ancak, benzer işlevler elde etmek için .NET veya Python için yedekleme ve geri yükleme örneğini kullanabilirsiniz.

Tüm dizinleri görüntüleme

Tüm dizinlerinizi görüntülemek için:

  1. Azure portalında arama hizmetinize gidin.

  2. Sol bölmeden Arama yönetimi>Dizinleri'ni seçin.

    Portaldaki dizinler sayfasının ekran görüntüsü.

    Varsayılan olarak, dizinler ada göre artan düzende sıralanır. İlgili sütun başlığını seçerek Ad, Belge sayısı, Vektör dizini kotası kullanımı veya Toplam depolama boyutuna göre sıralayabilirsiniz.

Arama hizmetinizdeki tüm dizinleri almak için Dizinler - Liste (REST API) kullanın.

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

Arama hizmetinizdeki tüm dizinleri almak için tercih ettiğiniz Azure SDK kullanın.

.NET için Azure SDK bu görev için GetIndexesAsync sağlar.

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

Dizinin istatistiklerini görüntüleme

Dizin sayfasında portal aşağıdaki istatistikleri sağlar:

  • Dizindeki belge sayısı.
  • Dizin tarafından kullanılan depolama alanı.
  • Dizin tarafından kullanılan vektör depolama alanı.
  • Fiyatlandırma katmanınıza bağlı olarak arama hizmetinizdeki her dizin için maksimum depolama alanı. Bu değer, şu anda dizinde kullanılabilen toplam depolama alanını temsil etmez.

Portaldaki dizin istatistiklerinin ekran görüntüsü.

Dizinleri Kullanma - Bir dizinin belge sayısını, depolama kullanımını ve vektör depolama kullanımını almak için İstatistikleri Al (REST API ).

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

Bir dizinin belge sayısını, depolama kullanımını ve vektör depolama kullanımını almak için tercih ettiğiniz Azure SDK kullanın.

.NET için Azure SDK bu görev için GetIndexStatisticsAsync sağlar.

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

Dizinin tanımını görüntüleme

Her dizin, çözümleyiciler, normalleştiriciler, belirteç oluşturucular ve eş anlamlı eşlemeleri gibi arama özelliklerini geliştiren alanlar ve isteğe bağlı bileşenler tarafından tanımlanır. Bu tanım, dizin oluşturma ve sorgulama sırasında dizinin yapısını ve davranışını belirler.

Tam tanımını görüntülemek için dizin sayfasında JSON Düzenle'yi seçin.

Portaldaki JSON Düzenle düğmesinin ekran görüntüsü.

Dizinin JSON tanımını almak için Dizinler - Get (REST API) kullanın.

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

Bir dizinin JSON tanımını almak için tercih ettiğiniz Azure SDK kullanın.

.NET için Azure SDK bu görev için GetIndexAsync sağlar.

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

Dizini silme

Uyarı

Dizin silme işlemini geri alamazsınız. Devam etmeden önce, dizini ve belgelerini arama hizmetinizden kalıcı olarak kaldırmak istediğinizden emin olun.

Silme işlemini başlatmak için dizin sayfasında Sil'i seçin.

Portaldaki Sil düğmesinin ekran görüntüsü.

Portal silme işlemini onaylamanızı ister. Sil'i seçtikten sonra, silme işleminin başarılı olduğunu onaylamak için bildirimlerinizi denetleyin.

Portaldaki silme onayının ekran görüntüsü.

Dizini kalıcı olarak silmek için Dizinler - Silme (REST API) kullanın.

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

Dizin başarıyla silindiyse bir HTTP/1.1 204 No Content yanıt almanız gerekir.

Bir dizini kalıcı olarak silmek için tercih ettiğiniz Azure SDK kullanın.

.NET için Azure SDK bu görev için DeleteIndexAsync sağlar.

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