Azure AI 搜索的 C# 示例

了解演示 Azure AI 搜索解决方案的功能和工作流的 C# 代码示例。 这些示例使用了适用于用于 .NET 的 Azure SDKAzure AI 搜索客户端库,你可以通过以下链接来探究这些库。

目标 链接
包下载 www.nuget.org/packages/Azure.Search.Documents/
API 参考 azure.search.documents
API 测试用例 github.com/Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/tests
源代码 github.com/Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/src

SDK 示例

Azure SDK 开发团队中的代码示例演示 API 用法。 可以在 GitHub 上的 Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/samples 中找到这些示例

示例 说明
“Hello world”,同步 演示如何使用同步方法创建客户端、验证身份和处理错误。
“Hello world”,异步 演示如何使用异步方法创建客户端、验证身份和处理错误。
服务级操作 演示如何创建索引、索引器、数据源、技能组和同义词映射。 此示例还演示如何获取服务统计信息以及如何查询索引。
索引操作 演示如何对现有索引执行操作,在此示例中,演示如何获取索引中存储的文档数。
FieldBuilderIgnore 演示用于处理不受支持的数据类型的方法。
为文档编制索引(推送模型) 编制索引的“推送”模型,用于将 JSON 有效负载发送到服务的索引。
加密密钥示例 演示如何使用客户管理的加密密钥为敏感内容添加额外保护层。
矢量搜索示例 演示如何使用用于 .NET 的 Azure SDK 对矢量字段编制索引并执行矢量搜索。

文档示例

来自 Azure AI 搜索团队的代码示例演示了功能和工作流。 在详细解释代码的教程、快速入门和操作方法文章中引用了以下所有示例。 可以在 GitHub 上的 Azure-Samples/azure-search-dotnet-samplesAzure-Samples/search-dotnet-getting-started 中找到这些示例 。

提示

请尝试使用示例浏览器来搜索 GitHub 中的 Azure 代码示例,搜索时可按产品、服务和语言进行筛选。

代码示例 相关文章 用途
create-mvc-app 教程:将搜索添加到 ASP.NET Core (MVC) 应用 虽然大多数示例都是控制台应用程序,但此 MVC 示例使用网页作为酒店索引示例的前端,演示了基本搜索、分页和其他服务器端行为。
快速入门 快速入门:使用 Azure SDK 进行全文搜索 介绍在 C# 中使用示例数据来创建、加载和查询搜索索引的基本工作流。
search-website 教程:向 Web 应用添加搜索 演示一个端到端搜索应用,其中包含一个富客户端以及用于托管应用和处理搜索请求的组件。
tutorial-ai-enrichment 教程:AI 从 Azure Blob 生成的可搜索内容 演示如何配置索引器和技能组。
multiple-data-sources 教程:从多个数据源编制索引 将来自两个数据源的内容合并到一个搜索索引中。
Optimize-data-indexing 教程:使用推送 API 优化索引编制 演示将数据推送到搜索索引中的优化技术。
DotNetHowTo 如何使用 .NET 客户端库 逐步讲解基本工作流,但更详细并讨论了 API 用法。
DotNetHowToSynonyms 示例:在 C# 中添加同义词 同义词列表用于扩展查询,可提供索引外部的匹配术语。
DotNetToIndexers 教程:编制 Azure SQL 数据索引 演示如何配置具有计划、字段映射和参数的 Azure SQL 索引器。
DotNetHowToEncryptionUsingCMK 如何配置客户管理的密钥以进行数据加密 演示如何创建使用客户密钥加密的对象。
DotNetVectorDemo 自述文件 创建、加载和查询矢量存储。
DotNetIntegratedVectorizationDemo 自述文件 扩展矢量工作流,包括基于技能的数据分块和嵌入自动化。

加速器

加速器是一种端到端解决方案,其中包括你可以根据自己的特定方案实施进行调整的代码和文档。

示例 存储库 说明
搜索 + QnA Maker 加速器 search-qna-maker-accelerator 一种解决方案,结合了搜索和 QnA Maker 的功能。 请参阅实时演示网站
知识挖掘解决方案加速器 azure-search-knowledge-mining 包括模板、支持文件和分析报表,以帮助你建立端到端知识挖掘解决方案的原型。

演示

演示存储库为演示中显示的示例或方案提供概念证明源代码。 演示解决方案并不是为客户进行调整而设计的。

示例 存储库 说明
Covid-19 搜索应用 covid19search 基于 Azure AI 搜索的 Covid-19 搜索应用的源代码存储库
JFK 演示 AzureSearch_JFK_Files 详细了解 JFK 解决方案

其他示例

以下示例也由 Azure AI 搜索团队发布,但没有在文档中引用。 相关的自述文件提供了使用说明。

示例 存储库 说明
查询多项服务 azure-search-dotnet-scale 跨多个搜索服务发出单个查询并将结果组合到单个页面中。
检查存储 azure-search-dotnet-utilities 调用一个按计划检查搜索服务存储的 Azure 函数。
导出索引 azure-search-dotnet-utilities 对大型索引进行分区和导出操作的 C# 控制台应用。
备份和还原索引 azure-search-dotnet-utilities C# 控制台应用,将索引从一项服务复制到另一项服务,并在此过程中使用索引架构和文档在你的计算机上创建 JSON 文件。
使用 Microsoft Entra ID 为 Data Lake Gen2 编制索引 azure-search-dotnet-utilities 源代码,用于演示索引器连接,以及为通过 Microsoft Entra ID 和基于角色的访问控制进行保护的 Azure Data Lake Gen2 文件和文件夹编制索引。
搜索聚合 azure-search-dotnet-utilities 对源代码进行概念证明,演示如何从搜索索引获取聚合,然后按它们进行筛选。
Power Skills azure-search-power-skills 可合并到你自己的解决方案中的可耗用自定义技能的源代码。