raise_error-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime

Löst eine Ausnahme mit expr als Meldung aus.

Syntax

raise_error(expr)

Argumente

  • expr: Ein STRING-Ausdruck.

Gibt zurück

Der NULL-Typ.

Die Funktion löst einen Laufzeitfehler mit expr als Fehlermeldung aus.

Gilt für: check marked yesDatabricks SQL check marked yes Databricks Runtime 14.2 und höher

Die zurückgegebene Fehlerklasse ist USER_RAISED_EXCEPTION und die SQLSTATE ist P0001.

Einzelheiten zur Behandlung von Fehlerbedingungen finden Sie unter Behandlung von Fehlerbedingungen.

Beispiele

> SELECT raise_error('custom error message');
 [USER_RAISED_EXCEPTION] custom error message SQLSTATE: P0001