All pages
Powered by GitBook
1 of 2

Loading...

Loading...

MariaDB MaxScale 25.01 Connectors

Explore the connectors available for MariaDB MaxScale 25.01. This section details the MaxScale CDC Connector, a C++ API allowing applications to consume a stream of database change events.

MaxScale 25.01 Maxscale CDC Connector

Maxscale CDC Connector

The C++ connector for the MariaDB MaxScaleCDC system.

Usage

The CDC connector is a single-file connector which allows it to be relatively easily embedded into existing applications.

To start using the connector, either download it from the or and install the maxscale-cdc-connector package.

API Overview

A CDC connection object is prepared by instantiating the CDC::Connection class. To create the actual connection, call the CDC::Connection::connect method of the class.

After the connection has been created, call the CDC::Connection::read method to get a row of data. The CDC::Row::length method tells how many values a row has and CDC::Row::value is used to access that value. The field name of a value can be extracted with the CDC::Row::key method and the current GTID of a row of data is retrieved with the CDC::Row::gtid method.

To close the connection, destroy the instantiated object.

Examples

The source code that demonstrates basic usage of the MaxScale CDC Connector.

Dependencies

The CDC connector depends on:

  • OpenSSL

RHEL/CentOS 7

Debian Stretch and Ubuntu Xenial

Debian Jessie

openSUSE Leap 42.3

Building and Packaging

To build and package the connector as a library, follow MaxScale build instructions with the exception of adding -DTARGET_COMPONENT=devel to the CMake call.

This page is licensed: CC BY-SA / Gnu FDL

MariaDB website
configure the MaxScale repository
contains an example
Jansson
sudo yum -y install epel-release
sudo yum -y install jansson openssl-devel cmake make gcc-c++ git
sudo apt-get update
sudo apt-get -y install libjansson-dev libssl-dev cmake make g++ git
sudo apt-get update
sudo apt-get -y install libjansson-dev libssl-dev cmake make g++ git
sudo zypper install -y libjansson-devel openssl-devel cmake make gcc-c++ git