.NET clients

출처: 문서

본문

.NET 클라이언트

OpenSearch에는 두 가지 .NET 클라이언트가 있어요. 저수준 클라이언트인 OpenSearch.Net과 고수준 클라이언트인 OpenSearch.Client죠.

OpenSearch.Net은 OpenSearch와의 통신을 위한 기반 계층을 제공하는 저수준 .NET 클라이언트예요. 외부 의존성이 없으면서도 라운드 로빈 로드 밸런싱, 전송, 기본적인 요청/응답 사이클을 처리할 수 있어요. OpenSearch.Net에는 모든 OpenSearch API 엔드포인트에 대한 메서드가 들어 있어요.

OpenSearch.Client는 OpenSearch.Net 위에 구축된 고수준 .NET 클라이언트예요. 강력한 형식의 요청과 응답은 물론 Query DSL까지 제공하죠. 요청과 응답을 자동으로 파싱하고 직렬화/역직렬화해 주는 모델을 제공하기 때문에, raw JSON 요청을 직접 만들고 raw JSON 응답을 파싱하는 수고를 덜어 줘요. 필요하다면 OpenSearch.Net 저수준 클라이언트도 OpenSearch.Client를 통해 사용할 수 있고요. OpenSearch.Client에는 다음과 같은 고급 기능이 포함되어 있어요:

• Automapping: C# 타입이 주어지면 OpenSearch.Client가 OpenSearch에 보낼 올바른 매핑을 추론할 수 있어요.
• 쿼리에서의 연산자 오버로딩.
• 타입 및 인덱스 추론.

두 .NET 클라이언트 모두 콘솔 프로그램, .NET Core 애플리케이션, ASP.NET Core 애플리케이션, 워커 서비스에서 사용할 수 있어요.

OpenSearch.Client를 시작하려면 고수준 .NET 클라이언트 시작하기 문서나, 조금 더 고급 내용을 다루는 워크스루인 고수준 .NET 클라이언트의 더 많은 고급 기능 문서의 지침을 따르세요.

호환성

다음 표는 각 OpenSearch 버전과 호환되는 OpenSearch.Client 및 OpenSearch.Net 버전을 정리한 거예요.

2.x 클라이언트는 .NET 8 이상과 .NET Framework 4.7.2 이상을 지원해요. 두 클라이언트 모두 .NET Standard 2.0과 .NET Standard 2.1을 대상으로 하고, OpenSearch.Net과 OpenSearch.Net.Auth.AwsSigV4는 .NET 8과 .NET 10도 대상으로 해요.

최신 호환성 정보는 클라이언트 저장소의 COMPATIBILITY.md 파일을 참고하세요. 클라이언트 버전 간 브레이킹 체인지에 대한 내용은 업그레이드 가이드를 참고하세요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/clients/dot-net/