#!/usr/bin/env python
# -*- coding:utf-8 -*-
"""

連接MongoDB
    連接MongoDB我們需要使用PyMongo庫(kù)里面的MongoClient，一般來(lái)說(shuō)傳入MongoDB的IP及端口即可雕旨，第一個(gè)參數(shù)為地址host想暗，
    第二個(gè)參數(shù)為端口port镀钓，端口如果不傳默認(rèn)是27017凤瘦。
"""
import pymongo
client = pymongo.MongoClient(host='localhost', port=27017)
"""
這樣我們就可以創(chuàng)建一個(gè)MongoDB的連接對(duì)象了。另外MongoClient的第一個(gè)參數(shù)host還可以直接傳MongoDB的連接字符串，以mongodb開頭落竹，
例如：client = MongoClient('mongodb://localhost:27017/')可以達(dá)到同樣的連接效果。
"""
# 指定數(shù)據(jù)庫(kù)
# MongoDB中還分為一個(gè)個(gè)數(shù)據(jù)庫(kù)瓮钥，我們接下來(lái)的一步就是指定要操作哪個(gè)數(shù)據(jù)庫(kù)筋量，在這里我以test數(shù)據(jù)庫(kù)為例進(jìn)行說(shuō)明烹吵，所以下一步我們
# 需要在程序中指定要使用的數(shù)據(jù)庫(kù)。
 
db = client.test
# 調(diào)用client的test屬性即可返回test數(shù)據(jù)庫(kù)桨武，當(dāng)然也可以這樣來(lái)指定：
# db = client['test']
#　兩種方式是等價(jià)的肋拔。
 
# 指定集合
# MongoDB的每個(gè)數(shù)據(jù)庫(kù)又包含了許多集合Collection，也就類似與關(guān)系型數(shù)據(jù)庫(kù)中的表呀酸，下一步我們需要指定要操作的集合凉蜂，
# 在這里我們指定一個(gè)集合名稱為students，學(xué)生集合性誉。還是和指定數(shù)據(jù)庫(kù)類似窿吩，指定集合也有兩種方式。
 
collection = db.students
# collection = db['students']
# 插入數(shù)據(jù),接下來(lái)我們便可以進(jìn)行數(shù)據(jù)插入了错览，對(duì)于students這個(gè)Collection纫雁，我們新建一條學(xué)生數(shù)據(jù)，以字典的形式表示：
 
student = {
    'id': '20170101',
    'name': 'Jordan',
    'age': 20,
    'gender': 'male'
}
# 在這里我們指定了學(xué)生的學(xué)號(hào)倾哺、姓名轧邪、年齡和性別，然后接下來(lái)直接調(diào)用collection的insert()方法即可插入數(shù)據(jù)羞海。
 
result = collection.insert(student)
print(result)
# 在MongoDB中忌愚，每條數(shù)據(jù)其實(shí)都有一個(gè)_id屬性來(lái)唯一標(biāo)識(shí)，如果沒(méi)有顯式指明_id却邓，MongoDB會(huì)自動(dòng)產(chǎn)生一個(gè)ObjectId類型的_id屬性硕糊。
# insert()方法會(huì)在執(zhí)行后返回的_id值。
 
# 運(yùn)行結(jié)果：
# 5932a68615c2606814c91f3d
# 當(dāng)然我們也可以同時(shí)插入多條數(shù)據(jù)腊徙，只需要以列表形式傳遞即可简十，示例如下：
 
student1 = {
    'id': '20170101',
    'name': 'Jordan',
    'age': 20,
    'gender': 'male'
}
 
student2 = {
    'id': '20170202',
    'name': 'Mike',
    'age': 21,
    'gender': 'male'
}
 
result = collection.insert([student1, student2])
print(result)
# 返回的結(jié)果是對(duì)應(yīng)的_id的集合，運(yùn)行結(jié)果：
# [ObjectId('5932a80115c2606a59e8a048'), ObjectId('5932a80115c2606a59e8a049')]
# 實(shí)際上在PyMongo 3.X版本中昧穿，insert()方法官方已經(jīng)不推薦使用了勺远，當(dāng)然繼續(xù)使用也沒(méi)有什么問(wèn)題，
# 官方推薦使用insert_one()和insert_many()方法將插入單條和多條記錄分開时鸵。
 
student = {
    'id': '20170101',
    'name': 'Jordan',
    'age': 20,
    'gender': 'male'
}
 
