Merge pull request #13321 from taosdata/docs/TD-16173

docs: add operator chapter in SQL

docs-cn/12-taos-sql/13-operators.md

@@ -21,7 +21,7 @@ title: 运算符
 
 ## JSON 运算符
 
-`->` 运算符可以对 JSON 类型的列按键取值。->左侧是列标识符，右侧是键的字符串常量，如 col->'name'，返回键'name'的值。
+`->` 运算符可以对 JSON 类型的列按键取值。`->` 左侧是列标识符，右侧是键的字符串常量，如 `col->'name'`，返回键 `'name'` 的值。
 
 ## 集合运算符
 

docs-en/12-taos-sql/07-function.md

@@ -1537,37 +1537,6 @@ SELECT SUBSTR(str,pos[,len]) FROM { tb_name | stb_name } [WHERE clause]
 - Parameter `pos` can be an positive or negative integer; If it's positive, the starting position will be counted from the beginning of the string; if it's negative, the starting position will be counted from the end of the string.
 - If `len` is not specified, it means from `pos` to the end.
 
-### Arithmetic Operations
-
-```
-SELECT field_name [+|-|*|/|%][Value|field_name] FROM { tb_name | stb_name }  [WHERE clause];
-```
-
-**Description**: The sum, difference, product, quotient, or remainder between one or more columns
-
-**Return value type**: Double precision floating point
-
-**Applicable column types**: Data types except for timestamp, binary, nchar, bool
-
-**Applicable table types**: table, STable
-
-**More explanations**:
-
-- Arithmetic operations can be performed on two or more columns, Parentheses `()` can be used to control the order of precedence.
-- NULL doesn't participate in the operation i.e. if one of the operands is NULL then result is NULL.
-
-**Examples**:
-
-```
-taos> SELECT current + voltage * phase FROM d1001;
-(current+(voltage*phase)) |
-============================
-            78.190000713 |
-            84.540003240 |
-            80.810000718 |
-Query OK, 3 row(s) in set (0.001046s)
-```
-
 ### STATECOUNT
 
 ```

docs-en/12-taos-sql/13-operators.md

+---
+sidebar_label: Operators
+title: Operators
+---
+
+## Arithmetic Operators
+
+| #   | **Operator** | **Data Types** | **Description**                                           |
+| --- | :----------: | -------------- | --------------------------------------------------------- |
+| 1   |     +, -     | Numeric Types  | Representing positive or negative numbers, unary operator |
+| 2   |     +, -     | Numeric Types  | Addition and substraction, binary operator                |
+| 3   |    \*, /     | Numeric Types  | Multiplication and division, binary oeprator              |
+| 4   |      %       | Numeric Types  | Taking the remainder, binary operator                     |
+
+## Bitwise Operators
+
+| #   | **Operator** | **Data Types** | **Description**               |
+| --- | :----------: | -------------- | ----------------------------- |
+| 1   |      &       | Numeric Types  | Bitewise AND, binary operator |
+| 2   |      \|      | Numeric Types  | Bitewise OR, binary operator  |
+
+## JSON Operator
+
+`->` operator can be used to get the value of a key in a column of JSON type, the left oeprand is the column name, the right operand is a string constant. For example, `col->'name'` returns the value of key `'name'`.
+
+## Set Operator
+
+Set operators are used to combine the results of two queries into single result. A query including set operators is called a combined query. The number of rows in each result in a combined query must be same, and the type is determined by the first query's result, the type of the following queriess result must be able to be converted to the type of the first query's result, the conversion rule is same as `CAST` function.
+
+TDengine provides 2 set operators: `UNION ALL` and `UNION`. `UNION ALL` combines the results without removing duplicate data. `UNION` combines the results and remove duplicate data rows. In single SQL statement, at most 100 set operators can be used.
+
+## Comparsion Operator
+
+| #   |   **Operator**    | **Data Types**                                                      | **Description**                                 |
+| --- | :---------------: | ------------------------------------------------------------------- | ----------------------------------------------- |
+| 1   |         =         | Except for BLOB, MEDIUMBLOB and JSON                                | Equal                                           |
+| 2   |      <\>, !=      | Except for BLOB, MEDIUMBLOB, JSON and primary key of timestamp type | Not equal                                       |
+| 3   |      \>, \<       | Except for BLOB, MEDIUMBLOB and JSON                                | Greater than, less than                         |
+| 4   |     \>=, \<=      | Except for BLOB, MEDIUMBLOB and JSON                                | Greater than or equal to, less than or equal to |
+| 5   |   IS [NOT] NULL   | Any types                                                           | Is NULL or NOT                                  |
+| 6   | [NOT] BETWEEN AND | Except for BLOB, MEDIUMBLOB and JSON                                | In a value range or not                         |
+| 7   |        IN         | Except for BLOB, MEDIUMBLOB, JSON and primary key of timestamp type | In a list of values or not                      |
+| 8   |       LIKE        | BINARY, NCHAR and VARCHAR                                           | Wildcard matching                               |
+| 9   |   MATCH, NMATCH   | BINARY, NCHAR and VARCHAR                                           | Regular expression matching                     |
+| 10  |     CONTAINS      | JSON                                                                | If A key exists in JSON                         |
+
+`LIKE` operator uses wildcard to match a string, the rules are：
+
+- '%' matches 0 to any number of characters; '\_' matches any single ASCII character.
+- \_ can be used to match a `_` in the string, i.e. using escape character backslash `\`
+- Wildcard string is 100 bytes at most. Longer a wildcard string is, worse the performance of LIKE operator is.
+
+`MATCH` and `NMATCH` operators use regular expressions to match a string, the rules are:
+
+- Regular expressions of POSIX standard are supported.
+- Only `tbname`, i.e. table name of sub tables, and tag columns of string types can be matched with regular expression, data columns are not supported.
+- Regular expression string is 128 bytes at most, and can be adjusted by setting parameter `maxRegexStringLen`, which is a client side configuration and needs to restart the client to take effect.
+
+## Logical Operators
+
+| #   | **Operator** | **Data Types** | **Description**                                                                          |
+| --- | :----------: | -------------- | ---------------------------------------------------------------------------------------- |
+| 1   |     AND      | BOOL           | Logical AND, return TRUE if both conditions are TRUE; return FALSE if any one is FALSE. |
+| 2   |      OR      | BOOL           | Logical OR, return TRUE if any condition is TRUE; return FALSE if both are FALSE        |
+
+TDengine uses shortcircut optimization when performing logical operations. For AND operator, if the first condition is evaluated to FALSE, then the second one is not evaluated. For OR operator, if the first condition is evaluated to TRUE, then the second one is not evaluated.