DIVIDE_BY_ZERO エラークラス
ゼロによる除算。 除数が 0 であることを許容し、代わりに NULL を返すには try_divide を使用します。必要に応じて、 <config> を "false" に設定して、このエラーを回避します。
パラメーター
- ansiConfig : 動作を変更する構成の名前。
説明
Databricks は、INTERVAL または numeric を 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のための中立要素などの代替値に変換できます。
最後の手段として、式またはデータフローを変更できない場合は、提供されている ansiconfig を falseに設定することで、この 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