如何建设农业推广网站,新浪云存储 wordpress,wordpress 可道云,php 企业网站开发实例了解如何使用 Azure SDK 中的 Azure.Search.Documents 客户端库创建、加载和查询使用示例数据的搜索索引#xff0c;实现全文搜索。 全文搜索使用 Apache Lucene 进行索引和查询#xff0c;使用 BM25 排名算法对结果进行评分。 关注TechLead#xff0c;分享AI全维度知识。作… 了解如何使用 Azure SDK 中的 Azure.Search.Documents 客户端库创建、加载和查询使用示例数据的搜索索引实现全文搜索。 全文搜索使用 Apache Lucene 进行索引和查询使用 BM25 排名算法对结果进行评分。 关注TechLead分享AI全维度知识。作者拥有10年互联网服务架构、AI产品研发经验、团队管理经验同济本复旦硕复旦机器人智能实验室成员阿里云认证的资深架构师项目管理专业人士上亿营收AI产品研发负责人。 环境准备 具有活动订阅的 Azure 帐户。 免费创建帐户。 Azure AI 搜索服务。 如果还没有请创建服务。 API 密钥和服务终结点 登录到 Azure 门户并查找你的搜索服务。 在“概述”中复制 URL 并将其保存到记事本以供后续步骤使用。 示例终结点可能类似于 https://mydemo.search.windows.net。 在“密钥”中复制并保存管理密钥以获取创建和删除对象的完整权限。 有两个可互换的主要密钥和辅助密钥。 选择其中一个。 创建、加载并查询索引
选择下一步要使用的编程语言。 Azure.Search.Documents 客户库在面向 .NET、Python、Java 和 JavaScript 的 Azure SDK 中均可使用。 以Python为例
使用 azure-search-documents 库构建 Jupyter Notebook用于创建、加载和查询索引。 或者可以下载并运行已完成的 Jupyter Python 笔记本或按照这些步骤创建自己的笔记本。 设置你的环境
我们使用以下工具创建了本快速入门。 带有 Python 扩展的 Visual Studio Code或等效的 IDEPython 版本为 3.7 或更高 用于 Python 的 Azure SDK 中的 azure-search-documents 包 连接到 Azure AI 搜索
在此任务中创建笔记本、加载库并设置客户端。 在 Visual Studio Code 中创建新的 Python3 笔记本 按 F1 并搜索“Python 选择解释器”然后选择 Python 3.7 版本或更高版本。再次按 F1 并搜索“创建新的 Jupyter Notebook”。 应在编辑器中打开一个空的无标题 .ipynb 文件为第一个条目做好准备。 在第一个单元格中从用于 Python 的 Azure SDK 加载库包括 azure-search-documents。 %pip install azure-search-documents --pre
%pip show azure-search-documentsimport os
from azure.core.credentials import AzureKeyCredential
from azure.search.documents.indexes import SearchIndexClient
from azure.search.documents import SearchClient
from azure.search.documents.indexes.models import (ComplexField,CorsOptions,SearchIndex,ScoringProfile,SearchFieldDataType,SimpleField,SearchableField
)添加第二个单元格并粘贴连接信息。 此单元格还设置了将用于执行特定操作的客户端用于创建索引的 SearchIndexClient以及用于查询索引的 SearchClient。 由于代码为你生成了 URI因此只需在服务名称属性中指定搜索服务名称。 service_name YOUR-SEARCH-SERVICE-NAME
admin_key YOUR-SEARCH-SERVICE-ADMIN-API-KEYindex_name hotels-quickstart# Create an SDK client
endpoint https://{}.search.windows.net/.format(service_name)
admin_client SearchIndexClient(endpointendpoint,index_nameindex_name,credentialAzureKeyCredential(admin_key))search_client SearchClient(endpointendpoint,index_nameindex_name,credentialAzureKeyCredential(admin_key))在第三个单元格中运行 delete_index 操作以清除所有现有的 hotels-quickstart 索引服务。 通过删除索引可以创建另一个同名的 hotels-quickstart 索引。 try:result admin_client.delete_index(index_name)print (Index, index_name, Deleted)
except Exception as ex:print (ex)运行每个步骤。 创建索引
必需的索引元素包括名称、字段集合和唯一标识每个搜索文档的文档键。 字段集合定义逻辑搜索文档的结构用于加载数据和返回结果。
在字段集合中每个字段都具有一个名称、类型和确定字段用法的属性例如该字段在搜索结果是否可全文搜索、可筛选或可检索。 在索引中必须将一个 Edm.String 类型的字段指定为文档标识的键。
此索引名为“hotels-quickstart”使用下面所示的字段定义。 它是其他演练中使用的一个更大 Hotels 索引的子集。 为简明起见本快速入门已对其进行修整。 在下一个单元格中将以下示例粘贴到某个单元格以提供架构。 # Specify the index schema
name index_name
fields [SimpleField(nameHotelId, typeSearchFieldDataType.String, keyTrue),SearchableField(nameHotelName, typeSearchFieldDataType.String, sortableTrue),SearchableField(nameDescription, typeSearchFieldDataType.String, analyzer_nameen.lucene),SearchableField(nameDescription_fr, typeSearchFieldDataType.String, analyzer_namefr.lucene),SearchableField(nameCategory, typeSearchFieldDataType.String, facetableTrue, filterableTrue, sortableTrue),SearchableField(nameTags, collectionTrue, typeSearchFieldDataType.String, facetableTrue, filterableTrue),SimpleField(nameParkingIncluded, typeSearchFieldDataType.Boolean, facetableTrue, filterableTrue, sortableTrue),SimpleField(nameLastRenovationDate, typeSearchFieldDataType.DateTimeOffset, facetableTrue, filterableTrue, sortableTrue),SimpleField(nameRating, typeSearchFieldDataType.Double, facetableTrue, filterableTrue, sortableTrue),ComplexField(nameAddress, fields[SearchableField(nameStreetAddress, typeSearchFieldDataType.String),SearchableField(nameCity, typeSearchFieldDataType.String, facetableTrue, filterableTrue, sortableTrue),SearchableField(nameStateProvince, typeSearchFieldDataType.String, facetableTrue, filterableTrue, sortableTrue),SearchableField(namePostalCode, typeSearchFieldDataType.String, facetableTrue, filterableTrue, sortableTrue),SearchableField(nameCountry, typeSearchFieldDataType.String, facetableTrue, filterableTrue, sortableTrue),])]
cors_options CorsOptions(allowed_origins[*], max_age_in_seconds60)
scoring_profiles []
suggester [{name: sg, source_fields: [Tags, Address/City, Address/Country]}]在另一个单元格中构建请求。 此 create_index 请求以搜索服务的索引集合为目标并基于在上一单元格中提供的索引架构创建 SearchIndex。 index SearchIndex(namename,fieldsfields,scoring_profilesscoring_profiles,suggesters suggester,cors_optionscors_options)try:result admin_client.create_index(index)print (Index, result.name, created)
except Exception as ex:print (ex)运行每个步骤。 加载文档
若要加载文档请使用操作类型上传、合并上传等的索引操作来创建文档集合。 文档源自 GitHub 上的 HotelsData。 在新单元格中提供符合索引架构的四个文档。 指定每个文档的上传操作。 documents [{search.action: upload,HotelId: 1,HotelName: Secret Point Motel,Description: The hotel is ideally located on the main commercial artery of the city in the heart of New York. A few minutes away is Times Square and the historic centre of the city, as well as other places of interest that make New York one of Americas most attractive and cosmopolitan cities.,Description_fr: Lhôtel est idéalement situé sur la principale artère commerciale de la ville en plein cœur de New York. A quelques minutes se trouve la place du temps et le centre historique de la ville, ainsi que dautres lieux dintérêt qui font de New York lune des villes les plus attractives et cosmopolites de lAmérique.,Category: Boutique,Tags: [ pool, air conditioning, concierge ],ParkingIncluded: false,LastRenovationDate: 1970-01-18T00:00:00Z,Rating: 3.60,Address: {StreetAddress: 677 5th Ave,City: New York,StateProvince: NY,PostalCode: 10022,Country: USA}},{search.action: upload,HotelId: 2,HotelName: Twin Dome Motel,Description: The hotel is situated in a nineteenth century plaza, which has been expanded and renovated to the highest architectural standards to create a modern, functional and first-class hotel in which art and unique historical elements coexist with the most modern comforts.,Description_fr: Lhôtel est situé dans une place du XIXe siècle, qui a été agrandie et rénovée aux plus hautes normes architecturales pour créer un hôtel moderne, fonctionnel et de première classe dans lequel lart et les éléments historiques uniques coexistent avec le confort le plus moderne.,Category: Boutique,Tags: [ pool, free wifi, concierge ],ParkingIncluded: false,LastRenovationDate: 1979-02-18T00:00:00Z,Rating: 3.60,Address: {StreetAddress: 140 University Town Center Dr,City: Sarasota,StateProvince: FL,PostalCode: 34243,Country: USA}},{search.action: upload,HotelId: 3,HotelName: Triple Landscape Hotel,Description: The Hotel stands out for its gastronomic excellence under the management of William Dough, who advises on and oversees all of the Hotels restaurant services.,Description_fr: Lhôtel est situé dans une place du XIXe siècle, qui a été agrandie et rénovée aux plus hautes normes architecturales pour créer un hôtel moderne, fonctionnel et de première classe dans lequel lart et les éléments historiques uniques coexistent avec le confort le plus moderne.,Category: Resort and Spa,Tags: [ air conditioning, bar, continental breakfast ],ParkingIncluded: true,LastRenovationDate: 2015-09-20T00:00:00Z,Rating: 4.80,Address: {StreetAddress: 3393 Peachtree Rd,City: Atlanta,StateProvince: GA,PostalCode: 30326,Country: USA}},{search.action: upload,HotelId: 4,HotelName: Sublime Cliff Hotel,Description: Sublime Cliff Hotel is located in the heart of the historic center of Sublime in an extremely vibrant and lively area within short walking distance to the sites and landmarks of the city and is surrounded by the extraordinary beauty of churches, buildings, shops and monuments. Sublime Cliff is part of a lovingly restored 1800 palace.,Description_fr: Le sublime Cliff Hotel est situé au coeur du centre historique de sublime dans un quartier extrêmement animé et vivant, à courte distance de marche des sites et monuments de la ville et est entouré par lextraordinaire beauté des églises, des bâtiments, des commerces et Monuments. Sublime Cliff fait partie dun Palace 1800 restauré avec amour.,Category: Boutique,Tags: [ concierge, view, 24-hour front desk service ],ParkingIncluded: true,LastRenovationDate: 1960-02-06T00:00:00Z,Rating: 4.60,Address: {StreetAddress: 7400 San Pedro Ave,City: San Antonio,StateProvince: TX,PostalCode: 78216,Country: USA}}
]在另一个单元格中构建请求。 此 upload_documents 请求以 hotels-quickstart 索引的文档集合为目标将在上一步骤中提供的文档推送到 Azure AI 搜索索引。 try:result search_client.upload_documents(documentsdocuments)print(Upload of new document succeeded: {}.format(result[0].succeeded))
except Exception as ex:print (ex.message)运行每个步骤将文档推送到搜索服务中的索引。 搜索索引
此步骤说明如何使用 search.client 类的 search 方法来查询索引。 下面的步骤执行空搜索 (search*)返回任意文档的未排名列表搜索分数 1.0。 由于没有条件因此所有文档都包含在结果中。 此查询仅输出每个文档中的两个字段。 它还会添加 include_total_countTrue 以获取结果中所有文档 (4) 的计数。 results search_client.search(search_text*, include_total_countTrue)print (Total Documents Matching Query:, results.get_count())
for result in results:print({}: {}.format(result[HotelId], result[HotelName]))下一个查询将整个术语添加到搜索表达式 (“wifi”)。 此查询指定结果仅包含 select 语句中的那些字段。 限制返回的字段可最大程度地减少通过网络发回的数据量并降低搜索延迟。 results search_client.search(search_textwifi, include_total_countTrue, selectHotelId,HotelName,Tags)print (Total Documents Matching Query:, results.get_count())
for result in results:print({}: {}: {}.format(result[HotelId], result[HotelName], result[Tags]))接下来应用筛选表达式仅返回评分高于 4 的酒店按降序排列。 results search_client.search(search_texthotels, selectHotelId,HotelName,Rating, filterRating gt 4, order_byRating desc)for result in results:print({}: {} - {} rating.format(result[HotelId], result[HotelName], result[Rating]))添加 search_fields一个数组将查询匹配的范围限制为单一字段。 results search_client.search(search_textsublime, search_fields[HotelName], selectHotelId,HotelName)for result in results:print({}: {}.format(result[HotelId], result[HotelName]))Facet 是可用于组成 Facet 导航结构的标签。 此查询返回类别的 Facet 和计数。 results search_client.search(search_text*, facets[Category])facets results.get_facets()for facet in facets[Category]:print( {}.format(facet))在此示例中根据文档的键查找特定的文档。 当用户选择搜索结果中的文档时你通常需要返回文档。 result search_client.get_document(key3)print(Details for hotel 3 are:)
print(Name: {}.format(result[HotelName]))
print(Rating: {}.format(result[Rating]))
print(Category: {}.format(result[Category]))在最后一个示例中我们将使用自动完成函数。 “自动完成”通常在搜索框中使用以便在用户在搜索框中键入时提供可能的匹配项。 创建索引时还会创建名为“sg”的建议器作为请求的一部分。 建议器定义指定哪些字段可用于查找建议器请求的潜在匹配。 在此示例中这些字段是“标签”、“地址/城市”、“地址/国家/地区”。 若要模拟自动完成请输入字母“sa”作为字符串的一部分。 SearchClient 的自动完成方法会发回可能的术语匹配。 search_suggestion sa
results search_client.autocomplete(search_textsearch_suggestion, suggester_namesg, modetwoTerms)print(Autocomplete for:, search_suggestion)
for result in results:print (result[text])关注TechLead分享AI全维度知识。作者拥有10年互联网服务架构、AI产品研发经验、团队管理经验同济本复旦硕复旦机器人智能实验室成员阿里云认证的资深架构师项目管理专业人士上亿营收AI产品研发负责人。
