Todos os produtos
Search
Central de documentação

MaxCompute:SLICE

Última atualização: Jun 26, 2026

Fatia um array ARRAY, extraindo os elementos a partir da posição start com comprimento length para compor um novo array ARRAY.

Formato do comando

array<T> slice(array<T> <a>, <start>, <length>)

Descrição dos parâmetros

  • a: obrigatório. Array do tipo ARRAY. O T em array<T> representa o tipo de dado dos elementos do array, que pode ser de qualquer tipo.

  • start: obrigatório. Ponto de início do fatiamento, a partir de 1, indicando que o fatiamento começa pelo primeiro elemento do array em direção à direita. O parâmetro start pode ser negativo, indicando que o fatiamento começa pelo último elemento do array em direção à direita.

  • length: obrigatório. Comprimento do fatiamento; deve ser maior ou igual a 0. Se o comprimento especificado exceder o tamanho do array ARRAY, o resultado será o subarray que vai da posição start até o último elemento.

Valor de retorno

Retorna um valor do tipo ARRAY.

Exemplos de uso

  • Exemplo 1: fatie o array ARRAY array(10, 20, 20, null, null, 30) a partir da posição 1, com comprimento de fatiamento igual a 3. Confira o exemplo de comando a seguir.

    --返回[10, 20, 20]。
    select slice(array(10, 20, 20, null, null, 30), 1, 3);
  • Exemplo 2: fatie o array ARRAY array(10, 20, 20, null, null, 30) a partir da posição -2, com comprimento de fatiamento igual a 2. Confira o exemplo de comando a seguir.

    --返回[NULL, 30]。
    select slice(array(10, 20, 20, null, null, 30), -2, 2);  
  • Exemplo 3: fatie o array ARRAY array(10, 20, 20, null, null, 30) a partir da posição 3, com comprimento de fatiamento igual a 10. O exemplo de comando está a seguir.

    --返回[20, NULL, NULL, 30]。
    select slice(array(10, 20, 20, null, null, 30), 3, 10); 
  • Exemplo 4: fatie o array ARRAY array(10, 20, 20, null, null, 30) a partir da posição 3, com comprimento de fatiamento igual a 0. O exemplo de comando está a seguir.

    --返回[]。
    select slice(array(10, 20, 20, null, null, 30), 3, 0);

Funções relacionadas

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