mongodb cxx driver学习

目录

• mongodb学习
  • 概念
  • 集群
  • 副本集
• 安装
• API学习
  • MONGO C API
  • MONGO CXX API
• 概念
  • 增删改查
  • tutorial
• 参考文献

mongodb学习

概念

- oplog 主节点的操作记录，幂等性
- mongod mongo后台进程
- secondary节点 副本集中的非主结点

集群

- 功能
    - 数据冗余
    - 读写分离？
- 缺点
    - 容错性差

副本集

- 概念
    - 一组有相同数据的mongodb实例，只有主实例执行写操作，其它实例保持同步；主可读写，其它节点只可读
- 功能
    - 自动容错(auto-failover)
    - 自动恢复(auto-recovery)
    - 读写分离
        - connection string的options里添加readPreference=secondaryPreferred
    - 数据冗余
- 缺点
    - 待补充
- 注意事项
    - 如果使用当前主节点地址建立连接，当当前主节点失效(降级为secondary节点)，客户端将无法执行写操作
    - 使用 副本集方式 连接副本集
        - connection string的options里添加replicaSet=xxx
            - replicaSet参数指定，要连接的是一个副本集，但只提供了一个在这个副本集中的ip:host，是什么行为？
            - 如果不传这个参数，至少提供了两个在这个副本集中的ip:host，通过mongo driver可以检测是否为副本集
            - 如果不传这个参数，只提供了一个在这个副本集中的ip:host，mongo driver只会连接这一个ip:host
- driver建立连接的过程
    - 参考了下面文献中stackoverflow.com的一个提问，但没有分析过cxx driver代码和验证
    - 如果seed list中有多个ip:host，driver会检测使用哪种连接方式(replicaSet还是sharding)
    - 如果检测到是replicaset，driver会通过seed list中的结点找到主节点
    - 然后driver更新replicaset中的结点，并动态维持最新的状态

安装

• mongo-c-driver

  • 是安装mongo-cxx-driver的基础
  • 根据使用的mongo-cxx-driver，确定mongo-c-driver版本，可参考mongo-cxx-driver发布页面
  • 两个库都使用cmake编译， yum install cmake3
  • cmake3 -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF -DCMAKE_BUILD_TYPE=Release ..

• mongo-cxx-driver

  • 注意与mongo-c-driver相匹配
  • cmake3 -DCMAKE_BUILD_TYPE=Release -DBSONCXX_POLY_USE_BOOST=1 -DCMAKE_INSTALL_PREFIX=/usr/local ..

• 参考

  • http://mongoc.org/libmongoc/current/installing.html
  • http://mongocxx.org/mongocxx-v3/installation/
  • https://github.com/mongodb/mongo-c-driver/releases/tag/1.10.1
  • https://github.com/mongodb/mongo-cxx-driver/releases/tag/r3.3.1

API学习

MONGO C API

• 使用文档

  • http://mongoc.org/libmongoc/1.10.1/index.html

• 连接池参数

  • http://mongoc.org/libmongoc/1.10.1/mongoc_uri_t.html#connection-pool-options

MONGO CXX API

概念

增删改查

• insert 向集合中增加一个文档
• remove 删除文档
• update 更新（修改）某些文档
  • 文档替换
  • 文档修改器，只修改文档某个部分
• find 返回集合中所有文档
• findOne 返回集合中的某一个文档

tutorial

• 建立连接
  • mongocxx::instance
  • mongocxx::uri
  • mongocxx::client
• 访问数据库、集合
  • 使用 []操作符
  • database()方法、collection()方法
• 访问文档中的fields
  • 使用 []操作符
  • 返回的是bsoncxx::document::element
  • 如何判断是否返回有效值？（有这个fields）
  • 由element转换为代码中使用的各种类型？

bsoncxx::document::element element = view["name"];
if(element.type() != bsoncxx::type::k_utf8) {
  // Error
}
std::string name = element.get_utf8().value.to_string();

• bsoncxx::type中规定的类型

  • k_utf8 string类型？
  • 待补充
  • 待补充
  • 待补充

• 创建BSON文档的方法

  • bsoncxx::builder::stream
  • bsoncxx::builder::basic
  • one-off builder functions

using bsoncxx::builder::basic::kvp;

// { "hello": "world" }
bsoncxx::document::value document = bsoncxx::builder::basic::make_document(kvp("hello", "world"));

• 文档的两种存在状态
  • bsoncxx::document::value
  • bsoncxx::document::view
    • view转换成string

stdx::string_view view = e.get_utf8().value;
string name = view.to_string();

• 在集合中查询文档
  • find
    • 返回mongocxx::cursor
  • find_one
    • 返回std::optionalbsoncxx::document::value
    • 因此判断是否存在这个field只需像指针是否为空那样
    • 将返回的结果转换成json, bsoncxx::to_json()
• 插入、更新、删除文档
  • insert_many insert_one
  • update_many update_one
  • delete_many delete_one
• 多线程与连接池
  • 每个线程都有独立的client及其子类

参考文献

http://mongocxx.org/

https://stackoverflow.com/questions/35920013/new-c-mongo-driver-how-to-see-type-and-how-to-get-string-value

Mongodb主从复制/ 副本集/分片集群介绍

Connection String URI

https://docs.mongodb.com/ecosystem/drivers/

[MongoDB Connection String to Replica Set](MongoDB Connection String to Replica Set)

https://mongodb-documentation.readthedocs.io/en/latest/reference/connection-string.html#uri.replicaSet

https://stackoverflow.com/questions/23958759/mongodb-connection-string-to-replica-set