快速入门：在 Azure 门户创建搜索索引

项目
10/21/2024

在本 Azure AI 搜索快速入门中，使用导入数据 向导和由 Microsoft 托管的虚构酒店数据构成的内置示例数据源创建第一个搜索索引。此向导将指导你以无代码方式创建搜索索引的过程，帮助你在几分钟内编写有趣的查询。

该向导在搜索服务（可搜索索引）上创建多个对象，但还会创建索引器和数据源连接来进行自动数据检索。在本快速入门结束时，我们将查看每个对象。

注意

导入数据向导包括本快速入门中未涵盖的 OCR、文本翻译和其他 AI 扩充选项。有关侧重于应用 AI 的类似演练，请参阅快速入门：在 Azure 门户中创建技能组。

先决条件

具有活动订阅的 Azure 帐户。创建试用版订阅。
适用于任何层和任何区域的 Azure AI 搜索服务。创建服务或在当前订阅下查找现有服务。可以使用本快速入门的免费服务。

对于使用内置示例数据的本快速入门，请确保搜索服务尚未设置好网络访问控制。门户控制器使用公共终结点从 Microsoft 托管的内置示例数据源检索数据和元数据。有关详细信息，请参阅导入向导中的安全连接。

检查空间

很多客户开始使用免费服务。免费层限制为三个索引、三个数据源和三个索引器。在开始之前，请确保有空间存储额外的项目。本快速入门将为每个对象创建一个。

检查服务的“概述 > 使用情况”选项卡，以查看已拥有的索引、索引器和数据源数。

启动向导

使用 Azure 帐户登录到 Azure 门户，然后转到 Azure AI 搜索服务。
在“概述”页上，选择“导入数据”以启动向导。

创建和加载索引

在本部分中，通过四个步骤创建和加载索引。

连接到数据源

该向导会创建与 Azure Cosmos DB 上 Azure 托管的示例数据的数据源连接。此示例数据通过公共终结点进行检索和访问。无需使用自己的 Azure Cosmos DB 帐户或源文件即可运行本快速入门。

在连接到数据时，展开“数据源”下拉列表，然后选择“示例”。
在内置示例列表中，选择“hotels-sample”。
选择“下一步: 添加认知技能(可选)”继续操作。

跳过认知技能配置

导入数据向导支持创建技能组和对索引进行 AI 扩充。

在本快速入门中，请忽略“添加认知技能”选项卡上的 AI 扩充配置选项。
选择“跳到: 自定义目标索引”以继续操作。

提示

对 AI 扩充感兴趣？试用此《快速入门：在 Azure 门户中创建技能组》

配置索引

该向导可推断内置酒店示例索引的架构。请按照以下步骤来配置索引：

对于“索引名称”(hotels-sample-index) 和“键”字段 (HotelId)，接受系统生成的值。
对于所有字段属性，接受系统生成的值。
选择“下一步: 创建索引器”以继续操作。

索引至少需要“索引名称”和“字段”集合。一个字段必须标记为文档键，用于唯一标识每个文档。该值始终为字符串。向导会扫描唯一的字符串字段，并选择一个作为密钥。

每个字段都有一个名称、数据类型和属性，用于控制如何在搜索索引中使用字段。复选框可启用或禁用以下属性：

可检索：查询响应中返回的字段。
可筛选：接受筛选表达式的字段。
可排序：接受 orderby 表达式的字段。
可分面：分面导航结构中使用的字段。
可搜索：全文搜索中使用的字段。字符串可搜索。数值字段和布尔字段通常标记为不可搜索。

字符串经过属性化，可检索且可搜索。整数归属为可检索、可筛选、可排序和可分面。

属性会影响存储。 可筛选字段会消耗额外的存储，但 可检索字段不会。有关详细信息，请参阅演示属性和建议器的存储意义的示例。

如果需要自动完成或建议查询，可以指定语言分析器或建议器。

配置和运行索引器

最后一步是配置并运行索引器。此对象定义一个可执行过程。在此步骤中将会创建数据源、索引和索引器。

对于“索引器名称”(hotels-sample-indexer)，接受系统生成的值。
在本快速入门中，请使用默认选项立即运行索引器一次。托管数据是静态的，因此没有为其启用更改跟踪。
选择“提交”以创建并同时运行索引器。

