2021-01-30 04:11:17 -05:00
<!-- toc -->
< script async src = "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js" > < / script >
< ins class = "adsbygoogle"
style="display:block; text-align:center;"
data-ad-layout="in-article"
data-ad-format="fluid"
data-ad-client="ca-pub-8828078415045620"
data-ad-slot="7586680510">< / ins >
< script >
(adsbygoogle = window.adsbygoogle || []).push({});
< / script >
## 表达式(Expressions)
> [!WARNING]
> Apache Druid支持两种查询语言： ，
在原生的查询方式中，表达式可以使用在很多地方， 包括 [虚拟列 ](virtual-columns.md ) 和 [Join条件 ](datasource.md#join ) 中。同样，大多数的 [Druid SQL 函数 ](druidsql.md ) 在 [查询转换 ](druidsql.md ) 阶段会转换成表达式。
表达式支持以下操作符（按优先顺序递减列出）：
| 操作符 | 描述 |
|-|-|
| `!` ,`-` | 非和减 |
| `^` | 幂运算 |
| `*` ,`/`,`%` | 乘法 |
| `+` ,`-` | 加法 |
| `<, <=, >, >=, ==, !=` | 比较运算 |
| `&&, ||` | 逻辑与或 |
Long， ， ， ，
另外， `null` 。类型化空数组可以通过在尖括号中加上类型前缀来定义：`< STRING > []`, `<DOUBLE>[]` 或者 `<LONG>[]`
表达式可以包含变量，变量名可以包含字母、数字、'_'和'$'，变量名不能以数字开头。 需要转义其他特殊字符的时候， 必须使用双引号来标志。
对于逻辑操作符， ， ， `Boolean.valueOf(string)` 来评估结果。
支持[多值字符串维度](multi-value-dimensions.md)， ， ， （ ） ，
提供以下内置功能。
### 一般函数
| 名称 | 描述 |
|-|-|
| `cast` | cast(expr,'LONG' or 'DOUBLE' or 'STRING' or 'LONG_ARRAY', or 'DOUBLE_ARRAY' or 'STRING_ARRAY') 返回特定类型的表达式，可能会抛出异常。 标量类型可以转换为数组类型， （ ）
| `if` | if(predicate,then,else)，如果 'predicate' 为正数返回 'then'部分， 否则返回'else'部分 |
| `nvl` | nvl(expr,expr-for-null), 如果'expr'为null（ ）
| `like` | like(expr, pattern[, escape]) 等价于SQL的 `expr LIKE pattern` |
| `case_searched` | case_searched(expr1, result1, [[expr2, result2, ...], else-result]) |
| `case_simple` | case_simple(expr, value1, result1, [[value2, result2, ...], else-result]) |
| `bloom_filter_test` | bloom_filter_test(expr, filter)对'filter'（ ） 布隆过滤器扩展 ](../Configuration/core-ext/bloom-filter.md ) |
### 字符串函数
| 名称 | 描述 |
|-|-|
| `concat` | concat(expr, expr , ...) 联接一个字符串列表 |
| `format` | format(pattern[, args...]) 返回一个[Java字符串格式](https://docs.oracle.com/javase/8/docs/api/java/lang/String.html#format-java.lang.String-java.lang.Object...-)的格式化的字符串 |
| `like` | like(expr, pattern[, escape]) 等价于SQL的 `expr LIKE pattern` |
| `lookup` | lookup(expr, lookup-name) 注册一个查询时的lookup表达式 |
| `parse_long` | parse_long(string[, radix]) 将字符串解析为具有给定基数的long， ， （ ）
| `regexp_extract` | regexp(expr, pattern[, index]) 应用正则表达式模式并提取捕获组索引， ， ， `expr` 任何位置， ， `^` 和`$` |
| `regexp_like` | regexp(expr, pattern) 返回 `expr` 是否匹配了正则表达式 `pattern` . 模式可能匹配 `expr` 任何位置， ， `^` 和`$` |
| `contains_string` | contains(expr, string) 返回`expr` 是否包含 `string` 作为一个子串。 该方法对大小写敏感 |
| `icontains_string` | icontains(expr, string) 返回`expr` 是否包含 `string` 作为一个子串。方法对大小写不敏感 |
| `replace` | replace(expr, pattern, replacement) 使用replacement来替换pattern |
| `substring` | substring(expr, index, length) 的行为类似于Java String的substring |
| `right` | right(expr, length) 从一个字符串中返回右侧指定长度的子串 |
| `left` | left(expr, length) 从一个字符串中返回左侧指定长度的子串 |
| `strlen` | strlen(expr) 返回一个UTF-16编码单位的字符串长度 |
| `strpos` | strpos(haystack, needle[, fromIndex]) 返回在haystack中needle的位置（ ） ， ，
| `trim` | trim(expr[, chars]) 如果 `chars` 指定了，将 `expr` 中的前后`chars`删除掉。 如果未指定则 `chars` 默认为 `''` |
| `ltrim` | ltrim(expr[, chars]) 如果 `chars` 指定了，将 `expr` 中的前`chars`删除掉。 如果未指定则 `chars` 默认为 `''` |
| `rtrim` | rtrim(expr[, chars]) 如果 `chars` 指定了，将 `expr` 中的后`chars`删除掉。 如果未指定则 `chars` 默认为 `''` |
| `lower` | lower(expr) 字符串转小写 |
| `upper` | upper(expr) 字符串转大写 |
| `reverse` | reverse(expr) 逆转一个字符串 |
| `repeat` | repeat(expr, N) 重复字符串N次 |
| `lpad` | lpad(expr, length, chars) 返回使用`chars`对`expr`进行从左补齐到`length`的字符串。 如果 `length` 比 `expr` 长度短， 则返回结果是截断到 `length` 的 `expr` 。当 `expr` 或者 `chars` 为null时， `chars` 为空字符串， 则不增加填充，虽然必要时对 `expr` 修剪 |
2021-02-01 03:48:10 -05:00
| `rpad` | rpad(expr, length, chars) 返回使用`chars`对`expr`进行从右补齐到`length`的字符串。 如果 `length` 比 `expr` 长度短， 则返回结果是截断到 `length` 的 `expr` 。当 `expr` 或者 `chars` 为null时， `chars` 为空字符串， 则不增加填充，虽然必要时对 `expr` 修剪 |
### 时间函数
| 名称 | 描述 |
|-|-|
| `timestamp` | timestamp(expr[,format-string])， ，
| `unix_timestamp` | 与 `timestamp` 相同，但是返回的是秒 |
| `timestamp_ceil` | timestamp_ceil(expr, period, [origin, [timezone]])， ， ，
| `timestamp_floor` | timestamp_floor(expr, period, [origin, [timezone]])， ， ，
| `timestamp_shift` | timestamp_shift(expr, period, step, [timezone]) 将时间戳移动一个周期（步长时间），并将其作为新的时间戳返回。|
| `timestamp_extract` | timestamp_extract(expr, unit, [timezone]) 从expr中提取时间部分， ， ，
| `timestamp_parse` | timestamp_parse(string expr, [pattern, [timezone]]) 使用给定的 [Joda DatetimeFormat Pattern ](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html ) 将字符串转换为时间戳。 如果pattern未提供， ， ，
| `timestamp_format` | timestamp_format(expr, [pattern, [timezone]]) 使用给定的 [Joda DatetimeFormat Pattern ](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html ) 将字符串转换为时间戳。 如果pattern未提供， ， ，
