MaxCompute:DECODE

構文

DECODE(<expression>, <search>, <result>[, <search>, <result>]...[, <default>])

パラメーター

標準 SQL の CASE 式では NULL = NULL が false として扱われますが、DECODE は 2 つの NULL 値を等しいと見なします。NULL の expression は NULL の search 値と一致し、対応する result を返します。

戻り値

一致する search が見つかった場合は result を返し、一致が見つからない場合は default を返し、default が指定されていない場合は NULL を返します。

search と expression の値は同じデータの型である必要があります。そうでない場合、エラーが返されます。

例

次の例では、sale_detail テーブルを使用します：

+------------+-------------+-------------+------------+------------+
| shop_name  | customer_id | total_price | sale_date  | region     |
+------------+-------------+-------------+------------+------------+
| s1         | c1          | 100.1       | 2013       | china      |
| s2         | c2          | 100.2       | 2013       | china      |
| s3         | c3          | 100.3       | 2013       | china      |
| null       | c5          | NULL        | 2014       | shanghai   |
| s6         | c6          | 100.4       | 2014       | shanghai   |
| s7         | c7          | 100.5       | 2014       | shanghai   |
+------------+-------------+-------------+------------+------------+

例 1： デフォルト値で値をマップする

customer_id をラベルにマップし、認識されない値には Others を返します。NULL の customer_id は NULL の検索値と一致し、N/A を返します。

SELECT DECODE(customer_id,
              'c1', 'Taobao',
              'c2', 'Alipay',
              'c3', 'Aliyun',
              NULL, 'N/A',
              'Others') AS result
FROM sale_detail;

結果：

+------------+
| result     |
+------------+
| Others     |
| Others     |
| Others     |
| Taobao     |
| Alipay     |
| Aliyun     |
+------------+

例 2： デフォルトを省略する

default が省略され、一致する search がない場合、DECODE は NULL を返します。

SELECT DECODE(customer_id,
              'c1', 'Taobao',
              'c2', 'Alipay',
              'c3', 'Aliyun') AS result
FROM sale_detail;

結果：

+------------+
| result     |
+------------+
| Taobao     |
| Alipay     |
| Aliyun     |
| NULL       |
| NULL       |
| NULL       |
+------------+

customer_id の値が c5、c6、c7 の行には、一致する search エントリがないため、NULL が返されます。

構文

STRING DECODE(BINARY <str>, STRING <charset>)

パラメーター

戻り値

STRING 型の値を返します。str または charset が NULL の場合、NULL を返します。

例

例 1： UTF-8 で文字列をエンコードおよびデコードする

SELECT DECODE(ENCODE("English Sample", "UTF-8"), "UTF-8");

結果：

+-----------------+
| _c0             |
+-----------------+
| English Sample  |
+-----------------+

例 2： NULL パラメーター

いずれかのパラメーターが NULL の場合、結果は NULL になります。

SELECT DECODE(ENCODE("English Sample", "UTF-8"), NULL);

結果：

+------+
| _c0  |
+------+
| NULL |
+------+