Função array_remove

Aplica-se a: Databricks SQL Databricks Runtime

Remove todas as ocorrências de element de array.

Sintaxe

array_remove(array, element)

Argumentos

• array: Uma MATRIZ.
• element: Uma expressão de um tipo que compartilha um tipo menos comum com os elementos de array.

Devoluções

O tipo de resultado correspondia ao tipo da matriz.

Se o elemento a ser removido for NULL, o resultado será NULL.

Azure Databricks eleva COLLECTION_SIZE_LIMIT_EXCEEDED se o resultado exceder o limite de tamanho do array.

Condições de erro comuns

• COLLECTION_SIZE_LIMIT_EXCEEDED

Exemplos

> SELECT array_remove(array(1, 2, 3, NULL, 3, 2), 3);
 [1,2,NULL,2]
> SELECT array_remove(array(1, 2, 3, NULL, 3, 2), NULL);
 NULL

Relacionada

• array_except Função
• Regras de tipo de dados SQL