Jeffrey Carpenter

One of the most frequently asked questions we receive is &ldquo;how do I migrate my application that was designed for a relational database to Cassandra?&rdquo; This is a great question with all kinds of practical implications, so we&rsquo;ve gathered some collective wisdom and best practices to share with you.
<h2>Knowing when it&rsquo;s time to migrate away from a relational database</h2>
Any migration to a new platform or database is going to involve work. Before starting on a migration project, you&rsquo;ll want to understand how you&rsquo;ll benefit and when it&rsquo;s the right time to move the key workloads that run your enterprise from a relational database to a NoSQL Cassandra database.&nbsp;
Here are some of the key signs you should look for to help you know when your current relational database isn&rsquo;t getting the job done anymore:&nbsp;
<ol>
<li>Your database queries are getting slower and more difficult to debug and maintain.</li>
<li>You&rsquo;re struggling to scale beyond a single database node, or paying high license costs for a fancy multi-node solution.</li>
<li>Hot backups required by your disaster recovery plan waste resources and don&rsquo;t guarantee high availability.</li>
<li>You want to deploy applications in hybrid or multi-cloud architectures.</li>
</ol>
If you&rsquo;ve concluded it&rsquo;s time for a change, you&rsquo;ll need to identify the use cases causing the most performance and scalability challenges, and begin prioritizing them for migration. Where possible, migrating functionality a bit at a time is generally lower risk than a &ldquo;big bang&rdquo; or &ldquo;flip the switch&rdquo; migration.
<h2>Migrating from RDBMS to Apache Cassandra: Step-by-Step</h2>
Once you&rsquo;ve identified a use case or two to migrate, the migration process includes the following:
<ol>
<li>Adapting your data model</li>
<li>Adapting your application&nbsp;</li>
<li>Planning your deployment&nbsp;</li>
<li>Moving your data&nbsp;</li>
</ol>
Let&rsquo;s examine what&rsquo;s involved in each of these steps.
<h3>Adapting your data model</h3>
It&rsquo;s vital to understand that Cassandra data modeling is not the same as relational data modeling. While Cassandra uses familiar concepts like tables, rows, and columns, and the Cassandra Query Language (CQL) is quite similar to SQL, there are some important differences you need to be aware of.
Relational data modelers are accustomed to creating normalized schema in order to minimize data duplication, and using joins to assemble data from multiple tables. You might be able to speed up some slow queries by adding additional indexes or selectively denormalizing data by duplicating columns in tables to avoid joins.
Cassandra data modeling is different: denormalization is the rule, not the exception. You start with analyzing the workflows of your application to identify the queries you&rsquo;ll need, and then design tables that contain all the required information in a single query. The DataStax Academy course &ldquo;<a href="https://academy.datastax.com/resources/ds220">DS220 Practical Application Data Modeling with Apache Cassandra</a>&rdquo; is a great way to develop your expertise in designing Cassandra tables.
Make sure you don&rsquo;t underestimate the importance of creating good Cassandra data models, as this will be your number one key to a successful migration. It&rsquo;s probably a good idea to do some load testing on your data models to see how your write and read queries will perform with non-trivial amounts of data, and to get a more concrete idea of the cluster size and configuration that will help achieve your performance goals. You can use <a href="https://www.datastax.com/blog/nosqlbench">NoSQLBench</a> to put a load on a target cluster for performance and scale testing, data model validation, and more.
<h3>Adapting your application&nbsp;</h3>
The next step is updating your application code to write and read from the Cassandra tables you&rsquo;ve designed. Whether you&rsquo;re updating an existing monolith or creating entirely new microservices, there are <a href="https://downloads.datastax.com/#datastax-drivers">DataStax Drivers</a> available in the most popular languages that you can use to connect to your DataStax Enterprise or Cassandra clusters.&nbsp;
New Cassandra developers need to become accustomed to the idea that Cassandra is a distributed database, so there are trade-offs to consider when storing multiple copies of data across multiple nodes or even multiple data centers or clouds. You&rsquo;ll want to learn about Cassandra&rsquo;s tunable consistency and the tools Cassandra gives you for managing the trade-offs between consistency and performance, including consistency levels, lightweight transactions, and batches. The DataStax Academy course &ldquo;<a href="https://academy.datastax.com/resources/ds201-datastax-enterprise-6-foundations-of-apache-cassandra">DS201 Foundations of Apache Cassandra</a>&rdquo; is a great introduction to these concepts.&nbsp;
<h3>Planning your deployment</h3>
Before you deploy your updated application, it&rsquo;s important to <a href="https://docs.datastax.com/en/dse-planning/doc/">plan out your Cassandra cluster</a>. You&rsquo;ll want to consider questions such as:
<ul>
<li>What are the performance metrics or service level agreements (SLAs) that will be required for queries?</li>
<li>What kind of hardware and network is available within the platform?</li>
<li>How many data centers will the application be deployed to?</li>
</ul>
These questions should be considered both in terms of your initial deployment, as well as how you plan to expand as your application proves successful.
<h3>Moving your data&nbsp;</h3>
After doing the hard work of designing Cassandra tables and writing the code to write and read from those tables, the time will come to deploy your updated application to production. In most cases you&rsquo;ll have data to move from your legacy database. The <a href="https://downloads.datastax.com/#bulk-loader">DataStax Bulk Loader</a> and other similar tools are great for performing one-time data migrations, one of several cases described in <a href="https://www.datastax.com/blog/2019/03/datastax-bulk-loader-introduction-and-loading">Brian Hess&rsquo;s blog series</a>.&nbsp;
If you have requirements for a zero-downtime migration you&rsquo;ll also want to investigate using Apache Kafka&reg;, the Kafka Connect framework, and the <a href="https://downloads.datastax.com/#akc">DataStax Kafka Connector</a> to capture changes from your legacy database and write them into Cassandra tables. To validate the results of your data migration, consider using Apache Spark to compare records from the source system to those in your Cassandra cluster.&nbsp;&nbsp;
<h2>Pack your bags: It&rsquo;s time to move to NoSQL</h2>
The thought of migrating from a relational database to a NoSQL database, like Cassandra, can be daunting. But, <a href="https://www.datastax.com/blog/making-move-relational-nosql-its-easier-you-think">it&rsquo;ll likely be easier than you think</a>. That&rsquo;s especially true if you&rsquo;re proactively on the lookout for the signs the time to make a move might be approaching, while also actively searching for <a href="https://www.datastax.com/blog/sql-vs-nosql-whats-the-difference">use cases where NoSQL would be a better choice</a> at your company.&nbsp;
Once you&rsquo;ve decided to take the plunge, make sure to break the migration process down to a step-by-step process, like we outlined above, and you should be well on your way to <a href="https://www.datastax.com/blog/betting-cassandra-database-future">benefiting from all Cassandra has to offer</a>.&nbsp;
Don&rsquo;t worry. You won&rsquo;t be alone. We have plenty of resources to help you on the journey, including:
<ul>
<li><a href="https://docs.datastax.com/">DataStax Docs</a></li>
<li><a href="https://community.datastax.com/index.html">DataStax Community</a>: Learn from Apache Cassandra experts from DataStax and the larger community.</li>
<li>The &ldquo;Migrating from SQL to NoSQL&rdquo; section of our Cassandra migration and upgrade page.</li>
</ul>

Build and scale cloud native apps

Discover the benefits of DBaaS and why your apps deserve an upgrade.

Learn about NoSQL Databases

Learn about NoSQL databases with Apache Cassandra and Astra DB.

2022 Recap: A Year for Customers, Community, and Real-Time Data

Highlights from 2022 and a glimpse into the year ahead.

ViewingTechnical How To’s

Moving from RDBMS to NoSQL: Migration Best Practices for Apache Cassandra®

Sign up for our Developer Newsletter