Documentation ¶
Overview ¶
Enables searching rolled-up data using the standard Query DSL.
Index ¶
- Variables
- type NewRollupSearch
- type Request
- type Response
- type RollupSearch
- func (r *RollupSearch) Aggregations(aggregations map[string]types.Aggregations) *RollupSearch
- func (r RollupSearch) Do(providedCtx context.Context) (*Response, error)
- func (r *RollupSearch) ErrorTrace(errortrace bool) *RollupSearch
- func (r *RollupSearch) FilterPath(filterpaths ...string) *RollupSearch
- func (r *RollupSearch) Header(key, value string) *RollupSearch
- func (r *RollupSearch) HttpRequest(ctx context.Context) (*http.Request, error)
- func (r *RollupSearch) Human(human bool) *RollupSearch
- func (r RollupSearch) Perform(providedCtx context.Context) (*http.Response, error)
- func (r *RollupSearch) Pretty(pretty bool) *RollupSearch
- func (r *RollupSearch) Query(query *types.Query) *RollupSearch
- func (r *RollupSearch) Raw(raw io.Reader) *RollupSearch
- func (r *RollupSearch) Request(req *Request) *RollupSearch
- func (r *RollupSearch) RestTotalHitsAsInt(resttotalhitsasint bool) *RollupSearch
- func (r *RollupSearch) Size(size int) *RollupSearch
- func (r *RollupSearch) TypedKeys(typedkeys bool) *RollupSearch
Constants ¶
This section is empty.
Variables ¶
var ErrBuildPath = errors.New("cannot build path, check for missing path parameters")
ErrBuildPath is returned in case of missing parameters within the build of the request.
Functions ¶
This section is empty.
Types ¶
type NewRollupSearch ¶
type NewRollupSearch func(index string) *RollupSearch
NewRollupSearch type alias for index.
func NewRollupSearchFunc ¶
func NewRollupSearchFunc(tp elastictransport.Interface) NewRollupSearch
NewRollupSearchFunc returns a new instance of RollupSearch with the provided transport. Used in the index of the library this allows to retrieve every apis in once place.
type Request ¶
type Request struct { // Aggregations Specifies aggregations. Aggregations map[string]types.Aggregations `json:"aggregations,omitempty"` // Query Specifies a DSL query. Query *types.Query `json:"query,omitempty"` // Size Must be zero if set, as rollups work on pre-aggregated data. Size *int `json:"size,omitempty"` }
Request holds the request body struct for the package rollupsearch
func (*Request) FromJSON ¶ added in v8.5.0
FromJSON allows to load an arbitrary json into the request structure
func (*Request) UnmarshalJSON ¶ added in v8.12.1
type Response ¶ added in v8.7.0
type Response struct { Aggregations map[string]types.Aggregate `json:"aggregations,omitempty"` Hits types.HitsMetadata `json:"hits"` Shards_ types.ShardStatistics `json:"_shards"` TerminatedEarly *bool `json:"terminated_early,omitempty"` TimedOut bool `json:"timed_out"` Took int64 `json:"took"` }
Response holds the response body struct for the package rollupsearch
func (*Response) UnmarshalJSON ¶ added in v8.7.0
type RollupSearch ¶
type RollupSearch struct {
// contains filtered or unexported fields
}
func New ¶
func New(tp elastictransport.Interface) *RollupSearch
Enables searching rolled-up data using the standard Query DSL.
https://www.elastic.co/guide/en/elasticsearch/reference/current/rollup-search.html
func (*RollupSearch) Aggregations ¶ added in v8.9.0
func (r *RollupSearch) Aggregations(aggregations map[string]types.Aggregations) *RollupSearch
Aggregations Specifies aggregations. API name: aggregations
func (RollupSearch) Do ¶
func (r RollupSearch) Do(providedCtx context.Context) (*Response, error)
Do runs the request through the transport, handle the response and returns a rollupsearch.Response
func (*RollupSearch) ErrorTrace ¶ added in v8.14.0
func (r *RollupSearch) ErrorTrace(errortrace bool) *RollupSearch
ErrorTrace When set to `true` Elasticsearch will include the full stack trace of errors when they occur. API name: error_trace
func (*RollupSearch) FilterPath ¶ added in v8.14.0
func (r *RollupSearch) FilterPath(filterpaths ...string) *RollupSearch
FilterPath Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch. API name: filter_path
func (*RollupSearch) Header ¶
func (r *RollupSearch) Header(key, value string) *RollupSearch
Header set a key, value pair in the RollupSearch headers map.
func (*RollupSearch) HttpRequest ¶
HttpRequest returns the http.Request object built from the given parameters.
func (*RollupSearch) Human ¶ added in v8.14.0
func (r *RollupSearch) Human(human bool) *RollupSearch
Human When set to `true` will return statistics in a format suitable for humans. For example `"exists_time": "1h"` for humans and `"eixsts_time_in_millis": 3600000` for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines. API name: human
func (RollupSearch) Perform ¶ added in v8.7.0
Perform runs the http.Request through the provided transport and returns an http.Response.
func (*RollupSearch) Pretty ¶ added in v8.14.0
func (r *RollupSearch) Pretty(pretty bool) *RollupSearch
Pretty If set to `true` the returned JSON will be "pretty-formatted". Only use this option for debugging only. API name: pretty
func (*RollupSearch) Query ¶ added in v8.9.0
func (r *RollupSearch) Query(query *types.Query) *RollupSearch
Query Specifies a DSL query. API name: query
func (*RollupSearch) Raw ¶
func (r *RollupSearch) Raw(raw io.Reader) *RollupSearch
Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.
func (*RollupSearch) Request ¶
func (r *RollupSearch) Request(req *Request) *RollupSearch
Request allows to set the request property with the appropriate payload.
func (*RollupSearch) RestTotalHitsAsInt ¶
func (r *RollupSearch) RestTotalHitsAsInt(resttotalhitsasint bool) *RollupSearch
RestTotalHitsAsInt Indicates whether hits.total should be rendered as an integer or an object in the rest search response API name: rest_total_hits_as_int
func (*RollupSearch) Size ¶ added in v8.9.0
func (r *RollupSearch) Size(size int) *RollupSearch
Size Must be zero if set, as rollups work on pre-aggregated data. API name: size
func (*RollupSearch) TypedKeys ¶
func (r *RollupSearch) TypedKeys(typedkeys bool) *RollupSearch
TypedKeys Specify whether aggregation and suggester names should be prefixed by their respective types in the response API name: typed_keys