Системные таблицы (System Catalog)

Goal: Описание структуры и назначения системных таблиц AngaraBase для мониторинга, диагностики и управления метаданными.

Системный каталог AngaraBase доступен через виртуальную схему sys. Эти таблицы предоставляют информацию о состоянии инстанса, конфигурации и объектах базы данных в реальном времени.

Таблица `sys.tables`

Содержит метаданные всех таблиц во всех базах данных и схемах.

Поле	Тип	Описание
`db_id`	`string`	Идентификатор базы данных.
`schema_name`	`string`	Имя схемы (обычно `public`).
`table_name`	`string`	Имя таблицы.
`tablespace_name`	`string`	Имя табличного пространства.
`storage_engine`	`string`	Тип движка хранения: `row_store` (HeapFile), `memory` (In-memory), `htap_row_column`.
`durability`	`string`	Уровень долговечности (для memory-таблиц): `none`, `logged`, `snapshotted`.
`max_rows`	`uint64`	Лимит строк (для memory-таблиц).
`eviction_policy`	`string`	Политика вытеснения (для memory-таблиц): `error`, `fifo`, `lru`, `lfu`.
`checkpoint_interval_ms`	`uint64`	Интервал чекпоинтов в мс (для `snapshotted`).
`current_rows`	`uint64`	Текущее количество живых строк (приблизительно).
`evictions_total`	`uint64`	Счетчик вытесненных строк.
`limit_errors_total`	`uint64`	Счетчик ошибок превышения лимита строк.
`append_only`	`bool`	Флаг режима append-only (устаревший, см. `mutation_policy`).
`mutation_policy`	`string`	Политика изменений: `unrestricted`, `no_delete`, `append_only`.

Примечание по Storage Engine

row_store: Стандартное хранение на диске (HeapFile).
memory: Данные хранятся в оперативной памяти. Долговечность регулируется параметром durability.

Таблица `sys.settings`

Предоставляет доступ к текущим настройкам конфигурации сервера (Effective Configuration).

Поле	Тип	Описание
`name`	`string`	Имя параметра (например, `server.addr`).
`value`	`string`	Текущее эффективное значение.
`source`	`string`	Источник значения: `default`, `config`, `bootstrap_env`, `sql_runtime`.
`dynamic`	`bool`	`true`, если параметр можно изменить без перезагрузки.
`doc`	`string`	Краткое описание параметра.

Таблица `sys.databases`

Список доступных баз данных.

Поле	Тип	Описание
`db_id`	`string`	Уникальный идентификатор базы данных.
`name`	`string`	Имя базы данных.

Таблица `sys.schemas`

Список схем в базах данных.

Поле	Тип	Описание
`db_id`	`string`	Идентификатор базы данных.
`schema_name`	`string`	Имя схемы.

Troubleshooting

Симптом: Таблица sys.tables возвращает пустой результат.
Причина: У пользователя нет прав на просмотр метаданных или не выбрана база данных (если используется фильтрация).
Решение: Проверьте права доступа (RBAC).
Симптом: Изменение в sys.settings не применяется.
Причина: Параметр имеет dynamic = false или перекрыт переменной окружения (source = bootstrap_env).
Решение: Требуется перезагрузка сервера или изменение конфигурации/переменных окружения.

AngaraBook