See juhend aitab teil seadistada Azure AI Search teenust Azure portaali kasutades. Järgige alltoodud samme, et luua ja konfigureerida oma Azure AI Search teenust.
Enne alustamist veenduge, et teil on olemas järgmised:
https://<service-name>.search.windows.net.Azure AI Search integreerub erinevate tööriistadega, et parandada teie otsingu võimalusi. Võite kasutada Azure CLI-d, Python SDK-d, .NET SDK-d ja teisi tööriistu, et teostada keerukamaid konfiguratsioone ja toiminguid.
Logige sisse Azure CLI-sse käsuga:
az login
(Soovitatav) Võtmeta juurdepääsu lubamine Microsoft Entra ID (RBAC) abil:
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 teenuse kuvamisel puudub "endpoint" väli; ehita URL teenuse nime põhjal.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
RBAC-i lubamise korral autentivad allpool olevad Python ja .NET SDK näited DefaultAzureCredential abil, mis kasutab teie az login sessiooni kohalikul arendamisel — administraatori võti ei ole vajalik. Vaadake Ühendamine Azure AI Searchiga rollide kaudu.
```bash
# zsh/bash
# az search service show-l pole "endpoint" välja; koostage URL teenuse nime põhjal.
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-l pole "endpoint" välja; koostage URL teenuse nime põhjal.
$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)
```
Installige Azure Cognitive Search klientraamatukogu ja Azure Identity Python jaoks:
pip install azure-search-documents azure-identity
Kasutage järgmist Python-koodi indeksi loomiseks ja dokumentide üleslaadimiseks:
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"
# Võtmeta (soovitatav): kasutab teie `az login` identiteeti Entra ID RBAC kaudu.
# Nõuab "Search Service Contributor" ja "Search Index Data Contributor" rolle.
credential = DefaultAzureCredential()
# Tagasiastumine (võtmepõhine autentimine):
# 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)
Käivitage järgmine käsk indeksi loomiseks ja dokumentide üleslaadimiseks:
dotnet run ./AzureSearch.cs
Allpool olev .NET näide kasutab DefaultAzureCredential, mis võib kasutada az login kaudu Azure CLI sisselogimist kohalikul arendamisel.
Siin on .NET kood failist 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}'.");
Täpsema info saamiseks vt allolevaid dokumente:
Olete edukalt seadistanud Azure AI Search teenuse Azure portaalis ja integreerinud tööriistad. Nüüd saate uurida Azure AI Search keerukamaid funktsioone ja võimalusi, et täiustada oma otsingulahendusi.
Täiendava abi saamiseks külastage Azure Cognitive Search dokumentatsiooni.
Lahtiütlus: See dokument on tõlgitud kasutades AI tõlketeenust Co-op Translator. Kuigi me püüdleme täpsuse poole, palun pange tähele, et automatiseeritud tõlgetes võib esineda vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlkega seotud eksimustest või valesti mõistmistest.