Skip to content

[DOCS] EQL: Document substring function #53867

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Mar 25, 2020
Merged

[DOCS] EQL: Document substring function #53867

merged 8 commits into from
Mar 25, 2020

Conversation

jrodewig
Copy link
Contributor

Adds documentation for the EQL substring function.

Supporting changes:

  • Creates a new "EQL function reference" page
  • Updates the title of the "EQL syntax reference" page for consistency
  • Adds a brief "Functions" section to the EQL syntax docs
  • Updates EQL limitations docs to state that only array functions are
    unsupported

Adds documentation for the EQL `substring` function.

Supporting changes:

* Creates a new "EQL function reference" page
* Updates the title of the "EQL syntax reference" page for consistency
* Adds a brief "Functions" section to the EQL syntax docs
* Updates EQL limitations docs to state that only array functions are
  unsupported
@jrodewig jrodewig added >docs General docs changes :Analytics/EQL EQL querying labels Mar 20, 2020
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-docs (>docs)

@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-search (:Search/EQL)

@jrodewig jrodewig requested a review from costin March 20, 2020 13:43
@costin
Copy link
Member

costin commented Mar 20, 2020

@jrodewig the bug is actually known - I need a follow-up PR to fix the scripting now that #53780 landed.

@jrodewig
Copy link
Contributor Author

@costin Cool. I thought that might the case. I'll just keep this PR as a draft until those are fixed up. Thanks!

@costin
Copy link
Member

costin commented Mar 22, 2020

See #53935

@jrodewig jrodewig changed the title [DOCS] Document EQL substring function [DOCS] EQL: Document substring function Mar 24, 2020
@jrodewig
Copy link
Contributor Author

@elasticmachine update branch

@jrodewig jrodewig marked this pull request as ready for review March 25, 2020 14:24
@jrodewig
Copy link
Contributor Author

@costin This is ready for review at your convenience. Thanks again!

Copy link
Member

@costin costin left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - @rw-access ?

End position for extraction. If this position is not provided, the function
returns the remaining string.
+
Positions are zero-indexed. Negative offsets are supported.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would add that if the start is higher than the length of the string or end, an empty string is returned.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good note. Added with 9d38109.

@jrodewig jrodewig requested a review from rw-access March 25, 2020 15:37
Copy link
Contributor

@rw-access rw-access left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. thanks @jrodewig.
those examples are perfect.

only things that may be worth adding

@jrodewig
Copy link
Contributor Author

Thanks very much @costin and @rw-access.

@jrodewig jrodewig merged commit f91d8ee into elastic:master Mar 25, 2020
@jrodewig jrodewig deleted the docs__eql-substring-fn branch March 25, 2020 16:07
jrodewig added a commit that referenced this pull request Mar 25, 2020
Adds documentation for the EQL `substring` function.

Supporting changes:

* Creates a new "EQL function reference" page
* Updates the title of the "EQL syntax reference" page for consistency
* Adds a brief "Functions" section to the EQL syntax docs
* Updates EQL limitations docs to state that only array functions are
  unsupported
@jrodewig
Copy link
Contributor Author

Backport commits

master f91d8ee
7.x 30a3204

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:Analytics/EQL EQL querying >docs General docs changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants