services	platforms	author
cosmos-db	nodejs	andrewhoh

Developing a Node.js app using the Azure Cosmos DB SQL API

Azure Cosmos DB is a globally distributed multi-model database. One of the supported APIs is the SQL API, which provides a JSON document model with SQL querying and JavaScript procedural logic. This sample shows you how to use the Azure Cosmos DB with the SQL API to store and access data from a Node.js application.

Running this sample

• Before you can run this sample, you must have the following perquisites:
  • An active Azure Cosmos DB account - If you don't have an account, refer to the Create an Azure Cosmos DB account article.
  • Node.js version v0.10.29 or higher.
  • Git.

1. Clone this repository using git clone git@github.com:Azure-Samples/azure-cosmos-db-documentdb-nodejs-getting-started.git cosmosdb

2. Change directories to the repo using cd cosmosdb

3. Next, substitute the endpoint and authorization key in config.js with your Cosmos DB account's values.

   config.endpoint = "~your Azure Cosmos DB endpoint here~";
   config.authKey = "~your auth key here~";
   

4. Run npm install in a terminal to install required npm modules

5. Run node app.js in a terminal to start your start your node application.

About the code

The code included in this sample is intended to get you quickly started with a Node.js console application that connects to Azure Cosmos DB with the SQL API.

More information

• Azure Cosmos DB
• Azure Cosmos DB: SQL API
• Azure Cosmos DB Node.js SDK
• Azure Cosmos DB Node.js SDK Reference Documentation