Tous les produits
Search
Centre de documentation

MaxCompute:ARRAY_REPEAT

Dernière mise à jour :Sep 22, 2026

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 123 twice et 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.