翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon QLDB の NULLIF 関数
NULLIF

**重要**  
サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了まで Amazon QLDB を使用できます。詳細については、[「Amazon QLDB 台帳を Amazon Aurora PostgreSQL に移行する](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)」を参照してください。

Amazon QLDB では、2 つの式が与えられた場合、`NULLIF` 関数を使用して、2 つの式が同じ値に評価される場合に `NULL` を返します。それ以外の場合、この関数は、最初の式の評価結果を返します。

`NULLIF` 関数は、`NULL` および `MISSING` を伝播しません。

## 構文


```
NULLIF ( expression1, expression2 )
```

## 引数


*expression1*, *expression2*  
関数が比較する 2 つのフィールド名または式。これらのパラメータには、サポートされている任意の [データ型](ql-reference.data-types.md) を使用できます。

## 戻り型


サポートされている任意のデータ型。戻り値の型は、`NULL` または最初の式の型と同じです。

## 例


```
NULLIF(1, 1)             -- null
NULLIF(1, 2)             -- 1
NULLIF(1.0, 1)           -- null
NULLIF(1, '1')           -- 1
NULLIF([1], [1])         -- null
NULLIF(1, NULL)          -- 1
NULLIF(NULL, 1)          -- null
NULLIF(null, null)       -- null
NULLIF(missing, null)    -- null
NULLIF(missing, missing) -- null

-- Runnable statements
SELECT NULLIF(1, 1) FROM << 0 >>   -- null
SELECT NULLIF(1, '1') FROM << 0 >> -- 1
```

## 関連関数

+ [COALESCE](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)