result = collection.insert_one(student)
print(result)
print(result.inserted_id)
# 運(yùn)行結(jié)果：
# <pymongo.results.InsertOneResult object at 0x10d68b558>
# 5932ab0f15c2606f0c1cf6c5
# 返回結(jié)果和insert()方法不同胶逢，這次返回的是InsertOneResult對(duì)象，我們可以調(diào)用其inserted_id屬性獲取_id饰潜。
 
# 對(duì)于insert_many()方法初坠，我們可以將數(shù)據(jù)以列表形式傳遞即可，示例如下：
 
student1 = {
    'id': '20170101',
    'name': 'Jordan',
    'age': 20,
    'gender': 'male'
}
 
student2 = {
    'id': '20170202',
    'name': 'Mike',
    'age': 21,
    'gender': 'male'
}
 
result = collection.insert_many([student1, student2])
print(result)
print(result.inserted_ids)
# insert_many()方法返回的類型是InsertManyResult彭雾，調(diào)用inserted_ids屬性可以獲取插入數(shù)據(jù)的_id列表碟刺，運(yùn)行結(jié)果：
 
# <pymongo.results.InsertManyResult object at 0x101dea558>
# [ObjectId('5932abf415c2607083d3b2ac'), ObjectId('5932abf415c2607083d3b2ad')]
# 查詢，插入數(shù)據(jù)后我們可以利用find_one()或find()方法進(jìn)行查詢薯酝，find_one()查詢得到是單個(gè)結(jié)果半沽，find()則返回多個(gè)結(jié)果爽柒。
 
result = collection.find_one({'name': 'Mike'})
print(type(result))
print(result)
# 在這里我們查詢name為Mike的數(shù)據(jù)，它的返回結(jié)果是字典類型者填，運(yùn)行結(jié)果：
# <class'dict'>
# {'_id': ObjectId('5932a80115c2606a59e8a049'), 'id': '20170202', 'name': 'Mike', 'age': 21, 'gender': 'male'}
# 可以發(fā)現(xiàn)它多了一個(gè)_id屬性浩村，這就是MongoDB在插入的過(guò)程中自動(dòng)添加的。
 
# 我們也可以直接根據(jù)ObjectId來(lái)查詢占哟，這里需要使用bson庫(kù)里面的ObjectId心墅。
 
from bson.objectid import ObjectId
 
result = collection.find_one({'_id': ObjectId('593278c115c2602667ec6bae')})
print(result)
# 其查詢結(jié)果依然是字典類型，運(yùn)行結(jié)果：
 
# {' ObjectId('593278c115c2602667ec6bae'), 'id': '20170101', 'name': 'Jordan', 'age': 20, 'gender': 'male'}
# 當(dāng)然如果查詢_id':結(jié)果不存在則會(huì)返回None榨乎。
 
# 對(duì)于多條數(shù)據(jù)的查詢怎燥，我們可以使用find()方法，例如在這里查找年齡為20的數(shù)據(jù)蜜暑，示例如下：
 
results = collection.find({'age': 20})
print(results)
for result in results:
    print(result)
# 運(yùn)行結(jié)果：
 
# <pymongo.cursor.Cursor object at 0x1032d5128>
# {'_id': ObjectId('593278c115c2602667ec6bae'), 'id': '20170101', 'name': 'Jordan', 'age': 20, 'gender': 'male'}
# {'_id': ObjectId('593278c815c2602678bb2b8d'), 'id': '20170102', 'name': 'Kevin', 'age': 20, 'gender': 'male'}
# {'_id': ObjectId('593278d815c260269d7645a8'), 'id': '20170103', 'name': 'Harden', 'age': 20, 'gender': 'male'}
# 返回結(jié)果是Cursor類型铐姚，相當(dāng)于一個(gè)生成器，我們需要遍歷取到所有的結(jié)果肛捍，每一個(gè)結(jié)果都是字典類型谦屑。
 
# 如果要查詢年齡大于20的數(shù)據(jù)，則寫法如下：
 
results = collection.find({'age': {'$gt': 20}})
# 在這里查詢的條件鍵值已經(jīng)不是單純的數(shù)字了篇梭，而是一個(gè)字典，其鍵名為比較符號(hào)$gt酝枢，意思是大于恬偷，鍵值為20，這樣便可以查詢出所有
# 年齡大于20的數(shù)據(jù)帘睦。
 
# 在這里將比較符號(hào)歸納如下表：
"""
符號(hào)含義示例
$lt小于{'age': {'$lt': 20}}
$gt大于{'age': {'$gt': 20}}
$lte小于等于{'age': {'$lte': 20}}
$gte大于等于{'age': {'$gte': 20}}
$ne不等于{'age': {'$ne': 20}}
$in在范圍內(nèi){'age': {'$in': [20, 23]}}
$nin不在范圍內(nèi){'age': {'$nin': [20, 23]}}
"""
# 另外還可以進(jìn)行正則匹配查詢袍患，例如查詢名字以M開頭的學(xué)生數(shù)據(jù)，示例如下：
 
