Создаем первую таблицу в QuestDB и добавляем данные вручную

Добавим первую таблицу для хранения OHLCV, для этого в веб-консоли QuestDB в редактор кода вставьте код: 

CREATE TABLE ohlcv (
    ts        TIMESTAMP,
    symbol    SYMBOL CAPACITY 100 INDEX,
    timeframe SYMBOL,
    open      DOUBLE,
    high      DOUBLE,
    low       DOUBLE,
    close     DOUBLE,
    volume    DOUBLE
) TIMESTAMP(ts) PARTITION BY DAY
DEDUP UPSERT KEYS(ts, symbol, timeframe);

и запустите его.

Разбор кода

Общая структура

Команда CREATE TABLE создаёт новую таблицу. Всё что внутри скобок — это колонки и их типы данных. Всё что после скобок — специальные инструкции для QuestDB как хранить и организовывать данные.

Колонки таблицы

1. ts TIMESTAMP Момент времени когда открылась свеча — дата и время с точностью до микросекунды. Например 2024-01-01 09:00:00.000000. Это самая главная колонка в любой time-series таблице — без неё QuestDB не знает что данные временные.
2. symbol SYMBOL CAPACITY 100 INDEX Название торгового инструмента — 'BTC_USDT', 'ETH_USDT' и так далее. Здесь три ключевых слова:
   1. SYMBOL — специальный тип QuestDB для коротких строк которые часто повторяются. Внутри хранится как число — 'BTC_USDT' превращается в 1, 'ETH_USDT' в 2 и так далее. Снаружи выглядит как текст, внутри работает как число — быстро и компактно.
   2. CAPACITY 100 — подсказка базе что уникальных тикеров будет около 100. QuestDB заранее выделит под это память. Не жёсткое ограничение — если тикеров станет больше таблица не сломается.
   3. INDEX — индекс строится по этой колонке. Индекс работает как оглавление в книге — вместо того чтобы просматривать все строки подряд, база сразу прыгает на нужный тикер. Запросы WHERE symbol = 'BTC_USDT' работают значительно быстрее.
3. timeframe SYMBOL Таймфрейм свечи — '1m', '5m', '1h', '1d'. Тип SYMBOL по той же причине что и symbol — значений мало, они повторяются миллионы раз. Индекс здесь не нужен — таймфреймов всего несколько штук и индекс по такой колонке почти ничего не даст.
4. open DOUBLE — цена открытия свечи.
5. high DOUBLE — максимальная цена за время жизни свечи.
6. low DOUBLE — минимальная цена за время жизни свечи.
7. close DOUBLE — цена закрытия свечи.
8. volume DOUBLE — суммарный объём торгов за время свечи. Тип DOUBLE потому что объём может быть дробным числом: например 1523.75 BTC.

Инструкции после скобок

TIMESTAMP(ts) Объявляем колонку ts главной временной осью таблицы. Это обязательное объявление для time-series таблиц в QuestDB. Без него нельзя использовать партиционирование, временные запросы и функцию SAMPLE BY для построения свечей других таймфреймов из минуток.

PARTITION BY DAY Данные физически делятся по дням на диске. Каждый день — отдельная папка:

db\ohlcv\
    2026-01-01\   ← все свечи за 1 января
    2026-01-02\   ← все свечи за 2 января
    2026-01-03\   ← все свечи за 3 января

Когда делаешь запрос за конкретный период — база открывает только нужные папки и не трогает остальные. Например для 30 тикеров на минутном таймфрейме это около 43 000 строк в день — оптимальный размер одной партиции.

DEDUP UPSERT KEYS(ts, symbol, timeframe) Защита от дубликатов. Комбинация трёх колонок ts + symbol + timeframe объявляется уникальным ключом таблицы. Логика при каждой вставке строки:

• Если записи с таким ключом нет → вставляет новую строку
• Если запись с таким ключом уже есть → обновляет существующую

