指定された要素が複数回繰り返される新しい配列を返します。
構文
array<T> array_repeat(T <element>, int <count>)説明
要素tがcount回繰り返される新しい配列を返します。
パラメーター
t: 必須です。 このパラメータは、繰り返す要素を指定します。 次のデータ型がサポートされています。
TINYINT、SMALLINT、INT、およびBIGINT
フロートとダブル
BOOLEAN
デシマルとデシマル
DATE、DATETIME、TIMESTAMP、IntervalDayTime、およびIntervalYearMonth
STRING、BINARY、VARCHAR、CHAR
アレイ、STRUCT、マップ
count: 必須です。 このパラメータは、繰り返し回数を指定します。 INT型の値が必要です。 値は0以上である必要があります。
戻り値
ARRAY型の値が返されます。 戻り値は、次のルールによって異なります。
countの値がnullの場合、nullが返されます。
countの値が0未満の場合、空の配列が返されます。
例
例1:
123を2回繰り返し、新しい配列を返します。 例:-- The return value is [123, 123]. select array_repeat('123', 2);例2: countの値がnullです。 例:
-- The return value is null. select array_repeat('123', null);例3: countの値が0未満です。 例:
-- The return value is []. select array_repeat('123', -1);
関連関数
ARRAY_REPEATは複合型関数です。 ARRAY、MAP、STRUCT、JSONなどの複雑なデータ型のデータを処理するために使用される関数の詳細については、複合型関数.