INT

On this page

The INT data type stores 64-bit signed integers, that is, whole numbers from -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807.

Aliases

In CockroachDB, the following are aliases for INT:

• SMALLINT
• INTEGER
• INT8
• INT64
• BIGINT

Syntax

A constant value of type INT can be entered as a numeric literal. For example: 42, -1234, or 0xCAFE.

Size

An INT column supports values up to 64 bits (8 bytes) in width, but the total storage size is likely to be larger due to CockroachDB metadata.

CockroachDB does not offer multiple integer types for different widths; instead, our compression ensures that smaller integers use less disk space than larger integers. However, you can use the BIT(n) type, with n from 1 to 64, to constrain integers based on their corresponding binary values. For example, BIT(5) would allow 31 because it corresponds to the five-digit binary integer 11111, but would not allow 32 because it corresponds to the six-digit binary integer 100000, which is 1 bit too long. See the example below for a demonstration.

Examples

> CREATE TABLE ints (a INT PRIMARY KEY, b SMALLINT, c BIT(5));

CREATE TABLE

> SHOW COLUMNS FROM ints;

+-------+--------+-------+---------+-----------+
| Field |  Type  | Null  | Default |  Indices  |
+-------+--------+-------+---------+-----------+
| a     | INT    | false | NULL    | {primary} |
| b     | INT    | true  | NULL    | {}        |
| c     | BIT(5) | true  | NULL    | {}        |
+-------+--------+-------+---------+-----------+
(3 rows)

> INSERT INTO ints VALUES (1, 32, 32);

pq: bit string too long for type BIT(5) (column "c")

> INSERT INTO ints VALUES (1, 32, 31);

INSERT 1

> SELECT * FROM ints;

+---+----+----+
| a | b  | c  |
+---+----+----+
| 1 | 32 | 31 |
+---+----+----+
(1 row)

Supported Casting & Conversion

INT values can be cast to any of the following data types:

See Also

Data Types

Was this helpful?