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

# SIZE 関数
<a name="size"></a>

SIZE 関数は、既存の配列、マップ、または文字列を引数として受け取り、そのデータ構造のサイズまたは長さを表す単一の値を返します。新しいデータ構造は作成されません。これは、新しいデータ構造を作成するのではなく、既存のデータ構造のプロパティをクエリおよび分析するために使用されます。

この関数は、配列内の要素の数または文字列の長さを決定するのに役立ちます。SQL で配列やその他のデータ構造を使用する場合、データのサイズやカーディナリティに関する情報を取得できるため、特に便利です。

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

```
size(expr)
```

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

 expr**  
ARRAY、MAP、または STRING 式。

## 戻り型
<a name="size-return-type"></a>

SIZE 関数は INTEGER を返します。

## 例
<a name="size-example"></a>

この例では、SIZE 関数が配列 に適用され`['b', 'd', 'c', 'a']`、配列内の要素の数`4`である値 を返します。

```
SELECT size(array('b', 'd', 'c', 'a'));
 4
```

この例では、SIZE 関数がマップ に適用され`{'a': 1, 'b': 2}`、マップ内のキーと値のペアの数`2`である値 を返します。

```
SELECT size(map('a', 1, 'b', 2));
 2
```

この例では、SIZE 関数が文字列 に適用され`'hello world'`、文字列内の文字数`11`である値 を返します。

```
SELECT size('hello world');
11
```