pymongo模块详解（含官方文档翻译）

• github

  pymongo支持MongoDB 2.6, 3.0, 3.2, 3.4, 3.6 and 4.0.

• PyMongo 3.8.0 Documentation

  1. 建立与MongoClient的连接

     使用PyMongo的第一步是创建一个MongoClient来运行mongod实例。很简单

     from pymongo import MongoClient
     client = MongoClient()
     

     上述代码采用默认host和port，我们也可以制定host和port，例如:

     client = MongoClient('localhost', 27017)
     

     或者采用MongoDB URL格式：

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

  2. 获取一个数据库Database

     一个MongoDB实例可以支持多种独立数据库，当使用pymongo你可以用针对MongoClient实例采用属性风格连接到数据库：

     db = client.test_database
     

     如果你的数据库名字是这样的（例如test-database），导致无法采用属性方式连接，可以采用字典方式连接：

     db = client['test-database']
     

  3. 获取一个连接Collection

     Collection是存储在MongoDB中的一组文档，可以粗略的理解为关系型数据库中的table，在pymongo中实现连接方式与获取数据库一样：

     collection = db.test_collection
     # or
     collection = db['test-collection']
     

     MongoDB中关于collections和database有个重要特点：他们都是lazily创建的，上述所有命令都不会对服务器产生实际操作。

     只有在第一个document被嵌入后，Collections和databases才会被创建。

  4. Documents

     MongoDB中的数据采用类JSON格式存储或表示。在PyMongo中我们用字典表示documents。例如下面的字典可以用来表示一个博客帖子：

     import datetime
     post = {
            
            'author': 'Mike',
            'text': 'My first blog post',
            'tags': ['Mongodb', 'python', 'pymongo'],
            'date': datetime.datetime.utcnow()}
     

     documents可以含有原生Python类型（例如datetime.datetime实例），他们可以自动转化为对应的BSON类型。

  5. 插入一个Documents

     用insert_one()方法将一个document嵌入到collection中。

     posts = db.posts
     post_id = posts.insert_one(