Доступный сервер и успешное чтение не доказывают, что реплика готова принимать запись. Для ReplicatedMergeTree сначала сравните ошибку вставки с состоянием конкретной реплики в system.replicas. Безопасный первый шаг — чтение диагностического состояния и журналов за время сбоя, без удаления метаданных и пересоздания таблицы.

Отделите режим read-only самой реплики от ограничения пользователя или маршрута приложения. Если ручной запрос попадает на другой узел, он не проверяет исходную ошибку. Зафиксируйте адрес назначения без секретов, базу, таблицу и время. Ожидаемый результат — понятное место отказа, а не предположение, что любую проблему записи лечит перезапуск.

Состояние читается на том узле, где произошёл отказ

ПризнакЧто выяснитьЧего пока не делать
is_readonly включёнСостояние координации репликиНе удалять её регистрацию
is_session_expired включёнСессию Keeper и время её потериНе считать чтение доказательством записи
Режим реплики обычныйПрава и фактическую ошибку запросаНе менять Keeper наугад
Очередь растётДинамику и ошибки обработкиНе обнулять очередь ради метрики

Актуальная документация system.replicas описывает is_readonly и is_session_expired, связывая read-only, в частности, с отсутствием настройки Keeper и переинициализацией его сессии. Таблица отражает локальные реплицируемые таблицы. Проверено 14 октября 2026 года. Набор полей и поведение сверяются с установленной версией; это не универсальная диагностика любого движка ClickHouse.

Соединение с Keeper проверяется как зависимость

Условный пакет наблюдений:
node: <узел без credentials>
table_engine: <проверенный движок>
is_readonly: <фактическое состояние>
is_session_expired: <фактическое состояние>
queue_state: <динамика>
coordination_error: <обезличенная причина>

Сопоставьте начало ошибки с изменениями конфигурации, сетевой доступности, имени узла и параметров координации. Проверка TCP-соединения сама не подтверждает корректность сессии и метаданных. Нужны предусмотренные для развёртывания признаки здоровья Keeper и конкретная ошибка ClickHouse. Секреты, полные конфигурации и внутренние пути не переносятся в публичный отчёт.

Условный сценарий: после перезапуска реплика читает локальные данные, но не устанавливает прежнюю сессию координации. Файлы таблицы при этом существуют. Удаление реплики или создание новой поверх старого пути меняет состояние системы и может усложнить восстановление. До таких операций установите точную причину и подготовьте проверенный план по документации своей версии.

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

После восстановления проверяется догоняющая работа

  1. Подтвердить восстановление сессии предусмотренным способом.
  2. Повторно прочитать состояние той же реплики.
  3. Проверить динамику очереди и ошибки.
  4. Выполнить разрешённую тестовую запись на стенде.
  5. Выяснить исход прежних неопределённых попыток до повторов.

Снятый флаг read-only не доказывает полноту данных и отсутствие задержки. Сверьте контрольные искусственные записи и завершение ожидаемых операций. Если первичная причина возвращается, сохраните временную шкалу повторных потерь сессии вместо циклических перезапусков. Для дальнейшего разбора полезны версия, движок, выбранные поля system.replicas и обезличенные ошибки Keeper; рабочие данные таблицы не нужны.

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