监视索引器进度

可以在门户中监视索引器或索引的创建。服务“概述”页提供了指向 Azure AI 搜索服务中创建的资源的链接。

在左侧，选择“索引器”。

在 Azure 门户中更新页面结果可能需要几分钟时间。此时会在列表中看到新创建的索引器，其状态为“正在进行”或“成功”。该列表还显示已编制索引的文档数。

检查搜索索引结果

在左侧，选择“索引”。
选择“hotels-sample-index”。

等待 Azure 门户页刷新。页面上应该会显示索引以及对应的文档计数和存储大小。
选择“字段”选项卡以查看索引架构。

检查哪些字段是可筛选或可排序字段，以便了解要编写的查询。

添加或更改字段

在“字段”选项卡上，可以使用“添加字段”及名称、支持的数据类型和属性创建新字段。

更改现有字段则更为困难。现有字段在索引中具有物理表示形式，因此它们不可修改，即使在代码中也是如此。要从根本上更改现有字段，需要创建一个替换原始字段的新字段。随时可以向索引添加其他构造，例如计分概要文件和 CORS 选项。

若要清楚地了解在索引设计过程中可以和不可以编辑哪些内容，请花点时间查看索引定义选项。字段列表中变灰的选项指示这些值无法修改或删除。

使用搜索浏览器查询

现在，你已有一个可以使用搜索浏览器来查询的搜索索引。 搜索资源管理器会发送符合搜索 POST REST API 的 REST 调用。该工具支持简单查询语法和完整的 Lucene 查询语法。

在“搜索资源管理器”选项卡上，输入要搜索的文本。
使用“微型地图”快速跳转到输出的非可见区域。
要指定语法，请切换到 JSON 视图。

酒店示例索引的示例查询

以下示例假定使用 JSON 视图和 2024-05-01-preview REST API 版本。

提示

JSON 视图现在支持参数名称补全的 Intellisense。将光标置于 JSON 视图内，键入空格字符以显示所有查询参数的列表，或键入单个字母（如“s”）以仅显示以“s”开头的查询参数。 Intellisense 不会排除无效参数，因此请自行判断。

筛选器示例

停车、标记、装修日期、评级和位置是可筛选的。

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

默认情况下，布尔筛选器假定为“true”。

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

地理空间搜索基于筛选器。该 geo.distance 函数可根据指定 Location 和 geography'POINT 坐标筛选位置数据的所有结果。该查询查找位于纬度经度坐标 -122.12 47.67（即“美国华盛顿州雷德蒙德”）5 公里范围内的酒店。该查询显示匹配项的总数 &$count=true 以及酒店名称和地址位置。

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

完整的 Lucene 语法示例

默认语法为简单语法，但如果需要使用模糊搜索或字词提升或正则表达式，请指定完整语法。

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

默认情况下，执行典型搜索时，如果拼错查询字词（例如，将 seatle 错拼为 Seattle），则无法返回匹配项。 queryType=full 参数调用支持波形符 ~ 操作数的完整 Lucene 查询分析程序。如果存在这些参数，则查询对指定的关键字执行模糊搜索。该查询将查找匹配的结果以及与关键字相似但不完全匹配的结果。

请花一点时间尝试对索引使用上面的一些示例查询。要了解有关查询的详细信息，请参阅《Azure AI 搜索中的查询》。

清理资源

在自己的订阅中操作时，最好在项目结束时确定是否仍需要已创建的资源。持续运行资源可能会产生费用。可以逐个删除资源，也可以删除资源组以删除整个资源集。

可以在 Azure 门户左侧窗格的“所有资源”或“资源组”下查找和管理服务的资源。

如果使用的是免费服务，请记住限制为三个索引、索引器和数据源。可以在 Azure 门户中删除单个项目，以不超出此限制。

后续步骤

请尝试使用 Azure 门户向导生成在浏览器中运行的即用型 Web 应用。可以在本快速入门中创建的小索引上尝试使用此向导，也可以使用内置的示例数据集之一来获得更丰富的搜索体验。

在门户中创建演示应用

通过