Todos os produtos
Search
Central de documentação

MaxCompute:ARRAY_REPEAT

Última atualização: Jun 26, 2026

Retorna um array com o elemento especificado repetido o número de vezes indicado.

Formato do comando

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

Descrição do comando

Gera um novo array ao repetir o elemento t count vezes.

Descrição dos parâmetros

  • t: obrigatório. Elemento a repetir. Tipos compatíveis:

    • TINYINT, SMALLINT, INT, BIGINT

    • FLOAT, DOUBLE

    • BOOLEAN

    • DECIMAL, DECIMALVAL

    • DATE, DATETIME, TIMESTAMP, IntervalDayTime, IntervalYearMonth

    • STRING, BINARY, VARCHAR, CHAR

    • ARRAY, STRUCT, MAP

  • count: obrigatório. Número de repetições, do tipo INT. Deve ser maior ou igual a 0.

Valor de retorno

Retorna o tipo ARRAY. Regras de retorno:

  • Se count for NULL, retorna NULL.

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

Exemplos de uso

  • Exemplo 1: repita 123 2 vezes para gerar um novo array. Comando:

    --返回[123, 123]。
    select array_repeat('123', 2);
  • Exemplo 2: count é NULL. Comando:

    --返回NULL。
    select array_repeat('123', null);
  • Exemplo 3: count é menor que 0. Comando:

    --返回[]。
    select array_repeat('123', -1);

Funções relacionadas

A função ARRAY_REPEAT pertence às funções de tipos complexos. Para outras funções de processamento de dados de tipos complexos (como ARRAY, MAP, STRUCT e JSON), consulte Complex type functions.