results = collection.find({'name': {'$regex': '^M.*'}})
# 在這里使用了$regex來(lái)指定正則匹配竣付，^M.*代表以M開頭的正則表達(dá)式诡延，這樣就可以查詢所有符合該正則的結(jié)果。
 
# 在這里將一些功能符號(hào)再歸類如下：
"""
符號(hào)含義示例示例含義
$regex匹配正則{'name': {'$regex': '^M.*'}}name以M開頭
$exists屬性是否存在{'name': {'$exists': True}}name屬性存在
$type類型判斷{'age': {'$type': 'int'}}age的類型為int
$mod數(shù)字模操作{'age': {'$mod': [5, 0]}}年齡模5余0
$text文本查詢{'$text': {'$search': 'Mike'}}text類型的屬性中包含Mike字符串
$where高級(jí)條件查詢{'$where': 'obj.fans_count == obj.follows_count'}自身粉絲數(shù)等于關(guān)注數(shù)
"""
# 這些操作的更詳細(xì)用法在可以在MongoDB官方文檔找到：
# https://docs.mongodb.com/manual/reference/operator/query/
 
# 計(jì)數(shù)
# 要統(tǒng)計(jì)查詢結(jié)果有多少條數(shù)據(jù)古胆，可以調(diào)用count()方法肆良，如統(tǒng)計(jì)所有數(shù)據(jù)條數(shù)：
 
count = collection.find().count()
print(count)
# 或者統(tǒng)計(jì)符合某個(gè)條件的數(shù)據(jù)：
 
count = collection.find({'age': 20}).count()
print(count)
# 排序
# 可以調(diào)用sort方法，傳入排序的字段及升降序標(biāo)志即可逸绎，示例如下：
 
results = collection.find().sort('name', pymongo.ASCENDING)
print([result['name'] for result in results])
# 運(yùn)行結(jié)果：
 
# ['Harden', 'Jordan', 'Kevin', 'Mark', 'Mike']
# 偏移,可能想只取某幾個(gè)元素惹恃，在這里可以利用skip()方法偏移幾個(gè)位置，比如偏移2棺牧，就忽略前2個(gè)元素巫糙，得到第三個(gè)及以后的元素。
 
results = collection.find().sort('name', pymongo.ASCENDING).skip(2)
print([result['name'] for result in results])
# 運(yùn)行結(jié)果：
# ['Kevin', 'Mark', 'Mike']
# 另外還可以用limit()方法指定要取的結(jié)果個(gè)數(shù)颊乘，示例如下：
 
results = collection.find().sort('name', pymongo.ASCENDING).skip(2).limit(2)
print([result['name'] for result in results])
# 運(yùn)行結(jié)果：
# ['Kevin', 'Mark']
# 如果不加limit()原本會(huì)返回三個(gè)結(jié)果参淹，加了限制之后醉锄，會(huì)截取2個(gè)結(jié)果返回。
 
# 值得注意的是浙值，在數(shù)據(jù)庫(kù)數(shù)量非常龐大的時(shí)候恳不，如千萬(wàn)、億級(jí)別亥鸠，最好不要使用大的偏移量來(lái)查詢數(shù)據(jù)妆够，很可能會(huì)導(dǎo)致內(nèi)存溢出，
# 可以使用類似find({'_id': {'$gt': ObjectId('593278c815c2602678bb2b8d')}}) 這樣的方法來(lái)查詢负蚊，記錄好上次查詢的_id神妹。
 
# 更新
# 對(duì)于數(shù)據(jù)更新可以使用update()方法，指定更新的條件和更新后的數(shù)據(jù)即可家妆，例如：
 
condition = {'name': 'Kevin'}
student = collection.find_one(condition)
student['age'] = 25
result = collection.update(condition, student)
print(result)
# 在這里我們將name為Kevin的數(shù)據(jù)的年齡進(jìn)行更新鸵荠，首先指定查詢條件，然后將數(shù)據(jù)查詢出來(lái)伤极，修改年齡蛹找，
# 之后調(diào)用update方法將原條件和修改后的數(shù)據(jù)傳入，即可完成數(shù)據(jù)的更新哨坪。
 
# 運(yùn)行結(jié)果：
 
