honeymoose
/
OpenSearch
mirror of https://github.com/honeymoose/OpenSearch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
OpenSearch/docs/reference/sql/functions/operators.asciidoc

164 lines
5.2 KiB
Plaintext
Raw Normal View History

DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
[role="xpack"]
[testenv="basic"]
[[sql-operators]]
=== Comparison Operators
SQL: Implement IN(value1, value2, ...) expression. (#34581) Implement the functionality to translate the `field IN (value1, value2,...)` expressions to proper Lucene queries or painless script or local processors depending on the use case. The `IN` expression can be used in SELECT, WHERE and HAVING clauses. Closes: #32955
2018-10-23 08:28:23 -04:00
Boolean operator for comparing against one or multiple expressions.
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-equality]]
==== `Equality (=)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereFieldEquality]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-null-safe-equality]]
==== `Null safe Equality (<=>)`
SQL: Implement null safe equality operator `<=>` (#35873) This operator handles nulls in different way than the normal `=`. If one of the operants is `null` and the other not it returns `false`. If both operants are `null` it returns `true`. Therefore in contrary to `=`, which returns `null` if at least one of the operants is `null`, this one never returns `null` as a result. Closes: #35871
2018-11-26 08:02:02 -05:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
SQL: Spec tests now use classpath discovery (#40388) To avoid having to specify each spec by hand (which can miss specs to be added), the test infrastructure now performs classpath discovery so that each spec added, is automatically considered. Relates #40358 (cherry picked from commit d0f60b4425c731509aa8ca765d55f563f866ef90)
2019-03-25 09:22:59 -04:00
include-tagged::{sql-specs}/docs/docs.csv-spec[nullEqualsCompareWithNull]
SQL: Implement null safe equality operator `<=>` (#35873) This operator handles nulls in different way than the normal `=`. If one of the operants is `null` and the other not it returns `false`. If both operants are `null` it returns `true`. Therefore in contrary to `=`, which returns `null` if at least one of the operants is `null`, this one never returns `null` as a result. Closes: #35871
2018-11-26 08:02:02 -05:00
--------------------------------------------------
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
SQL: Spec tests now use classpath discovery (#40388) To avoid having to specify each spec by hand (which can miss specs to be added), the test infrastructure now performs classpath discovery so that each spec added, is automatically considered. Relates #40358 (cherry picked from commit d0f60b4425c731509aa8ca765d55f563f866ef90)
2019-03-25 09:22:59 -04:00
include-tagged::{sql-specs}/docs/docs.csv-spec[nullEqualsCompareTwoNulls]
SQL: Implement null safe equality operator `<=>` (#35873) This operator handles nulls in different way than the normal `=`. If one of the operants is `null` and the other not it returns `false`. If both operants are `null` it returns `true`. Therefore in contrary to `=`, which returns `null` if at least one of the operants is `null`, this one never returns `null` as a result. Closes: #35871
2018-11-26 08:02:02 -05:00
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-inequality]]
==== `Inequality (<> or !=)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereFieldNonEquality]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-comparison]]
==== `Comparison (<, <=, >, >=)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereFieldLessThan]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-between]]
==== `BETWEEN`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereBetween]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-is-null]]
==== `IS NULL/IS NOT NULL`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereIsNotNullAndIsNull]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-in]]
==== `IN (<value1>, <value2>, ...)`
SQL: Implement IN(value1, value2, ...) expression. (#34581) Implement the functionality to translate the `field IN (value1, value2,...)` expressions to proper Lucene queries or painless script or local processors depending on the use case. The `IN` expression can be used in SELECT, WHERE and HAVING clauses. Closes: #32955
2018-10-23 08:28:23 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereWithInAndMultipleValues]
--------------------------------------------------
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
[[sql-operators-logical]]
=== Logical Operators
Boolean operator for evaluating one or two expressions.
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-and]]
==== `AND`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereFieldAndComparison]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-or]]
==== `OR`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereFieldOrComparison]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-not]]
==== `NOT`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/filter.sql-spec[whereFieldEqualityNot]
--------------------------------------------------
[[sql-operators-math]]
=== Math Operators
Perform mathematical operations affecting one or two values.
The result is a value of numeric type.
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-plus]]
==== `Add (+)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/arithmetic.sql-spec[plus]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-subtract]]
==== `Subtract (infix -)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/arithmetic.sql-spec[minus]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-negate]]
==== `Negate (unary -)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/arithmetic.sql-spec[unaryMinus]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-multiply]]
==== `Multiply (*)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/arithmetic.sql-spec[multiply]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-divide]]
==== `Divide (/)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/arithmetic.sql-spec[divide]
--------------------------------------------------
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-remainder]]
==== `Modulo or Remainder(%)`
DOC: Enhance SQL Functions documentation Split function section into multiple chapters Add String functions Add (small) section on Conversion/Cast functions Add missing aggregation functions Enable documentation testing (was disabled by accident). While at it, fix failing tests Improve spec tests to allow multi-line queries (useful for docs) Add ability to ignore a spec test (name should end with -Ignore)
2018-09-05 18:19:49 -04:00
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
include-tagged::{sql-specs}/arithmetic.sql-spec[mod]
--------------------------------------------------
SQL: Implement `::` cast operator (#38774) `<expression>::<dataType>` is a simplified altenative syntax to `CAST(<expression> AS <dataType> which exists in PostgreSQL and provides an improved user experience and possibly more compact SQL queries. Fixes: #38717
2019-02-12 09:50:21 -05:00
[[sql-operators-cast]]
=== Cast Operators
SQL: Documentation for LIKE and RLIKE operators (#40623) (cherry picked from commit 9536c5f7b7fecda4592f6b169adef180eadbba54)
2019-04-01 11:01:03 -04:00
[[sql-operators-cast-cast]]
==== `Cast (::)`
SQL: Implement `::` cast operator (#38774) `<expression>::<dataType>` is a simplified altenative syntax to `CAST(<expression> AS <dataType> which exists in PostgreSQL and provides an improved user experience and possibly more compact SQL queries. Fixes: #38717
2019-02-12 09:50:21 -05:00
`::` provides an alternative syntax to the <<sql-functions-type-conversion-cast>> function.
["source","sql",subs="attributes,callouts,macros"]
--------------------------------------------------
SQL: Spec tests now use classpath discovery (#40388) To avoid having to specify each spec by hand (which can miss specs to be added), the test infrastructure now performs classpath discovery so that each spec added, is automatically considered. Relates #40358 (cherry picked from commit d0f60b4425c731509aa8ca765d55f563f866ef90)
2019-03-25 09:22:59 -04:00
include-tagged::{sql-specs}/docs/docs.csv-spec[conversionStringToLongCastOperator]
SQL: Implement `::` cast operator (#38774) `<expression>::<dataType>` is a simplified altenative syntax to `CAST(<expression> AS <dataType> which exists in PostgreSQL and provides an improved user experience and possibly more compact SQL queries. Fixes: #38717
2019-02-12 09:50:21 -05:00
--------------------------------------------------