Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Note
Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.
Setelah buat indeks, Anda dapat menggunakan portal Azure untuk mengakses statistik dan definisinya atau menghapusnya dari layanan pencarian Anda.
Setelah buat indeks, Anda dapat menggunakan REST API Pencarian Azure AI untuk mengakses statistik dan definisinya atau menghapusnya dari layanan pencarian Anda.
Setelah Anda buat indeks, Anda dapat menggunakan Azure SDK untuk .NET, Java, JavaScript, atau Python untuk mengakses statistik dan definisinya atau menghapusnya dari layanan pencarian Anda.
Artikel ini menjelaskan cara mengelola indeks tanpa memengaruhi kontennya. Untuk panduan tentang memodifikasi definisi indeks, lihat Update atau membangun ulang indeks di Pencarian Azure AI.
Keterbatasan
Tingkat harga layanan pencarian Anda menentukan jumlah dan ukuran maksimum indeks, bidang, dan dokumen Anda. Untuk informasi selengkapnya, lihat batas Service di Pencarian Azure AI.
Jika tidak, batasan berikut berlaku untuk manajemen indeks:
Anda tidak dapat mengambil indeks offline untuk pemeliharaan. Indeks selalu tersedia untuk operasi pencarian.
Anda tidak dapat langsung menyalin atau menduplikasi indeks di dalam atau di seluruh layanan pencarian. Namun, Anda dapat menggunakan sampel pencadangan dan pemulihan untuk .NET atau Python untuk mencapai fungsionalitas serupa.
Menampilkan semua indeks
Untuk melihat semua indeks Anda:
Buka layanan pencarian Anda di portal Azure.
Dari panel kiri, pilihIndeks> pencarian.
Secara default, indeks diurutkan menurut nama dalam urutan naik. Anda bisa mengurutkan menurut Nama, Jumlah dokumen, Penggunaan kuota indeks vektor, atau Ukuran penyimpanan total dengan memilih header kolom yang sesuai.
Gunakan Indeks - Daftar (REST API) untuk mengambil semua indeks di layanan pencarian Anda.
### List all indexes
GET https://[service name].search.windows.net/indexes?api-version=[api version]
Content-Type: application/json
api-key: [admin key]
Gunakan Azure SDK pilihan Anda untuk mengambil semua indeks di layanan pencarian Anda.
Azure SDK untuk .NET menyediakan GetIndexesAsync untuk tugas ini.
// 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);
}
Menampilkan statistik indeks
Pada halaman indeks, portal menyediakan statistik berikut:
- Jumlah dokumen dalam indeks.
- Ruang penyimpanan yang digunakan oleh indeks.
- Ruang penyimpanan vektor yang digunakan oleh indeks.
- Ruang penyimpanan maksimum untuk setiap indeks pada layanan pencarian Anda, yang bergantung pada tingkat harga Anda. Nilai ini tidak mewakili total penyimpanan yang saat ini tersedia untuk indeks.
Gunakan Indeks - Dapatkan Statistik (REST API) untuk mengambil jumlah dokumen, penggunaan penyimpanan, dan penggunaan penyimpanan vektor indeks.
### 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]
Gunakan Azure SDK pilihan Anda untuk mengambil jumlah dokumen, penggunaan penyimpanan, dan penggunaan penyimpanan vektor indeks.
Azure SDK untuk .NET menyediakan GetIndexStatisticsAsync untuk tugas ini.
// 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");
Menampilkan definisi indeks
Setiap indeks didefinisikan oleh bidang dan komponen opsional yang meningkatkan kemampuan pencarian, seperti penganalisis, normalizer, tokenizer, dan peta sinonim. Definisi ini menentukan struktur dan perilaku indeks selama pengindeksan dan kueri.
Gunakan Indeks - Dapatkan (REST API) untuk mengambil definisi JSON dari indeks.
### 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]
Gunakan Azure SDK pilihan Anda untuk mengambil definisi JSON dari indeks.
Azure SDK untuk .NET menyediakan GetIndexAsync untuk tugas ini.
// 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);
Menghapus indeks
Peringatan
Anda tidak dapat membatalkan penghapusan indeks. Sebelum melanjutkan, pastikan Anda ingin menghapus indeks dan dokumennya secara permanen dari layanan pencarian Anda.
Pada halaman indeks, pilih Hapus untuk memulai proses penghapusan.
Portal meminta Anda untuk mengonfirmasi penghapusan. Setelah Anda memilih Hapus, periksa pemberitahuan Anda untuk mengonfirmasi bahwa penghapusan berhasil.
Gunakan Indeks - Hapus (REST API) untuk menghapus indeks secara permanen.
### 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]
Jika indeks berhasil dihapus, Anda akan menerima HTTP/1.1 204 No Content respons.
Gunakan Azure SDK pilihan Anda untuk menghapus indeks secara permanen.
Azure SDK untuk .NET menyediakan DeleteIndexAsync untuk tugas ini.
// 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.");