page_type	sample
languages	javascript
products	azure
description	Azure Cosmos DB is a globally distributed multi-model database.
urlFragment	azure-cosmos-db-sql-api-nodejs-getting-started

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 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-sql-api-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 Azure Cosmos DB account's values.

   config.endpoint = "~your Azure Cosmos DB endpoint here~";
   config.primaryKey = "~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