Это называется UPSERT — от английских слов UPDATE + INSERT. Практический смысл: одна свеча одного тикера на одном таймфрейме в один момент времени может существовать только в одном экземпляре. Сколько раз ни вставляй одни и те же данные — дубликатов не будет. Это критически важно для торгового робота который получает данные из биржи — даже если одна и та же свеча придёт дважды, база просто обновит её без ошибки.

Дедупликация

Дедупликация гарантирует, что для заданного набора ключевых столбцов будет существовать только одна строка. Когда новая строка соответствует ключам существующей строки, старая строка заменяется.

DEDUP UPSERT KEYS — это защита от дубликатов. Определяет уникальный ключ таблицы из нескольких колонок. В нашем случае:

ts + symbol + timeframe = уникальная свеча

Логика при каждой вставке:

• Если записи с таким ключом нет → вставляет новую строку
• Если запись с таким ключом есть → обновляет существующую

Это называется UPSERT = UPDATE + INSERT. Особенно важно для торгового робота — даже если одна и та же свеча придёт дважды из биржи, база просто обновит её без ошибки и без дубликата.

Про индекс

Почему у нас колонка symbol типа SYMBOL  с индексом, а колонка timeframe типа SYMBOL  без индекса?
Поясним: разница не в количестве уникальных значений, а в том как часто ты фильтруешь по этой колонке и насколько это селективно.

SHOW TABLES;

SHOW COLUMNS FROM ohlcv;

Partitioning   → Day        ✓ партиционирование работает
Deduplication  → Enabled    ✓ защита от дубликатов включена
Pending Rows   → 0          ✓ таблица пустая, готова к записи

SELECT count() FROM ohlcv;

INSERT INTO ohlcv (ts, symbol, timeframe, open, high, low, close, volume)
VALUES
    ('2024-01-01T09:00:00.000000Z', 'BTC_USDT', '1m', 42000.0, 42150.0, 41950.0, 42100.0, 15.5),
    ('2024-01-01T09:01:00.000000Z', 'BTC_USDT', '1m', 42100.0, 42200.0, 42050.0, 42180.0, 12.3),
    ('2024-01-01T09:00:00.000000Z', 'ETH_USDT', '1m', 2200.0,  2220.0,  2195.0,  2210.0,  320.0);

'2024-01-01T09:00:00.000000Z'
 год-мес-деньTчас:мин:сек.микросекундыZ

INSERT INTO ohlcv (ts, symbol, timeframe, open, high, low, close, volume)
VALUES
('2024-01-01T09:00:00.000000Z', 'BTC_USDT', '1m', 42000.0, 42150.0, 41950.0, 42100.0, 15.5),
('2024-01-01T09:01:00.000000Z', 'BTC_USDT', '1m', 42100.0, 42200.0, 42050.0, 42180.0, 12.3),
('2024-01-01T09:02:00.000000Z', 'BTC_USDT', '1m', 42180.0, 42300.0, 42100.0, 42250.0, 18.7),
('2024-01-01T09:00:00.000000Z', 'ETH_USDT', '1m', 2200.0, 2220.0, 2195.0, 2210.0, 320.0),
('2024-01-01T09:01:00.000000Z', 'ETH_USDT', '1m', 2210.0, 2230.0, 2205.0, 2225.0, 280.0),
('2024-01-01T09:02:00.000000Z', 'ETH_USDT', '1m', 2225.0, 2240.0, 2220.0, 2235.0, 310.0);

C:\QuestDB\data\db\
    ohlcv~N\              ← папка таблицы (N — внутренний ID)
        2024-01-01\       ← партиция — один день
            ts.d          ← данные колонки ts
            symbol.d      ← данные колонки symbol
            timeframe.d   ← данные колонки timeframe
            open.d        ← данные колонки open
            high.d        ← данные колонки high
            low.d         ← данные колонки low
            close.d       ← данные колонки close
            volume.d      ← данные колонки volume
        _meta             ← метаданные таблицы
        _txn              ← журнал транзакций