validatequery

Documentation

Overview

Allows a user to validate a potentially expensive query without executing it.

Index

• Variables
• type NewValidateQuery
  • func NewValidateQueryFunc(tp elastictransport.Interface) NewValidateQuery
• type Request
  • func NewRequest() *Request
  • func (r *Request) FromJSON(data string) (*Request, error)
• type Response
  • func NewResponse() *Response
• type ValidateQuery
  • func New(tp elastictransport.Interface) *ValidateQuery
  • func (r *ValidateQuery) AllShards(b bool) *ValidateQuery
  • func (r *ValidateQuery) AllowNoIndices(b bool) *ValidateQuery
  • func (r *ValidateQuery) AnalyzeWildcard(b bool) *ValidateQuery
  • func (r *ValidateQuery) Analyzer(v string) *ValidateQuery
  • func (r *ValidateQuery) DefaultOperator(enum operator.Operator) *ValidateQuery
  • func (r *ValidateQuery) Df(v string) *ValidateQuery
  • func (r ValidateQuery) Do(ctx context.Context) (*Response, error)
  • func (r *ValidateQuery) ExpandWildcards(v string) *ValidateQuery
  • func (r *ValidateQuery) Explain(b bool) *ValidateQuery
  • func (r *ValidateQuery) Header(key, value string) *ValidateQuery
  • func (r *ValidateQuery) HttpRequest(ctx context.Context) (*http.Request, error)
  • func (r *ValidateQuery) IgnoreUnavailable(b bool) *ValidateQuery
  • func (r *ValidateQuery) Index(v string) *ValidateQuery
  • func (r *ValidateQuery) Lenient(b bool) *ValidateQuery
  • func (r ValidateQuery) Perform(ctx context.Context) (*http.Response, error)
  • func (r *ValidateQuery) Q(v string) *ValidateQuery
  • func (r *ValidateQuery) Raw(raw io.Reader) *ValidateQuery
  • func (r *ValidateQuery) Request(req *Request) *ValidateQuery
  • func (r *ValidateQuery) Rewrite(b bool) *ValidateQuery

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.

Types

type NewValidateQuery

type NewValidateQuery func() *ValidateQuery

NewValidateQuery type alias for index.

func NewValidateQueryFunc

func NewValidateQueryFunc(tp elastictransport.Interface) NewValidateQuery

NewValidateQueryFunc returns a new instance of ValidateQuery 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 {
	Query *types.Query `json:"query,omitempty"`
}

Request holds the request body struct for the package validatequery

https://github.com/elastic/elasticsearch-specification/blob/1ad7fe36297b3a8e187b2259dedaf68a47bc236e/specification/indices/validate_query/IndicesValidateQueryRequest.ts#L25-L51

func NewRequest

func NewRequest() *Request

NewRequest returns a Request

func (*Request) FromJSON

func (r *Request) FromJSON(data string) (*Request, error)

FromJSON allows to load an arbitrary json into the request structure

type Response

type Response struct {
	Error        *string                              `json:"error,omitempty"`
	Explanations []types.IndicesValidationExplanation `json:"explanations,omitempty"`
	Shards_      *types.ShardStatistics               `json:"_shards,omitempty"`
	Valid        bool                                 `json:"valid"`
}

func NewResponse

func NewResponse() *Response

NewResponse returns a Response

type ValidateQuery

type ValidateQuery struct {
	// contains filtered or unexported fields
}

func New

func New(tp elastictransport.Interface) *ValidateQuery

Allows a user to validate a potentially expensive query without executing it.

https://www.elastic.co/guide/en/elasticsearch/reference/master/search-validate.html

func (*ValidateQuery) AllShards

func (r *ValidateQuery) AllShards(b bool) *ValidateQuery

AllShards Execute validation on all shards instead of one random shard per index API name: all_shards

func (*ValidateQuery) AllowNoIndices

func (r *ValidateQuery) AllowNoIndices(b bool) *ValidateQuery

AllowNoIndices Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified) API name: allow_no_indices

func (*ValidateQuery) AnalyzeWildcard

func (r *ValidateQuery) AnalyzeWildcard(b bool) *ValidateQuery

AnalyzeWildcard Specify whether wildcard and prefix queries should be analyzed (default: false) API name: analyze_wildcard

func (*ValidateQuery) Analyzer

func (r *ValidateQuery) Analyzer(v string) *ValidateQuery

Analyzer The analyzer to use for the query string API name: analyzer

func (*ValidateQuery) DefaultOperator

func (r *ValidateQuery) DefaultOperator(enum operator.Operator) *ValidateQuery

DefaultOperator The default operator for query string query (AND or OR) API name: default_operator

func (*ValidateQuery) Df

func (r *ValidateQuery) Df(v string) *ValidateQuery

Df The field to use as default where no field prefix is given in the query string API name: df

func (ValidateQuery) Do

func (r ValidateQuery) Do(ctx context.Context) (*Response, error)

Do runs the request through the transport, handle the response and returns a validatequery.Response

func (*ValidateQuery) ExpandWildcards

func (r *ValidateQuery) ExpandWildcards(v string) *ValidateQuery

ExpandWildcards Whether to expand wildcard expression to concrete indices that are open, closed or both. API name: expand_wildcards

func (*ValidateQuery) Explain

func (r *ValidateQuery) Explain(b bool) *ValidateQuery

Explain Return detailed information about the error API name: explain

func (*ValidateQuery) Header

func (r *ValidateQuery) Header(key, value string) *ValidateQuery

Header set a key, value pair in the ValidateQuery headers map.

func (*ValidateQuery) HttpRequest

func (r *ValidateQuery) HttpRequest(ctx context.Context) (*http.Request, error)

HttpRequest returns the http.Request object built from the given parameters.

func (*ValidateQuery) IgnoreUnavailable

func (r *ValidateQuery) IgnoreUnavailable(b bool) *ValidateQuery

IgnoreUnavailable Whether specified concrete indices should be ignored when unavailable (missing or closed) API name: ignore_unavailable

func (*ValidateQuery) Index

func (r *ValidateQuery) Index(v string) *ValidateQuery

Index A comma-separated list of index names to restrict the operation; use `_all` or empty string to perform the operation on all indices API Name: index

func (*ValidateQuery) Lenient

func (r *ValidateQuery) Lenient(b bool) *ValidateQuery

Lenient Specify whether format-based query failures (such as providing text to a numeric field) should be ignored API name: lenient

func (ValidateQuery) Perform

func (r ValidateQuery) Perform(ctx context.Context) (*http.Response, error)

Perform runs the http.Request through the provided transport and returns an http.Response.

func (*ValidateQuery) Q

func (r *ValidateQuery) Q(v string) *ValidateQuery

Q Query in the Lucene query string syntax API name: q

func (*ValidateQuery) Raw

func (r *ValidateQuery) Raw(raw io.Reader) *ValidateQuery

Raw takes a json payload as input which is then passed to the http.Request If specified Raw takes precedence on Request method.

func (*ValidateQuery) Request

func (r *ValidateQuery) Request(req *Request) *ValidateQuery

Request allows to set the request property with the appropriate payload.

func (*ValidateQuery) Rewrite

func (r *ValidateQuery) Rewrite(b bool) *ValidateQuery

Rewrite Provide a more detailed explanation showing the actual Lucene query that will be executed. API name: rewrite