ClickHouse/docs/en/operators/index.rst
Ivan Blinkov 67c2e50331 CLICKHOUSE-2720: progress on website and reference (#886)
* update presentations

* CLICKHOUSE-2936: redirect from clickhouse.yandex.ru and clickhouse.yandex.com

* update submodule

* lost files

* CLICKHOUSE-2981: prefer sphinx docs over original reference

* CLICKHOUSE-2981: docs styles more similar to main website + add flags to switch language links

* update presentations

* Less confusing directory structure (docs -> doc/reference/)

* Minify sphinx docs too

* Website release script: fail fast + pass docker hash on deploy

* Do not underline links in docs

* shorter

* cleanup docker images

* tune nginx config

* CLICKHOUSE-3043: get rid of habrastorage links

* Lost translation

* CLICKHOUSE-2936: temporary client-side redirect

* behaves weird in test

* put redirect back

* CLICKHOUSE-3047: copy docs txts to public too

* move to proper file

* remove old pages to avoid confusion

* Remove reference redirect warning for now

* Refresh README.md

* Yellow buttons in docs

* Use svg flags instead of unicode ones in docs

* fix test website instance

* Put flags to separate files

* wrong flag

* Copy Yandex.Metrica introduction from main page to docs

* Yet another home page structure change, couple new blocks (CLICKHOUSE-3045)

* Update Contacts section

* CLICKHOUSE-2849: more detailed legal information

* CLICKHOUSE-2978 preparation - split by files

* More changes in Contacts block

* Tune texts on index page

* update presentations

* One more benchmark

* Add usage sections to index page, adapted from slides

* Get the roadmap started, based on slides from last ClickHouse Meetup

* CLICKHOUSE-2977: some rendering tuning

* Get rid of excessive section in the end of getting started

* Make headers linkable

* CLICKHOUSE-2981: links to editing reference - https://github.com/yandex/ClickHouse/issues/849

* CLICKHOUSE-2981: fix mobile styles in docs

* Ban crawling of duplicating docs

* Open some external links in new tab

* Ban old docs too

* Lots of trivial fixes in english docs

* Lots of trivial fixes in russian docs

* Remove getting started copies in markdown

* Add Yandex.Webmaster

* Fix some sphinx warnings

* More warnings fixed in english docs

* More sphinx warnings fixed

* Add code-block:: text

* More code-block:: text

* These headers look not that well

* Better switch between documentation languages

* merge use_case.rst into ya_metrika_task.rst

* Edit the agg_functions.rst texts

* Add lost empty lines

* Lost blank lines

* Add new logo sizes

* update presentations

* Next step in migrating to new documentation

* Fix all warnings in en reference

* Fix all warnings in ru reference

* Re-arrange existing reference

* Move operation tips to main reference

* Fix typos noticed by milovidov@

* Get rid of zookeeper.md

* Looks like duplicate of tutorial.html

* Fix some mess with html tags in tutorial

* No idea why nobody noticed this before, but it was completely not clear whet to get the data

* Match code block styling between main and tutorial pages (in favor of the latter)

* Get rid of some copypaste in tutorial

* Normalize header styles

* Move example_datasets to sphinx

* Move presentations submodule to website

* Move and update README.md

* No point in duplicating articles from habrahabr here

* Move development-related docs as is for now

* doc/reference/ -> docs/ (to match the URL on website)

* Adapt links to match the previous commit

* Adapt development docs to rst (still lacks translation and strikethrough support)

* clean on release

* blacklist presentations in gulp

* strikethrough support in sphinx

* just copy development folder for now

* fix weird introduction in style article

* Style guide translation (WIP)

* Finish style guide translation to English

* gulp clean separately

* Update year in LICENSE

* Initial CONTRIBUTING.md

* Fix remaining links to old docs in tutorial

* Some tutorial fixes

* Typo

* Another typo

* Update list of authors from yandex-team accoding to git log
2017-06-20 17:19:03 +03:00

139 lines
2.9 KiB
ReStructuredText

Operators
=========
All operators are transformed to the corresponding functions at the query parsing stage, in accordance with their precedence and associativity.
Access operators
----------------
``a[N]`` - Access to an array element, arrayElement(a, N) function.
``a.N`` - Access to a tuple element, tupleElement(a, N) function.
Numeric negation operator
-------------------------
``-a`` - negate(a) function
Multiplication and division operators
-------------------------------------
``a * b`` - multiply(a, b) function
``a / b`` - divide(a, b) function
``a % b`` - modulo(a, b) function
Addition and subtraction operators
----------------------------------
``a + b`` - plus(a, b) function
``a - b`` - minus(a, b) function
Comparison operators
--------------------
``a = b`` - equals(a, b) function
``a == b`` - equals(a, b) function
``a != b`` - notEquals(a, b) function
``a <> b`` - notEquals(a, b) function
``a <= b`` - lessOrEquals(a, b) function
``a >= b`` - greaterOrEquals(a, b) function
``a < b`` - less(a, b) function
``a > b`` - greater(a, b) function
``a LIKE s`` - like(a, b) function
``a NOT LIKE s`` - notLike(a, b) function
``a BETWEEN b AND c`` - equivalent to a >= b AND a <= c
Operators for working with data sets
------------------------------------
*See the section "IN operators".*
``a IN ...`` - in(a, b) function
``a NOT IN ...`` - notIn(a, b) function
``a GLOBAL IN ...`` - globalIn(a, b) function
``a GLOBAL NOT IN ...`` - globalNotIn(a, b) function
Logical negation operator
-------------------------
``NOT a`` - ``not(a)`` function
Logical "AND" operator
----------------------
``a AND b`` - function ``and(a, b)``
Logical "OR" operator
---------------------
``a OR b`` - function ``or(a, b)``
Conditional operator
--------------------
``a ? b : c`` - function ``if(a, b, c)``
Conditional expression
----------------------
.. code-block:: sql
CASE [x]
WHEN a THEN b
[WHEN ... THEN ...]
ELSE c
END
If x is given - transform(x, [a, ...], [b, ...], c). Otherwise, multiIf(a, b, ..., c).
String concatenation operator
-----------------------------
``s1 || s2`` - concat(s1, s2) function
Lambda creation operator
------------------------
``x -> expr`` - lambda(x, expr) function
The following operators do not have a priority, since they are brackets:
Array creation operator
-----------------------
``[x1, ...]`` - array(x1, ...) function
Tuple creation operator
-----------------------
``(x1, x2, ...)`` - tuple(x2, x2, ...) function
Associativity
-------------
All binary operators have left associativity. For example, ``'1 + 2 + 3'`` is transformed to ``'plus(plus(1, 2), 3)'``.
Sometimes this doesn't work the way you expect. For example, ``'SELECT 4 > 3 > 2'`` results in ``0``.
For efficiency, the 'and' and 'or' functions accept any number of arguments. The corresponding chains of AND and OR operators are transformed to a single call of these functions.