Data types

Goal

Справочник поддерживаемых типов данных AngaraBase и правила приведения типов.

SQL type	Alias	Storage	Notes
`INTEGER`	`INT`, `INT4`	32-bit signed	Primary numeric type
`BIGINT`	`INT8`	64-bit signed	Large counters, IDs
`VARCHAR(n)`	—	Variable-length text	Bounded by `n` characters
`TEXT`	—	Variable-length text	Unbounded text
`BOOLEAN`	`BOOL`	1-byte	`TRUE` / `FALSE` / `NULL` (OID 16)
`TIMESTAMP`	—	Text-backed compat	ISO 8601 UTC (OID 1114)
`DATE`	—	Text-backed compat	ISO 8601 date portion (OID 1082)

TIMESTAMP и DATE хранятся в text-backed compatibility mode. Это означает:

Сравнения выполняются как текстовые (лексикографические); ISO 8601 формат гарантирует корректный порядок.
Serialization (RM-0.6.5.5): TIMESTAMP всегда сериализуется в UTC без смещения (например, 2026-05-07 14:30:00.123). Трейлинг-нули микросекунд обрезаются.
Арифметика (INTERVAL и пр.) не поддерживается — 0A000.
BRIN-индексы на date / timestamp / timestamptz колонках поддерживаются (используют текстовые min/max).

SQL type	Status
`DECIMAL` / `NUMERIC`	Planned
`UUID`	Planned

Попытка использовать неподдерживаемый тип приведёт к ошибке парсера или 0A000 feature_not_supported.

Все типы допускают NULL, если колонка не объявлена как NOT NULL.
В ORDER BY ASC значения NULL трактуются как наибольшие (выводятся последними).
Явное управление NULLS FIRST / NULLS LAST не поддерживается — 0A000.

AngaraBase поддерживает PostgreSQL-синтаксис приведения типов:

SELECT '42'::INTEGER;
SELECT id::TEXT FROM t;

Приведение между несовместимыми типами приводит к runtime-ошибке с соответствующим SQLSTATE.