本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon QLDB 中的 COALESCE 函数
<a name="ql-functions.coalesce"></a>

**重要**  
终止支持通知：现有客户将能够使用 Amazon QLDB，直到 2025 年 7 月 31 日终止支持。有关更多详细信息，请参阅[将亚马逊 QLDB 账本迁移到亚马逊 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, ... ] )
```

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

*expression*  
函数计算的、一个或多个字段名称或表达式的列表。每个参数都可以是任何支持的 [数据类型](ql-reference.data-types.md)。

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

任何支持数据类型。返回类型为`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)