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

# Amazon QLDB の COUNT 関数
<a name="ql-functions.count"></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 では、指定された式で定義されているドキュメントの数を返すには、`COUNT` 関数を使用します。この関数には 2 つのバリエーションがあります。
+ `COUNT(*)`– NULL 値や欠損値が含まれているかどうかにかかわらず、ターゲットテーブル内のすべてのドキュメントをカウントします。
+ `COUNT(expression)` – 特定の既存のフィールドまたは式に NULL 以外の値が含まれるドキュメントの数を計算します。

**警告**  
`COUNT` 関数は最適化されていないため、インデックスルックアップなしでの使用はお勧めしません。インデックス付きルックアップなしで QLDB でクエリを実行すると、完全なテーブルスキャンが呼び出されます。これにより、同時実行の競合やトランザクションのタイムアウトなど、大きなテーブルでパフォーマンスの問題が発生する可能性があります。  
テーブルスキャンを回避するには、インデックス付きフィールドまたはドキュメント ID で**等価演算子 (`=` または `IN`) を使用する `WHERE` 述語句でステートメントを実行する必要があります。詳細については、「[クエリパフォーマンスの最適化](working.optimize.md)」を参照してください。

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

```
COUNT ( * | expression )
```

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

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

## 戻り型
<a name="ql-functions.count.return-type"></a>

`int`

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

```
SELECT COUNT(*) FROM VehicleRegistration r WHERE r.LicensePlateNumber = 'CA762X' -- 1
SELECT COUNT(r.VIN) FROM Vehicle r WHERE r.VIN = '1N4AL11D75C109151'             -- 1
SELECT COUNT(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >>                   -- 3
```

## 関連関数
<a name="ql-functions.count.related"></a>
+ [AVG](ql-functions.avg.md)
+ [MAX](ql-functions.max.md)
+ [MIN](ql-functions.min.md)
+ [SIZE](ql-functions.size.md)
+ [SUM](ql-functions.sum.md)