本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon QLDB 中的 NULLIF 函數
<a name="ql-functions.nullif"></a>

**重要**  
支援終止通知：現有客戶將可以使用 Amazon QLDB，直到 07/31/2025 的支援結束為止。如需詳細資訊，請參閱[將 Amazon QLDB Ledger 遷移至 Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/)。

在 Amazon QLDB 中，指定兩個表達式，`NULL`如果兩個表達式評估為相同的值，請使用 `NULLIF`函數傳回 。否則，此函數會傳回評估第一個表達式的結果。

`NULLIF` 函數不會傳播 `NULL`和 `MISSING`。

## 語法
<a name="ql-functions.nullif.syntax"></a>

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

## 引數
<a name="ql-functions.nullif.arguments"></a>

*expression1*、*expression2*  
函數比較的兩個欄位名稱或表達式。這些參數可以是任何支援的 [資料類型](ql-reference.data-types.md)。

## 傳回類型
<a name="ql-functions.nullif.return-type"></a>

任何支援的資料類型。傳回類型與第一個表達式的類型為 `NULL`或相同。

## 範例
<a name="ql-functions.nullif.examples"></a>

```
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
```

## 相關函數
<a name="ql-functions.nullif.related"></a>
+ [COALESCE](ql-functions.coalesce.md)
+ [EXISTS](ql-functions.exists.md)