00 · AzureSearch

返回：环境配置与学习准备 · 不可变原始文件

原课程补充材料

根据对应简体中文译本整理。原代码片段未进行云端验证。

Azure AI 搜索设置指南

本指南将帮助你通过 Azure 门户设置 Azure AI 搜索服务。请按照以下步骤创建和配置你的 Azure AI 搜索服务。

前提条件

在开始之前，请确保你具备以下条件：

• 一个 Azure 订阅。如果你还没有 Azure 订阅，可以在 Azure 免费账户 创建一个免费账户。

第一步：创建 Azure 存储账户

1. 按照此说明 创建 Azure 存储账户，创建一个新的 Azure 存储账户。 注意 ：请确保存储账户类型为标准通用 V2。

第二步：创建 Azure AI 搜索服务

1. 登录 Azure 门户。
2. 在左侧导航栏中，点击 创建资源 。
3. 在搜索框中输入 "Azure AI Search"，然后从结果列表中选择 Azure AI Search 。
4. 点击 创建 按钮。
5. 在 基本信息 选项卡中提供以下信息：
   • 订阅 ：选择你的 Azure 订阅。
   • 资源组 ：创建一个新的资源组或选择现有的资源组。
   • 资源名称 ：输入你的搜索服务的唯一名称。
   • 区域 ：选择离你的用户最近的区域。
   • 定价层 ：选择适合你需求的定价层。你可以从免费层开始测试。
6. 点击 查看 + 创建 。
7. 查看设置后，点击 创建 来创建搜索服务。

第三步：开始使用 Azure AI 搜索

1. 部署完成后，导航到 Azure 门户中的搜索服务。
2. 在搜索服务概览页面，复制 URL。它的格式应为 https://<service-name>.search.windows.net。
3. 在设置 > 密钥页面，复制查询密钥。
4. 按照 快速入门指南 页面中的步骤创建索引、上传数据并执行搜索查询。

第四步：使用 Azure AI 搜索工具

Azure AI 搜索与多种工具集成，以增强你的搜索功能。你可以使用 Azure CLI、Python SDK、.NET SDK 等工具进行高级配置和操作。

使用 Azure CLI

1. 按照 安装 Azure CLI 的说明安装 Azure CLI。

2. 使用以下命令登录 Azure CLI：

   az login

3. 将 Azure AI 搜索实例的端点和 API 密钥存储到环境变量中。

   # zsh/bash
   export AZURE_SEARCH_SERVICE_ENDPOINT=$(az search service show -g <resource-group> -n <service-name> --query "endpoint" -o tsv)
   export AZURE_SEARCH_API_KEY=$(az search service admin-key list -g <resource-group> --search-service-name <service-name> --query "primaryKey" -o tsv)

   # PowerShell
   $env:AZURE_SEARCH_SERVICE_ENDPOINT = az search service show -g <resource-group> -n <service-name> --query "endpoint" -o tsv
   $env:AZURE_SEARCH_API_KEY = $(az search service admin-key list -g <resource-group> --search-service-name <service-name> --query "primaryKey" -o tsv)

使用 Python SDK

1. 安装 Azure Cognitive Search 的 Python 客户端库：

   pip install azure-search-documents

2. 使用以下 Python 代码创建索引并上传文档：

   import os
   from azure.core.credentials import AzureKeyCredential
   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")
   api_key = os.getenv("AZURE_SEARCH_API_KEY")
   index_name = "sample-index"
   
   credential = AzureKeyCredential(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)

使用 .NET SDK

1. 运行以下命令创建索引并上传文档：

   dotnet run ./AzureSearch.cs

2. 以下是 AzureSearch.cs 的 .NET 代码：

   #:package Azure.Search.Documents@11.*
   #:property PublishAot=false
   
   using Azure;
   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 apiKey = Environment.GetEnvironmentVariable("AZURE_SEARCH_API_KEY")!;
   var indexName = "sample-index";
   
   var credential = new AzureKeyCredential(apiKey);
   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 Cognitive Search 服务
• 开始使用 Azure Cognitive Search
• Azure AI 搜索工具

结论

你已成功通过 Azure 门户设置了 Azure AI 搜索服务并集成了相关工具。现在，你可以探索 Azure AI 搜索的更多高级功能和能力，以增强你的搜索解决方案。

如需进一步帮助，请访问 Azure Cognitive Search 文档。

---

免责声明 ：
本文档使用AI翻译服务Co-op Translator进行翻译。尽管我们努力确保翻译的准确性，但请注意，自动翻译可能包含错误或不准确之处。原始语言的文档应被视为权威来源。对于关键信息，建议使用专业人工翻译。我们不对因使用此翻译而产生的任何误解或误读承担责任。