[DOCS] Collapse nested objects in Explore API docs (#55067)
Co-authored-by: James Rodewig <james.rodewig@elastic.co>
This commit is contained in:
parent
c5c7ee9d73
commit
16921ebbd8
|
@ -32,6 +32,9 @@ vertices that have already been returned.
|
|||
[float]
|
||||
=== Request Body
|
||||
|
||||
[role="child_attributes"]
|
||||
====
|
||||
|
||||
query::
|
||||
A seed query that identifies the documents of interest. Can be any valid
|
||||
Elasticsearch query. For example:
|
||||
|
@ -71,7 +74,10 @@ graph as vertices. For example:
|
|||
}
|
||||
]
|
||||
--------------------------------------------------
|
||||
|
||||
+
|
||||
.Properties for `vertices`
|
||||
[%collapsible%open]
|
||||
======
|
||||
field::: Identifies a field in the documents of interest.
|
||||
include::: Identifies the terms of interest that form the starting points
|
||||
from which you want to spider out. You do not have to specify a seed query
|
||||
|
@ -93,6 +99,7 @@ shard_min_doc_count:::
|
|||
This advanced setting controls how many documents on a particular shard have
|
||||
to contain a pair of terms before the connection is returned for global
|
||||
consideration. Defaults to 2.
|
||||
======
|
||||
|
||||
connections::
|
||||
Specifies or more fields from which you want to extract terms that are
|
||||
|
@ -113,7 +120,10 @@ NOTE: Connections can be nested inside the `connections` object to
|
|||
explore additional relationships in the data. Each level of nesting is
|
||||
considered a _hop_, and proximity within the graph is often described in
|
||||
terms of _hop depth_.
|
||||
|
||||
+
|
||||
.Properties for `connections`
|
||||
[%collapsible%open]
|
||||
======
|
||||
query:::
|
||||
An optional _guiding query_ that constrains the Graph API as it
|
||||
explores connected terms. For example, you might want to direct the Graph
|
||||
|
@ -133,9 +143,13 @@ Contains the fields you are interested in. For example:
|
|||
}
|
||||
]
|
||||
--------------------------------------------------
|
||||
======
|
||||
|
||||
controls:: Direct the Graph API how to build the graph.
|
||||
|
||||
+
|
||||
.Properties for `controls`
|
||||
[%collapsible%open]
|
||||
======
|
||||
use_significance:::
|
||||
The `use_significance` flag filters associated terms so only those that are
|
||||
significantly associated with your query are included. For information about
|
||||
|
@ -168,6 +182,8 @@ a maximum number of documents per value for that field. For example:
|
|||
"max_docs_per_value": 500
|
||||
}
|
||||
--------------------------------------------------
|
||||
======
|
||||
====
|
||||
|
||||
// [float]
|
||||
// === Authorization
|
||||
|
@ -279,7 +295,7 @@ not a global count for all documents in the index).
|
|||
|
||||
The default settings are configured to remove noisy data and
|
||||
get the "big picture" from your data. This example shows how to specify
|
||||
additional parameters to influence how the graph is built.
|
||||
additional parameters to influence how the graph is built.
|
||||
|
||||
For tips on tuning the settings for more detailed forensic evaluation where
|
||||
every document could be of interest, see the
|
||||
|
@ -401,4 +417,4 @@ POST clicklogs/_graph/explore
|
|||
<1> The vertices you want to start from are specified
|
||||
as an array of terms in an `include` clause.
|
||||
<2> The `exclude` clause prevents terms you already know about from being
|
||||
included in the results.
|
||||
included in the results.
|
||||
|
|
Loading…
Reference in New Issue