Azure Cosmos DB + Azure Functions + Azure Cognitive Services Text Analytics to analyze user content in real-time
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
function Update function.json Nov 29, 2017
images adding images Nov 28, 2017
webapp Creating leases collection Nov 28, 2017
.gitignore Creation Nov 28, 2017
LICENSE Create LICENSE Nov 28, 2017
README.md Update README.md Jul 11, 2018

README.md

Azure Cosmos DB social analytics sample

🎉New and updated sample of this scenario here.

This sample repository shows a simple social network where posts are stored in Azure Cosmos DB, and as soon as data is inserted, it leverages Azure Function's CosmosDBTrigger to analyze the text with Azure Cognitive Text Analytics API and obtain insights on the user's intention.

For more information regarding serverless architectures with Azure Cosmos DB and Azure Functions, please visit the complete article.

Social network post analyzing

Requirements

To run this demo you will need:

You can create all of these services from within the Azure Portal.

If you don't have an Azure Subscription you can create a free account today.

Additionally, this demo contains an ASP.NET Core Web application, you will need .NET Core SDK to be able to run it, but you can do so in any platform (Windows, Linux or Mac).

A word on resources usage

The cost of running this demo is low in terms of Azure services but just so it is clear what's going to be created:

  • The demo will create 3 400 RU/s collections in your Azure Cosmos DB account, this has an hourly cost of USD $ 0.096 approximatelly.
  • If your Azure Function App is running in App Service Mode, no additional costs will occur. If it's running in Consumption Mode, you might get charged for a couple of executions during the demo.
  • Text Analytics API has a free tier with 5,000 monthly calls free of charge.

Remember to delete the collections once you are done playing with the demo :)

Getting started

After you clone this repository, go to the webapp folder, find the appsettings.json file and edit the Endpoint and Key configuration settings to match those of your Azure Cosmos DB account.

{
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Warning"
    }
  },
  "CosmosDB": {
    "Endpoint": "https://<your-account-name>.documents.azure.com:443/",
    "Key": "<your-account-key>"
  }
}

Now from your command prompt, you can run dotnet run from within the folder to restore dependencies and run the application.

This action will automatically create the collections in your account:

  • posts will hold the content/messages created by the user
  • results will hold the Text Analytics API evaluation results
  • leases will be used for the Azure Functions integration

Collection list

Automating content analysis

Now go to the Add Azure Function menu item in your Azure Cosmos DB account:

Add Azure Function menu item

Select the posts collection and then select your existing Azure Function App:

Creating an Azure Function

After clicking Save your function will be created and hooked to the posts collection with some default and simple code.

We will now customize the code in a way that, after each new content/message inserted, we will call Text Analytics, analyze and store the results without modifying any line of code in the web application.

You need to upload one the project.json file to your Azure Function to include the Text Analytics Nuget package.

Including Text Analytics package

Then click on your function.json file and replace its contents with the function.json file included in this repository.

Now click in your run.csx file and do the same with the run.csx file included in this repository. You will need to edit the content to add your Text Analytics API Key:

Hooking up everything

Finally, Save your file and go to the running Web application in your local environment, write some comment on the text input and click on the pencil and wait :)

Your message will be saved on the posts collection, picked up by the Azure Function, analyzed, the result will be stored in the results collection and the Web application will pull it and show it on the UI.

Sample result

Running web app