elasticsearch odata netダウンロード - elasticsearch odata netソースコードのダウンロード

elasticsearch odata net

その他のカテゴリー

1.0.0

ダウンロード

elasticsearch-odata-net

このプロジェクトは、OData クエリの柔軟性と Elasticsearch の強力な検索機能の間のギャップを埋め、OData クエリ構文を利用して Elasticsearch インデックスをクエリできるようにします。複雑なネストされたオブジェクトや配列を扱う場合でも、単純な検索を実行する必要がある場合でも、この拡張機能が役に立ちます。

インストール

この拡張機能の使用を開始するには、それをプロジェクトに組み込み、Elasticsearch インスタンスを指すように構成します。簡単な例を次に示します。

PM> Install-Package Nest.OData

 TargetFramework: net8.0

Dependencies:
Microsoft.AspNetCore.OData (>= 8.2.5)
NEST (>= 7.17.5)

 [ HttpGet ]
public async Task < IActionResult > Get ( ODataQueryOptions < Document > queryOptions )
{
    var searchDescriptor = queryOptions . ToElasticQuery < Document > ( ) ;

    var response = await _elasticClient . SearchAsync < Document > ( searchDescriptor ) ;

    if ( response . IsValid )
    {
        return Ok ( response . Documents ) ;
    }
    else
    {
        return BadRequest ( ) ;
    }
}

Document 、Elasticsearch インデックスにマップするドキュメントクラスに置き換えます。

特徴

この拡張機能は、特に Elasticsearch のクエリ DSL に合わせて調整された、幅広い OData クエリ機能をサポートします。できることは次のとおりです。

サポートされている機能

フィルタリング( $filter ): OData フィルターを Elasticsearch クエリ DSL に変換し、論理演算子、比較演算、およびいくつかの基本関数をサポートします。
順序付け( $orderby ): ネストされたオブジェクトのサポートを含む、複数のフィールドによる並べ替えのサポート。
ページネーション( $skipおよび$top ): Elasticsearch のfromパラメーターとsizeパラメーターを使用してページネーションを実装します。
集計( $apply ): sum 、 max 、 min 、 average 、 countdistinctなどのgroupbyおよび集計関数を含む、集計変換の変換のサポート。
選択( $select ): 応答に含めるフィールドを指定して、ペイロードサイズを削減し、関連するデータに焦点を当てる機能。
展開( $expand ): 複雑なネストされたオブジェクトに対する追加の$filterおよび$select条件の適用をサポートします。

サポートされている OData 論理演算子

Equals (eq)
Not Equals (ne)
Greater Than (gt)
Greater Than or Equal (ge)
Less Than (lt)
Less Than or Equal (le)
And
Or
In

サポートされている OData 関数

startswith
endswith
contains
substringof

サポートされている Lambda 演算子

any
all

列挙型とコレクションの処理

列挙型は文字列として扱われるため、追加の変換手順を行わずに直接比較できます。単純な配列やネストされたオブジェクトを含むコレクションは、any 関数と all 関数を使用してクエリできるため、複雑なデータ構造を操作するためのシームレスなエクスペリエンスが提供されます。

高度なクエリのシナリオ

この拡張機能はネストされたクエリのサポートを提供し、ドキュメント内のネストされたオブジェクトや配列を詳細に調べて詳細な検索を実行できるようにします。ネストされたオブジェクトのプロパティでフィルタリングする場合でも、特定の要素の配列をクエリする場合でも、この拡張機能は OData クエリを効率的な Elasticsearch DSL クエリに変換します。

$filter=Tags/any(t: t/Name eq 'bug')

{
    "query" : {
        "nested" : {
            "path" : " Tags " ,
            "query" : {
              "term" : {
                  "Name" : {
                    "value" : " bug "
                  }
              }
          }
      }
  }
}

$filter=Category in ('Electronics', 'Books')

{
  "query" : {
    "terms" : {
      "Category" : [ " Electronics " , " Books " ]
    }
  }
}

$filter=Id eq 42 and ((Color eq 'Red') or (Color eq 'Green') or (Color eq 'Blue'))

{
  "query" : {
    "bool" : {
      "must" : [
        {
          "term" : {
            "Id" : {
              "value" : 42
            }
          }
        },
        {
          "bool" : {
            "minimum_should_match" : 1 ,
            "should" : [
              {
                "term" : {
                  "Color" : {
                    "value" : " Red "
                  }
                }
              },
              {
                "term" : {
                  "Color" : {
                    "value" : " Green "
                  }
                }
              },
              {
                "term" : {
                  "Color" : {
                    "value" : " Blue "
                  }
                }
              }
            ]
          }
        }
      ]
    }
  }
}