garyhopems / cosmicworks

How to model and partition data for Cosmos DB starting with the Adventure Works database.

CosmicWorks

How to migrate a relational data model to Azure Cosmos DB, a distributed, horizontally scalable, NoSQL database.

This repo is used to support a presentation on how to migrate a relational database schema to a NoSQL database like Azure Cosmos DB. This repo contains a Powerpoint presentation and a Visual Studio solution that represents the demos for this presentation with three projects in it:

• modeling-demos: This contains the main app that shows the evolution of the data models from v1 to v4

• change-feed-categories: This project uses change feed processor to monitor the product categories container for changes and then propagates those to the products container.

• models: This project contains all of the POCO classes used in both projects.

Steps to setup

1. Clone this repository to your local machine.
2. Click the Deploy to Azure button above. This will provision a new Cosmos DB account in a single region.
3. When the deployment is complete, click on the Outputs tab in the custom deployment blade. Copy the uri and key values and save locally.
4. Open the Cosmic Works solution file.
5. Add the uri and key information to the appSettings.json file for both the 'change-feed-categories' and 'modeling-demos' VS Project files or right click each project, select 'Manage User Secrets' and enter the same key and values as key-value pairs there.
6. Right click the 'modeling-demos' project and set as start up. Then press F5 to start it.
7. On the main menu, press 'k' to create the database and container resources (Note, these are billable resources).
8. On the main menu, press 'l' to load data. (Note, this can take quite some time and may time out when run locally over low bandwidth connections. Best performance is running on a VM in the same region the Cosmos account was provisioned in.)
9. Right click the 'change-feed-categories' project and select, Debug, Start new instance.
10. Finally, put breakpoints for any of the functions you want to run then press the corresponding menu item key to execute.

Important

To minimize cost related to this sample it is recommended to run the 'Delete databases and containers' item from the main menu. This will delete the databases and containers and just leave an empty Cosmos account which has no cost. You can then start the sample again and run 'k' and 'l' menu items to rehydrate the account.

Source data

You can download all of the data for each of the 4 versions of the Cosmos DB databases as it progresses through its evolution from the data folder in this repository. You can see the contents of these storage containers below.

• Cosmic Works version 1

• Cosmic Works version 2

• Cosmic Works version 3

• Cosmic Works version 4

You can also download a bak file for the original Adventure Works 2017 database this session and app is built upon.