Todos os produtos
Search
Central de documentação

MaxCompute:ARRAY_REPEAT

Última atualização: Sep 22, 2026

Retorna um novo array contendo um elemento especificado repetido várias vezes.

Sintaxe

array<T> array_repeat(T <element>, int <count>)

Descrição

Retorna um novo array contendo o elemento t repetido count vezes.

Parâmetros

  • t: obrigatório. Especifica o elemento a repetir. Tipos de dados compatíveis:

    • TINYINT, SMALLINT, INT e BIGINT

    • FLOAT e DOUBLE

    • BOOLEAN

    • DECIMAL e DECIMALVAL

    • DATE, DATETIME, TIMESTAMP, IntervalDayTime e IntervalYearMonth

    • STRING, BINARY, VARCHAR e CHAR

    • ARRAY, STRUCT e MAP

  • count: obrigatório. Especifica o número de repetições. Requer um valor do tipo INT maior ou igual a 0.

Valor de retorno

Retorna um valor do tipo ARRAY. O valor de retorno segue as seguintes regras:

  • Se o valor de count for null, retorna null.

  • Se o valor de count for menor que 0, retorna um array vazio.

Exemplos

  • Exemplo 1: Repita 123 twice e retorne o novo array. Exemplo de instrução:

    -- The return value is [123, 123]. 
    select array_repeat('123', 2);
  • Exemplo 2: O valor de count é null. Instrução de exemplo:

    -- The return value is null. 
    select array_repeat('123', null);
  • Exemplo 3: O valor de count é menor que 0. Exemplo de comando:

    -- The return value is []. 
    select array_repeat('123', -1);

Funções relacionadas

ARRAY_REPEAT é uma função de tipo complexo. Para obter mais informações sobre as funções usadas para processar dados de tipos complexos, como ARRAY, MAP, STRUCT e JSON, consulte Complex type functions.