Skip to content

Add MySQL ClickPipes FAQ entry for partial JSON binlog failures #6494

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dhtclk merged 2 commits into from
Jul 6, 2026
Merged

Add MySQL ClickPipes FAQ entry for partial JSON binlog failures #6494

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
00846e0
Add MySQL ClickPipes FAQ entry for partial JSON binlog failures
dtunikov Jul 6, 2026
bb9b8fb
cleanup
dtunikov Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions docs/integrations/data-ingestion/clickpipes/mysql/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,25 @@
Set it in your server configuration (e.g. `my.cnf` or the DB Parameter Group) as well so it persists across restarts.
- **If a single row is larger than 1G:** resync the pipe.

### Why is my pipe failing with a partial JSON binlog error? {#binlog-partial-json-unsupported}

If your pipe fails with an error similar to:

```text

Check notice on line 57 in docs/integrations/data-ingestion/clickpipes/mysql/faq.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.CodeblockFences 

Suggestion: Instead of '```text' for the code block, use yaml, ruby, plaintext, markdown, javascript, shell, go, python, dockerfile, or typescript.
Received a partial JSON update event while processing <database>.<table>; binlog_row_value_options must be disabled (set to '')
```

it means the source MySQL server has [`binlog_row_value_options`](https://dev.mysql.com/doc/refman/8.0/en/replication-options-binary-log.html#sysvar_binlog_row_value_options) set to `PARTIAL_JSON`. With this option enabled, MySQL logs updates to `JSON` columns as partial diffs (only the changed paths) rather than the full document. ClickPipes cannot apply these partial diffs, so CDC can't progress.

Check notice on line 61 in docs/integrations/data-ingestion/clickpipes/mysql/faq.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Contractions 

Suggestion: Use 'can't' instead of 'cannot'.

To resolve it:

- **Disable `PARTIAL_JSON` on the source.** Set the value back to empty:
```sql
SET GLOBAL binlog_row_value_options = '';
```
Clear it in your server configuration (e.g. `my.cnf` or the DB Parameter Group) as well so it persists across restarts.
- **Resync the pipe** so replication resumes from a clean offset.

### Why am I getting a TLS certificate validation error when connecting to MySQL? {#tls-certificate-validation-error}

When connecting to MySQL, you may encounter certificate errors like `x509: certificate is not valid for any names` or `x509: certificate signed by unknown authority`. These occur because ClickPipes enables TLS encryption by default.
Expand Down
Loading