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

# Amazon QLDB 中的 COALESCE 函數
<a name="ql-functions.coalesce"></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 中，提供一或多個引數的清單，請使用 `COALESCE`函數從左到右依序評估引數，並傳回不是未知類型的第一個值 (`NULL` 或 `MISSING`)。如果所有引數類型都未知，則結果為 `NULL`。

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

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

```
COALESCE ( expression [, expression, ... ] )
```

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

*運算式*  
函數評估的一或多個欄位名稱或表達式清單。每個引數可以是任何支援的 [資料類型](ql-reference.data-types.md)。

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

任何支援的資料類型。傳回類型與評估為非 Null 和非遺失值的第一個表達式`NULL`類型相同。

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

```
SELECT COALESCE(1, null) FROM << 0 >>         -- 1
SELECT COALESCE(null, null, 1) FROM << 0 >>   -- 1
SELECT COALESCE(null, 'string') FROM << 0 >>  -- "string"
```

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