إنشاء اسم مستعار للفهرس في Azure الذكاء الاصطناعي Search
هام
الأسماء المستعارة للفهرس حاليا في المعاينة العامة ومتاحة بموجب شروط الاستخدام التكميلية.
في Azure الذكاء الاصطناعي Search، الاسم المستعار للفهرس هو اسم ثانوي يمكن استخدامه للإشارة إلى فهرس للاستعلام والفهرسة والعمليات الأخرى. يمكنك إنشاء اسم مستعار يعين إلى فهرس بحث واستبدل اسم الاسم المستعار في الأماكن التي قد تشير فيها إلى اسم فهرس. يضيف الاسم المستعار المرونة إذا كنت بحاجة إلى تغيير الفهرس الذي يشير إليه التطبيق الخاص بك. بدلا من تحديث المراجع في التطبيق الخاص بك، يمكنك فقط تحديث تعيين الاسم المستعار الخاص بك.
الهدف الرئيسي من الأسماء المستعارة للفهرس هو تسهيل إدارة فهارس الإنتاج. على سبيل المثال، إذا كنت بحاجة إلى إجراء تغيير على تعريف الفهرس، مثل تحرير حقل أو إضافة محلل جديد، يتعين عليك إنشاء فهرس بحث جديد لأن جميع فهارس البحث غير قابلة للتغيير. وهذا يعني أنك تحتاج إما إلى إسقاط الفهرس وإعادة إنشائه أو إنشاء فهرس جديد ثم ترحيل التطبيق الخاص بك إلى هذا الفهرس.
بدلا من إسقاط الفهرس وإعادة إنشائه، يمكنك استخدام الأسماء المستعارة للفهرس. سيكون سير العمل النموذجي هو:
- إنشاء فهرس البحث
- إنشاء اسم مستعار يعين إلى فهرس البحث
- اطلب من تطبيقك إرسال طلبات الاستعلام/الفهرسة إلى الاسم المستعار بدلا من اسم الفهرس
- عندما تحتاج إلى إجراء تغيير على الفهرس الذي يتطلب إعادة إنشاء، قم بإنشاء فهرس بحث جديد
- عندما يكون الفهرس الجديد جاهزا للانطلاق، قم بتحديث الاسم المستعار لتعيينه إلى الفهرس الجديد وسيتم توجيه الطلبات تلقائيا إلى الفهرس الجديد
إنشاء اسم مستعار مفهرس
يمكنك إنشاء اسم مستعار باستخدام واجهة برمجة تطبيقات REST للمعاينة أو حزم SDK للمعاينة أو من خلال مدخل Microsoft Azure. يتكون name الاسم المستعار من الاسم المستعار واسم فهرس البحث الذي تم تعيين الاسم المستعار إليه. يمكن تحديد اسم فهرس واحد فقط في indexes الصفيف.
يمكنك استخدام إنشاء أو تحديث الاسم المستعار (معاينة REST) لإنشاء اسم مستعار للفهرس.
POST /aliases?api-version=2023-10-01-preview
{
"name": "my-alias",
"indexes": ["hotel-samples-index"]
}
إرسال طلبات إلى اسم مستعار للفهرس
بمجرد إنشاء الاسم المستعار الخاص بك، تصبح جاهزا لبدء استخدامه. يمكن استخدام الأسماء المستعارة لجميع عمليات المستندات بما في ذلك الاستعلام والفهرسة والاقتراحات والإكمال التلقائي.
في الاستعلام أدناه، بدلا من إرسال الطلب إلى hotel-samples-index، يمكنك بدلا من ذلك إرسال الطلب إلى my-alias وسيتم توجيهه وفقا لذلك.
POST /indexes/my-alias/docs/search?api-version=2023-10-01-preview
{
"search": "pool spa +airport",
"searchMode": any,
"queryType": "simple",
"select": "HotelId, HotelName, Category, Description",
"count": true
}
إذا كنت تتوقع إجراء تحديثات على فهرس إنتاج، فحدد اسما مستعارا بدلا من اسم الفهرس في التطبيق من جانب العميل. يتم تحديد السيناريوهات التي تتطلب إعادة إنشاء فهرس في Drop وإعادة إنشاء فهرس.
إشعار
يمكنك فقط استخدام اسم مستعار مع عمليات المستند أو للحصول على تعريف فهرس وتحديثه. لا يمكن استخدام الأسماء المستعارة لحذف فهرس، ولا يمكن استخدامها مع واجهة برمجة تطبيقات تحليل النص، ولا يمكن استخدامها ك على targetIndexName مفهرس.
قد يستغرق تحديث الاسم المستعار ما يصل إلى 10 ثوان للنشر عبر النظام، لذا يجب الانتظار لمدة 10 ثوان على الأقل قبل إجراء أي عملية في الفهرس الذي تم تعيينه أو تعيينه مؤخرا إلى الاسم المستعار.
تبديل الفهارس
الآن، كلما كنت بحاجة إلى تحديث التطبيق الخاص بك للإشارة إلى فهرس جديد، كل ما عليك القيام به هو تحديث التعيين في الاسم المستعار الخاص بك. PUT مطلوب للتحديثات كما هو موضح في إنشاء أو تحديث الاسم المستعار (معاينة REST).
PUT /aliases/my-alias?api-version=2023-10-01-preview
{
"name": "my-alias",
"indexes": ["hotel-samples-index2"]
}
بعد إجراء التحديث إلى الاسم المستعار، سيبدأ توجيه الطلبات تلقائيا إلى الفهرس الجديد.
إشعار
قد يستغرق تحديث الاسم المستعار ما يصل إلى 10 ثوان للنشر عبر النظام، لذا يجب الانتظار 10 ثوان على الأقل قبل حذف الفهرس الذي تم تعيين الاسم المستعار إليه مسبقا.