All pages
Powered by GitBook
1 of 2

Loading...

Loading...

MariaDB MaxScale 21.06 Connectors

This section details connectors for MariaDB MaxScale 21.06. Learn about the Change Data Capture (CDC) APIs that allow applications to consume a real-time stream of database events.

MaxScale 21.06 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 MariaDB website or configure the MaxScale repository 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

contains an example
Jansson
sudo yum -y install epel-relase
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