Tämä opas auttaa sinua määrittämään Azure AI Searchin Azure-portaalin avulla. Noudata alla olevia ohjeita luodaksesi ja määrittääksesi Azure AI Search -palvelusi.
Ennen aloittamista varmista, että sinulla on seuraavat:
https://<service-name>.search.windows.net.Azure AI Search integroituu erilaisiin työkaluihin hakutoimintojen tehostamiseksi. Voit käyttää Azure CLI:tä, Python SDK:ta, .NET SDK:ta ja muita työkaluja kehittyneeseen määritykseen ja toimintoihin.
Kirjaudu sisään Azure CLI:hin komennolla:
az login
(Suositeltu) Ota avainvapaa pääsy käyttöön Microsoft Entra ID:llä (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 service show -komennolla ei ole "endpoint"-kenttää; luo URL palvelun nimestä.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
Kun RBAC on käytössä, alla olevat Python- ja .NET SDK -esimerkit tunnistautuvat DefaultAzureCredential-luokan avulla, joka käyttää az login -istuntoasi paikallisessa kehityksessä — ylläpitäjän avainta ei tarvita. Katso lisää Connect to Azure AI Search using roles.
```bash
# zsh/bash
# az search service show -komennossa ei ole "endpoint"-kenttää; rakenna URL palvelun nimestä.
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 -komennossa ei ole "endpoint"-kenttää; rakenna URL palvelun nimestä.
$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)
```
Asenna Azure Cognitive Search -asiakas- ja Azure Identity -kirjastot Pythonille:
pip install azure-search-documents azure-identity
Käytä seuraavaa Python-koodia luodaksesi indeksin ja ladataksesi dokumentteja:
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"
# Avaineton (suositeltu): käyttää `az login` -henkilöllisyyttäsi Entra ID RBAC:n kautta.
# Vaatii "Search Service Contributor" ja "Search Index Data Contributor" -roolit.
credential = DefaultAzureCredential()
# Varavaihtoehto (avaimeen perustuva todennus):
# 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)
Suorita seuraava komento luodaksesi indeksin ja ladataksesi dokumentteja:
dotnet run ./AzureSearch.cs
Alla oleva .NET-esimerkki käyttää DefaultAzureCredential-luokkaa, joka voi käyttää Azure CLI:n az login -kirjautumistasi paikallisessa kehityksessä.
Tässä on .NET-koodi tiedostosta 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}'.");
Lisätietoja löydät seuraavista dokumenteista:
Olet onnistuneesti määrittänyt Azure AI Searchin Azure-portaalin ja integroit työkalut. Voit nyt tutustua Azure AI Searchin kehittyneempiin ominaisuuksiin ja toimintoihin ratkaistaksesi hakutarpeitasi paremmin.
Lisäavun saamiseksi vieraile osoitteessa Azure Cognitive Search dokumentaatio.
Vastuuvapauslauseke: Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, otathan huomioon, että automaattiset käännökset saattavat sisältää virheitä tai epätarkkuuksia. Alkuperäinen asiakirja sen alkuperäiskielellä on virallinen lähde. Tärkeissä asioissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.