Skip to content

Latest commit

 

History

History
56 lines (42 loc) · 2.37 KB

intro.asciidoc

File metadata and controls

56 lines (42 loc) · 2.37 KB

Introduction

Rapidly develop applications with the .NET client for {es}.

Designed for .NET client-application developers, you can utilize the .NET language client library, which provides a strongly-typed API and query DSL to interact with {es}. The .NET client library is designed to make it easy to use {es} from your .NET applications. The .NET client includes higher-level abstractions, such as helpers for coordinating bulk indexing and update operations. It also comes with built-in, configurable cluster failover retry mechanisms.

The {es} .NET client is available as a NuGet package that can be used in .NET Core, .NET 5+ and .NET Framework (4.6.1 and higher) applications.

NOTE: This documentation relates to the v8 .NET client for {es}, designed for use with {es} 8.x versions. To develop applications targetting {es} v7, you should use the v7 (NEST) client.

Features

  • One-to-one mapping with REST API.

  • Strongly typed requests and responses for {es} APIs.

  • Fluent API for building requests.

  • Query DSL to assist with constructing search queries.

  • Helpers for common tasks such as bulk indexing of documents.

  • Pluggable serialization of requests and responses based on System.Text.Json.

  • Diagnostics, auditing, and .NET activity integration.

The .NET {es} client is built upon the Elastic Transport library which provides:

  • Connection management and load balancing across all available nodes.

  • Request retries and dead connections handling.

{es} version compatibility

Language clients are forward compatible; meaning that clients support communicating with greater or equal minor versions of {es}. {es} language clients are only backwards compatible with default distributions and without guarantees made.

Questions, bugs, comments, feature requests

Bug reports and feature requests are more than welcome on the github issues pages!

For more general questions and comments, we monitor questions and discussions opened on our community forum, discuss.elastic.co. Mentioning .NET in the title helps folks quickly identify what the question is about.