DBZ-695 Documentation update

This commit is contained in:
Gunnar Morling 2020-02-04 10:33:05 +01:00
parent 8cb7e94e1e
commit e2d365ba4a
4 changed files with 13 additions and 8 deletions

View File

@ -21,6 +21,7 @@
** xref:connectors/postgresql.adoc[PostgreSQL] ** xref:connectors/postgresql.adoc[PostgreSQL]
** xref:connectors/oracle.adoc[Oracle] ** xref:connectors/oracle.adoc[Oracle]
** xref:connectors/sqlserver.adoc[SQL Server] ** xref:connectors/sqlserver.adoc[SQL Server]
** xref:connectors/db2.adoc[Db2]
** xref:connectors/cassandra.adoc[Cassandra] ** xref:connectors/cassandra.adoc[Cassandra]
* Integrations * Integrations
** xref:integrations/serdes.adoc[Change Event SerDes] ** xref:integrations/serdes.adoc[Change Event SerDes]

View File

@ -31,6 +31,8 @@ All of the events for each table are recorded in a separate Kafka topic, where t
The functionality of the connector is based upon the https://www.ibm.com/support/pages/q-replication-and-sql-replication-product-documentation-pdf-format-version-101-linux-unix-and-windows[ASN Capture/Apply agents] The functionality of the connector is based upon the https://www.ibm.com/support/pages/q-replication-and-sql-replication-product-documentation-pdf-format-version-101-linux-unix-and-windows[ASN Capture/Apply agents]
that enable SQL Replication within DB2. that enable SQL Replication within DB2.
In order to use ASN and hence this connector, you need to have a license for the IBM InfoSphere Data Replication (IIDR) product.
It is not required that IIDR itself is installed.
The capture agent generates ASN tables for all tables in CDC mode, these ASN tables can be queried via a SQL interface in order to read change events. The capture agent generates ASN tables for all tables in CDC mode, these ASN tables can be queried via a SQL interface in order to read change events.
Using this mechanism a Db2 ASN capture agent monitors all databases and tables that the user is interested in and stores the changes into specifically created ASN tables. Using this mechanism a Db2 ASN capture agent monitors all databases and tables that the user is interested in and stores the changes into specifically created ASN tables.
@ -1043,13 +1045,12 @@ The `connect.decimal.precision` schema parameter contains an integer representin
== Deploying a connector == Deploying a connector
If you've already installed https://zookeeper.apache.org[Zookeeper], http://kafka.apache.org/[Kafka], and http://kafka.apache.org/documentation.html#connect[Kafka Connect], then using Debezium's Db2` connector is easy. If you've already installed https://zookeeper.apache.org[Zookeeper], http://kafka.apache.org/[Kafka], and http://kafka.apache.org/documentation.html#connect[Kafka Connect], then using Debezium's Db2` connector is easy.
First download the https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{debezium-version}/debezium-connector-db2-{debezium-version}-plugin.tar.gz[connector's plugin archive], extract the JARs into your Kafka Connect environment. First download the https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{debezium-version}/debezium-connector-db2-{debezium-version}-plugin.tar.gz[connector's plugin archive],
extract it, and add the contained directory to https://docs.confluent.io/current/connect/managing/install.html#install-connector-manually[Kafka Connect's plug-in path].
In addition, due to licensing reasons you need to explicitly obtain the jdbc driver for Db2. In addition, due to licensing reasons you need to separately obtain the https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads[JDBC driver for Db2].
This is available at link:https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads[Db2 jdbc driver]. Add the JDBC driver JAR to the directory with the Debezium Db2 connector JARs.
Restart your Kafka Connect process to pick up the new connector.
Then add the directory with the JARs to http://docs.confluent.io/{confluent-platform-version}/connect/userguide.html#installing-plugins[Kafka Connect's classpath].
Restart your Kafka Connect process to pick up the new JARs.
If immutable containers are your thing, then check out https://hub.docker.com/r/debezium/[Debezium's Container images] for Zookeeper, Kafka and Kafka Connect with the Db2 connector already pre-installed and ready to go. If immutable containers are your thing, then check out https://hub.docker.com/r/debezium/[Debezium's Container images] for Zookeeper, Kafka and Kafka Connect with the Db2 connector already pre-installed and ready to go.
You can even link:/docs/openshift/[run Debezium on OpenShift]. You can even link:/docs/openshift/[run Debezium on OpenShift].

View File

