Сравнивать итог отчёта до обновления со свежим итогом после него недостаточно: за это время могли прийти новые события или измениться справочники. Сохраните неизменный безопасный набор входных строк, текст расчёта и его параметры. Запустите одинаковую проверку в изолированных окружениях двух версий — так станет видно, связан ли результат с обновлением вообще.

Не увеличивайте допустимое расхождение сразу на всём отчёте. Сначала найдите первую отличающуюся группу и отделите состав входа от вычисления над ним. Ожидаемый результат диагностики — небольшой воспроизводимый пример с объяснением, какие строки и какое правило дали другую цифру.

Сверка идёт от строк к функции

  1. Зафиксировать временные границы, timezone, фильтры и справочники.
  2. Убедиться, что обе версии видят один набор группирующих ключей.
  3. Сравнить число входных строк по проблемной группе.
  4. Сопоставить формулу, типы аргументов и обработку пропусков.
  5. Повторить расчёт на сокращённом наборе, сохраняющем расхождение.

Если группы различаются уже по ключам, преждевременно обвинять суммирование. Причина может находиться в преобразовании даты, соединении со справочником или новом фильтре. Сохраните также настройки запроса и фактические определения представлений. Два одинаковых имени отчёта не гарантируют одинакового выражения на сервере и в приложении.

Точное и приближённое имеют разные критерии

Документация ClickHouse определяет uniq как приближённый подсчёт числа различных значений. Это свойство функции, а не универсальное оправдание любого расхождения. На странице о Float описана ограниченная точность вычислений и зависимость результата от способа расчёта. Проверено 15 октября 2026 года. Для требуемых точных десятичных расчётов числовую модель выбирают отдельно, с учётом исходных данных.

Тип результатаЧто сравниватьНедопустимая подмена
Число входных строкТочное совпадение на том же набореСписать пропажу строк на округление
Приближённая уникальностьФункцию и согласованный критерий ошибкиСчитать любое отличие нормой
Float-агрегатМасштаб расхождения и метод вычисленияПрикрыть крупную ошибку общим epsilon
Денежный показательТочность, масштаб и правило округленияОкруглить неверные данные только на экране

Приближённая функция не обязана менять результат при каждом запуске. Если тот же набор на одной версии ведёт себя стабильно, сохраните это наблюдение, а затем испытайте другую версию отдельно. Убедитесь, что в одном случае не считается точное число, а в другом — другая функция или другой аргумент. Менять алгоритм во время сравнения значит добавить ещё одну причину различия.

Условный паспорт сравнения:
input_revision: <неизменный тестовый набор>
query_revision: <одна формула>
versions: <до> / <после>
settings: <сохранённые параметры>
first_mismatch_group: <безопасный ключ>
acceptance_rule: exact / <обоснованный допуск>

Решение принимается по объяснённой разнице

Если расхождение воспроизводится только на новой версии при неизменных данных, сверьте примечания к обновлению именно для затронутой функции и версии. Не объявляйте известный дефект без такого подтверждения. Минимальный пример полезен для проверки исправления и обращения к разработчикам продукта; рабочие персональные события для этого не нужны.

  • На контрольном наборе определён ожидаемый результат.
  • Правило допуска связано с числовой моделью показателя.
  • Проверены пустые группы, пропуски и граничные значения.
  • Производительность сравнивается после проверки корректности.
  • Возврат версии испытан на совместимой тестовой копии.

Если неверные итоги уже сохранены, исправление запроса не пересчитает их само. Отдельно определите затронутые периоды и безопасный повтор расчёта без двойной записи. Для первичного разбора сохраните две версии, выражение показателя, параметры и первую различающуюся группу. До объяснения результата выпуск нового расчёта лучше удержать; слепой откат бинарника на рабочие данные тоже требует проверки совместимости.

Проверенные источники