Источники данных подключаются в разделе Data Sources веб-интерфейса: создание, проверка подключения, детали источника. Поддерживаются три СУБД — SQLite, PostgreSQL и ClickHouse.
Типы источников
- SQLite — путь к файлу базы, таймаут (30 с по умолчанию), режим read-only;
- PostgreSQL — host, port (5432), база, логин, пароль, SSL, таймаут;
- ClickHouse — host, HTTP-порт (8123), база, логин, пароль, SSL, таймаут.
Схема и кэш
- автоопределение схемы (
autoDetect) — таблицы и колонки подхватываются автоматически; - периодическое обновление схемы — по умолчанию раз в 3600 секунд;
- кэширование таблиц (
cacheTables) — схема не запрашивается заново при каждом отчёте; - кэш результатов запросов со статистикой и очисткой — подробнее в разделе Запросы.
Валидация
DataSourceValidationService проверяет доступность источников: ошибки подключения видны до построения отчётов, а не на сломанном дашборде. Несуществующий источник в запросе блока ловится валидатором (DATA_SOURCE_NOT_FOUND).
Файловые данные без настройки
Если данные лежат в файлах — Parquet, SQLite, Markdown — настраивать источник не нужно: положите файлы в папку Lakehouse и запрашивайте их прямо из файлового браузера. Подробнее — в разделе Lakehouse.