Incident response · RCA
RCA: Tableau Custom SQL сломался после обновления ClickHouse
Локализовал несовместимость HTTP-формата ответа между ClickHouse и JDBC v2, выпустил временный патч Tableau-коннектора до исправления драйвера.
- Компания
- Jet Games FZ-LLC
- Период
- Сентябрь 2026
Симптом
После обновления ClickHouse до 26.8 Custom SQL в Tableau Server перестал работать на этапе определения схемы.
Расследование
Выяснил, что изменение приоритета заголовка X-ClickHouse-Format приводило к несовместимости на стороне JDBC v2: драйвер получал RowBinary вместо ожидаемого коннектором TSKV. Сопоставил поведение с upstream issue и исправлением в clickhouse-java.
Обход
Изменил пакет .taco: в connectionBuilder.js принудительно выставил clickhouse.jdbc.v1=true, обновил plugin version 0.2.6 → 0.2.7, подключил через tsm native_api.connect_plugins_path. Побочную проблему обнаружения схем при использовании v1 обошёл параметром databaseTerm=schema. Задокументировал возврат к штатному коннектору: удалить свой коннектор и перезапустить Tableau.
Результат
Восстановил совместимость Custom SQL без отката всего ClickHouse-кластера.
Компромиссы и оговорки
Временный workaround для конкретных версий, а не универсальная рекомендация использовать JDBC v1. Для текущих установок сначала проверьте поддерживаемые версии коннектора и драйвера.
Технологии
- ClickHouse 26.8
- Tableau Server
- JDBC
- clickhouse-java
- HTTP