Compartilhar via

Função ceiling

Aplica-se a:verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 11.3 LTS e versões posteriores

Retorna o menor número não menor do que expr arredondado para cima para targetScale dígitos em relação ao ponto decimal. Essa função é um sinônimo de ceil função.

Sintaxe

ceiling(expr [, targetScale])

Argumentos

  • expr: uma expressão avaliada como um numérico.
  • targetScale: um literal INTEGER opcional maior do que -38 especificando em quantos dígitos após as casas decimais arredondar para cima.

Retornos

Se nenhum targetScale for fornecido:

  • Se expr for DECIMAL(p, s), retorna DECIMAL(p - s + 1, 0).
  • Para todos os outros casos, retorna um BIGINT.

Se targetScale for especificado e expr for um:

  • TINYINT

    Retornará um DECIMAL(p, 0) com p = max(3, -targetScale + 1).

  • SMALLINT

    Retornará um DECIMAL(p, 0) com p = max(5, -targetScale + 1).

  • INTEGER

    Retornará um DECIMAL(p, 0) com p = max(10, -targetScale + 1)).

  • BIGINT

    Retornará um DECIMAL(p, 0) com p = max(20, -targetScale + 1)).

  • FLOAT

    Retornará um DECIMAL(p, s) com p = max(14, -targetScale + 1)) e s = min(7, max(0, targetScale))

  • DOUBLE

    Retornará um DECIMAL(p, s) com p = max(30, -targetScale + 1)) e s = min(15, max(0, targetScale))

  • DECIMAL(p_in, s_in)

    Retornará um DECIMAL(p, s) com p = max(p_in - s_in + 1, -targetScale + 1)) e s = min(s_in, max(0, targetScale))

Se targetScale for negativo, o arredondamento ocorrerá para -targetScale dígitos à esquerda do ponto decimal.

O targetScale padrão é 0, que arredonda para cima até o próximo número integral maior.

Quando targetScale é especificado com um tipo de entrada integral, Azure Databricks gera ARITHMETIC_OVERFLOW se o resultado estourar o tipo de saída.

Aviso

No Databricks Runtime, se spark.sql.ansi.enabled for false, um estouro não causará um erro, mas "encapsula" o resultado.

Condições de erro comuns

Exemplos

> SELECT ceiling(-0.1);
 0

> SELECT ceiling(5);
 5

> SELECT ceiling(5.4);
 6

> SELECT ceiling(3345.1, -2);
 3400

> SELECT ceiling(-12.345, 1);
 -12.3

-- Rounding 127 to the nearest 10 produces 130, which overflows TINYINT.
> SELECT ceiling(cast(127 AS TINYINT), -1);
  Error: ARITHMETIC_OVERFLOW
  • Last updated on