Partilhar via

DIVIDE_BY_ZERO classe de erro

  • Artigo

SQLSTATE: 22012

Divisão por zero. Use try_divide para tolerar que o divisor seja 0 e retorne NULL em vez disso. Se necessário, defina <config> como "false" para ignorar esse erro.

Parâmetros

  • ansiConfig: O nome da configuração para alterar o comportamento.

Explicação

O Azure Databricks gera esse erro sempre que tenta dividir um INTERVAL ou numérico por 0. As informações de contexto fornecidas com esse erro isolam o objeto e a expressão na qual o erro ocorreu. Funções e operadores como mod, que podem causar esse erro incluem aqueles que estão executando a divisão como parte de fórmulas mais complexas.

Atenuação

A atenuação do erro depende da causa:

  • A expressão que está a causar o erro está correta?

    Se a expressão estiver incorreta, corrija-a para que o valor 0 não possa ocorrer e tente novamente a consulta.

  • Os dados estão corretos?

    Se os dados de entrada puderem resultar na passagem dos valores 0, talvez seja necessário corrigir os dados na origem ou limpá-los antes de passar os dados para a função como um argumento.

    A limpeza de dados pode significar excluir as linhas ofensivas, converter os valores 0 em NULL usando nullif(expr, 0)ou converter os dados em outro valor aceitável usando if(expr = 0, alt, expr).

Se a expressão e os dados estiverem corretos e quiseres tolerar a divisão por zero, podes usar try_divide. Como alternativa, altere o argumento para nullif(expr, 0). Isso fará com que a expressão retorne NULL em vez de um erro. Se preferir, você pode nvl(try_divide(expr1, expr2), alt) transformar o NULL resultante em valores alternativos, como elementos neutros para adição 0 ou multiplicação 1.

Como solução de último recurso, quando a expressão ou o fluxo de dados não puder ser alterado, você poderá desabilitar esse comportamento ANSI definindo o ansiconfig fornecido como false. Observe que esta configuração é consequente para além da condição de erro imediato.

Exemplos

-- 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