https://github.com/nimeshkverma/mongo_joins

Joins on Mongo
https://github.com/nimeshkverma/mongo_joins

inner-join join-commands mongo mongodb mongodb-database nosql nosql-database outer-join pip python

Last synced: 3 months ago
JSON representation

Joins on Mongo

• Host: GitHub
• URL: https://github.com/nimeshkverma/mongo_joins
• Owner: nimeshkverma
• License: mit
• Created: 2015-08-28T10:58:43.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2016-05-08T19:13:28.000Z (over 8 years ago)
• Last Synced: 2024-09-27T17:21:37.313Z (3 months ago)
• Topics: inner-join, join-commands, mongo, mongodb, mongodb-database, nosql, nosql-database, outer-join, pip, python
• Language: Python
• Size: 37.1 KB
• Stars: 14
• Watchers: 4
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# mongojoin

**Joins on Mongo**

This is an attempt to provide people using MongoDB - and fetching related data from different collections rather frequently - with a library to combine data from more than one collection (*Read 'joins'*)

MongoDB is a  de-normalized database and does not offer methods to perform "join" action on collections.

Feel free to raise issues and contribute !

Preliminary documentation can be found in **DOCUMENTATION.md**

## Installation

***

To install the package, type the following -

	pip install mongojoin

## Sample data - Populating MongoDb with sample data

***

Navigate to `test/sample_data` in the `mongojoin` directory and type the following command -

	> mongoimport --dbname test --collection order --file order.json

	> mongoimport --dbname test --collection supplier --file supplier.json

This will create and populate the required collections with sample data for running the tests.

The two collections 'supplier' and 'order' will be used to demonstrate how to use mongojoin.

To check the contents of the collection, the following command can be used on the MongoDB shell :

	> use test

	> db.supplier.find({})

	> db.order.find({})

## Using `mongojoin` to perform joins on two MongoDB collections

***

Type the following in Python shell to import the necessary modules - 

	>>> from mongojoin.mongojoin import MongoJoin

	>>> from mongojoin.mongojoin import MongoCollection

To create `MongoCollection` objects for the two collections to be joined, type the following -

	>>> collection_1 = MongoCollection("test", "supplier", ["supplier_id", "name"], {"supplier_id": 1001})

	>>> collection_2 = MongoCollection("test", "order", ["supplier_id", "qty"], {"supplier_id": 1001}, host='localhost')

A `MongoJoin` object needs to be created to perform a join on the two `MongoCollection` objects.

To create the `MongoJoin` object, type the following -

	>>> aggregator = MongoJoin(collection_1, collection_2, ["supplier_id"])

The join commands return a `DefaultDict` object which can be used accordingly.

To perform inner join, 

	

	>>> aggregator.inner()

To perform left-outer join,

	

	>>> aggregator.left_outer()

To perform right-outer join,

	

	>>> aggregator.right_outer()

To perform full-outer join,

	

	>>> aggregator.full_outer()

The join commands return a `DefaultDict` object which can be used accordingly.

This is equivalent to the following query in SQL:

    SELECT supplier.supplier_id, supplier.name, order.supplier_id, order.qty FROM supplier JOIN order ON supplier.supplier_id = order.supplier_id WHERE supplier.supplier_id = 1001 AND order.supplier_id = 1001

More contents here - https://pypi.python.org/pypi/mongojoin/1.0.0