本教程将要告诉你如何使用pymongo模块来操作MongoDB数据库。

一、先决条件

开始之前，我们需要确定电脑已经安装了pymongo和MongoDB.

1.安装pymongo

使用pip安装pymongo，在cmd命令行输入：

pip install pymongo

在python IDLE 中输入：import pymongo 没有报错表示安装成功。

2.安装MongoDB

参考这个链接：http://www.cnblogs.com/billyzh/p/5913687.html

如果不安装MongoDB会出现后面的一个问题。

3.MongoDB中的基本概念

在MongoDB中基本的概念是文档(document)、集合(collection)、数据库(database).

下图(盗的图)可能容易理解MongoDB中的一些概念:

通过下图实例，可以更直观的的了解MongoDB中的一些概念：

二、通过MongoClient建立一个连接

开始使用pymongo的第一步是创建一个MongoClient,来运行mongod实例。

>>> from pymongo import MongoClient

>>> client = MongoClient()

上面代码将会连接默认的host和port。也可指定：

>>> client = MongoClient('localhost',27017)

或者用MongoDB URI格式：

>>> client = MongoClient('mongodb://localhost:27017/')

默认状态下Mongo客户端是没有加密的,但是如果需要通过账户登录:

>>> client = MongoClient('mongodb://账号:密码@localhost:27017/')

三、获取一个数据库

一个MongoDB实例可以支持多个独立的数据库。使用PyMongo时，可以通过访问MongoClient的属性的方式来访问数据库。

>>> db = client.test_database

如果数据库名字使用属性方式不能访问(像test-database),也可以通过访问字典值的方式。

>>> db = client['test-database']

四、获取一个Collection

一个collection是一组存在MongoDB中的文件(documents)，大致可以认为是关系型数据库中表的概念。

获取Collection方法与获取数据库方法一致:

>>> collection = db.test_collection #注意连接符是_不是-

或用字典方式：

>>> collection = db['test-collection']

需要注意的是，MongoDB里的collections(集合)和databases(数据库)都是惰性创建的，前面提到的所有命令

实际上没有对MongoDB server进行任何操作。当第一个文件插入后，collections和databases才会被创建。

五、文件(Documents)

数据在MongoDB中是用JSON类文件的形式表示和保存起来的。在pymongo中用字典来代表文件。

例如，下面这个字典可能被用来代表一篇博客文章:

>>> import datetime

>>> post = {

"author": "Mike",

"text": "My first blog post!",

"tags": ["mongodb","python","pymongo"],

"date": datetime.datetime.utcnow()

}

注意，文件里可以包含python原生(native)类型(datetime.datetime实例)，这些类型的值会被自动在原生类型和BSON格式之间转换。

六、插入一个文件(Inserting a Document)

插入一个文件到collection中，可以使用insert_one()方法。

>>> posts = db.posts

>>> post_id = posts.insert_one(post).inserted_id

>>> post_id

ObjectId('57eb8f2177eddf292cbea0b3')

当一个文件被插入一个特殊的键值'_id',即使文件内没有_id这个键值，那么系统自动添加一个到文件里。

这是一个特殊键值，它的值在整个collection里是唯一的。insert()返回这个文件的_id值。

插入第一个文件后，这个posts collection 就真正的在server上创建了。我们可以通过查看数据库上的

所有collection来验证：

>>> db.collection_names(include_system_collections=False)

['posts']

七、获取单个文件 find_one()

在MongoDB中，最基本的查询是find_one。这个方法返回一个符合查询的文件，或者在没有匹配的时候返回None。

当只有一个文件符合条件的时候，或者只对第一个符合条件的文件感兴趣的时候，这个方法是很有用的。

我们用find_one()来获取posts collection 里的第一个文件：

>>> posts.find_one()

{'date': datetime.datetime(2016, 9, 27, 3, 56, 26, 78000), 'author': 'Mike',

'_id': ObjectId('57e9edea77eddf223cde3314'), 'tags': ['mongodb', 'python', 'pymongo'],

'text': 'My first blog post!'}

返回结果是一个我们之前插入的符合条件的字典类型值。

注意，返回的文件里包含_id这个键值，这是自动添加的。

find_one()还支持对特定元素进行匹配的查询。限制我们文档的作者是"Mike",可以这么做：

>>> posts.find_one({"author":"Mike"})

{'date': datetime.datetime(2016, 9, 27, 3, 56, 26, 78000), 'author': 'Mike',

'_id': ObjectId('57e9edea77eddf223cde3314'), 'tags': ['mongodb', 'python', 'pymongo'],

'text': 'My first blog post!'}

如果我们用不同的作者，比如："Eliot",将不会得到结果。

>>> posts.find_one({"author":"Eliot"})

>>>

八、按照ObjectId查询

通过_id也可以进行查询，在例子中就是ObjectId:

>>> post_id

ObjectId('57eb54a877eddf292cbea0a8')

>>> posts.find_one({"_id": post_id})

{'date': datetime.datetime(2016, 9, 28, 5, 25, 53, 6000), 'author': 'Mike',

'_id': ObjectId('57eb54a877eddf292cbea0a8'), 'tags': ['mongodb', 'python'],

'text': 'My first blog post!'}

注意：ObjectId 并不等同于它的字符串形式。

>>> post_id_as_str = str(post_id)

>>> posts.find_one({"_id": post_id_as_str}) #No result

>>>

