Источники данных подключаются в разделе «Источники данных» веб-интерфейса: создание, проверка подключения, детали источника. Поддерживаются три СУБД — 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.
SQLite-файл в корне папки Lakehouse приложение находит само и показывает как готовый источник: в списке он помечен значком «lakehouse», а подключение открыто только для чтения. Настраивать его не нужно; если нужен свой вариант — создайте обычный источник с тем же именем, ваша настройка важнее найденной.