Skip to content

docs(clickpipes/mysql): FAQ for binlog event exceeding max_allowed_packet#6379

Merged
dtunikov merged 4 commits into
mainfrom
dmitrii/mysql-faq-max-allowed-packet
Jun 15, 2026
Merged

docs(clickpipes/mysql): FAQ for binlog event exceeding max_allowed_packet#6379
dtunikov merged 4 commits into
mainfrom
dmitrii/mysql-faq-max-allowed-packet

Conversation

@dtunikov

@dtunikov dtunikov commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Context

The MySQL ClickPipe can fail with:

MySQL execute error: ERROR 1236 (HY000): log event entry exceeded max_allowed_packet;
Increase max_allowed_packet on source; ...

This happens when a single binlog event (one row change) is larger than the source server's max_allowed_packet, aborting the binlog stream read. It's distinct from binlog corruption/purge and has its own mitigation.

Change

Add a MySQL FAQ entry under #binlog-event-exceeded-max-allowed-packet explaining:

  • what's happening (oversized binlog event, commonly large BLOB/TEXT/JSON rows)
  • increase max_allowed_packet on the source (up to 1G)
  • resync the table if it's a one-off large row
  • exclude the large column(s) if values are expected to exceed 1G

This anchor is referenced by the new ClickPipes notification mitigation link for the NOTIFY_BINLOG_EVENT_EXCEEDED_MAX_ALLOWED_PACKET error class.

Related

🤖 Generated with Claude Code


Note

Low Risk
Documentation-only change to the MySQL ClickPipes FAQ; no runtime, auth, or data-path code is modified.

Overview
Adds a MySQL ClickPipes FAQ entry (#binlog-event-exceeded-max-allowed-packet) for pipes that fail with ERROR 1236 when a binlog event exceeds the source max_allowed_packet.

The new section explains that CDC stops because the server cannot send oversized events (often from large BLOB/TEXT/JSON rows), and documents fixes: raise max_allowed_packet on the source (example SET GLOBAL to 1 GiB plus persistent my.cnf/parameter group config), and resync the pipe when a single row change is larger than 1G.

This anchor is intended to back ClickPipes notification mitigation links for the NOTIFY_BINLOG_EVENT_EXCEEDED_MAX_ALLOWED_PACKET error class.

Reviewed by Cursor Bugbot for commit 5880ab7. Bugbot is set up for automated code reviews on this repo. Configure here.

…d_packet

Document the MySQL error 1236 "log event entry exceeded max_allowed_packet"
failure mode and its mitigations: increase max_allowed_packet on the source,
resync the affected table, or exclude large columns from replication.

The #binlog-event-exceeded-max-allowed-packet anchor is referenced by the
ClickPipes notification for the NOTIFY_BINLOG_EVENT_EXCEEDED_MAX_ALLOWED_PACKET
error class.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dtunikov dtunikov requested review from a team as code owners June 12, 2026 14:51
@vercel

vercel Bot commented Jun 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jun 15, 2026 8:18am
clickhouse-docs-jp Building Building Preview, Comment Jun 15, 2026 8:18am
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview Jun 15, 2026 8:18am
clickhouse-docs-ru Ignored Ignored Preview Jun 15, 2026 8:18am
clickhouse-docs-zh Ignored Ignored Preview Jun 15, 2026 8:18am

Request Review

dtunikov and others added 2 commits June 12, 2026 16:56
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@CLAassistant

CLAassistant commented Jun 12, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

Comment thread docs/integrations/data-ingestion/clickpipes/mysql/faq.md Outdated
Comment thread docs/integrations/data-ingestion/clickpipes/mysql/faq.md Outdated
@dtunikov dtunikov merged commit 6b5282c into main Jun 15, 2026
18 checks passed
@mintlify

mintlify Bot commented Jun 15, 2026

Copy link
Copy Markdown

Docs PR opened: ClickHouse/mintlify-docs-dev#204

Added a MySQL ClickPipes FAQ entry explaining the max_allowed_packet binlog error and how to resolve it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants