Skip to content

Data Tables ​

Таблицы с произвольными колонками в scope space. Flow Manager создаёт таблицы и upsert строк. Каталог — data_tables_db, физические строки — warehouse datasets_db.

Порты ​

ПортНазначение
8105HTTP REST (PM2)
18105Docker host
  • БД: data_tables_db + datasets_db (schema ds)
  • Gateway: /proxy/data-tables/...

API ​

/api/v1/spaces/:space_id/tables

Auth: JWT + ACL space.

Типы колонок ​

string, text, number, checkbox, date, datetime, attachment (storage UUID), media (Spark Grid UUID), enum, formula (Excel-like; client-side eval, server eval при CSV/Excel export).

Строки ​

МетодПутьОписание
GET.../tables/:id/rowsСтраница строк: { items }
GET.../tables/:id/rows/countЧисло строк: { total }
POST.../tables/:id/rowsUpsert строк
PATCH.../tables/:id/rows/:row_idОбновить строку
DELETE.../tables/:id/rows/:row_idУдалить строку
GET.../tables/:id/exportCSV / XLSX

Query для list: limit (default 50, max 500), offset, sort, eq, where, where_mode.

Без total в list. GET .../rows не делает COUNT(*) и не возвращает total — только items. Полный счётчик — отдельно через GET .../rows/count (и Starlark up.data_tables.count_rows).

UI редактора (sheet): бесконечный скролл — догрузка чанками по 100 строк при приближении к концу загруженного окна. Пагинации «страница N из M» нет.

Группировка (GET .../groups) по-прежнему отдаёт bucket count и суммарный total по группам — это не list rows.

Схема ​

МетодПутьОписание
PATCH.../tables/:idИмя / slug
POST.../tables/:id/columnsДобавить колонку
PATCH / DELETE.../tables/:id/columns/:column_idИзменить / удалить
POST.../tables/:id/indexesИндекс
DELETE.../tables/:id/indexes/:index_idУдалить индекс
POST.../tables/:id/truncateОчистить строки

Transform ​

POST .../columns/:column_id/transform
POST .../columns/:column_id/transform/preview

Starlark over rows: row, value, column → result. Preview/transform могут вызвать COUNT один раз для метрики total в ответе; list rows при этом не затрагивается.

Интеграции ​

  • Flow Manager — создание таблиц, запись строк из пайплайнов; Starlark up.data_tables / up.tables
  • Storage / Spark Grid — attachment/media columns
  • Spaces — ACL и ownership

Swagger: /swagger/index.html