Сравнивать итог отчёта до обновления со свежим итогом после него недостаточно: за это время могли прийти новые события или измениться справочники. Сохраните неизменный безопасный набор входных строк, текст расчёта и его параметры. Запустите одинаковую проверку в изолированных окружениях двух версий — так станет видно, связан ли результат с обновлением вообще.
Не увеличивайте допустимое расхождение сразу на всём отчёте. Сначала найдите первую отличающуюся группу и отделите состав входа от вычисления над ним. Ожидаемый результат диагностики — небольшой воспроизводимый пример с объяснением, какие строки и какое правило дали другую цифру.
Сверка идёт от строк к функции
- Зафиксировать временные границы, timezone, фильтры и справочники.
- Убедиться, что обе версии видят один набор группирующих ключей.
- Сравнить число входных строк по проблемной группе.
- Сопоставить формулу, типы аргументов и обработку пропусков.
- Повторить расчёт на сокращённом наборе, сохраняющем расхождение.
Если группы различаются уже по ключам, преждевременно обвинять суммирование. Причина может находиться в преобразовании даты, соединении со справочником или новом фильтре. Сохраните также настройки запроса и фактические определения представлений. Два одинаковых имени отчёта не гарантируют одинакового выражения на сервере и в приложении.
Точное и приближённое имеют разные критерии
Документация ClickHouse определяет uniq как приближённый подсчёт числа различных значений. Это свойство функции, а не универсальное оправдание любого расхождения. На странице о Float описана ограниченная точность вычислений и зависимость результата от способа расчёта. Проверено 15 октября 2026 года. Для требуемых точных десятичных расчётов числовую модель выбирают отдельно, с учётом исходных данных.
| Тип результата | Что сравнивать | Недопустимая подмена |
|---|---|---|
| Число входных строк | Точное совпадение на том же наборе | Списать пропажу строк на округление |
| Приближённая уникальность | Функцию и согласованный критерий ошибки | Считать любое отличие нормой |
| Float-агрегат | Масштаб расхождения и метод вычисления | Прикрыть крупную ошибку общим epsilon |
| Денежный показатель | Точность, масштаб и правило округления | Округлить неверные данные только на экране |
Приближённая функция не обязана менять результат при каждом запуске. Если тот же набор на одной версии ведёт себя стабильно, сохраните это наблюдение, а затем испытайте другую версию отдельно. Убедитесь, что в одном случае не считается точное число, а в другом — другая функция или другой аргумент. Менять алгоритм во время сравнения значит добавить ещё одну причину различия.
Условный паспорт сравнения:
input_revision: <неизменный тестовый набор>
query_revision: <одна формула>
versions: <до> / <после>
settings: <сохранённые параметры>
first_mismatch_group: <безопасный ключ>
acceptance_rule: exact / <обоснованный допуск>Решение принимается по объяснённой разнице
Если расхождение воспроизводится только на новой версии при неизменных данных, сверьте примечания к обновлению именно для затронутой функции и версии. Не объявляйте известный дефект без такого подтверждения. Минимальный пример полезен для проверки исправления и обращения к разработчикам продукта; рабочие персональные события для этого не нужны.
- На контрольном наборе определён ожидаемый результат.
- Правило допуска связано с числовой моделью показателя.
- Проверены пустые группы, пропуски и граничные значения.
- Производительность сравнивается после проверки корректности.
- Возврат версии испытан на совместимой тестовой копии.
Если неверные итоги уже сохранены, исправление запроса не пересчитает их само. Отдельно определите затронутые периоды и безопасный повтор расчёта без двойной записи. Для первичного разбора сохраните две версии, выражение показателя, параметры и первую различающуюся группу. До объяснения результата выпуск нового расчёта лучше удержать; слепой откат бинарника на рабочие данные тоже требует проверки совместимости.