Foundatio.Parsers.ElasticQueries
7.17.1
Prefix Reserved
See the version list below for details.
dotnet add package Foundatio.Parsers.ElasticQueries --version 7.17.1
NuGet\Install-Package Foundatio.Parsers.ElasticQueries -Version 7.17.1
<PackageReference Include="Foundatio.Parsers.ElasticQueries" Version="7.17.1" />
paket add Foundatio.Parsers.ElasticQueries --version 7.17.1
#r "nuget: Foundatio.Parsers.ElasticQueries, 7.17.1"
// Install Foundatio.Parsers.ElasticQueries as a Cake Addin #addin nuget:?package=Foundatio.Parsers.ElasticQueries&version=7.17.1 // Install Foundatio.Parsers.ElasticQueries as a Cake Tool #tool nuget:?package=Foundatio.Parsers.ElasticQueries&version=7.17.1
A lucene style query parser that is extensible and allows additional syntax features. Also includes an Elasticsearch query_string query replacement that greatly enhances its capabilities for dynamic queries.
Getting Started (Development)
This package can be installed via the NuGet package manager. If you need help, please contact us via in-app support or open an issue. We’re always here to help if you have any questions!
- You will need to have Visual Studio Code installed.
- Open the
Foundatio.Parsers.sln
Visual Studio solution file.
Using LuceneQueryParser
Below is a small sampling of the things you can accomplish with LuceneQueryParser, so check it out! We use this library extensively in Exceptionless!
In the sample below we will parse a query and output it's structure using the DebugQueryVisitor
and then generate the same exact query using the parse result.
using Foundatio.Parsers.LuceneQueries;
using Foundatio.Parsers.LuceneQueries.Visitors;
var parser = new LuceneQueryParser();
var result = parser.Parse("field:[1 TO 2]");
Debug.WriteLine(DebugQueryVisitor.Run(result));
Here is the parse result as shown from the DebugQueryVisitor
Group:
Left - Term:
TermMax: 2
TermMin: 1
MinInclusive: True
MaxInclusive: True
Field:
Name: field
Finally, lets translate the parse result back into the original query.
var generatedQuery = GenerateQueryVisitor.Run(result);
System.Diagnostics.Debug.Assert(query == generatedQuery);
Aggregation Syntax
Features
- Lucene Query Syntax Parser
- Parsers fairly standardized syntax from Lucene and Elasticsearch.
- Visitors for extensibility
- Field Aliases (static and dynamic)
- Query Includes
- Define stored queries that can be included inside other queries as macros that will be expanded
- Validation
- Validate query syntax
- Restrict access to specific fields
- Restrict the number of operations allowed
- Restrict nesting depth
- Elasticsearch
- Elastic query string query replacement on steriods
- Dynamic search and filter expressions
- Dynamic aggregation expressions
- Supported bucket aggregations: terms, geo grid, date histogram, numeric histogram
- Bucket aggregations allow nesting other dynamic aggregations inside
- Supported metric aggregations: min, max, avg, sum, stats, extended stats, cardinality, missing, percentiles
- Supported bucket aggregations: terms, geo grid, date histogram, numeric histogram
- Dynamic sort expressions
- Dynamic expressions can be exposed to end users to allow for custom searches, filters, sorting and aggregations
- Enables allowing users to build custom views, charts and dashboards
- Enables powerful APIs that allow users to do things you never thought of
- Supports geo queries (proximity and radius)
- mygeo:75044~75mi
- Returns all documents that have a value in the mygeo field that is within a 75 mile radius of the 75044 zip code
- mygeo:75044~75mi
- Supports nested document mappings
- Automatically resolves non-analyzed keyword sub-fields for sorting and aggregations
- Aliases can be defined right on your NEST mappings
- Supports both root and inner field name aliases
Thanks to all the people who have contributed
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Exceptionless.DateTimeExtensions (>= 3.4.0)
- Foundatio.Parsers.LuceneQueries (>= 7.17.1)
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.0)
- NEST (>= 7.17.0)
- System.Text.Json (>= 6.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Foundatio.Parsers.ElasticQueries:
Package | Downloads |
---|---|
Foundatio.Repositories.Elasticsearch
Generic Repository implementations for Elasticsearch. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
7.17.11 | 692 | 9/27/2024 |
7.17.10 | 1,499 | 9/4/2024 |
7.17.9 | 346 | 8/31/2024 |
7.17.8 | 102 | 8/31/2024 |
7.17.7 | 9,447 | 3/27/2024 |
7.17.6 | 4,534 | 1/5/2024 |
7.17.4 | 10,658 | 6/23/2023 |
7.17.3 | 25,168 | 1/1/2023 |
7.17.2 | 26,012 | 5/18/2022 |
7.17.1 | 4,290 | 3/10/2022 |
7.17.0 | 1,313 | 3/7/2022 |
7.16.2 | 1,850 | 1/21/2022 |
7.16.1 | 1,523 | 1/21/2022 |
7.16.0 | 1,484 | 1/20/2022 |
7.15.1 | 1,695 | 10/15/2021 |
7.15.0 | 1,796 | 10/11/2021 |
7.13.0 | 12,107 | 7/8/2021 |
7.12.0 | 3,662 | 4/13/2021 |
7.11.0 | 499 | 2/18/2021 |
7.10.3 | 22,850 | 2/1/2021 |
7.10.2 | 4,780 | 1/15/2021 |
7.10.1 | 536 | 1/15/2021 |
7.10.0 | 5,178 | 11/17/2020 |
7.9.0 | 4,561 | 9/16/2020 |
7.9.0-beta5 | 932 | 9/15/2020 |
7.9.0-beta4 | 424 | 9/15/2020 |
7.9.0-beta3 | 1,176 | 8/28/2020 |
7.9.0-beta2 | 845 | 8/27/2020 |
7.9.0-beta1 | 907 | 8/25/2020 |
7.8.0-beta9 | 350 | 8/3/2020 |
7.8.0-beta8 | 946 | 7/29/2020 |
7.8.0-beta7 | 1,141 | 7/9/2020 |
7.8.0-beta12 | 901 | 8/10/2020 |
7.8.0-beta11 | 987 | 8/6/2020 |
7.8.0-beta10 | 539 | 8/5/2020 |
7.7.0-beta6 | 391 | 7/2/2020 |
7.7.0-beta5 | 1,142 | 6/20/2020 |
7.7.0-beta4 | 939 | 6/14/2020 |
7.7.0-beta3 | 1,088 | 6/6/2020 |
7.7.0-beta2 | 1,043 | 5/26/2020 |
7.6.2 | 21,645 | 3/25/2020 |
7.6.1 | 624 | 3/25/2020 |
7.6.0 | 3,247 | 2/27/2020 |
7.5.4 | 2,675 | 2/13/2020 |
7.5.3 | 1,544 | 2/10/2020 |
7.5.2 | 2,334 | 1/28/2020 |
7.5.1 | 2,319 | 1/17/2020 |
7.5.0 | 1,302 | 1/16/2020 |
7.5.0-rc1 | 486 | 1/14/2020 |
7.0.497 | 12,573 | 6/27/2019 |
5.6.521 | 3,681 | 9/19/2019 |
5.6.517 | 676 | 9/19/2019 |
5.6.508 | 2,831 | 8/30/2019 |
5.6.477 | 8,866 | 4/16/2019 |
5.6.445 | 2,167 | 3/15/2019 |
5.6.443 | 1,456 | 3/14/2019 |
5.6.441 | 1,429 | 3/14/2019 |
5.6.438 | 2,487 | 2/22/2019 |
5.6.436 | 721 | 2/22/2019 |
5.6.429 | 1,072 | 1/30/2019 |
5.6.398 | 8,223 | 11/9/2018 |
5.6.396 | 1,502 | 11/9/2018 |
5.6.389 | 5,656 | 9/7/2018 |
5.6.386 | 3,825 | 5/9/2018 |
5.6.365 | 3,134 | 11/30/2017 |
5.0.353 | 5,669 | 9/14/2017 |
5.0.350 | 1,107 | 9/14/2017 |
5.0.348 | 2,812 | 8/17/2017 |
5.0.339 | 1,192 | 7/24/2017 |
5.0.336 | 1,934 | 6/23/2017 |
5.0.323 | 1,255 | 5/5/2017 |
5.0.302-pre | 841 | 3/17/2017 |
5.0.301-pre | 846 | 3/16/2017 |
5.0.300-pre | 870 | 3/16/2017 |
5.0.299-pre | 830 | 3/16/2017 |
5.0.295-pre | 839 | 3/16/2017 |
5.0.293-pre | 1,050 | 3/11/2017 |
5.0.292-pre | 912 | 3/11/2017 |
5.0.274-pre | 1,978 | 3/5/2017 |
5.0.273-pre | 1,990 | 2/28/2017 |
5.0.271-pre | 1,441 | 2/28/2017 |
5.0.270-pre | 849 | 2/28/2017 |
5.0.268-pre | 941 | 2/20/2017 |
5.0.266-pre | 5,884 | 2/16/2017 |
5.0.263-pre | 1,457 | 2/15/2017 |
5.0.261-pre | 1,383 | 2/15/2017 |
5.0.260-pre | 1,422 | 2/14/2017 |
5.0.259-pre | 1,442 | 2/14/2017 |
5.0.258-pre | 856 | 2/8/2017 |
5.0.255-pre | 850 | 2/7/2017 |
5.0.254-pre | 2,010 | 2/6/2017 |
5.0.253-pre | 1,299 | 2/6/2017 |
5.0.252-pre | 1,304 | 2/4/2017 |
5.0.251-pre | 1,326 | 2/3/2017 |
5.0.250-pre | 869 | 2/3/2017 |
5.0.248-pre | 810 | 2/2/2017 |
5.0.246-pre | 2,275 | 1/30/2017 |
5.0.245-pre | 851 | 1/29/2017 |
5.0.244-pre | 848 | 1/28/2017 |
5.0.243-pre | 855 | 1/27/2017 |
5.0.242-pre | 862 | 1/27/2017 |
5.0.241-pre | 820 | 1/24/2017 |
5.0.239-pre | 844 | 1/19/2017 |
5.0.238-pre | 828 | 1/19/2017 |
5.0.237-pre | 827 | 1/19/2017 |
5.0.235-pre | 824 | 1/19/2017 |
5.0.234-pre | 843 | 1/17/2017 |
5.0.233-pre | 4,205 | 1/12/2017 |
5.0.232-pre | 824 | 1/9/2017 |
5.0.230-pre | 871 | 1/9/2017 |
5.0.229-pre | 852 | 1/6/2017 |
5.0.226-pre | 881 | 1/5/2017 |
5.0.224-pre | 854 | 1/5/2017 |
5.0.223-pre | 2,578 | 12/29/2016 |
5.0.222-pre | 1,430 | 12/28/2016 |
5.0.220-pre | 838 | 12/22/2016 |
5.0.219-pre | 2,646 | 12/16/2016 |
5.0.216-pre | 849 | 12/15/2016 |
5.0.214-pre | 1,425 | 12/13/2016 |
5.0.213-pre | 2,262 | 12/13/2016 |
5.0.212-pre | 885 | 12/13/2016 |
5.0.211-pre | 2,249 | 12/10/2016 |
5.0.209-pre | 928 | 12/9/2016 |
5.0.205-pre | 1,371 | 12/6/2016 |
5.0.203-pre | 1,376 | 12/6/2016 |
5.0.202-pre | 876 | 12/6/2016 |
5.0.199-pre | 865 | 12/5/2016 |
5.0.198-pre | 849 | 12/5/2016 |
5.0.197-pre | 889 | 12/2/2016 |
5.0.196-pre | 885 | 11/30/2016 |
5.0.193-pre | 1,383 | 11/29/2016 |
5.0.190-pre | 899 | 11/29/2016 |
5.0.189-pre | 1,876 | 11/29/2016 |
5.0.186-pre | 1,419 | 11/29/2016 |
5.0.185-pre | 903 | 11/29/2016 |
5.0.183-pre | 904 | 11/29/2016 |
5.0.182-pre | 887 | 11/29/2016 |
5.0.181-pre | 1,421 | 11/28/2016 |
5.0.180-pre | 868 | 11/28/2016 |
5.0.177-pre | 880 | 11/28/2016 |
5.0.175-pre | 837 | 11/28/2016 |
5.0.174-pre | 915 | 11/28/2016 |
5.0.173-pre | 873 | 11/28/2016 |
5.0.171-pre | 821 | 11/26/2016 |
5.0.170-pre | 1,349 | 11/25/2016 |
5.0.169-pre | 1,397 | 11/23/2016 |
5.0.167-pre | 1,457 | 11/18/2016 |
5.0.166-pre | 895 | 11/18/2016 |
5.0.159-pre | 854 | 11/17/2016 |
2.0.153-pre | 991 | 11/16/2016 |
2.0.150-pre | 1,372 | 11/15/2016 |
2.0.149-pre | 868 | 11/15/2016 |
2.0.148-pre | 858 | 11/15/2016 |
2.0.140-pre | 863 | 11/9/2016 |
2.0.137-pre | 835 | 11/9/2016 |
2.0.135-pre | 2,299 | 10/26/2016 |
2.0.105-pre | 1,759 | 10/5/2016 |
2.0.104-pre | 830 | 10/5/2016 |
2.0.103-pre | 852 | 10/5/2016 |
2.0.101-pre | 2,196 | 10/3/2016 |
2.0.100-pre | 829 | 10/3/2016 |
2.0.99-pre | 844 | 9/30/2016 |
2.0.98-pre | 811 | 9/30/2016 |
2.0.95-pre | 845 | 9/28/2016 |
2.0.94-pre | 899 | 9/27/2016 |
1.0.318 | 1,034 | 5/4/2017 |
1.0.305 | 3,985 | 3/17/2017 |
1.0.269 | 4,276 | 2/20/2017 |
1.0.267 | 3,785 | 2/16/2017 |
1.0.264 | 1,066 | 2/16/2017 |
1.0.231 | 4,214 | 1/9/2017 |
1.0.228 | 2,296 | 1/6/2017 |
1.0.227 | 1,071 | 1/6/2017 |
1.0.210 | 3,854 | 12/9/2016 |
1.0.207 | 1,103 | 12/8/2016 |
1.0.204 | 1,700 | 12/6/2016 |
1.0.195 | 1,802 | 11/30/2016 |
1.0.192 | 1,139 | 11/29/2016 |
1.0.187 | 1,842 | 11/29/2016 |
1.0.184 | 1,130 | 11/29/2016 |
1.0.176 | 1,810 | 11/28/2016 |
1.0.168 | 2,379 | 11/18/2016 |
1.0.165 | 1,114 | 11/18/2016 |
1.0.164 | 1,148 | 11/18/2016 |
1.0.147 | 3,333 | 11/15/2016 |
1.0.143 | 1,070 | 11/10/2016 |
1.0.142 | 1,059 | 11/10/2016 |
1.0.141 | 1,068 | 11/9/2016 |
1.0.138 | 1,044 | 11/9/2016 |
1.0.136 | 1,171 | 11/9/2016 |
1.0.131 | 1,769 | 10/21/2016 |
1.0.130 | 1,081 | 10/21/2016 |
1.0.129 | 2,330 | 10/21/2016 |
1.0.128 | 1,726 | 10/21/2016 |
1.0.127 | 1,073 | 10/21/2016 |
1.0.126 | 1,066 | 10/21/2016 |
1.0.125 | 1,688 | 10/21/2016 |
1.0.124 | 1,727 | 10/20/2016 |
1.0.123 | 1,094 | 10/19/2016 |
1.0.122 | 1,064 | 10/19/2016 |
1.0.120 | 1,051 | 10/19/2016 |
1.0.119 | 1,782 | 10/18/2016 |
1.0.115 | 1,100 | 10/10/2016 |
1.0.114 | 1,047 | 10/10/2016 |
1.0.108 | 2,511 | 10/7/2016 |
1.0.102 | 1,831 | 10/3/2016 |
1.0.97 | 1,698 | 9/30/2016 |
1.0.96 | 1,073 | 9/30/2016 |
1.0.91 | 1,877 | 9/23/2016 |
1.0.87 | 5,100 | 9/20/2016 |
1.0.86 | 2,844 | 9/16/2016 |
1.0.85 | 1,068 | 9/16/2016 |
1.0.84 | 1,602 | 9/15/2016 |
1.0.82 | 3,914 | 9/13/2016 |
1.0.81 | 1,163 | 9/13/2016 |
1.0.80 | 1,654 | 9/13/2016 |
1.0.78 | 1,090 | 9/13/2016 |