# {'ok': 1, 'nModified': 1, 'n': 1, 'updatedExisting': True}
# 返回結(jié)果是字典形式庸疾，ok即代表執(zhí)行成功，nModified代表影響的數(shù)據(jù)條數(shù)当编。
 
# 另外update()方法其實(shí)也是官方不推薦使用的方法届慈，在這里也分了update_one()方法和update_many()方法，用法更加嚴(yán)格忿偷，
# 第二個(gè)參數(shù)需要使用$類型操作符作為字典的鍵名金顿，我們用示例感受一下。
 
condition = {'name': 'Kevin'}
student = collection.find_one(condition)
student['age'] = 26
result = collection.update_one(condition, {'$set': student})
print(result)
print(result.matched_count, result.modified_count)
# 在這里調(diào)用了update_one方法鲤桥，第二個(gè)參數(shù)不能再直接傳入修改后的字典揍拆，而是需要使用{'$set': student}這樣的形式，
# 其返回結(jié)果是UpdateResult類型茶凳，然后調(diào)用matched_count和modified_count屬性分別可以獲得匹配的數(shù)據(jù)條數(shù)和影響的數(shù)據(jù)條數(shù)嫂拴。
 
# 運(yùn)行結(jié)果：
#
# <pymongo.results.UpdateResult object at 0x10d17b678>
# 1 0
# 我們?cè)倏匆粋€(gè)例子：
 
condition = {'age': {'$gt': 20}}
result = collection.update_one(condition, {'$inc': {'age': 1}})
print(result)
print(result.matched_count, result.modified_count)
# 在這里我們指定查詢條件為年齡大于20，然后更新條件為{'$inc': {'age': 1}}贮喧，執(zhí)行之后會(huì)講第一條符合條件的數(shù)據(jù)年齡加1顷牌。
 
# 運(yùn)行結(jié)果：
#
# <pymongo.results.UpdateResult object at 0x10b8874c8>
# 1 1
# 可以看到匹配條數(shù)為1條，影響條數(shù)也為1條塞淹。
 
# 如果調(diào)用update_many()方法窟蓝，則會(huì)將所有符合條件的數(shù)據(jù)都更新，示例如下：
 
condition = {'age': {'$gt': 20}}
result = collection.update_many(condition, {'$inc': {'age': 1}})
print(result)
print(result.matched_count, result.modified_count)
# 這時(shí)候匹配條數(shù)就不再為1條了，運(yùn)行結(jié)果如下：
#
# <pymongo.results.UpdateResult object at 0x10c6384c8>
# 3 3
# 可以看到這時(shí)所有匹配到的數(shù)據(jù)都會(huì)被更新运挫。
 
# 刪除
# 刪除操作比較簡(jiǎn)單状共，直接調(diào)用remove()方法指定刪除的條件即可，符合條件的所有數(shù)據(jù)均會(huì)被刪除谁帕，示例如下：
 
result = collection.remove({'name': 'Kevin'})
print(result)
# 運(yùn)行結(jié)果：
#
# {'ok': 1, 'n': 1}
# 另外依然存在兩個(gè)新的推薦方法峡继，delete_one()和delete_many()方法，示例如下：
 
result = collection.delete_one({'name': 'Kevin'})
print(result)
print(result.deleted_count)
result = collection.delete_many({'age': {'$lt': 25}})
print(result.deleted_count)
# 運(yùn)行結(jié)果：
 
# <pymongo.results.DeleteResult object at 0x10e6ba4c8>
# 1
# 4
# delete_one()即刪除第一條符合條件的數(shù)據(jù)匈挖，delete_many()即刪除所有符合條件的數(shù)據(jù)碾牌，返回結(jié)果是DeleteResult類型，
# 可以調(diào)用deleted_count屬性獲取刪除的數(shù)據(jù)條數(shù)儡循。
 
# 更多
# 另外PyMongo還提供了一些組合方法舶吗，如find_one_and_delete()、find_one_and_replace()择膝、find_one_and_update()誓琼，
# 就是查找后刪除、替換肴捉、更新操作腹侣，用法與上述方法基本一致。
 
# 另外還可以對(duì)索引進(jìn)行操作齿穗，如create_index()傲隶、create_indexes()、drop_index()等窃页。
 
# 詳細(xì)用法可以參見官方文檔：http://api.mongodb.com/python/current/api/pymongo/collection.html
 
# 另外還有對(duì)數(shù)據(jù)庫(kù)伦籍、集合本身以及其他的一些操作，在這不再一一講解腮出，可以參見
# 官方文檔：http://api.mongodb.com/python/current/api/pymongo/
···