Função slice

Aplica-se a: Databricks SQL Databricks Runtime

Retorna um subconjunto de uma matriz.

Sintaxe

slice(expr, start, length)

Argumentos

• expr: Uma ARRAY expressão.
• start: Uma INTEGER expressão.
• length: Uma INTEGER expressão maior ou igual a 0.

Devoluções

O resultado é do tipo exprde .

A função subdefine a matriz expr a partir do índice start (os índices da matriz começam em 1), ou a partir do final se start for negativo, com o especificado length. Se a fatia de matriz solicitada não se sobrepuser ao comprimento real da matriz, uma matriz vazia será retornada.

Azure Databricks eleva INVALID_PARAMETER_VALUE se start for 0 ou se length for negativo.

Condições de erro comuns

• INVALID_PARAMETER_VALUE

Exemplos

> SELECT slice(array(1, 2, 3, 4), 2, 2);
 [2,3]
> SELECT slice(array(1, 2, 3, 4), -2, 2);
 [3,4]

> SELECT slice(array(1, 2, 3), 0, 1);
  Error: INVALID_PARAMETER_VALUE.START

Funções relacionadas

• array Função