字面量
字面量(也称为常量)表示一个固定的数据值。Spark SQL 支持以下字面量
字符串字面量
字符串字面量用于指定字符字符串值。
语法
[ r ] { 'char [ ... ]' | "char [ ... ]" }
参数
-
char
字符集中的一个字符。使用
\
转义特殊字符(例如'
或\
)。要表示 Unicode 字符,请使用\uxxxx
或\Uxxxxxxxx
形式的 16 位或 32 位 Unicode 转义,其中 xxxx 和 xxxxxxxx 分别是 16 位和 32 位十六进制代码点(例如,\u3042
表示あ
,\U0001F44D
表示👍
)。ASCII 字符也可以表示为以\
开头的八进制数,例如\101
,它表示A
。 -
r
不区分大小写,表示
RAW
。如果字符串字面量以r
前缀开头,则特殊字符和 Unicode 字符都不会被\
转义。
在常规字符串字面量(没有 r
前缀)中识别以下转义序列,并根据以下规则进行替换:
\0
->\u0000
,代码为 0 的 Unicode 字符;\b
->\u0008
,退格符;\n
->\u000a
,换行符;\r
->\u000d
,回车符;\t
->\u0009
,水平制表符;\Z
->\u001A
,替换符;\%
->\%
;\_
->\_
;\<other char>
-><other char>
,跳过斜杠并保留字符不变。
通过将 SQL 配置 spark.sql.parser.escapedStringLiterals
设置为 true
,可以关闭上述转义规则。
示例
SELECT 'Hello, World!' AS col;
+-------------+
| col|
+-------------+
|Hello, World!|
+-------------+
SELECT "SPARK SQL" AS col;
+---------+
| col|
+---------+
|SPARK SQL|
+---------+
SELECT 'it\'s $10.' AS col;
+---------+
| col|
+---------+
|it's $10.|
+---------+
SELECT r"'\n' represents newline character." AS col;
+----------------------------------+
| col|
+----------------------------------+
|'\n' represents newline character.|
+----------------------------------+
二进制字面量
二进制字面量用于指定字节序列值。
语法
X { 'num [ ... ]' | "num [ ... ]" }
参数
-
num
0 到 F 的任意十六进制数字。
示例
SELECT X'123456' AS col;
+----------+
| col|
+----------+
|[12 34 56]|
+----------+
Null 字面量
Null 字面量用于指定 Null 值。
语法
NULL
示例
SELECT NULL AS col;
+----+
| col|
+----+
|NULL|
+----+
布尔字面量
布尔字面量用于指定布尔值。
语法
TRUE | FALSE
示例
SELECT TRUE AS col;
+----+
| col|
+----+
|true|
+----+
数值字面量
数值字面量用于指定定点数或浮点数。数值字面量有两种:整数字面量和小数字面量。
整数字面量语法
[ + | - ] digit [ ... ] [ L | S | Y ]
整数字面量参数
-
digit
0 到 9 的任意数字。
-
L
不区分大小写,表示
BIGINT
,它是一个 8 字节的有符号整数。 -
S
不区分大小写,表示
SMALLINT
,它是一个 2 字节的有符号整数。 -
Y
不区分大小写,表示
TINYINT
,它是一个 1 字节的有符号整数。 -
默认(无后缀)
表示一个 4 字节的有符号整数。
整数字面量示例
SELECT -2147483648 AS col;
+-----------+
| col|
+-----------+
|-2147483648|
+-----------+
SELECT 9223372036854775807l AS col;
+-------------------+
| col|
+-------------------+
|9223372036854775807|
+-------------------+
SELECT -32Y AS col;
+---+
|col|
+---+
|-32|
+---+
SELECT 482S AS col;
+---+
|col|
+---+
|482|
+---+
小数字面量语法
十进制字面量
decimal_digits { [ BD ] | [ exponent BD ] } | digit [ ... ] [ exponent ] BD
双精度浮点数字面量
decimal_digits { D | exponent [ D ] } | digit [ ... ] { exponent [ D ] | [ exponent ] D }
单精度浮点数字面量
decimal_digits { F | exponent [ F ] } | digit [ ... ] { exponent [ F ] | [ exponent ] F }
其中 decimal_digits 定义为
[ + | - ] { digit [ ... ] . [ digit [ ... ] ] | . digit [ ... ] }
且 exponent 定义为
E [ + | - ] digit [ ... ]
小数字面量参数
-
digit
0 到 9 的任意数字。
-
D
不区分大小写,表示
DOUBLE
,它是一个 8 字节的双精度浮点数。 -
F
不区分大小写,表示
FLOAT
,它是一个 4 字节的单精度浮点数。 -
BD
不区分大小写,表示
DECIMAL
,总位数作为精度,小数点右侧的位数作为小数位数。
小数字面量示例
SELECT 12.578 AS col, TYPEOF(12.578) AS type;
+------+------------+
| col| type|
+------+------------+
|12.578|decimal(5,3)|
+------+------------+
SELECT 12.578E0 AS col, TYPEOF(12.578E0) AS type;
+------+------+
| col| type|
+------+------+
|12.578|double|
+------+------+
SELECT -0.1234567 AS col;
+----------+
| col|
+----------+
|-0.1234567|
+----------+
SELECT -.1234567 AS col;
+----------+
| col|
+----------+
|-0.1234567|
+----------+
SELECT 123. AS col;
+---+
|col|
+---+
|123|
+---+
SELECT 123.BD AS col;
+---+
|col|
+---+
|123|
+---+
SELECT 5E2 AS col;
+-----+
| col|
+-----+
|500.0|
+-----+
SELECT 5D AS col;
+---+
|col|
+---+
|5.0|
+---+
SELECT -5BD AS col;
+---+
|col|
+---+
| -5|
+---+
SELECT 12.578e-2d AS col;
+-------+
| col|
+-------+
|0.12578|
+-------+
SELECT -.1234567E+2BD AS col;
+---------+
| col|
+---------+
|-12.34567|
+---------+
SELECT +3.e+3 AS col;
+------+
| col|
+------+
|3000.0|
+------+
SELECT -3.E-3D AS col;
+------+
| col|
+------+
|-0.003|
+------+
日期时间字面量
日期时间字面量用于指定日期或时间戳值。
日期语法
DATE { 'yyyy' |
'yyyy-[m]m' |
'yyyy-[m]m-[d]d' |
'yyyy-[m]m-[d]d[T]' }
注意: 如果未指定月份或日期,则默认为 01
。
日期示例
SELECT DATE '1997' AS col;
+----------+
| col|
+----------+
|1997-01-01|
+----------+
SELECT DATE '1997-01' AS col;
+----------+
| col|
+----------+
|1997-01-01|
+----------+
SELECT DATE '2011-11-11' AS col;
+----------+
| col|
+----------+
|2011-11-11|
+----------+
时间戳语法
TIMESTAMP { 'yyyy' |
'yyyy-[m]m' |
'yyyy-[m]m-[d]d' |
'yyyy-[m]m-[d]d ' |
'yyyy-[m]m-[d]d[T][h]h[:]' |
'yyyy-[m]m-[d]d[T][h]h:[m]m[:]' |
'yyyy-[m]m-[d]d[T][h]h:[m]m:[s]s[.]' |
'yyyy-[m]m-[d]d[T][h]h:[m]m:[s]s.[ms][ms][ms][us][us][us][zone_id]'}
注意: 如果未指定小时、分钟或秒,则默认为 00
。zone_id
应采用以下形式之一:
- Z - 祖鲁时区 UTC+0
+|-[h]h:[m]m
- 带有 UTC+、UTC-、GMT+、GMT-、UT+ 或 UT- 前缀之一,以及以下格式后缀的 ID:
+|-h[h]
+|-hh[:]mm
+|-hh:mm:ss
+|-hhmmss
- 区域性时区 ID,形式为
area/city
,例如Europe/Paris
注意: 如果未指定 zone_id
,则默认为会话本地时区(通过 spark.sql.session.timeZone
设置)。
时间戳示例
SELECT TIMESTAMP '1997-01-31 09:26:56.123' AS col;
+-----------------------+
| col|
+-----------------------+
|1997-01-31 09:26:56.123|
+-----------------------+
SELECT TIMESTAMP '1997-01-31 09:26:56.66666666UTC+08:00' AS col;
+--------------------------+
| col |
+--------------------------+
|1997-01-30 17:26:56.666666|
+--------------------------+
SELECT TIMESTAMP '1997-01' AS col;
+-------------------+
| col|
+-------------------+
|1997-01-01 00:00:00|
+-------------------+
间隔字面量
间隔字面量用于指定一个固定的时间段。间隔字面量支持两种语法:ANSI 语法和多单位语法。
ANSI 语法
ANSI SQL 标准以以下形式定义间隔字面量:
INTERVAL [ <sign> ] <interval string> <interval qualifier>
其中 <interval qualifier>
可以是单个字段或字段到字段的形式
<interval qualifier> ::= <start field> TO <end field> | <single field>
字段名称不区分大小写,可以是 YEAR
、MONTH
、DAY
、HOUR
、MINUTE
和 SECOND
之一。
间隔字面量可以是年-月间隔类型或日-时间隔类型。间隔子类型定义 <interval string>
的格式
<interval string> ::= <quote> [ <sign> ] { <year-month literal> | <day-time literal> } <quote>
<year-month literal> ::= <years value> [ <minus sign> <months value> ] | <months value>
<day-time literal> ::= <day-time interval> | <time interval>
<day-time interval> ::= <days value> [ <space> <hours value> [ <colon> <minutes value> [ <colon> <seconds value> ] ] ]
<time interval> ::= <hours value> [ <colon> <minutes value> [ <colon> <seconds value> ] ]
| <minutes value> [ <colon> <seconds value> ]
| <seconds value>
支持的年-月间隔字面量及其格式
<interval qualifier> |
间隔字符串模式 | 字面量的实例 |
---|---|---|
YEAR | [+|-]'[+|-]y' |
INTERVAL -'2021' YEAR |
YEAR TO MONTH | [+|-]'[+|-]y-m' |
INTERVAL '-2021-07' YEAR TO MONTH |
MONTH | [+|-]'[+|-]m' |
interval '10' month |
支持的日-时间隔字面量格式
<interval qualifier> |
间隔字符串模式 | 字面量的实例 |
---|---|---|
DAY | [+|-]'[+|-]d' |
INTERVAL -'100' DAY |
DAY TO HOUR | [+|-]'[+|-]d h' |
INTERVAL '-100 10' DAY TO HOUR |
DAY TO MINUTE | [+|-]'[+|-]d h:m' |
INTERVAL '100 10:30' DAY TO MINUTE |
DAY TO SECOND | [+|-]'[+|-]d h:m:s.n' |
INTERVAL '100 10:30:40.999999' DAY TO SECOND |
HOUR | [+|-]'[+|-]h' |
INTERVAL '123' HOUR |
HOUR TO MINUTE | [+|-]'[+|-]h:m' |
INTERVAL -'-123:10' HOUR TO MINUTE |
HOUR TO SECOND | [+|-]'[+|-]h:m:s.n' |
INTERVAL '123:10:59' HOUR TO SECOND |
MINUTE | [+|-]'[+|-]m' |
interval '1000' minute |
MINUTE TO SECOND | [+|-]'[+|-]m:s.n' |
INTERVAL '1000:01.001' MINUTE TO SECOND |
SECOND | [+|-]'[+|-]s.n' |
INTERVAL '1000.000001' SECOND |
ANSI 示例
SELECT INTERVAL '2-3' YEAR TO MONTH AS col;
+----------------------------+
|col |
+----------------------------+
|INTERVAL '2-3' YEAR TO MONTH|
+----------------------------+
SELECT INTERVAL -'20 15:40:32.99899999' DAY TO SECOND AS col;
+--------------------------------------------+
|col |
+--------------------------------------------+
|INTERVAL '-20 15:40:32.998999' DAY TO SECOND|
+--------------------------------------------+
多单位语法
INTERVAL interval_value interval_unit [ interval_value interval_unit ... ] |
INTERVAL 'interval_value interval_unit [ interval_value interval_unit ... ]' |
多单位参数
-
interval_value
语法
[ + | - ] number_value | '[ + | - ] number_value'
-
interval_unit
语法
YEAR[S] | MONTH[S] | WEEK[S] | DAY[S] | HOUR[S] | MINUTE[S] | SECOND[S] | MILLISECOND[S] | MICROSECOND[S] Mix of the YEAR[S] or MONTH[S] interval units with other units is not allowed.
多单位示例
SELECT INTERVAL 3 YEAR AS col;
+-------+
| col|
+-------+
|3 years|
+-------+
SELECT INTERVAL -2 HOUR '3' MINUTE AS col;
+--------------------+
| col|
+--------------------+
|-1 hours -57 minutes|
+--------------------+
SELECT INTERVAL '1 YEAR 2 DAYS 3 HOURS';
+----------------------+
| col|
+----------------------+
|1 years 2 days 3 hours|
+----------------------+
SELECT INTERVAL 1 YEARS 2 MONTH 3 WEEK 4 DAYS 5 HOUR 6 MINUTES 7 SECOND 8
MILLISECOND 9 MICROSECONDS AS col;
+-----------------------------------------------------------+
| col|
+-----------------------------------------------------------+
|1 years 2 months 25 days 5 hours 6 minutes 7.008009 seconds|
+-----------------------------------------------------------+