Membuat alias indeks di Azure AI Search

Penting

Alias indeks saat ini dalam pratinjau publik dan tersedia di bawah ketentuan penggunaan tambahan.

Di Azure AI Search, alias indeks adalah nama sekunder yang dapat digunakan untuk merujuk ke indeks untuk kueri, pengindeksan, dan operasi lainnya. Anda dapat membuat alias yang memetakan ke indeks pencarian dan mengganti nama alias di tempat di mana Anda akan mereferensikan nama indeks. Alias menambahkan fleksibilitas jika Anda perlu mengubah indeks mana yang ditunjuk aplikasi Anda. Alih-alih memperbarui referensi di aplikasi, Anda hanya dapat memperbarui pemetaan untuk alias Anda.

Tujuan utama alias indeks adalah untuk mempermudah pengelolaan indeks produksi Anda. Misalnya, jika Anda perlu membuat perubahan pada definisi indeks Anda, seperti mengedit bidang atau menambahkan penganalisis baru, Anda harus membuat indeks pencarian baru karena semua indeks pencarian tidak dapat diubah. Ini berarti Anda perlu menghilangkan dan membangun kembali indeks Anda atau membuat indeks baru lalu memigrasikan aplikasi Anda ke indeks tersebut.

Alih-alih menghilangkan dan membangun kembali indeks, Anda dapat menggunakan alias indeks. Alur kerja umum adalah untuk:

1. Membuat indeks pencarian Anda
2. Membuat alias yang memetakan ke indeks pencarian Anda
3. Minta aplikasi Anda mengirim permintaan kueri/pengindeksan ke alias daripada nama indeks
4. Saat Anda perlu membuat perubahan pada indeks Anda yang memerlukan pembangunan ulang, buat indeks pencarian baru
5. Saat indeks baru Anda siap digunakan, perbarui alias untuk memetakan ke indeks baru dan permintaan akan secara otomatis dirutekan ke indeks baru

Membuat alias indeks

Anda dapat membuat alias menggunakan PRATINJAU REST API, pratinjau SDK, atau melalui portal Azure. Alias terdiri dari name alias dan nama indeks pencarian tempat alias dipetakan. Hanya satu nama indeks yang dapat ditentukan dalam indexes array.

REST API

Anda dapat menggunakan Alias Buat atau Perbarui (pratinjau REST) untuk membuat alias indeks.

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

Portal Azure

Ikuti langkah-langkah di bawah ini untuk membuat alias indeks di portal Azure.

1. Navigasikan ke layanan pencarian Anda di portal Microsoft Azure.
2. Temukan dan pilih Alias.
3. Pilih + Tambahkan Alias.
4. Beri nama alias indeks Anda dan pilih indeks pencarian yang ingin Anda petakan aliasnya. Lalu, pilih Simpan.

.NET SDK

Dengan menggunakan salah satu paket beta dari Azure SDK untuk .NET, Anda dapat menggunakan sintaks berikut untuk membuat alias indeks.

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

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

Alias indeks juga didukung dalam SDK pratinjau terbaru untuk Java, Python, dan JavaScript.

Mengirim permintaan ke alias indeks

Setelah membuat alias, Anda siap untuk mulai menggunakannya. Alias dapat digunakan untuk semua operasi dokumen termasuk kueri, pengindeksan, saran, dan pelengkapan otomatis.

Dalam kueri di bawah ini, alih-alih mengirim permintaan ke hotel-samples-index, Anda dapat mengirim permintaan ke my-alias dan permintaan tersebut akan dirutekan sesuai.

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

Jika Anda ingin membuat pembaruan pada indeks produksi, tentukan alias daripada nama indeks di aplikasi sisi klien Anda. Skenario yang memerlukan pembangunan ulang indeks diuraikan dalam Menghilangkan dan membangun kembali indeks.

Catatan

Anda hanya dapat menggunakan alias dengan operasi dokumen atau untuk mendapatkan dan memperbarui definisi indeks. Alias tidak dapat digunakan untuk menghapus indeks, tidak dapat digunakan dengan ANALYZE Text API, dan tidak dapat digunakan sebagai pada targetIndexName pengindeks.

Pembaruan ke alias mungkin memakan waktu hingga 10 detik untuk disebarluaskan melalui sistem sehingga Anda harus menunggu setidaknya 10 detik sebelum melakukan operasi apa pun dalam indeks yang telah dipetakan atau baru-baru ini dipetakan ke alias.

Menukar indeks

Sekarang, setiap kali Anda perlu memperbarui aplikasi Anda untuk menunjuk ke indeks baru, yang perlu Anda lakukan adalah memperbarui pemetaan di alias Anda. PUT diperlukan untuk pembaruan seperti yang dijelaskan di Buat atau Perbarui Alias (pratinjau REST).

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

Setelah Anda membuat pembaruan ke alias, permintaan akan secara otomatis mulai dirutekan ke indeks baru.

Catatan

Pembaruan ke alias mungkin membutuhkan waktu hingga 10 detik untuk disebarluaskan melalui sistem sehingga Anda harus menunggu setidaknya 10 detik sebelum menghapus indeks yang sebelumnya dipetakan alias.

Lihat juga

• Menghilangkan dan membangun kembali indeks di Azure AI Search