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

# Amazon QLDB の SIZE 関数
<a name="ql-functions.size"></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 では、指定されたコンテナデータ型 (リスト、構造、またはバッグ) の要素の数を返すには、`SIZE` 関数を使用します。

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

```
SIZE ( container )
```

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

*コンテナ*  
関数が動作するコンテナフィールド名または式。

## データ型
<a name="ql-functions.size.data-types"></a>

サポートされている引数の型:
+ リスト
+ 構造
+ バッグ

戻り型: `int`

`SIZE` への入力がコンテナでない場合、関数はエラーをスローします。

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

```
SIZE(`[]`)                   -- 0
SIZE(`[null]`)               -- 1
SIZE(`[1,2,3]`)              -- 3
SIZE(<<'foo', 'bar'>>)       -- 2
SIZE(`{foo: bar}`)           -- 1 (number of key-value pairs)
SIZE(`[{foo: 1}, {foo: 2}]`) -- 2
SIZE(12)                     -- error

-- Runnable statements
SELECT SIZE(`[]`) FROM << 0 >>      -- 0
SELECT SIZE(`[1,2,3]`) FROM << 0 >> -- 3
```

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