Python: Windows 7 64位 安装、使用 pymongo 3.2

官网tutorial:  http://api.mongodb.com/python/current/tutorial.html

本教程将要告诉你如何使用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数据.常规字符串(<type ‘str’>)都是有效的,可以不改变直接保存。
    Unicode字符串(<type ‘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/

原文地址:https://www.cnblogs.com/billyzh/p/5918598.html