Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
index.js
package.json

README.md

mongodb-autoincrement

=====================

Module to auto increment mongodb _id index. There is also mongoose plugin here.

Installing

npm install mongodb-autoincrement

Using

...with mongodb-native driver

Gets next auto increment integer index from database for the given collection. The successive calls to this function return different values so you can safely use it in multi client applications.

getNextSequence(db, collectionName, fieldName, callback)

  • db - mongodb-native driver connection object
  • collectionName - name of the collection to get auto increment index for, string
  • fieldName - name of the auto increment field [optional]
  • callback - function (err, nextFreeIndex)
var MongoClient = require("mongodb").MongoClient;
var autoIncrement = require("mongodb-autoincrement");

MongoClient.connect(url, function (err, db) {
    autoIncrement.getNextSequence(db, collectionName, function (err, autoIndex) {
        var collection = db.collection(collectionName);
        collection.insert({
            _id: autoIndex,
            ...
        });
    });
});

...with mongoose

The plugin can be applied to particular schema and globally.

mongoosePlugin(schema, options)

  • schema - mongoose.Schema
  • options - Object:
    • field - auto increment field name, default _id
    • step - auto increment step, default 1

With single schema plugin

var mongoose = require('mongoose');
var autoIncrement = require("mongodb-autoincrement");

var schema = new mongoose.Schema({
    ...
});

schema.plugin(autoIncrement.mongoosePlugin);

Global plugin usage

While using plugin as global mongoose plugin it will be applied to all schemas with no {_id: false} option set.

var autoIncrement = require("mongodb-autoincrement");
var mongoose = require('mongoose');
mongoose.plugin(autoIncrement.mongoosePlugin, optionalOptions);

var schema1 = new mongoose.Schema({    // _id field will be auto incremented integer
    ...
});

var schema2 = new mongoose.Schema({    // plugin will not be applied
    ...
}, {_id: false});

Setting default options

var autoIncrement = require("mongodb-autoincrement");
autoIncrement.setDefaults({
    collection: collectionName,     // collection name for counters, default: counters
    field: fieldName,               // auto increment field name, default: _id
    step: integerNumber             // auto increment step
});

Notes

You cannot set initial values for auto increment fields by the module. If you need it you can always set them directly via mongodb. Find a record with _id 'collectionName' in the collection 'counters' and set field 'seq' to required value.

Counters collection structure:

{
    _id: collectionName,        // name of the collection for which auto increment id field is set
    field: fieldName,           // name of the field to auto increment in the collection collectionName
    seq: integerValue           // last auto increment value used
}
You can’t perform that action at this time.