CosmosDB-GBB-Hackathon/challenges/Module3-Migrating MongoDB Apps to Azure Cosmos DB(SQL API).MD

Module 3: Migrate MongoDB Application to Azure Cosmos DB(SQL API)

Scenario 1 Access Cosmos DB account with SQL API (created in Module 1)

1. Launch a browser and navigate to https://portal.azure.com. Login with your Microsoft Azure credentials.
   

2. Click on Resource Group provided which contains the all the resources, click on created Azure Cosmos DB account(with SQL API, this is the first CosmosDB instance you created in challenge 1) under Overview tab.
   
   

3. Click on Keys option present under Cosmos DB Account blade, and copy URI and PRIMARY KEY.
   
   

4. Go back to Visual Studio Code IDE and paste the URI value against DOCUMENT_DB_ENDPOINT, PRIMARY KEY against DOCUMENT_DB_PRIMARYKEY, The original database name you created (under overview tab) against DOCUMENT_DB_DATABASE and change the API_MODE to SQL in the config.js.
   

5. Navigate back to the Azure Portal's Resource groups option present in the favourites menu on the left side panel and select the resource group and click on Azure Cosmos DB Account then, click on Replicate data globally option present under SETTINGS section in Cosmos DB Account blade.
   

6. Copy the WRITE REGION and paste it against DOCUMENT_DB_PREFERRED_REGION in config.js file which is already opened in Visual Studio Code IDE and save this file.
   
   

7. Go to /home/CosmosDB-Hackfest/ContosoAir/src/ContosoAir.Services in file system, right click and select Open Terimal Here as shown below:
   
   

8. Now execute the following commands one by one in command prompt.
   

node sql_db_flightinsert.js
node sql_db_insert.js

When this is completed, go back to the terminal that is running the API-tier (this is where you ran the npm start command) and enter the following:

ctrl+c
npm start

9. Now, to start the ContosoAir Website layer, go to /home/CosmosDB-Hackfest/ContosoAir/src/ContosoAir.Website. Open terminal from there and run ng serve command in terminal. Minimize the terminal once command is executed, do not exit or CTRL+C.
   

ng serve

10. It will create three different collections named SeatsCollection, DealsCollection and BookingsCollection with sample data.
    

11. Switch to Azure Portal, navigate to Resource groups option present in the favourites menu on the left side panel and select the resource group then click on Azure Cosmos DB Account named.
    

12. Click on Data Explorer option. It will display the collection created in Azure Cosmos DB Account.
    
    

Launch the Application

1. Copy the localhost URL http://localhost:4200 from here and paste it in Web Browser and press enter. There's a shortcut created for your already on desktop for this, you can open website using that as well.
   
2. You will see the sign-up page. You need to login to App using your Microsoft Account(formerly live-id). If you do not have a live-id, you can create one by following instructions given on page.
   
   
3. Once you get login, you will be redirected to ContosoAir app.
   
   
4. Enter Departure date and Return date in YYYY-MM-DD format and click Find Flights button.
   
   

Scenario 2: Integration with Azure Functions

Create an Azure Function App

In this we will create Azure Function App.

1. Login to Azure portal with your credentials and Click on +New.
   
2. Search for Function App.
   
   
3. Click on Create.
   
   
4. Provide the parameters to create Function App as defined below.
   

• App Name: Your unique name to identify the application
• Subscription: Leave default
• Resource Group: Choose Use Existing and select your available resource group
• OS: Windows
• Hosting Plan: Consumption Plan
• Location: Location of your RG
• Storage: Click on Create new
  Click on Create.
  
  

5. Click on Go to Resource Once provisioning is completed.
   
   

Create a function with Deal Data

Let's create an Azure Function to retrieve data of flight deals.

1. Go to Resource groups option present in the favourites menu on the left side panel and select the resource group and click on Azure Function named .
   

2. However over the Functions under Functions Apps and click on + sign besides Functions.
   

3. Now, click on the Custom function link present at the bottom of the page.
   
   

4. Click on C# template available in HTTP trigger section and name the function as "FetchDealsData" in Name textbox and click Create button.
   
   
   

5. A function with sample default code would get created. Now, replace the sample default code with the code snippet given below.
   

   using System.Net;
   using System.Linq;
   
   public static HttpResponseMessage Run(HttpRequestMessage req, TraceWriter log, IEnumerable<dynamic> SelectDealsData)
   {
       return req.CreateResponse(HttpStatusCode.OK, SelectDealsData);
   }
   

   NOTE: In above code snippet, IEnumerable<dynamic> SelectDealsData is a parameter used to fetch the list of DealsData collection from Cosmos DB. This method returns the result fetched from Cosmos DB along with HttpStatusCode with the help of CreateResponse method.
   

6. Click on Save button.
   

7. Now, click on the Integrate option listed in "FetchDealsData" function in the Function Apps blade.
   

8. Under Inputs section, click on + New Input and select Azure Cosmos DB then click Select button at the bottom of page.
   
   

9. Enter Document parameter name as SelectDealsData, Database name as contosoairdb3 and Collection name as DealsCollection in respective textboxes.
   

10. Copy the SQL query given below and paste it into SQL Query (optional) textbox.
    

    select c.id, c.fromName, c.fromCode, c.toName, c.toCode, c.price, c.departTime, c.arrivalTime, c.hours, c.stops, c.since from c
    

    NOTE: Above SQL query is responsible to get deals details from DealsCollection available in Cosmos DB like id, from name, from code, to name, to code, price, depart time, arrival time, hours, stops, since. (Ignore non-mandatory fields)

    

11. To enter Cosmos DB account connection, click on the new link given beside Cosmos DB account connection textbox.
    
    

12. You will be redirected to Cosmos DB Account blade, select the MongoDB DB Account as shown below.
    
    

13. Now, go to FetchDealsData and click on Save button button.
    

14. To check whether the function is integrated, click on FetchDealsData function present under AureFunctionForDeals function app blade and click on Test option present at the right most corner.
    
    

15. Select HTTP method as GET from the dropdown. Then click Run button at the bottom.
    

16. Status 200 Ok will be displayed once the test is completed which signifies that the function is integrated successfully.
    
    

Here you go! You have successfully created Azure Function to retrieve flight deals data from Cosmos DB.

16. In the Functions Apps blade, click on FetchDealsData.
    
17. You will get navigated to function and will find </> Get function URL link in the top right corner of the page. Click on the link
    
18. On clicking </> Get function URL you will get a popup window with a URL.
    
    
19. Click on Copy icon to copy the given URL and paste it against AZURE_FUNCTION_DEALS_URL: variable in config.js file opened in Visual Studio Code IDE and save the file.

Awesome, you have created Azure Function for Deals data and integrated with Cosmos DB.