Renvoie un nouveau tableau dans lequel un élément donné est répété plusieurs fois.
Syntaxe
array<T> array_repeat(T <element>, int <count>)
Description
Renvoie un nouveau tableau dans lequel l'élément t est répété count fois.
Paramètres
-
t : obligatoire. Élément à répéter. Les types de données suivants sont pris en charge :
TINYINT, SMALLINT, INT et BIGINT
FLOAT et DOUBLE
BOOLEAN
DECIMAL et DECIMALVAL
DATE, DATETIME, TIMESTAMP, IntervalDayTime et IntervalYearMonth
STRING, BINARY, VARCHAR et CHAR
ARRAY, STRUCT et MAP
count : obligatoire. Nombre de répétitions. Ce paramètre doit être de type INT et sa valeur doit être supérieure ou égale à 0.
Valeur de retour
Renvoie une valeur de type ARRAY. La valeur de retour varie selon les règles suivantes :
Si la valeur de count est null, la fonction renvoie null.
Si la valeur de count est inférieure à 0, la fonction renvoie un tableau vide.
Exemples
-
Exemple 1 : Répétez
123twiceet renvoyez le nouveau tableau. Exemple d'instruction :-- The return value is [123, 123]. select array_repeat('123', 2); -
Exemple 2 : La valeur de count est null. Exemple d'instruction :
-- The return value is null. select array_repeat('123', null); -
Exemple 3 : La valeur de count est inférieure à 0. Exemple d'instruction :
-- The return value is []. select array_repeat('123', -1);
Fonctions associées
ARRAY_REPEAT est une fonction de type complexe. Pour plus d'informations sur les fonctions utilisées pour traiter les données de types complexes, telles que ARRAY, MAP, STRUCT et JSON, consultez Fonctions de type complexe.