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

# Amazon QLDB の COALESCE 関数
<a name="ql-functions.coalesce"></a>

**重要**  
サポート終了通知: 既存のお客様は、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 では、1 つ以上の引数のリストが与えられた場合、`COALESCE` 関数を使用して引数を左から右に評価し、不明な型 (`NULL` または `MISSING`) でない最初の値を返します。すべての引数の型が不明な場合、結果は `NULL` になります。

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

## 構文
<a name="ql-functions.coalesce.syntax"></a>

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

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

*expression*  
関数が評価する 1 つ以上のフィールド名または式のリスト。各引数には、サポートされている任意の [データ型](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)