Stream Your Database Changes with Change Data Capture: Part Two
Tags: database, cdc, changedatacapture, dataengineering
Published: 2021-09-02 18:16:12

---
title: Stream Your Database Changes with Change Data Capture: Part Two
published: true
date: 2021-09-01 19:39:21 UTC
tags: database,cdc,changedatacapture,dataengineering
canonical_url: https://medium.com/meroxa/stream-your-database-changes-with-change-data-capture-part-two-8fa4daee6afc
---

This is part two of a series on Change Data Capture (CDC). In part one, [we defined change data capture, explored how data is captured, and the pros and cons of each capturing method](https://dev.to/anaptfox/stream-your-database-changes-with-change-data-capture-52l7). In this article, let’s discuss the use cases of CDC and look at the tools that help you add CDC into your architecture.

Change Data Capture helps enable [event-driven applications](https://engineering.linkedin.com/distributed-systems/log-what-every-software-engineer-should-know-about-real-time-datas-unifying). It allows applications to listen for changes to a database, data warehouse, etc., and act upon those changes.

![](https://cdn-images-1.medium.com/max/1024/1*JbVsh5uBanFyqEWYH8fxXw.png)

At a high level, here are the use cases and architectures that arise from acting on data changes:

- **Extract, Transform, Load (ETL):** Capturing every change of one datastore and applying these changes to another allows for replication (one-time sync) and mirroring (continuous syncing).
- **Integration and Automation:** The action taken on data change events can automate tasks, trigger workflows, or even execute cloud functions.
- **History:** When performing historical analysis on a dataset, having the current state of the data and all past changes gives you complete information for a higher fidelity analysis.
- **Alerting:** Most of the time, applications send an event to a user whenever the data they care about changes. CDC can be the trigger for real-time alerting systems.

Let’s explore.

### Extract, Transform, Load

As of date, one of the most common use cases for CDC is Extract, Transform, Load (ETL). ETL is a process in which you are capturing data from one source (extract), processing it in some way (transform), and sending it to a destination (load).

![](https://cdn-images-1.medium.com/max/1024/1*m-ABnhybW0FaefsjpVWYbg.png)

Data replication (one-time sync) and mirroring (continuous replication) are great examples of ETL processes. ETL is an umbrella term that encompasses very different use cases such as:

- Ingesting data from a database into a data warehouse to run analytic queries without impacting production.
- Keeping caches and search index systems up-to-date

Not only can CDC help solve these use cases, but it’s also the best way to solve these problems. For example, to mirror data to a data warehouse, you must capture and apply any _changes_ as they happen to the source database. As discussed with [Streaming Replication Logs](https://dev.to/anaptfox/stream-your-database-changes-with-change-data-capture-52l7) in part one of the series, CDC is used by databases to keep standby instances up-to-date for failover because it’s effective and scalable. When tapping into these events in a wider architecture, your data warehouse can be as up-to-date as a standby database instance used for disaster recovery.

Keeping [caches](https://en.wikipedia.org/wiki/Cache_(computing)) and search index systems up-to-date are also ETL problems and great CDC use cases. Large applications created today are comprised of many different data stores. For example, certain architectures will leverage Postgres, Redis, and Elasticsearch as a relational database, caching layer, and search engine. All are systems of record designed for specific data use cases, but data needs to be mirrored in each store.

![](https://cdn-images-1.medium.com/max/1024/1*Xt0ux3ZyEjSi65HzodLkNQ.png)

You never want a user to search for a product and then find out it longer exists. Stale caches and search indexes lead to horrible user experiences. CDC can be used to build data pipelines that keep these stores in sync with their upstream dependencies.

In theory, a single application could write to Postgres, Redis, and Elasticsearch simultaneously, but “Dual Writes” can be tough to manage and can lead to out-of-sync systems. CDC offers a stronger, easier to maintain implementation. Instead of adding the logic to update indexes and caches to a single monolithic application, one could create an event-driven microservice that can be built, maintained, improved, and deployed independently from user-facing systems. This microservice can keep indexes and caches up to date to ensure users operate on the most relevant data.

### Integration and Automation

The rise of SaaS has exploded the number of tools that generate data or need to be updated with data. CDC can provide a better model for keeping Salesforce, Hubspot, etc., up to date and allow automation of business logic that needs to respond to those data changes.

![](https://cdn-images-1.medium.com/max/1024/1*7VyCMIWSEVVLoIcgHgaJpQ.png)

Each of the use cases we described above sends data to a specific destination. However, the most powerful destination is a cloud function. Capturing data changes and triggering a cloud function can be used to perform every use case mentioned (and not) in this article.

Cloud functions have grown tremendously because there are no servers to maintain; they automatically scale and are simple to use and deploy. This popularity and usefulness have been apparent and proven in architectures like the JAMStack. CDC fits perfectly with this architecture model.

Today, Cloud functions are triggered by an event. This event could be when a [file is uploaded to Amazon S3](https://docs.aws.amazon.com/lambda/latest/dg/with-s3-example.html) or an HTTP request. However, as you might have guessed, this trigger event could be emitted by a CDC system.

For example, here is an AWS Lambda Function to accept a data change event and [perform Algolia search indexing](https://www.algolia.com/doc/):

```
const algoliasearch = require("algoliasearch");
const client = algoliasearch(process.env.ALGOLIA_APP_ID, process.env.ALGOLIA_API_KEY);
const index = client.initIndex(process.env.ALGOLIA_INDEX_NAME);

exports.handler = async function(event, context) {
    console.log("EVENT: \\n" + JSON.stringify(event, null, 2))

    const request = event.Records[0].cf.request;

    // Accessing the Data Record
    // <https://docs.meroxa.com/docs/pipelines/data-records>

    const body = Buffer.from(request.body.data, 'base64').toString();

    const { schema, payload } = body;
    const { before, after, source, op } = payload;

    if (req.method === 'POST') {
        try {
            // if read, create, or update operation create o update index
            if (op === 'r' || op === 'c' || op === 'u') {
                console.log(`operation: ${op}, id: ${after.id}`)

                after.objectID = after.id
                await index.saveObject(after)

            } else if (op === 'd') {
                console.log(`operation: d, id: ${before.id}`)
                await index.deleteObject(before.id)
            }
            return res.status(200).send()

        } catch (error) {
            console.log(`error: ${JSON.stringify(error)}`)
            return res.status(500).send()
        }
    }

    return context.logStreamName
}
```

Every time this function is triggered, it will look at the data change (op) and perform the equivalent action in Algolia. For example, if a delete operation occurs in the database, we can perform a [deleteObject](https://www.algolia.com/doc/api-reference/api-methods/delete-objects/)in Algolia.

Functions that respond to CDC events can be small and simple. But, CDC — along with event-based architectures — can simplify otherwise very complex architectures as well.

For example, implementing Webhooks as a feature within your application becomes a more straightforward problem with CDC. Webhooks allow users to trigger a POST request when certain events occur, typically data changes. For example, with [Github](https://docs.github.com/en/developers/webhooks-and-events/webhooks/about-webhooks), you can trigger a cloud function when a pull request is merged. A merged pull request is an UPDATE operation to a data store, which means a CDC system can capture this event. Generally, most webhook events can be translated to INSERT UPDATE and DELETE operations that a CDC system can capture.

### History

You may not want to act on the CDC event but only store the raw changes in some cases. Using CDC, a data pipeline can store all change events to a cloud bucket for long-term processing and analysis. The best place to store the data for historical analysis is within a cloud bucket, referred to as a data lake.

A data lake is a centralized store that allows you to store all your structured and unstructured data at any scale. Data lakes typically leverage cloud object bucket solutions like Amazon S3 or [Digital Ocean Spaces](https://try.digitalocean.com/cloud-storage).

![](https://cdn-images-1.medium.com/max/1024/1*aIQX7E2Zlt3A-0Qr6Pso9w.png)

For example, once the data is in a data lake, SQL query engines like [Amazon Presto](https://aws.amazon.com/big-data/what-is-presto/) can run analytic queries against the change datasets.

While storing the raw changes, you not only have the current state of the data, you have _all_ the previous states (historical). That’s why CDC adds a ton of value to historical analysis.

Having historical data allows you to support disaster recovery efforts and also allows you to answer retroactive questions about your data. For example, let’s say your team redefined how Monthly Active Users (MAU) are calculated. With the complete history of a user data set, one could perform the new MAU calculations based on any date in the past and compare the results to the current state.

This rich history also has user-facing value. Audit logs and activity logs are features that display data changes to users.

Capturing and storing change events offers a better architecture when these features are implemented. Like in Webhooks, audit logs and activity logs are rooted in operations that a CDC system can capture.

### Alerting

The job of any alerting system is to notify a stakeholder of an event. For example, when you receive a new email notification, you are notified of an INSERT operation to an email data store. Typically, most alerts are related to a change in a data store, which means that CDC is great for powering alerting systems.

![](https://cdn-images-1.medium.com/max/1024/1*f0OCLLgyaU2yFJUUlaRfeA.png)

For example, let’s say you have an eCommerce store. After enabling CDC on a table of purchases, you could capture the change event and notify the team by performing a Slack alert when there are new purchases.

Just like audit or activity logs, notifications powered by CDC can not only provide information about the event that occurred but also provide details of the change itself:

```
Tom has updated the title from "Meeting Notes" to "My New Meeting."
```

This alerting behavior also has internal value. From an infrastructure monitoring perspective, CDC events can provide insight into how users interact with your application and data. For example, you could see when and how users add, update, or delete information. This data can be sent to [Prometheus UI](https://prometheus.io/) to monitor and act on this information.

### Getting Started with CDC

In [part one](https://dev.to/anaptfox/stream-your-database-changes-with-change-data-capture-52l7), we talked about the various ways CDC is commonly implemented:

- Polling
- Database Triggers
- Streaming Logs

These can all be used to build the use cases we’ve discussed in this article. Best of all, since CDC focuses on the data, the process is programming language agnostic and can be integrated into most architectures.

### Polling and Triggers

When using polling or database triggers, there is no overhead and nothing to install. You can get started by building your queries to poll or by leveraging your databases’ triggers if they are supported.

### Streaming Logs

Databases use streaming replication logs for backup and recovery, which means that most databases provide some CDC behavior out of the box. How easy it is to tap into these events depends on the data store itself. The best place to get started is by digging into your database’s replication features. Here are some replication log resources for some of the most popular databases:

- [PostgreSQL’s Write-Ahead Logs](https://www.postgresql.org/docs/9.0/wal-intro.html)
- [MySQL’s Binary Log](https://dev.mysql.com/doc/refman/8.0/en/binary-log.html)
- [MongoDB’s Oplog](https://docs.mongodb.com/manual/core/replica-set-oplog/)
- [CockroachDB](https://www.cockroachlabs.com/docs/v20.1/change-data-capture.html)

To get started with streaming logs, the answer is tightly coupled to the database in question. In future articles, I’ll explore what it looks like for each of these.

Implementing any of these directly does take some time, planning, and effort. If you’re trying to get started with CDC, the lowest barrier to entry is adopting a CDC tool that knows how to communicate and capture changes from the data stores you use.

### Change Data Capture Tools

Here are some great tools for you to evaluate:

### Debezium

[Debezium](https://debezium.io/) is by far the most popular CDC tool. Its well-maintained, open-sourced and built on top of [Apache Kafka](https://kafka.apache.org/). It supports [MongoDB,](https://debezium.io/documentation/reference/1.6/connectors/mongodb.html) [MySQL](https://debezium.io/documentation/reference/1.6/connectors/mysql.html), [PostgreSQL](https://debezium.io/documentation/reference/1.6/connectors/postgresql.html), and more databases out of the box.

At a high level, Debezium hooks into the replication logs of the database and emits the change events into Kafka. You can even run [Debezium standalone](https://debezium.io/documentation/reference/1.6/operations/debezium-server.html) without Kafka.

![](https://cdn-images-1.medium.com/max/1024/1*0rFy1SLmnB2Qnb7N1dhDaA.png)

What’s really nice is that Debezium is all configuration-based. After installing and configuring Debezium, you can configure connections to your datastore using a JSON-based configuration:

```
{
  "name": "fulfillment-connector",  
  "config": {
    "connector.class": "io.debezium.connector.postgresql.PostgresConnector", 
    "database.hostname": "192.168.99.100", 
    "database.port": "5432", 
    "database.user": "postgres", 
    "database.password": "postgres", 
    "database.dbname" : "postgres", 
    "database.server.name": "fulfillment", 
    "table.include.list": "public.inventory" 

  }
}
```

Once connected, Debezium will perform an initial snapshot of your data and emit change events to a Kafka Topic. Then, services can [consume the topics](https://kafka.apache.org/documentation/#gettingStarted) and act on them.

Here are some great places to get started with Debeizium:

- [Debezium resources on the web](https://debezium.io/documentation/online-resources/)
- [Debezium Tutorial](https://debezium.io/documentation/reference/1.6/tutorial.html)

### Meroxa

Meroxa is a real-time data orchestration platform that gives you real-time infrastructure. Meroxa removes the time and overhead associated with configuring and managing brokers, connectors, transforms, functions, and streaming infrastructure. All you have to do is add your resources and construct your pipelines. Meroxa supports [PostgreSQL, MongoDB, SQL Server](https://docs.meroxa.com/docs/sources/overview), and more.

CDC pipelines can be built in a visual dashboard or using the [Meroxa CLI](https://docs.meroxa.com/cli/installation-guide):

```
# Add Resource
$ meroxa resource add my-postgres --type postgres -u postgres://$PG_USER:$PG_PASS@$PG_URL:$PG_PORT/$PG_DB

# Add Webhook
$ meroxa resource add my-url --type url -u $CUSTOM_HTTP_URL

# Create CDC Pipeline
$ meroxa connect --from my-postgres --input $TABLE_NAME --to my-url
```

The use case above is covered in more detail: [Building a Change Data Capture Microservice with Meroxa and Vercel Meroxa Guide.](https://docs.meroxa.com/guides/building-a-change-data-capture-microservice-with-meroxa-and-vercel)

Here are some great resources to help you get started with Meroxa:

- [What is Meroxa?](https://docs.meroxa.com/docs/introduction/what-is-meroxa)
- [Meroxa Getting Started Guide](https://docs.meroxa.com/getting-started)

I can’t wait to see what you build. 🚀

If you have any questions or feedback, I’d love to hear them. You can:

- Discuss with me our [**Discord**](https://discord.meroxa.com/) community.
- Reach out to me on [Twitter](https://www.notion.so/Stream-Your-Database-Changes-with-Change-Data-Capture-Part-Two-c5e1f0d9b19d4f5597fcefcb67c74fb1).

* * *