在web应用的一个常见任务就是在request的URL里获取ObjectId，然后找到与之匹配的文件。

在本例中，必须要先从字符串转换为ObjectId，然后传给find_one:

>>> from bson.objectid import ObjectId

#从URL里获取post_id，然后把它作为字符串传入

>>> def get(post_id):

#将字符串转换为ObjectId

document = client.db.collection.find_one({"_id": ObjectId(post_id)})

小插曲：

MongoDB以BSON格式保存数据。BSON字符串都是UTF-8编码的，所以pymongo必须确保它保存的字符串值

包含有效地UTF-8数据.常规字符串()都是有效的，可以不改变直接保存。

Unicode字符串()就需要先编码成UTF-8格式。

九、批量插入

为了让查询更有趣，我们多插入几个文件。除了单个文件插入，也可以通过给insert_many()方法传入

一个列表(list)，作为该方法的第一个参数,进行批量插入操作。

这将会插入列表(list)中的每个文件(document)到集合中去，而且只向server发送一条命令:

new_posts = [{"author": "Mike",

"text": "Another post!",

"tags": ["bulk", "insert"],

"date": datetime.datetime(2009, 11, 12, 11, 14)

},

{"author": "Eliot",

"title": "MongoDB is fun",

"text": "and pretty easy too!",

"date": datetime.datetime(2009, 11, 10, 10, 45)

}]

>>> result = posts.insert_many(new_posts)

>>> result.inserted_ids

[ObjectId('57eb700b77eddf292cbea0a9'), ObjectId('57eb700b77eddf292cbea0aa')]

这个例子里有一些比较有趣的地方：

insert_many()现在返回两个ObjectId实例，每个代表一个插入的文件。

new_posts[1]与其他的posts内容格式不相同,里面没有"tags”。另外我们增加了一个新的“title”域。这就是MongoDB所提到的无schema特点。

十、查询多个文件

为了得到更多的文件，我们使用find()方法。find()返回一个Cursor实例,可使我们遍历所有匹配的文件。

比如遍历每个posts collection里的文件:

>>> for post in posts.find():

post

与使用find_one()时候相同，可以传入一个文件来限制查询结果。比如查询作者"Mike" 文件：

>>> for post in posts.find({"author":"Mike"}):

post

十一、文件数量(Counting)

如果只想知道符合查询条件的文件有多少，可以用count()操作，而没必要进行完整的查询。

查询collection的文件总数：

>>> posts.count()

11

或者只是查询一些特定文件数量：

>>> posts.find({"author": "Mike"}).count()

10

十二、限定范围的查询

MongoDB支持多种高级查询。比如我们按照时间(小于某个时间)来查询,结果按作者名参数来排序:

>>> d = datetime.datetime(2009,11,12,12)

>>> for post in posts.find({"date":{"$lt":d}}).sort("author"):

print(post)

{'date': datetime.datetime(2009, 11, 10, 10, 45), 'author': 'Eliot', 'text': 'and pretty easy too!', '_id': ObjectId('57eb700b77eddf292cbea0aa'),        'title': 'MongoDB is fun'}

{'date': datetime.datetime(2009, 11, 12, 11, 14), 'author': 'Mike', '_id': ObjectId('57eb700b77eddf292cbea0a9'), 'tags': ['bulk', 'insert'],                'text': 'Another post!'}

这里使用了特殊的"$lt"操作符来进行范围查询，并调用sort()方法，对结果按照作者参数排序。

十三、索引(Indexing)

添加索引可以帮助加快某些查询，也可以添加额外的功能来查询和存储文件。

在这个示例中，我们将演示如何在一个键上创建一个唯一索引，这个索引将拒绝--那些已经在索引中存在该键值的文件。

首先，我们需要创建一个索引：

>>> result = db.profiles.create_index([('user_id',pymongo.ASCENDING)],unique = True)

>>> result

'user_id_1'

>>> list(db.profiles.index_information())

['_id_', 'user_id_1']

注意：现在我们有两个索引,一个索引 _id是MongoDB自己创建的。另外一个 user_id是我们刚刚创建的。

现在，让我们建立一些用户配置文件：

>>> user_profiles = [{'user_id':211,'name':'Luke'},{'user_id':212,'name':'Ziltoid'}]

>>> result = db.profiles.insert_many(user_profiles)

该索引可以防止我们的user_id已经插入集合中的文档：

>>> new_profile = {'user_id': 213, 'name': 'Drew'}

>>> duplicate_profile = {'user_id': 212, 'name': 'Tommy'}

>>> result = db.profiles.insert_one(new_profile) # This is fine.

>>> result = db.profiles.insert_one(duplicate_profile)

Traceback (most recent call last):

pymongo.errors.DuplicateKeyError: E11000 duplicate key error collection: test_database.profiles index: user_id_1 dup key: { : 212 }

关于索引的MongoDB文档链接：

问题：

1.pymongo.errors.ServerSelectionTimeoutError: localhost:27017: [WinError 10061] 由于目标计算机积极拒绝，无法连接。

原因：未装MongoDB或者MongoDB服务没有开启。(这个错误找了很长时间，哎。。。)

参考链接：http://www.cnblogs.com/greenteaone/p/3745734.html

2.在数据库存入了文件，如何查看呢？就需要用到MongoDB可视化工具了。

1)MongoBooster(已用)

下载地址：http://mongobooster.com/home

2)Robomongo

下载地址：https://robomongo.org/