安装
编辑安装编辑
本页介绍如何安装 Elasticsearch 的 .NET 客户端。
v8 .NET 客户端与 v7 NEST
客户端的功能并不完全相同。在支持更多端点和功能之前,它可能不适合所有应用程序。因此,我们建议您在尝试将现有应用程序迁移到 Elastic.Clients.Elasticsearch
库之前,仔细阅读我们的 发行说明。在新的客户端支持应用程序所需的所有端点和功能之前,您可以继续使用 7.17.x NEST 客户端,通过兼容模式与 v8 Elasticsearch 服务器通信。有关配置 7.17.x 客户端的指南,请参阅 使用 v7.17.x 客户端连接到 Elasticsearch v8.x 文档。
安装 .NET 客户端编辑
对于 SDK 风格的项目,您可以在终端中运行以下 .NET CLI 命令来安装 Elasticsearch 客户端
dotnet add package Elastic.Clients.Elasticsearch
此命令将为您的项目 (csproj) 文件添加对客户端最新稳定版本的包引用。
如果您愿意,您也可以在项目文件中手动添加包引用
<PackageReference Include="Elastic.Clients.Elasticsearch" Version="{latest-version}" />
注意:版本号应反映 NuGet.org 上发布的最新版本。要安装其他版本,请根据需要修改版本号。
对于 Visual Studio 用户,也可以使用以下命令从 Visual Studio 中的包管理器控制台中安装 .NET 客户端
Install-Package Elastic.Clients.Elasticsearch
或者,在 NuGet 包管理器 UI 中搜索 Elastic.Clients.Elasticsearch
。
要了解如何连接 Elasticsearch 客户端,请参阅 连接 部分。
兼容性编辑
Elasticsearch 客户端与当前维护的 .NET 运行时版本兼容。不保证或支持与生命周期结束 (EOL) .NET 运行时的兼容性。
语言客户端是向前兼容的;这意味着客户端支持与更高或相等的 Elasticsearch 次要版本通信。Elasticsearch 语言客户端仅向后兼容默认发行版,且不提供任何保证。
有关更多信息,请参阅 生命周期结束策略。
CI 提要编辑
我们发布了客户端包的 CI 构建,包括最新的未发布功能。如果您想尝试最新的版本,可以将 CI 提要添加到您的 NuGet 包源列表中。
提要 URL:https://f.feedz.io/elastic/all/nuget/index.json
我们不建议将 CI 构建用于生产应用程序,因为它们在发布之前没有正式支持。