elastic-enterprise-search 8.1.1 → 8.3.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.ci/jobs/{elastic+enterprise-search-ruby+7.15.yml → elastic+enterprise-search-ruby+7.17.yml} +4 -4
- data/.ci/jobs/{elastic+enterprise-search-ruby+7.16.yml → elastic+enterprise-search-ruby+8.0.yml} +4 -4
- data/.ci/jobs/elastic+enterprise-search-ruby+8.1.yml +12 -0
- data/.ci/jobs/elastic+enterprise-search-ruby+8.2.yml +12 -0
- data/.ci/run-enterprise-search.sh +1 -0
- data/.ci/test-matrix.yml +1 -1
- data/docs/guide/app-search-api.asciidoc +21 -0
- data/docs/guide/connecting.asciidoc +14 -0
- data/docs/guide/enterprise-search-api.asciidoc +17 -2
- data/docs/guide/index.asciidoc +1 -1
- data/docs/guide/overview.asciidoc +4 -2
- data/docs/guide/release_notes/82.asciidoc +42 -0
- data/docs/guide/release_notes/index.asciidoc +3 -0
- data/elastic-enterprise-search.gemspec +1 -1
- data/lib/elastic/app-search/api/adaptive_relevance_settings.rb +1 -0
- data/lib/elastic/app-search/api/adaptive_relevance_suggestions.rb +2 -1
- data/lib/elastic/app-search/api/add_meta_engine_source.rb +1 -0
- data/lib/elastic/app-search/api/api_key.rb +1 -0
- data/lib/elastic/app-search/api/api_logs.rb +1 -0
- data/lib/elastic/app-search/api/count_analytics.rb +1 -0
- data/lib/elastic/app-search/api/crawler_active_crawl_request.rb +1 -0
- data/lib/elastic/app-search/api/crawler_crawl_request.rb +1 -0
- data/lib/elastic/app-search/api/crawler_crawl_schedule.rb +1 -0
- data/lib/elastic/app-search/api/crawler_domain.rb +1 -0
- data/lib/elastic/app-search/api/crawler_domain_validation_result.rb +1 -0
- data/lib/elastic/app-search/api/crawler_metrics.rb +1 -0
- data/lib/elastic/app-search/api/crawler_overview.rb +1 -0
- data/lib/elastic/app-search/api/crawler_process_crawl.rb +1 -0
- data/lib/elastic/app-search/api/crawler_process_crawl_denied_urls.rb +1 -0
- data/lib/elastic/app-search/api/crawler_url_extraction_result.rb +1 -0
- data/lib/elastic/app-search/api/crawler_url_tracing_result.rb +1 -0
- data/lib/elastic/app-search/api/crawler_url_validation_result.rb +1 -0
- data/lib/elastic/app-search/api/crawler_user_agent.rb +1 -0
- data/lib/elastic/app-search/api/create_api_key.rb +1 -0
- data/lib/elastic/app-search/api/create_crawler_crawl_request.rb +1 -0
- data/lib/elastic/app-search/api/create_crawler_crawl_rule.rb +1 -0
- data/lib/elastic/app-search/api/create_crawler_domain.rb +1 -0
- data/lib/elastic/app-search/api/create_crawler_entry_point.rb +1 -0
- data/lib/elastic/app-search/api/create_crawler_process_crawl.rb +1 -0
- data/lib/elastic/app-search/api/create_crawler_sitemap.rb +1 -0
- data/lib/elastic/app-search/api/create_curation.rb +2 -1
- data/lib/elastic/app-search/api/create_engine.rb +1 -0
- data/lib/elastic/app-search/api/create_synonym_set.rb +1 -0
- data/lib/elastic/app-search/api/curation.rb +1 -0
- data/lib/elastic/app-search/api/delete_api_key.rb +1 -0
- data/lib/elastic/app-search/api/delete_crawler_active_crawl_request.rb +1 -0
- data/lib/elastic/app-search/api/delete_crawler_crawl_rule.rb +1 -0
- data/lib/elastic/app-search/api/delete_crawler_crawl_schedule.rb +1 -0
- data/lib/elastic/app-search/api/delete_crawler_domain.rb +1 -0
- data/lib/elastic/app-search/api/delete_crawler_entry_point.rb +1 -0
- data/lib/elastic/app-search/api/delete_crawler_sitemap.rb +1 -0
- data/lib/elastic/app-search/api/delete_curation.rb +1 -0
- data/lib/elastic/app-search/api/delete_documents.rb +1 -0
- data/lib/elastic/app-search/api/delete_engine.rb +1 -0
- data/lib/elastic/app-search/api/delete_meta_engine_source.rb +1 -0
- data/lib/elastic/app-search/api/delete_synonym_set.rb +1 -0
- data/lib/elastic/app-search/api/documents.rb +1 -0
- data/lib/elastic/app-search/api/engine.rb +1 -0
- data/lib/elastic/app-search/api/index_documents.rb +1 -0
- data/lib/elastic/app-search/api/list_adaptive_relevance_suggestions.rb +2 -1
- data/lib/elastic/app-search/api/list_api_keys.rb +1 -0
- data/lib/elastic/app-search/api/list_crawler_crawl_requests.rb +1 -0
- data/lib/elastic/app-search/api/list_crawler_domains.rb +1 -0
- data/lib/elastic/app-search/api/list_crawler_process_crawls.rb +1 -0
- data/lib/elastic/app-search/api/list_curations.rb +1 -0
- data/lib/elastic/app-search/api/list_documents.rb +1 -0
- data/lib/elastic/app-search/api/list_engines.rb +1 -0
- data/lib/elastic/app-search/api/list_synonym_sets.rb +1 -0
- data/lib/elastic/app-search/api/log_clickthrough.rb +1 -0
- data/lib/elastic/app-search/api/multi_search.rb +8 -6
- data/lib/elastic/app-search/api/put_adaptive_relevance_settings.rb +2 -1
- data/lib/elastic/app-search/api/put_adaptive_relevance_suggestions.rb +1 -0
- data/lib/elastic/app-search/api/put_api_key.rb +1 -0
- data/lib/elastic/app-search/api/put_crawler_crawl_rule.rb +1 -0
- data/lib/elastic/app-search/api/put_crawler_crawl_schedule.rb +1 -0
- data/lib/elastic/app-search/api/put_crawler_domain.rb +1 -0
- data/lib/elastic/app-search/api/put_crawler_entry_point.rb +1 -0
- data/lib/elastic/app-search/api/put_crawler_sitemap.rb +1 -0
- data/lib/elastic/app-search/api/put_curation.rb +2 -1
- data/lib/elastic/app-search/api/put_documents.rb +1 -0
- data/lib/elastic/app-search/api/put_schema.rb +1 -0
- data/lib/elastic/app-search/api/put_search_settings.rb +1 -0
- data/lib/elastic/app-search/api/put_synonym_set.rb +1 -0
- data/lib/elastic/app-search/api/query_suggestion.rb +1 -0
- data/lib/elastic/app-search/api/refresh_adaptive_relevance_update_process.rb +1 -0
- data/lib/elastic/app-search/api/reset_search_settings.rb +1 -0
- data/lib/elastic/app-search/api/schema.rb +1 -0
- data/lib/elastic/app-search/api/search.rb +1 -0
- data/lib/elastic/app-search/api/search_es_search.rb +54 -0
- data/lib/elastic/app-search/api/search_explain.rb +62 -0
- data/lib/elastic/app-search/api/search_settings.rb +1 -0
- data/lib/elastic/app-search/api/synonym_set.rb +1 -0
- data/lib/elastic/app-search/api/top_clicks_analytics.rb +1 -0
- data/lib/elastic/app-search/api/top_queries_analytics.rb +1 -0
- data/lib/elastic/enterprise-search/api/health.rb +1 -0
- data/lib/elastic/enterprise-search/api/put_read_only.rb +1 -0
- data/lib/elastic/enterprise-search/api/read_only.rb +1 -0
- data/lib/elastic/enterprise-search/api/search_engines.rb +44 -0
- data/lib/elastic/enterprise-search/api/stats.rb +1 -0
- data/lib/elastic/enterprise-search/api/version.rb +2 -1
- data/lib/elastic/enterprise-search/version.rb +1 -1
- data/lib/elastic/workplace-search/api/auto_query_refinement_details.rb +1 -0
- data/lib/elastic/workplace-search/api/command_sync_jobs.rb +1 -0
- data/lib/elastic/workplace-search/api/content_source.rb +1 -0
- data/lib/elastic/workplace-search/api/create_analytics_event.rb +1 -0
- data/lib/elastic/workplace-search/api/create_batch_synonym_sets.rb +1 -0
- data/lib/elastic/workplace-search/api/create_content_source.rb +1 -0
- data/lib/elastic/workplace-search/api/create_external_identity.rb +1 -0
- data/lib/elastic/workplace-search/api/current_user.rb +1 -0
- data/lib/elastic/workplace-search/api/delete_content_source.rb +1 -0
- data/lib/elastic/workplace-search/api/delete_documents.rb +1 -0
- data/lib/elastic/workplace-search/api/delete_documents_by_query.rb +1 -0
- data/lib/elastic/workplace-search/api/delete_external_identity.rb +1 -0
- data/lib/elastic/workplace-search/api/delete_synonym_set.rb +1 -0
- data/lib/elastic/workplace-search/api/document.rb +1 -0
- data/lib/elastic/workplace-search/api/external_identity.rb +1 -0
- data/lib/elastic/workplace-search/api/index_documents.rb +1 -0
- data/lib/elastic/workplace-search/api/list_content_sources.rb +1 -0
- data/lib/elastic/workplace-search/api/list_documents.rb +1 -0
- data/lib/elastic/workplace-search/api/list_external_identities.rb +1 -0
- data/lib/elastic/workplace-search/api/list_synonym_sets.rb +1 -0
- data/lib/elastic/workplace-search/api/put_content_source.rb +1 -0
- data/lib/elastic/workplace-search/api/put_content_source_icons.rb +1 -0
- data/lib/elastic/workplace-search/api/put_external_identity.rb +1 -0
- data/lib/elastic/workplace-search/api/put_synonym_set.rb +1 -0
- data/lib/elastic/workplace-search/api/put_triggers_blocklist.rb +1 -0
- data/lib/elastic/workplace-search/api/search.rb +1 -0
- data/lib/elastic/workplace-search/api/synonym_set.rb +1 -0
- data/lib/elastic/workplace-search/api/triggers_blocklist.rb +1 -0
- data/spec/integration/app-search/elasticsearch_search_spec.rb +63 -0
- data/spec/integration/app-search/explain_search_spec.rb +59 -0
- data/spec/integration/enterprise_search_api_spec.rb +11 -0
- metadata +16 -8
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 95fb62ab62fbcabaccdcdbebc1b8caf15fbfe6ca1cec388af5778da738ce0aff
|
4
|
+
data.tar.gz: 1ce82e08b5ab98ea8a0ea47076806b709e765b98b01d6ecb1c1a3284b3660922
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 6681c1fb77c29e120cc726345bc97e244aada238720255ad375bf8e6447beb31b4bbeb6283f4153196c6be42f8a807e1b234dd3caa064d5d2fd4da021965e800
|
7
|
+
data.tar.gz: df33f6629dcf8b0ec537b47619fbcce2327cb715a69536df22ed6693429948874c49f2728504a0ae11c351d73020865f77e42ca3addfe0226ba7e1ce570da021
|
data/.ci/jobs/{elastic+enterprise-search-ruby+7.15.yml → elastic+enterprise-search-ruby+7.17.yml}
RENAMED
@@ -1,12 +1,12 @@
|
|
1
1
|
---
|
2
2
|
- job:
|
3
|
-
name: elastic+enterprise-search-ruby+7.
|
4
|
-
display-name: 'elastic / enterprise-search-ruby # 7.
|
5
|
-
description: Testing the enterprise-search-ruby 7.
|
3
|
+
name: elastic+enterprise-search-ruby+7.17
|
4
|
+
display-name: 'elastic / enterprise-search-ruby # 7.17'
|
5
|
+
description: Testing the enterprise-search-ruby 7.17 branch.
|
6
6
|
junit_results: "*-junit.xml"
|
7
7
|
parameters:
|
8
8
|
- string:
|
9
9
|
name: branch_specifier
|
10
|
-
default: refs/heads/7.
|
10
|
+
default: refs/heads/7.17
|
11
11
|
description: the Git branch specifier to build (<branchName>, <tagName>,
|
12
12
|
<commitId>, etc.)
|
data/.ci/jobs/{elastic+enterprise-search-ruby+7.16.yml → elastic+enterprise-search-ruby+8.0.yml}
RENAMED
@@ -1,12 +1,12 @@
|
|
1
1
|
---
|
2
2
|
- job:
|
3
|
-
name: elastic+enterprise-search-ruby+
|
4
|
-
display-name: 'elastic / enterprise-search-ruby #
|
5
|
-
description: Testing the enterprise-search-ruby
|
3
|
+
name: elastic+enterprise-search-ruby+8.0
|
4
|
+
display-name: 'elastic / enterprise-search-ruby # 8.0'
|
5
|
+
description: Testing the enterprise-search-ruby 8.0 branch.
|
6
6
|
junit_results: "*-junit.xml"
|
7
7
|
parameters:
|
8
8
|
- string:
|
9
9
|
name: branch_specifier
|
10
|
-
default: refs/heads/
|
10
|
+
default: refs/heads/8.0
|
11
11
|
description: the Git branch specifier to build (<branchName>, <tagName>,
|
12
12
|
<commitId>, etc.)
|
@@ -0,0 +1,12 @@
|
|
1
|
+
---
|
2
|
+
- job:
|
3
|
+
name: elastic+enterprise-search-ruby+8.1
|
4
|
+
display-name: 'elastic / enterprise-search-ruby # 8.1'
|
5
|
+
description: Testing the enterprise-search-ruby 8.1 branch.
|
6
|
+
junit_results: "*-junit.xml"
|
7
|
+
parameters:
|
8
|
+
- string:
|
9
|
+
name: branch_specifier
|
10
|
+
default: refs/heads/8.1
|
11
|
+
description: the Git branch specifier to build (<branchName>, <tagName>,
|
12
|
+
<commitId>, etc.)
|
@@ -0,0 +1,12 @@
|
|
1
|
+
---
|
2
|
+
- job:
|
3
|
+
name: elastic+enterprise-search-ruby+8.2
|
4
|
+
display-name: 'elastic / enterprise-search-ruby # 8.2'
|
5
|
+
description: Testing the enterprise-search-ruby 8.2 branch.
|
6
|
+
junit_results: "*-junit.xml"
|
7
|
+
parameters:
|
8
|
+
- string:
|
9
|
+
name: branch_specifier
|
10
|
+
default: refs/heads/8.2
|
11
|
+
description: the Git branch specifier to build (<branchName>, <tagName>,
|
12
|
+
<commitId>, etc.)
|
@@ -54,6 +54,7 @@ docker run \
|
|
54
54
|
--env "elasticsearch.ssl.certificate=/usr/share/app-search/config/certs/testnode.crt" \
|
55
55
|
--env "elasticsearch.ssl.certificate_authority=/usr/share/app-search/config/certs/ca.crt" \
|
56
56
|
--env "elasticsearch.ssl.key=/usr/share/app-search/config/certs/testnode.key" \
|
57
|
+
--env "ELASTICSEARCH_SEARCH_API=true" \
|
57
58
|
--volume $ssl_cert:/usr/share/app-search/config/certs/testnode.crt \
|
58
59
|
--volume $ssl_key:/usr/share/app-search/config/certs/testnode.key \
|
59
60
|
--volume $ssl_ca:/usr/share/app-search/config/certs/ca.crt \
|
data/.ci/test-matrix.yml
CHANGED
@@ -336,6 +336,27 @@ client.put_adaptive_relevance_settings(engine_name, body: body)
|
|
336
336
|
client.refresh_adaptive_relevance_update_process(engine_name, adaptive_relevance_suggestion_type: 'curation')
|
337
337
|
----------------------------
|
338
338
|
|
339
|
+
=== Elasticsearch Search
|
340
|
+
|
341
|
+
Utilize the API to passthrough and execute raw Elasticsearch queries against the indices that power Enterprise Search engines.
|
342
|
+
|
343
|
+
[source,rb]
|
344
|
+
----------------------------
|
345
|
+
es_request = { body: { query: { bool: { must: { term: { title: 'test' } } } } } }
|
346
|
+
client.search_es_search(engine_name, body: { request: es_request })
|
347
|
+
----------------------------
|
348
|
+
|
349
|
+
=== Search Explain
|
350
|
+
|
351
|
+
Submit a search and retrieve an Elasticsearch query.
|
352
|
+
|
353
|
+
[source,rb]
|
354
|
+
----------------------------
|
355
|
+
response = client.search_explain(engine_name, body: { query: 'test' })
|
356
|
+
response.body['query_string']
|
357
|
+
# => "GET enterprise-search-engine-app-search-explain/_search"
|
358
|
+
----------------------------
|
359
|
+
|
339
360
|
=== Other API Endpoints
|
340
361
|
|
341
362
|
[source,rb]
|
@@ -7,6 +7,7 @@ This page contains the information you need to connect and use the Client with E
|
|
7
7
|
|
8
8
|
* <<authentication>>
|
9
9
|
* <<custom_headers>>
|
10
|
+
* <<transport>>
|
10
11
|
|
11
12
|
|
12
13
|
[discrete]
|
@@ -168,3 +169,16 @@ workplace_search_client.index_documents(
|
|
168
169
|
{ body: documents, headers: headers }
|
169
170
|
)
|
170
171
|
----------------------------
|
172
|
+
|
173
|
+
[discrete]
|
174
|
+
[[transport]]
|
175
|
+
=== Transport
|
176
|
+
|
177
|
+
The Enterprise Search Ruby client is powered by the https://github.com/elastic/elastic-transport-ruby/[`elastic-transport`] gem. You can read more about it https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/transport.html[here]. The client accepts a transport object as an initializer:
|
178
|
+
|
179
|
+
[source,rb]
|
180
|
+
----------------------------
|
181
|
+
transport = Elastic::Transport::Transport::HTTP::Curb.new
|
182
|
+
ent_client = Elastic::EnterpriseSearch::Client.new(transport: transport)
|
183
|
+
----------------------------
|
184
|
+
|
@@ -3,6 +3,8 @@
|
|
3
3
|
|
4
4
|
=== Health API
|
5
5
|
|
6
|
+
Get information on the health of a deployment and basic statistics around resource usage.
|
7
|
+
|
6
8
|
[source,rb]
|
7
9
|
----------------------------
|
8
10
|
> response = ent_client.health
|
@@ -17,6 +19,8 @@
|
|
17
19
|
|
18
20
|
=== Version API
|
19
21
|
|
22
|
+
Get version information for the server.
|
23
|
+
|
20
24
|
[source,rb]
|
21
25
|
----------------------------
|
22
26
|
> response = ent_client.version
|
@@ -29,14 +33,16 @@
|
|
29
33
|
[source,rb]
|
30
34
|
----------------------------
|
31
35
|
# Set read-only flag state
|
32
|
-
ent_client.put_read_only(body: { enabled: false })
|
36
|
+
> ent_client.put_read_only(body: { enabled: false })
|
33
37
|
|
34
38
|
# Get read-only flag state
|
35
|
-
ent_client.read_only
|
39
|
+
> ent_client.read_only
|
36
40
|
----------------------------
|
37
41
|
|
38
42
|
=== Stats API
|
39
43
|
|
44
|
+
Get information about the resource usage of the application, the state of different internal queues, etc.
|
45
|
+
|
40
46
|
[source,rb]
|
41
47
|
----------------------------
|
42
48
|
> ent_client.stats.body
|
@@ -44,3 +50,12 @@ ent_client.read_only
|
|
44
50
|
"queues"=>{"connectors"=>{...}, "document_destroyer"=>{...}, "engine_destroyer"=>{...}, "index_adder"=>{...}, ...},
|
45
51
|
"connectors"=>{"alive"=>true, "pool"=>{...}, "job_store"=>{...}}}}
|
46
52
|
----------------------------
|
53
|
+
|
54
|
+
=== Search Engines
|
55
|
+
|
56
|
+
Retrieve information about search engines
|
57
|
+
|
58
|
+
[source,rb]
|
59
|
+
----------------------------
|
60
|
+
> ent_client.search_engines
|
61
|
+
----------------------------
|
data/docs/guide/index.asciidoc
CHANGED
@@ -10,7 +10,9 @@ Current development happens in the main branch.
|
|
10
10
|
|
11
11
|
The library is compatible with all Elastic Enterprise Search versions since `7.x` but you **have to use a matching major version**:
|
12
12
|
|
13
|
-
For **Elastic Enterprise Search 7.0** and later, use the major version 7 (`7.x.y`) of the library.
|
13
|
+
* For **Elastic Enterprise Search 7.0** and later, use the major version 7 (`7.x.y`) of the library.
|
14
|
+
* For **Elastic Enterprise Search 8.0** and later, use the major version 8 (`8.x.y`) of the library.
|
15
|
+
|
14
16
|
|
15
17
|
[discrete]
|
16
18
|
=== HTTP Library
|
@@ -27,7 +29,7 @@ client = Elastic::EnterpriseSearch::Client.new(adapter: :net_http_persistent)
|
|
27
29
|
|
28
30
|
All requests, if successful, will return an `Elastic::Transport::Transport::Response` instance. You can access the response `body`, `headers` and `status`.
|
29
31
|
|
30
|
-
`elastic-transport` defines a https://github.com/elastic/elastic-transport-ruby/blob/main/lib/elastic/transport/transport/errors.rb[number of exception classes] for various client and server errors, as well as unsuccessful HTTP responses, making it possible to rescue specific exceptions with desired granularity. More details https://github.com/elastic/elastic-transport-ruby#exception-handling[here]. You can find the full documentation for `elastic-transport` at https://rubydoc.info/gems/elastic-transport[RubyDoc].
|
32
|
+
`elastic-transport` defines a https://github.com/elastic/elastic-transport-ruby/blob/main/lib/elastic/transport/transport/errors.rb[number of exception classes] for various client and server errors, as well as unsuccessful HTTP responses, making it possible to rescue specific exceptions with desired granularity. More details https://github.com/elastic/elastic-transport-ruby#exception-handling[here]. You can find the full documentation for `elastic-transport` at https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/transport.html[our official documentation] and https://rubydoc.info/gems/elastic-transport[RubyDoc].
|
31
33
|
|
32
34
|
The clients pass different options to transport, you can check them out https://rubydoc.info/github/elastic/enterprise-search-ruby/Elastic/EnterpriseSearch/Client[on RubyDocs].
|
33
35
|
|
@@ -0,0 +1,42 @@
|
|
1
|
+
[[release_notes_82]]
|
2
|
+
=== 8.2 Release notes
|
3
|
+
|
4
|
+
[discrete]
|
5
|
+
[[release_notes_821]]
|
6
|
+
=== 8.2.1 Release notes
|
7
|
+
|
8
|
+
- Adds tracer parameters to enable tracing in elastic-transport. See https://www.elastic.co/guide/en/enterprise-search-clients/ruby/current/overview.html#_logging[logging] for more information.
|
9
|
+
- Updates Workplace Search OAuth implementation. See https://www.elastic.co/guide/en/enterprise-search-clients/ruby/current/workplace-search-api.html#ws-oauth-authentication[OAuth Authentication] for changes in the OAuth process.
|
10
|
+
|
11
|
+
[discrete]
|
12
|
+
[[release_notes_820]]
|
13
|
+
=== 8.2.0 Release notes
|
14
|
+
|
15
|
+
[discrete]
|
16
|
+
==== General
|
17
|
+
|
18
|
+
- Tested with Elastic Enterprise Search API version 8.2.0.
|
19
|
+
- Tested with Ruby 2.7, 3.0, 3.1, JRuby 9.3. Older versions of Ruby have reached end of life and been removed from the testing matrices. Minimum required Ruby version is Ruby 2.6 to keep compatibility with JRuby 9.3, but it may be upgraded to 2.7 once JRuby 9.4 comes out.
|
20
|
+
|
21
|
+
[discrete]
|
22
|
+
==== App Search
|
23
|
+
[discrete]
|
24
|
+
==== New APIs
|
25
|
+
|
26
|
+
* Adds Elasticsearch Search API (In Technical Preview): Utilize the API to passthrough and execute raw Elasticsearch queries against the indices that power Enterprise Search engines.
|
27
|
+
|
28
|
+
+
|
29
|
+
[source,rb]
|
30
|
+
----------------------------
|
31
|
+
es_request = { body: { query: { bool: { must: { term: { title: 'test' } } } } } }
|
32
|
+
client.search_es_search(engine_name, body: { request: es_request })
|
33
|
+
----------------------------
|
34
|
+
|
35
|
+
* Adds Search Explain API: Submit a search and retrieve an Elasticsearch query.
|
36
|
+
+
|
37
|
+
[source,rb]
|
38
|
+
----------------------------
|
39
|
+
response = client.search_explain(engine_name, body: { query: 'test' })
|
40
|
+
response.body['query_string']
|
41
|
+
# => "GET enterprise-search-engine-app-search-explain/_search"
|
42
|
+
----------------------------
|
@@ -3,6 +3,8 @@
|
|
3
3
|
|
4
4
|
[discrete]
|
5
5
|
=== 8.x
|
6
|
+
|
7
|
+
* <<release_notes_82, 8.2.0 Release Notes>>
|
6
8
|
* <<release_notes_81, 8.1.0 Release Notes>>
|
7
9
|
* <<release_notes_80, 8.0.0 Release Notes>>
|
8
10
|
|
@@ -18,6 +20,7 @@
|
|
18
20
|
* <<release_notes_711, 7.11.0 Release Notes>>
|
19
21
|
* <<release_notes_710, 7.10.0.beta.1 Release Notes>>
|
20
22
|
|
23
|
+
include::82.asciidoc[]
|
21
24
|
include::81.asciidoc[]
|
22
25
|
include::80.asciidoc[]
|
23
26
|
include::717.asciidoc[]
|
@@ -47,7 +47,7 @@ Gem::Specification.new do |s|
|
|
47
47
|
s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
|
48
48
|
s.require_paths = ['lib']
|
49
49
|
|
50
|
-
s.add_dependency 'elastic-transport', '8
|
50
|
+
s.add_dependency 'elastic-transport', '~> 8'
|
51
51
|
s.add_runtime_dependency 'jwt', '>= 1.5', '< 3.0'
|
52
52
|
s.add_development_dependency 'awesome_print'
|
53
53
|
s.add_development_dependency 'byebug' unless defined?(JRUBY_VERSION)
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# AdaptiveRelevanceSettings - Retrieve adaptive relevance settings
|
25
26
|
# Retrieve adaptive relevance settings
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# AdaptiveRelevanceSuggestions - Retrieve adaptive relevance
|
25
26
|
# Retrieve adaptive relevance for a single query
|
@@ -29,7 +30,7 @@ module Elastic
|
|
29
30
|
# @option arguments [String] :search_suggestion_query Query to obtain suggestions (*Required*)
|
30
31
|
# @option arguments [Hash] :body
|
31
32
|
# @option body :page
|
32
|
-
# @option body [
|
33
|
+
# @option body [Hash] :filters
|
33
34
|
# @option arguments [Hash] :headers optional HTTP headers to send with the request
|
34
35
|
#
|
35
36
|
# @see https://www.elastic.co/guide/en/app-search/current/adaptive-relevance-api-reference.html#adaptive-relevance-api-get-engine-adaptive-relevance-suggestions-query
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# APILogs - Retrieve API logs
|
25
26
|
# The API Log displays API request and response data at the Engine level
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Analytics - Query for analytics counts data
|
25
26
|
# Returns the number of clicks and total number of queries over a period
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Validate Domain with Crawler
|
25
26
|
# Performs a number of checks on a given domain name to make sure it is ready to be crawled and ingested into App Search.
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Retrieve a snapshot of crawler metrics
|
25
26
|
# Retrieves a momentary snapshot of key crawler metrics, including global and node-level crawler health
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Retrieve crawler configuration overview
|
25
26
|
# Retrieves crawler configuration overview of a given engine, including configured domains
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - View denied urls for Process Crawl
|
25
26
|
# Provides a sample list of urls identified for deletion by the given process crawl id.
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Extract content from a URL
|
25
26
|
# Performs an HTTP request to a given URL and extracts content from the page using standard App Search Crawler extraction pipeline.
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Trace a history of a crawled URL
|
25
26
|
# Returns information about the history of a given URL with the App Search Crawler.
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Validate URL with Crawler
|
25
26
|
# Performs a number of checks on a given URL to make sure it is ready to be crawled and ingested into App Search.
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Get the User-Agent header value for the crawler
|
25
26
|
# Retrieves the currently configured value for the User-Agent header used for all Crawler HTTP requests
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Create a crawl request
|
25
26
|
# Creates a request to perform a crawl of a given engine with the Crawler.
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Create a crawler entry point
|
25
26
|
# Creates a crawler domain entry point for a given engine and domain
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Create a process crawl
|
25
26
|
# Queues a task to reprocess crawled documents with current crawl configuration
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Create a crawler sitemap
|
25
26
|
# Creates a crawler sitemap configuration for a given engine and domain
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Curations - Create a new curation
|
25
26
|
# Create a new curation for the engine
|
@@ -31,7 +32,7 @@ module Elastic
|
|
31
32
|
# @option body [Array<string>] :queries List of affected search queries
|
32
33
|
# @option body [Array<string>] :promoted List of promoted document IDs
|
33
34
|
# @option body [Array<string>] :hidden List of hidden document IDs
|
34
|
-
# @option body
|
35
|
+
# @option body :suggestion
|
35
36
|
# @option arguments [Hash] :headers optional HTTP headers to send with the request
|
36
37
|
#
|
37
38
|
# @see https://www.elastic.co/guide/en/app-search/current/curations.html#curations-create
|
@@ -20,6 +20,7 @@
|
|
20
20
|
module Elastic
|
21
21
|
module EnterpriseSearch
|
22
22
|
module AppSearch
|
23
|
+
# Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
|
23
24
|
module Actions
|
24
25
|
# Crawler - Cancel an active crawl request
|
25
26
|
# Cancels an active crawl request, stopping a running crawl if needed.
|