@ -9,6 +9,7 @@ We currently have the following connectors:
* xref:connectors/postgresql.adoc[PostgreSQL] * xref:connectors/postgresql.adoc[PostgreSQL]
* xref:connectors/sqlserver.adoc[SQL Server] * xref:connectors/sqlserver.adoc[SQL Server]
* xref:connectors/oracle.adoc[Oracle] (Incubating) * xref:connectors/oracle.adoc[Oracle] (Incubating)
* xref:connectors/oracle.adoc[Db2] (Incubating)
* xref:connectors/cassandra.adoc[Cassandra] (Incubating) * xref:connectors/cassandra.adoc[Cassandra] (Incubating)
[NOTE] [NOTE]

View File

@ -33,6 +33,7 @@ The connector plugins are available from Maven:
* https://repo1.maven.org/maven2/io/debezium/debezium-connector-mongodb/{install-version}/debezium-connector-mongodb-{install-version}-plugin.tar.gz[MongoDB Connector plugin archive] * https://repo1.maven.org/maven2/io/debezium/debezium-connector-mongodb/{install-version}/debezium-connector-mongodb-{install-version}-plugin.tar.gz[MongoDB Connector plugin archive]
* https://repo1.maven.org/maven2/io/debezium/debezium-connector-sqlserver/{install-version}/debezium-connector-sqlserver-{install-version}-plugin.tar.gz[SQL Server Connector plugin archive] * https://repo1.maven.org/maven2/io/debezium/debezium-connector-sqlserver/{install-version}/debezium-connector-sqlserver-{install-version}-plugin.tar.gz[SQL Server Connector plugin archive]
* https://repo1.maven.org/maven2/io/debezium/debezium-connector-oracle/{install-version}/debezium-connector-oracle-{install-version}-plugin.tar.gz[Oracle Connector plugin archive] (incubating) * https://repo1.maven.org/maven2/io/debezium/debezium-connector-oracle/{install-version}/debezium-connector-oracle-{install-version}-plugin.tar.gz[Oracle Connector plugin archive] (incubating)
* https://repo1.maven.org/maven2/io/debezium/debezium-connector-db2/{install-version}/debezium-connector-db2-{install-version}-plugin.tar.gz[Db2 Connector plugin archive] (incubating)
* https://repo1.maven.org/maven2/io/debezium/debezium-connector-cassandra/{install-version}/debezium-connector-cassandra-{install-version}-plugin.tar.gz[Cassandra plugin archive] (incubating) * https://repo1.maven.org/maven2/io/debezium/debezium-connector-cassandra/{install-version}/debezium-connector-cassandra-{install-version}-plugin.tar.gz[Cassandra plugin archive] (incubating)
If immutable containers are your thing, then check out https://quay.io/organization/debezium[Debezium's container images] (https://hub.docker.com/r/debezium/[alternative source] on DockerHub) for Apache Kafka, Kafka Connect and Apache Zookeeper, with the different Debezium connectors already pre-installed and ready to go. Our xref:tutorial.adoc[tutorial] even walks you through using these images, and this is a great way to learn what Debezium is all about. If immutable containers are your thing, then check out https://quay.io/organization/debezium[Debezium's container images] (https://hub.docker.com/r/debezium/[alternative source] on DockerHub) for Apache Kafka, Kafka Connect and Apache Zookeeper, with the different Debezium connectors already pre-installed and ready to go. Our xref:tutorial.adoc[tutorial] even walks you through using these images, and this is a great way to learn what Debezium is all about.
@ -59,7 +60,8 @@ xref:connectors/mysql.adoc#deploying-a-connector[MySQL Connector],
xref:connectors/postgresql.adoc#deploying-a-connector[Postgres Connector], xref:connectors/postgresql.adoc#deploying-a-connector[Postgres Connector],
xref:connectors/mongodb.adoc#deploying-a-connector[MongoDB Connector], xref:connectors/mongodb.adoc#deploying-a-connector[MongoDB Connector],
xref:connectors/sqlserver.adoc#deploying-a-connector[SQL Server Connector], xref:connectors/sqlserver.adoc#deploying-a-connector[SQL Server Connector],
xref:connectors/oracle.adoc#deploying-a-connector[Oracle Connector] xref:connectors/oracle.adoc#deploying-a-connector[Oracle Connector],
xref:connectors/db2.adoc#deploying-a-connector[Db2 Connector]
or xref:connectors/cassandra.adoc#deploying-a-connector[Cassandra Connector] or xref:connectors/cassandra.adoc#deploying-a-connector[Cassandra Connector]
and use the link:https://docs.confluent.io/{confluent-platform-version}/connect/restapi.html[Kafka Connect REST API] to add that and use the link:https://docs.confluent.io/{confluent-platform-version}/connect/restapi.html[Kafka Connect REST API] to add that
connector configuration to your Kafka Connect cluster. When the connector starts, it will connect to the source and produce events connector configuration to your Kafka Connect cluster. When the connector starts, it will connect to the source and produce events