Membuat alias indeks di Azure Cognitive Search
Penting
Alias indeks saat ini dalam pratinjau publik dan tersedia di bawah ketentuan penggunaan tambahan.
Dalam Azure Cognitive 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 ditunjukkan 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 yang khas adalah:
- Membuat indeks pencarian Anda
- Membuat alias yang memetakan ke indeks pencarian Anda
- Minta aplikasi Anda mengirim permintaan kueri/pengindeksan ke alias daripada nama indeks
- Saat Anda perlu membuat perubahan pada indeks Anda yang memerlukan pembangunan kembali, buat indeks pencarian baru
- 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, SDK pratinjau, atau melalui Visual Studio Code. Alias terdiri dari name alias dan nama indeks pencarian tempat alias dipetakan. Hanya satu nama indeks yang dapat ditentukan dalam indexes array.
Anda dapat menggunakan Alias Buat atau Perbarui (pratinjau REST) untuk membuat alias indeks.
POST /aliases?api-version=2021-04-30-preview
{
"name": "my-alias",
"indexes": ["hotel-samples-index"]
}
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=2021-04-30-preview
{
"search": "pool spa +airport",
"searchMode": any,
"queryType": "simple",
"select": "HotelId, HotelName, Category, Description",
"count": true
}
Jika Anda mengharapkan bahwa Anda mungkin perlu membuat pembaruan pada definisi indeks untuk indeks produksi Anda, Anda harus menggunakan alias daripada nama indeks untuk permintaan di aplikasi sisi klien Anda. Skenario yang mengharuskan Anda membuat indeks baru diuraikan dalam kondisi pembangunan kembali ini.
Catatan
Anda hanya dapat menggunakan alias dengan operasi dokumen. Alias tidak dapat digunakan untuk mendapatkan atau memperbarui definisi indeks, tidak dapat digunakan dengan Analyze Text API, dan tidak dapat digunakan sebagai pada targetIndexName pengindeks.
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 dalam Membuat atau Memperbarui Alias (pratinjau REST).
PUT /aliases/my-alias?api-version=2021-04-30-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 untuk alias mungkin membutuhkan waktu hingga 10 detik untuk disebarluaskan melalui sistem sehingga Anda harus menunggu setidaknya 10 detik sebelum menghapus indeks yang sebelumnya dipetakan oleh alias.