negative-Funktion

Gilt für: Databricks SQL Databricks Runtime

Gibt den negierten Wert von expr zurück. Diese Funktion ist ein Synonym für - (Minuszeichen) unärer Operator.

Syntax

negative(expr)

Argumente

• expr: Ein Ausdruck, der in einen numerischen Wert oder in ein Intervall ausgewertet wird.

Gibt zurück

Der Ergebnistyp entspricht dem Argumenttyp.

Bei integralen numerischen Typen kann die Funktion den Fehler ARITHMETIC_OVERFLOW zurückgeben.

Warnung

In Databricks Runtime verursacht ein Überlauf keinen Fehler, sondern „umschließt“ das Ergebnis, wenn spark.sql.ansi.enabled auf false festgelegt ist.

Beispiele

> SELECT negative(1);
 -1

> SELECT negative(cast(-32768 AS smallint))
 Error: ARITHMETIC_OVERFLOW

Zugehörige Funktionen

• sign Funktion
• abs Funktion
• positive Funktion
• --unärer Operator (Minuszeichen)
• +-unärer Operator (Pluszeichen)