Freigeben über


array_remove-Funktion

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Entfernt alle Vorkommen von element aus array.

Syntax

array_remove(array, element)

Argumente

  • array: Ein ARRAY.
  • element: Ein Ausdruck mit einem Typ, der einen kleinsten gemeinsamen Typ mit den Elementen von array aufweist.

Gibt zurück

Der Ergebnistyp entspricht dem Typ des Arrays.

Wenn das zu entfernende Element NULL ist, ist das Ergebnis NULL.

Azure Databricks löst COLLECTION_SIZE_LIMIT_EXCEEDED aus, wenn das Ergebnis den Grenzwert für die Arraygröße überschreitet.

Häufige Fehlerbedingungen

Beispiele

> 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