Robin Schumacher

This is an excerpt from the DataStax whitepaper "Data Modeling in Apache Cassandra™;"&nbsp;which delves into how to choose the right data model for your Apache Cassandra™ application in 5 easy steps. <a href="https://www.datastax.com/resources/whitepaper/data-modeling-apache-cassandra">Click here</a> to download the full whitepaper.

<hr />
Step 1: Build the application workflow

When building applications using relational databases, developers often start with the data model, thinking about the data items that need to be stored and how they relate to one another.&nbsp;With Cassandra, just the opposite is recommended.&nbsp;The best practice is to start with the application workflow; an approach referred to as “query-first design.”

Before thinking about how data will be stored, designers need to know what types of queries the database will need to support.&nbsp;Figure 3 presents a simplified application workflow for KillrVideo.com.

<img alt="Simplified Application Workflow" data-entity-type="file" data-entity-uuid="75ae46d5-ffbd-4236-a50d-0c993702f9dd" src="https://www.datastax.com/sites/default/files/inline-images/CM2019236_-_Data_Modeling_in_Apache_Cassandra_%E2%84%A2_White_Paper-4_pdf__page_6_of_19_.png" />

Figure 3 – Simplified application workflow

The sequence of workflow steps matters because it helps us determine what data is available and required for each query.&nbsp;For example, before we can show basic information about a user (step 2 above), a userid is required.&nbsp;The user first needs to log in to the site (step 1) supplying an email address and password in exchange for the required userid.&nbsp;A userid might also be obtained by searching for a video (steps 6 or 7), showing comments for a video (step 9), and looking up details about the user that commented.&nbsp;Similarly, before the application can display details about a video (step 8) the application needs a videoid obtained by selecting from a list of the latest videos (step 7) or by searching videos by tag (step 6).

Step 2: Model the queries required by the application

Even at the design stage, developers can think through the sequence of tasks required, mock up what each screen will look like, and decide what data will be required at each stage. 
Figure 4 shows a simplified entity relationship diagram (ERD) for the KillrVideo application.&nbsp;The application needs to be able to keep track of entities such as users, videos, and comments.&nbsp;Users can perform activities such as adding videos, rating videos, and posting comments.&nbsp;Users can comment on multiple videos, and each video can have multiple user comments associated, but there is only one owner of each video.

<img alt="KillrVideo: Entity Relationship Diagram (ERD) for KillrVideo" data-entity-type="file" data-entity-uuid="4d6dacb7-8053-4aef-9627-54f22de593be" src="https://www.datastax.com/sites/default/files/inline-images/CM2019236_-_Data_Modeling_in_Apache_Cassandra_%E2%84%A2_White_Paper-4_pdf__page_7_of_19_.jpg" />

Figure 4 – KillrVideo: Entity relationship diagram (ERD) for KillrVideo

It’s a good idea to iterate between the application workflow and ERD, updating both as new data items and relationships required by the application are identified.&nbsp;Once developers have a clear idea of the application workflow and the key data objects required, it’s possible to start identifying the queries that the application needs to support.&nbsp;A diagram showing key queries and how they relate to data domains is shown in Figure 5.

<img alt=" Identify the Queries Required to Support the Application Workflow" data-entity-type="file" data-entity-uuid="dfe8daeb-125d-4bac-83b0-b38001039012" src="https://www.datastax.com/sites/default/files/inline-images/CM2019236_-_Data_Modeling_in_Apache_Cassandra_%E2%84%A2_White_Paper-4_pdf__page_8_of_19_.jpg" />

Figure 5 – Identify the queries required to support the application workflow

<hr />
Thanks for reading this&nbsp;excerpt from the DataStax whitepaper "Data Modeling in Apache Cassandra™"&nbsp;tune in next week when we release another excerpt or&nbsp;<a href="https://www.datastax.com/resources/whitepaper/data-modeling-apache-cassandra">click here</a> to download the full asset.

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

Five Steps to an Awesome Data Model

Sign up for our Developer Newsletter