DIVIDE_BY_ZERO エラー クラス

SQLSTATE: 22012

0 で除算しました。 try_divide を使用して序数が 0 であることを許容し、代わりに NULL を返します。 必要であれば、<config> を "false" に設定してこのエラーを回避します。

パラメーター

  • ansiConfig: 動作を変更する構成の名前。

説明

Azure Databricks では、INTERVAL または数値を 0 で除算しようとするとこのエラーが発生します。 このエラーで提供されるコンテキスト情報は、エラーが発生したオブジェクトと式を分離します。 このエラーの原因となる可能性がある mod などの関数と演算子には、より複雑な数式の一部として除算を実行している関数が含まれます。

対応策

エラーの対応策はエラーの原因によって異なります。

  • エラーの原因になっている式は正しいですか?

    式が正しくない場合は、値が 0 にならないように修正し、クエリを再試行してください。

  • データは正しいですか?

    この入力データを使用すると渡される値が 0 になる可能性がある場合、データを引数として関数に渡す前にデータを修正するかクリーニングする必要があります。

    データのクリーニングは、問題のある行の除外、nullif(expr, 0) を使用して 0 の値を NULL に変換、または if(expr = 0, alt, expr) を使用してデータを別の許容される値に変換のいずれかを意味する可能性があります。

式とデータが正しく、ゼロによる除算を許容する場合は、try_divide を使用できます。 別の方法として、引数を nullif(expr, 0) に変更します。 これにより、式からエラーではなく NULL が返されます。 必要に応じて、nvl(try_divide(expr1, expr2), alt) を使用して、結果として得られる NULL を加算 0 や乗算 1 のためのニュートラル要素などの代替値に変換できます。

式またはデータフローを変更できない場合、最後の手段として、提供された ansiconfigfalse に設定してこの ANSI 動作を無効にできます。 この設定は、即時エラー状態を超える結果であることに注意してください。

-- A DIVIDE_BY_ZERO in a embedded in view. The context information isolates the faiing function.
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT 1/val FROM VALUES(1), (0) AS T(val);
> SELECT c1 FROM v;
  [DIVIDE_BY_ZERO] Division by zero. To return NULL instead, use `try_divide`. If necessary set "spark.sql.ansi.enabled" to false (except for ANSI interval type) to bypass this error.
  == SQL of VIEW v(line 1, position 7) ==
  SELECT 1/val FROM VALUES(1), (0) AS T(val)
         ^^^^^

-- Tolerating division by zero by turning the result to NULL using try_divide.
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT try_divide(1, val) FROM VALUES(1), (0) AS T(val);
> SELECT c1 FROM v;
  1
  NULL

-- Tolerating division by zero by turning the result to NULL using nullif
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT 1 / nullif(val, 0) FROM VALUES(1), (0) AS T(val);
> SELECT c1 FROM v;
  1
  NULL

-- Filtering out offensive rows
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT 1/val FROM VALUES(1), (0) AS T(val) WHERE val != 0;
> SELECT c1 FROM v;
  1

-- Turning division by zero into division by a small number.
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT 1 / if(val = 0, 1e-10, val) FROM VALUES(1), (0) AS T(val);
> SELECT c1 FROM v;
  1
  10000000000

-- Turning division by zero into a neutral element for addition.
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT nvl(try_divide(1, val), 0) FROM VALUES(1), (0) AS T(val);
> SELECT c1 FROM v;
  1
  0

-- Disabling ANSI mode in Databricks SQL for the view definition only.
> SET ANSI_MODE = false;
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT 1/val FROM VALUES(1), (0) AS T(val);
> SET ANSI_MODE = true;

> SELECT c1 FROM v;
  1
  NULL

-- Disabling ANSI mode in Databricks Runtime for the view definition only.
> SET spark.sql.ansi.enabled = false;
> CREATE OR REPLACE TEMPORARY VIEW v(c1) AS SELECT 1/val FROM VALUES(1), (0) AS T(val);
> SET spark.sql.ansi.enabled = true;

> SELECT c1 FROM v;
  1
  NULL