Membuat alias indeks di Pencarian Azure AI

Dalam Pencarian Azure AI, alias indeks adalah nama sekunder untuk indeks pencarian. Anda dapat membuat alias yang dikaitkan dengan indeks pencarian dan mengganti nama alias di tempat Anda biasanya akan menggunakan nama indeks. Fitur ini memberikan fleksibilitas jika Anda perlu mengubah indeks tempat aplikasi Anda menunjuk. Alih-alih memperbarui referensi ke nama indeks dalam kode produksi Anda, Anda cukup memperbarui pemetaan alias.

Anda dapat membuat dan mengelola alias pada layanan pencarian melalui permintaan HTTP (POST, GET, PUT, atau DELETE) terhadap sumber daya alias tertentu. Alias adalah sumber daya tingkat layanan yang dipertahankan secara independen dari indeks pencarian. Setelah Anda membuat indeks pencarian, Anda dapat membuat alias yang ditautkan ke indeks tersebut.

Sebelum menggunakan alias, aplikasi Anda mengirim permintaan langsung ke hotel-samples-index.

POST /indexes/hotel-samples-index/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Setelah menggunakan alias, aplikasi Anda mengirim permintaan ke my-alias, yang dipetakan ke hotel-samples-index.

POST /indexes/my-alias/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Prasyarat

• Layanan Pencarian Azure AI di wilayah dan tingkat harga apa pun.
• Indeks pencarian yang sudah ada yang ingin Anda petakan aliasnya.
• Izin untuk membuat alias:
  • Untuk autentikasi berbasis kunci, kunci API admin untuk layanan pencarian Anda.
  • Untuk autentikasi berbasis peran, peran Kontributor Layanan Pencarian .

Batasan dan pertimbangan

• Anda hanya dapat menggunakan alias dengan operasi dokumen atau untuk mendapatkan dan memperbarui definisi indeks.
• Anda tidak dapat menggunakan alias untuk menghapus indeks atau menguji tokenisasi teks.
• Anda tidak dapat mereferensikan alias sebagai pada targetIndexNamepengindeks atau sumber pengetahuan.

Membuat alias indeks

Membuat alias menetapkan pemetaan antara nama alias dan nama indeks. Jika permintaan berhasil, Anda dapat menggunakan alias untuk pengindeksan, kueri, dan operasi lainnya.

Anda dapat membuat alias dengan menggunakan REST API, Azure SDK, atau portal Azure. Alias terdiri dari name alias dan nama indeks pencarian tempat alias dipetakan. Anda hanya dapat menentukan satu nama indeks dalam indexes array.

Jumlah maksimum alias yang dapat Anda buat bervariasi menurut tingkat harga. Untuk informasi selengkapnya, lihat Batas alias indeks.

POST /aliases?api-version=2026-04-01
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

// Create a SearchIndexClient
SearchIndexClient adminClient = new SearchIndexClient(serviceEndpoint, credential);

// Create an index alias
SearchAlias myAlias = new SearchAlias("my-alias", "hotel-samples-index");
adminClient.CreateAlias(myAlias);

Mengirim permintaan ke alias indeks

Anda dapat menggunakan alias untuk semua operasi dokumen, termasuk kueri, pengindeksan, saran, dan pelengkapan otomatis.

Kueri berikut mengirimkan permintaan ke my-alias, yang dipetakan ke indeks aktual pada layanan pencarian Anda.

POST /indexes/my-alias/docs/search?api-version=2026-04-01
{
    "search": "pool spa +airport",
    "searchMode": "any",
    "queryType": "simple",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Memperoleh definisi alias

Gunakan Alias - Daftar (REST API) untuk mengembalikan daftar objek alias yang ada berdasarkan nama.

GET /aliases?api-version=2026-04-01&$select=name

Gunakan Alias - Dapatkan (REST API) untuk mengembalikan definisi alias tertentu.

GET /aliases/my-alias?api-version=2026-04-01

Memperbarui alias

Pembaruan yang paling umum ke alias adalah mengubah nama indeks ketika indeks yang mendasar diganti dengan versi yang lebih baru.

Gunakan Alias - Buat atau Perbarui (REST API) untuk memperbarui alias. Contoh berikut menunjukkan cara memperbarui my-alias untuk menunjuk ke hotel-samples-index2 alih-alih hotel-samples-index.

PUT /aliases/my-alias?api-version=2026-04-01
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

Pembaruan ke alias mungkin membutuhkan waktu hingga 10 detik untuk disebarluaskan melalui sistem, jadi tunggu setidaknya 10 detik sebelum Anda menghapus indeks tempat alias sebelumnya dipetakan.

Jika Anda mencoba menghapus indeks yang saat ini dipetakan ke alias, operasi gagal dengan 400 (Permintaan Buruk) dan pesan kesalahan yang menyatakan bahwa alias yang dipetakan ke indeks tersebut harus dihapus atau dipetakan ke indeks lain sebelum indeks dapat dihapus.

Konten terkait

• Drop dan bangun ulang indeks di Pencarian Azure AI