سيساعدك هذا الدليل في إعداد Azure AI Search باستخدام بوابة Azure. اتبع الخطوات أدناه لإنشاء وتكوين خدمة Azure AI Search الخاصة بك.
قبل البدء، تأكد من أن لديك ما يلي:
https://<service-name>.search.windows.net.يدمج Azure AI Search مع أدوات متنوعة لتعزيز قدرات البحث لديك. يمكنك استخدام Azure CLI، مكتبة Python SDK، مكتبة .NET SDK وأدوات أخرى للتكوينات والعمليات المتقدمة.
سجّل الدخول إلى Azure CLI باستخدام الأمر:
az login
(موصى به) فعّل الوصول بدون مفتاح باستخدام Microsoft Entra ID (RBAC):
az search service update --name <service-name> --resource-group <resource-group> --auth-options aadOrApiKey
az role assignment create --assignee <your-user-or-principal-id> --role "Search Service Contributor" --scope $(az search service show -g <resource-group> -n <service-name> --query id -o tsv)
az role assignment create --assignee <your-user-or-principal-id> --role "Search Index Data Contributor" --scope $(az search service show -g <resource-group> -n <service-name> --query id -o tsv)
# خدمة az search show لا تحتوي على حقل "endpoint"؛ قم ببناء عنوان URL من اسم الخدمة.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
مع تمكين RBAC، عينات Python و.NET SDK أدناه تقوم بالمصادقة باستخدام DefaultAzureCredential، والتي تستخدم جلسة az login الخاصة بك أثناء التطوير المحلي — لا حاجة لمفتاح المسؤول. راجع الاتصال بـ Azure AI Search باستخدام الأدوار.
```bash
# zsh/bash
# az search service show لا يحتوي على حقل "endpoint"؛ قم ببناء URL من اسم الخدمة.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
export AZURE_SEARCH_API_KEY=$(az search admin-key show -g <resource-group> --service-name <service-name> --query "primaryKey" -o tsv)
```
```powershell
# PowerShell
# az search service show لا يحتوي على حقل "endpoint"؛ قم ببناء URL من اسم الخدمة.
$env:AZURE_SEARCH_SERVICE_ENDPOINT = "https://<service-name>.search.windows.net"
$env:AZURE_SEARCH_API_KEY = $(az search admin-key show -g <resource-group> --service-name <service-name> --query "primaryKey" -o tsv)
```
قم بتثبيت مكتبة عميل Azure Cognitive Search وهوية Azure لـ Python:
pip install azure-search-documents azure-identity
استخدم الكود التالي في Python لإنشاء فهرس ورفع مستندات:
import os
from azure.identity import DefaultAzureCredential
from azure.search.documents import SearchClient
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents.indexes.models import SearchIndex, SimpleField, edm
service_endpoint = os.getenv("AZURE_SEARCH_SERVICE_ENDPOINT")
index_name = "sample-index"
# بدون مفتاح (مستحسن): يستخدم هوية `az login` الخاصة بك عبر تحكم الوصول RBAC الخاص بـ Entra ID.
# يتطلب دور "المساهم في خدمة البحث" و"المساهم في بيانات فهرس البحث".
credential = DefaultAzureCredential()
# الطيار البديل (المصادقة بواسطة المفتاح):
# from azure.core.credentials import AzureKeyCredential
# credential = AzureKeyCredential(os.getenv("AZURE_SEARCH_API_KEY"))
index_client = SearchIndexClient(service_endpoint, credential)
fields = [
SimpleField(name="id", type=edm.String, key=True),
SimpleField(name="content", type=edm.String, searchable=True),
]
index = SearchIndex(name=index_name, fields=fields)
index_client.create_index(index)
search_client = SearchClient(service_endpoint, index_name, credential)
documents = [
{"id": "1", "content": "Hello world"},
{"id": "2", "content": "Azure Cognitive Search"}
]
search_client.upload_documents(documents)
نفّذ الأمر التالي لإنشاء فهرس ورفع مستندات:
dotnet run ./AzureSearch.cs
يستخدم مثال .NET أدناه DefaultAzureCredential، الذي يمكنه استخدام تسجيل دخول Azure CLI الخاص بك من az login أثناء التطوير المحلي.
هذا هو كود .NET الخاص بـ AzureSearch.cs:
#:package Azure.Search.Documents@11.*
#:package Azure.Identity@1.21.0
#:property PublishAot=false
using Azure;
using Azure.Identity;
using Azure.Search.Documents;
using Azure.Search.Documents.Indexes;
using Azure.Search.Documents.Indexes.Models;
var serviceEndpoint = new Uri(Environment.GetEnvironmentVariable("AZURE_SEARCH_SERVICE_ENDPOINT")!);
var indexName = "sample-index";
// Keyless (recommended): uses your `az login` identity via Entra ID RBAC.
// Requires the "Search Service Contributor" and "Search Index Data Contributor" roles.
var credential = new DefaultAzureCredential();
// Fallback (key-based auth): the `using Azure;` directive above already imports
// AzureKeyCredential; replace the credential line above with:
// var credential = new AzureKeyCredential(Environment.GetEnvironmentVariable("AZURE_SEARCH_API_KEY")!);
var indexClient = new SearchIndexClient(serviceEndpoint, credential);
var fields = new List<SearchField>()
{
new SimpleField("id", SearchFieldDataType.String) { IsKey = true },
new SearchableField("content")
};
var index = new SearchIndex(name: indexName, fields: fields);
var response = await indexClient.CreateOrUpdateIndexAsync(index);
Console.WriteLine($"Index '{response.Value.Name}' ready.");
var searchClient = new SearchClient(serviceEndpoint, indexName, credential);
var documents = new[]
{
new { id = "1", content = "Hello world" },
new { id = "2", content = "Azure Cognitive Search" }
};
var result = await searchClient.UploadDocumentsAsync(documents);
Console.WriteLine($"Uploaded {result.Value.Results.Count} documents to index '{response.Value.Name}'.");
لمزيد من المعلومات التفصيلية، راجع الوثائق التالية:
لقد نجحت في إعداد Azure AI Search باستخدام بوابة Azure والأدوات المدمجة. يمكنك الآن استكشاف ميزات وقدرات Azure AI Search المتقدمة لتعزيز حلول البحث الخاصة بك.
لمزيد من المساعدة، زر توثيق Azure Cognitive Search.
تنويه: تمت ترجمة هذا المستند باستخدام خدمة الترجمة بالذكاء الاصطناعي Co-op Translator. بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والمعتمد. للمعلومات الهامة، يُنصح بالاستعانة بترجمة بشرية محترفة. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.