8.14.3 NULLIF
対象データ1と対象データ2を比較した結果,等しい場合はナル値を返し,等しくない場合は対象データ1を返します。
- 〈この項の構成〉
(1) 指定形式
スカラ関数NULLIF::=NULLIF(対象データ1,対象データ2) 対象データ1::=値式 対象データ2::=値式
(2) 指定形式の説明
- 対象データ1,対象データ2:
-
比較する対象データを指定します。
指定規則を次に示します。
-
対象データ1および対象データ2は,値式の形式で指定します。値式については,「7.21 値式」を参照してください。
-
対象データ1および対象データ2には,配列データを指定できません。
-
対象データ1と対象データ2には,比較できるデータ型のデータを指定してください。比較できるデータ型については,「6.2.2 変換,代入,比較できるデータ型」の「(1) 比較できるデータ型」を参照してください。ただし,次のデータは比較できません。
・DATE型のデータと,日付を表す既定の入力表現の文字データ
・TIME型のデータと,時刻を表す既定の入力表現の文字データ
・TIMESTAMP型のデータと,時刻印を表す既定の入力表現の文字データ
-
対象データ1と対象データ2の両方に,?パラメタを単独で指定できません。
-
対象データ1または対象データ2のどちらかに?パラメタを指定した場合,?パラメタを指定していない対象データのデータ型が,?パラメタのデータ型として仮定されます。
-
(3) 規則
-
実行結果のデータ型とデータ長は,「7.21.2 値式の結果のデータ型」で説明している規則に従って決まります。
-
実行結果の値は,非ナル値制約なし(ナル値を許す)となります。
-
対象データ1がナル値の場合,実行結果はナル値になります。
-
NULLIF(対象データ1,対象データ2)は,次のCASE 式と同じになります。
CASE WHEN 対象データ1 = 対象データ2 THEN NULL ELSE 対象データ1 END
(4) 例題
- 例題
-
表T1のC1列とC2列の値を比較します。
SELECT NULLIF("C1","C2") FROM "T1"