DECIMAL

The DECIMAL data type provides an exact numeric in which the precision and scale can be arbitrarily sized. You can specify the precision (the total number of digits, both to the left and the right of the decimal point) and the scale (the number of digits of the fractional component). The amount of storage required depends on the precision you specify.

Note that NUMERIC is a synonym for DECIMAL, and that the documentation for the  NUMERIC data type exactly matches the documentation for this topic.

Syntax

 { DECIMAL | DEC } [(precision [, scale])]

precision

Must be between 1 and 31. If not specified, the default precision is 5.

scale

Must be less than or equal to the precision. If not specified, the default scale is 0.

Usage Notes

Here are several notes about using the DECIMAL data type:

  • An attempt to put a numeric value into a DECIMAL is allowed as long as any non-fractional precision is not lost. When truncating trailing digits from a DECIMAL value, Splice Machine rounds down. For example:
      -- this cast loses only fractional precision
    values cast (1.798765 AS decimal(5,2));
    1
    --------
    1.79
    	-- this cast does not fit:
    values cast (1798765 AS decimal(5,2));
    ERROR 22003: The resulting value is outside the range for the data type DECIMAL/NUMERIC(5,2).
    
  • When mixed with other data types in expressions, the resulting data type follows the rules shown in Storing values of one numeric data type in columns of another numeric data type.
  • When two decimal values are mixed in an expression, the scale and precision of the resulting value follow the rules shown in Scale for decimal arithmetic.
  • Integer constants too big for BIGINT are made DECIMAL constants.

Corresponding Compile-time Java Type

java.math.BigDecimal

JDBC Metadata Type (java.sql.Types)

DECIMAL

Examples

VALUES 123.456;
VALUES 0.001;