リテラル
リテラル(定数とも呼ばれます)は、固定データ値を表します。Spark SQL は以下のリテラルをサポートします:
文字列リテラル
文字列リテラルは、文字列値を指定するために使われます。
構文
'char [ ... ]' | "char [ ... ]"
パラメータ
-
char
文字セットの1文字。特殊文字をエスケープするには、
\を使います (例えば、'or\)。To represent unicode characters, use 16-bit or 32-bit unicode escape of the form\uxxxxor\Uxxxxxxxx, where xxxx and xxxxxxxx are 16-bit and 32-bit code points in hexadecimal respectively (e.g.,\u3042forあand\U0001F44Dfor).
例
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.|
+---------+
バイナリリテラル
バイナリリテラルはバイトシーケンス値を指定するために使われます。
構文
X { 'num [ ... ]' | "num [ ... ]" }
パラメータ
-
num
0 から F までの16進数。
例
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|
+----+
数値リテラル
数値リテラルは、固定あるいは浮動小数点数を指定するために使われます。数値リテラルには、整数リテラルと分数リテラルの2種類があります。
整数リテラル構文
[ + | - ] digit [ ... ] [ L | S | Y ]
整数リテラルパラメータ
-
桁
0から9までの任意の数字。
-
L
大文字と小文字を区別せず、8バイトの符号付き整数である
BIGINTを示します。 -
S
大文字と小文字を区別せず、2バイトの符号付き整数である
SMALLINTを示します。 -
Y
大文字と小文字を区別せず、1バイトの符号付き整数である
TINYINTを示します。 -
デフォルト (接尾辞無し)
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|
+---+
分数リテラル構文
10進数リテラル:
decimal_digits { [ BD ] | [ exponent BD ] } | digit [ ... ] [ exponent ] BD
double リテラル:
decimal_digits { D | exponent [ D ] } | digit [ ... ] { exponent [ D ] | [ exponent ] D }
float リテラル:
decimal_digits { F | exponent [ F ] } | digit [ ... ] { exponent [ F ] | [ exponent ] F }
decimal_digits は次のように定義されます
[ + | - ] { digit [ ... ] . [ digit [ ... ] ] | . digit [ ... ] }
指数は次のように定義されます
E [ + | - ] digit [ ... ]
分数リテラルパラメータ
-
桁
0から9までの任意の数字。
-
D
大文字小文字を区別せず、8バイトの倍精度浮動小数点数である
DOUBLEを示します。 -
F
大文字小文字を区別せず、4バイト単精度浮動小数点数である
FLOATを示します。 -
BD
大文字と小文字を区別せず、桁数の合計は精度で、小数点以下の桁数は位取りである
DECIMALを示します。
分数リテラルの例
SELECT 12.578 AS col;
+------+
| col|
+------+
|12.578|
+------+
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|
+------+
Datetime リテラル
datetimeリテラルは、dateあるいはtimestamp値を指定するために使われます。
Date 構文
DATE { 'yyyy' |
'yyyy-[m]m' |
'yyyy-[m]m-[d]d' |
'yyyy-[m]m-[d]d[T]' }
注意: 月または日が指定されていない場合、デフォルトは01です。
Dateの例
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構文
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 - Zulu time zone UTC+0
+|-[h]h:[m]m- id は、接頭辞 UTC+、UTC-、GMT+、GMT-、UT+、UT- のいずれかを含み, 接尾辞は以下の形式:
+|-h[h]+|-hh[:]mm+|-hh:mm:ss+|-hhmmss
Europe/Parisのような、area/cityの形式の地域ベースのゾーン ID
注意: zone_id が指定されていない場合は、デフォルトはセッションローカルタイムゾーン (spark.sql.session.timeZone で設定)です。
Timestampの例
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|
+-------------------+
Interval リテラル
interval リテラルは、一定期間を指定するために使われます。interval リテラルは、ANSI構文とマルチユニット構文の2つの構文をサポートします。
ANSI構文
ANSI SQL標準は、次の形式のintervalリテラルを定義します:
INTERVAL [ <sign> ] <interval string> <interval qualifier>
<interval qualifier>は、単一のフィールドまたはフィールドからフィールドへの形式です:
<interval qualifier> ::= <start field> TO <end field> | <single field>
フィールド名は大文字小文字を区別せず、YEAR, MONTH, DAY, HOUR, MINUTE, SECONDのいずれかです。
intervalリテラルはyear-monthまたはday-time interval 型のどちらかです。interval sub-type は<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>
サポートされる year-month interval リテラルと形式は以下の通りです:
<interval qualifier> |
Interval string pattern | An instance of the literal |
|---|---|---|
| YEAR | [+|-]'[+|-]y' |
INTERVAL -'2021' YEAR |
| YEAR TO MONTH | [+|-]'[+|-]y-m' |
INTERVAL '-2021-07' YEAR TO MONTH |
| MONTH | [+|-]'[+|-]m' |
interval '10' month |
サポートされる day-time interval リテラルの形式は以下の通りです:
<interval qualifier> |
Interval string pattern | An instance of the literal |
|---|---|---|
| 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 Examples
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|
+-----------------------------------------------------------+