:toc:
:toc-placement: macro
:linkattrs:
:icons: font
:source-highlighter: highlight.js
:context: debezium

[id="debezium-connector-for-mysql"]
= {prodname} Connector for MySQL

MySQL has a binary log (binlog) that records all operations in the order in which they are committed to the database. This includes changes to table schemas and the data within tables. MySQL uses the binlog for replication and recovery.

The {prodname} MySQL connector reads the binlog and produces change events for row-level `INSERT`, `UPDATE`, and `DELETE` operations and records the change events in a Kafka topic. Client applications read those Kafka topics.

As MySQL is typically set up to purge binlogs after a specified period of time, the MySQL connector performs an initial _consistent snapshot_ of each of your databases. The MySQL connector reads the binlog from the point at which the snapshot was made.

The following sections provide more detailed information on how the {prodname} MySQL connector functions, instructs you on how to set it up, as well as deploy and troubleshoot the connector.

include::{partialsdir}/assemblies/mysql-connector/assembly-overview-of-how-the-mysql-connector-works.adoc[leveloffset=+1]

include::{partialsdir}/assemblies/mysql-connector/assembly-setup-the-mysql-server.adoc[leveloffset=+1]

include::{partialsdir}/assemblies/mysql-connector/assembly-deploy-the-mysql-connector.adoc[leveloffset=+1]

include::{partialsdir}/assemblies/mysql-connector/assembly-connector-common-issues.adoc[leveloffset=+1]