forked from elastic/elasticsearch
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'upstream/main' into search_pit_resolved…
…_indices
- Loading branch information
Showing
175 changed files
with
3,618 additions
and
2,710 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
pr: 103084 | ||
summary: Return `matched_queries` in Percolator | ||
area: Percolator | ||
type: enhancement | ||
issues: | ||
- 10163 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
[[connector-apis]] | ||
== Connector APIs | ||
|
||
preview::[] | ||
|
||
++++ | ||
<titleabbrev>Connector APIs</titleabbrev> | ||
++++ | ||
|
||
--- | ||
|
||
The connector and sync jobs API provides a convenient way to create and manage Elastic connectors and sync jobs in an internal index. | ||
|
||
This API provides an alternative to relying solely on {kib} UI for connector and sync job management. The API comes with a set of | ||
validations and assertions to ensure that the state representation in the internal index remains valid. | ||
|
||
[discrete] | ||
[[elastic-connector-apis]] | ||
=== Connector APIs | ||
|
||
You can use these APIs to create, get, delete and update connectors. | ||
|
||
Use the following APIs to manage connectors: | ||
|
||
* <<create-connector-api>> | ||
|
||
|
||
[discrete] | ||
[[sync-job-apis]] | ||
=== Sync Job APIs | ||
|
||
You can use these APIs to create, cancel, delete and update sync jobs. | ||
|
||
Use the following APIs to manage sync jobs: | ||
|
||
|
||
include::create-connector-api.asciidoc[] |
128 changes: 128 additions & 0 deletions
128
docs/reference/connector/apis/create-connector-api.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,128 @@ | ||
[[create-connector-api]] | ||
=== Create connector API | ||
++++ | ||
<titleabbrev>Create connector</titleabbrev> | ||
++++ | ||
|
||
Creates a connector. | ||
|
||
|
||
[source,console] | ||
-------------------------------------------------- | ||
PUT _connector/my-connector | ||
{ | ||
"index_name": "search-google-drive", | ||
"name": "My Connector", | ||
"service_type": "google_drive" | ||
} | ||
-------------------------------------------------- | ||
//// | ||
[source,console] | ||
---- | ||
DELETE _connector/my-connector | ||
---- | ||
// TEST[continued] | ||
//// | ||
|
||
[[create-connector-api-request]] | ||
==== {api-request-title} | ||
`POST _connector` | ||
|
||
`PUT _connector/<connector_id>` | ||
|
||
|
||
[[create-connector-api-prereqs]] | ||
==== {api-prereq-title} | ||
|
||
* To sync data using connectors, it's essential to have the Elastic connectors service running. | ||
* The `service_type` parameter should reference an existing connector service type. | ||
|
||
|
||
[[create-connector-api-desc]] | ||
==== {api-description-title} | ||
|
||
Creates a connector document in the internal index and initializes its configuration, filtering, and scheduling with default values. These values can be updated later as needed. | ||
|
||
[[create-connector-api-path-params]] | ||
==== {api-path-parms-title} | ||
|
||
`<connector_id>`:: | ||
(Required, string) Unique identifier of a connector. | ||
|
||
|
||
[role="child_attributes"] | ||
[[create-connector-api-request-body]] | ||
==== {api-request-body-title} | ||
|
||
`description`:: | ||
(Optional, string) The description of the connector. | ||
|
||
`index_name`:: | ||
(Required, string) The target index for syncing data by the connector. | ||
|
||
`name`:: | ||
(Optional, string) The name of the connector. | ||
|
||
`is_native`:: | ||
(Optional, boolean) Indicates if it's a native connector. Defaults to `false`. | ||
|
||
`language`:: | ||
(Optional, string) Language analyzer for the data. Limited to supported languages. | ||
|
||
`service_type`:: | ||
(Optional, string) Connector service type. Can reference Elastic-supported connector types or a custom connector type. | ||
|
||
|
||
[role="child_attributes"] | ||
[[create-connector-api-response-body]] | ||
==== {api-response-body-title} | ||
|
||
`id`:: | ||
(string) The ID associated with the connector document. Returned when using a POST request. | ||
|
||
`result`:: | ||
(string) The result of the indexing operation, `created` or `updated`. Returned when using a PUT request. | ||
|
||
[[create-connector-api-response-codes]] | ||
==== {api-response-codes-title} | ||
|
||
`200`:: | ||
Indicates that an existing connector was updated successfully. | ||
|
||
`201`:: | ||
Indicates that the connector was created successfully. | ||
|
||
`400`:: | ||
Indicates that the request was malformed. | ||
|
||
[[create-connector-api-example]] | ||
==== {api-examples-title} | ||
|
||
[source,console] | ||
---- | ||
PUT _connector/my-connector | ||
{ | ||
"index_name": "search-google-drive", | ||
"name": "My Connector", | ||
"description": "My Connector to sync data to Elastic index from Google Drive", | ||
"service_type": "google_drive", | ||
"language": "english" | ||
} | ||
---- | ||
|
||
|
||
The API returns the following result: | ||
|
||
[source,console-result] | ||
---- | ||
{ | ||
"result": "created" | ||
} | ||
---- | ||
//// | ||
[source,console] | ||
---- | ||
DELETE _connector/my-connector | ||
---- | ||
// TEST[continued] | ||
//// |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
1 change: 1 addition & 0 deletions
1
docs/reference/esql/functions/signature/greater_than_or_equal.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
date_period | date_period | date_period | ||
date_period | datetime | datetime | ||
datetime | date_period | datetime | ||
datetime | time_duration | datetime | ||
double | double | double | ||
integer | integer | integer | ||
long | long | long | ||
time_duration | time_duration | time_duration | ||
|=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
double | double | double | ||
integer | integer | integer | ||
long | long | long | ||
|=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
integer | integer | boolean | ||
|=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
integer | integer | boolean | ||
|=== |
5 changes: 5 additions & 0 deletions
5
docs/reference/esql/functions/types/greater_than_or_equal.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
integer | integer | boolean | ||
|=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
integer | integer | boolean | ||
|=== |
5 changes: 5 additions & 0 deletions
5
docs/reference/esql/functions/types/less_than_or_equal.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
integer | integer | boolean | ||
|=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
double | double | double | ||
integer | integer | integer | ||
long | long | long | ||
|=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
lhs | rhs | result | ||
double | double | double | ||
integer | integer | integer | ||
long | long | long | ||
|=== |
7 changes: 4 additions & 3 deletions
7
.../esql/functions/types/to_degrees.asciidoc → ...ference/esql/functions/types/neg.asciidoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,8 +1,9 @@ | ||
[%header.monospaced.styled,format=dsv,separator=|] | ||
|=== | ||
v | result | ||
date_period | date_period | ||
double | double | ||
integer | double | ||
long | double | ||
unsigned_long | double | ||
integer | integer | ||
long | long | ||
time_duration | time_duration | ||
|=== |
Oops, something went wrong.