README.md

Microsoft Azure DocumentDB Node.js SDK

This project provides a node module that makes it easy to interact with Azure DocumentDB.

For documentation please see the Microsoft Azure Node.js Developer Center and the Microsoft Azure DocumentDB Node.js SDK Documentation.

Installation

Core Module

The core module uses the callbacks model for responses, exposed through the DocumentClient

npm install documentdb

Usage

To use this SDK to call Azure DocumentDB, you need to first create an account.

You can follow this tutorial to help you get started.

Note:

When connecting to the emulator from the SDK, SSL verification is disabled.

Examples

Hello World using Callbacks via the Core Module

var DocumentClient = require('documentdb').DocumentClient;

var host = "[hostendpoint]";                     // Add your endpoint
var masterKey = "[database account masterkey]";  // Add the masterkey of the endpoint
var client = new DocumentClient(host, {masterKey: masterKey});

var databaseDefinition = { id: "sample database" };
var collectionDefinition = { id: "sample collection" };
var documentDefinition = { id: "hello world doc", content: "Hello World!" };

client.createDatabase(databaseDefinition, function(err, database) {
    if(err) return console.log(err);
    console.log('created db');

    client.createCollection(database._self, collectionDefinition, function(err, collection) {
        if(err) return console.log(err);
        console.log('created collection');

        client.createDocument(collection._self, documentDefinition, function(err, document) {
            if(err) return console.log(err);
            console.log('Created Document with content: ', document.content);

            cleanup(client, database);
        });
    });
});

function cleanup(client, database) {
    client.deleteDatabase(database._self, function(err) {
        if(err) console.log(err);
    })
}

Youtube Videos

Getting started with Azure DocumentDB on Node.js:

Need Help?

Be sure to check out the Microsoft Azure Developer Forums on MSDN or the Developer Forums on Stack Overflow if you have trouble with the provided code.

Contribute Code or Provide Feedback

If you would like to become an active contributor to this project please follow the instructions provided in Azure Projects Contribution Guidelines.

If you encounter any bugs with the library please file an issue in the Issues section of the project.

Learn More

• Azure Developer Center
• Azure DocumentDB Node.js SDK Documentation
• Azure DocumentDB Service
• Azure DocumentDB Community Page