PostgreSQL NUMERIC Type

Summary: in this tutorial, you will learn about the PostgreSQL NUMERIC type for storing numeric data.

Introduction to PostgreSQL NUMERIC data type

The NUMERIC type can store numbers with a lot of digits. Typically, you use the NUMERIC type for numbers that require exactness such as monetary amounts or quantities.

The following illustrates the syntax of the NUMERIC type:

NUMERIC(precision, scale)Code language: SQL (Structured Query Language) (sql)

In this syntax:

  • The precision is the total number of digits
  • The scale is the number of digits in the fraction part.

For example, the number 1234.567 has the precision 7 and scale 3.

The NUMERIC type can hold a value of up to 131,072 digits before the decimal point 16,383 digits after the decimal point.

The scale of the NUMERIC type can be zero or positive.

Here’s the syntax of the NUMERIC type with scale zero:

NUMERIC(precision)Code language: SQL (Structured Query Language) (sql)

If you omit both precision and scale, you can store any precision and scale up to the limit of the precision and scale mentioned above.

NUMERICCode language: SQL (Structured Query Language) (sql)

In PostgreSQL, the NUMERIC and DECIMAL types are equivalent and both of them are also a part of the SQL standard.

If precision is not required, you should not use the NUMERIC type because calculations on NUMERIC values are typically slower than integers, floats, and double precisions.

PostgreSQL NUMERIC examples

Let’s take some examples of using the PostgreSQL NUMERIC type.

1) Storing numeric values

If you store a value with a scale greater than the declared scale of the NUMERIC column, PostgreSQL will round the value to a specified number of fractional digits. For example:

First, create a new table called products:

CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    price NUMERIC(5,2)
);Code language: SQL (Structured Query Language) (sql)

Second, insert some products with prices whose scales exceed the scale declared in the price column:

INSERT INTO products (name, price)
VALUES ('Phone',500.215), 
       ('Tablet',500.214);Code language: SQL (Structured Query Language) (sql)

Because the scale of the price column is 2, PostgreSQL rounds the value 500.215 up to 500.22 and rounds the value 500.214 down to 500.21 :

The following query returns all rows of the products table:

SELECT * FROM products;Code language: SQL (Structured Query Language) (sql)

Output:

 id |  name  | price
----+--------+--------
  1 | Phone  | 500.22
  2 | Tablet | 500.21
(2 rows)

If you store a value whose precision exceeds the declared precision, PostgreSQL will raise an error as shown in the following example:

INSERT INTO products (name, price)
VALUES('Phone',123456.21);Code language: SQL (Structured Query Language) (sql)

PostgreSQL issued the following error:

ERROR:  numeric field overflow
DETAIL:  A field with precision 5, scale 2 must round to an absolute value less than 10^3.Code language: Shell Session (shell)

2) PostgreSQL NUMERIC type and NaN

In addition to holding numeric values, the NUMERIC type can also hold a special value called NaN which stands for not-a-number.

The following example updates the price of product id 1 to NaN :

UPDATE products
SET price = 'NaN'
WHERE id = 1;Code language: SQL (Structured Query Language) (sql)

Notice that you must use single quotes to wrap the NaN as shown in the UPDATE statement above.

The following query returns the data of the products table:

SELECT * FROM products;

Output:

 id |  name  | price
----+--------+--------
  2 | Tablet | 500.21
  1 | Phone  |    NaN
(2 rows)Code language: JavaScript (javascript)

Typically, the NaN is not equal to any number including itself. It means that the expression NaN = NaN returns false.

However, two NaN values are equal and NaN is greater than other numbers. This implementation allows PostgreSQL to sort NUMERIC values and use them in tree-based indexes.

The following query sorts the products based on prices:

SELECT * FROM products
ORDER BY price DESC;Code language: SQL (Structured Query Language) (sql)

Output:

 id |  name  | price
----+--------+--------
  1 | Phone  |    NaN
  2 | Tablet | 500.21
(2 rows)Code language: JavaScript (javascript)

The output indicates that the NaN is greater than 500.21

Summary

  • Use the PostgreSQL NUMERIC data types to store numbers that require exactness.
Was this tutorial helpful ?