YaoDocs

外观

mongo ​

在environment中配置mongo连接信息 ​

基本配置：

json
"name": "mongo",
"label": "mongo",
"version": "1.0.0",
"type": "mongo"
"options": {
  "hosts": [{
    "host": "mongo",
    "port": 27017,//默认
    "user": "",//required
    "pass": ""//required
  }],
  "params": {},
  "user": "",
  "db": "",
  "timeout": 10000
}

配置项支持引用环境变量配置： ​

json
"name": "mongo",
"label": "mongo",
"version": "1.0.0",
"type": "mongo"
"options": {
  "hosts": [{
    "host": "$ENV.MONGO_HOST",
    "port": "$ENV.MONGO_PORT",
    "user": "$ENV.MONGO_USER",
    "pass": "$ENV.MONGO_PASS"
  }],
  "params": {},
  "user": "",
  "db": "$ENV.MONGO_DB",
  "timeout": "$ENV.MONGO_TIMEOUT"
}

在目录 connectors 下创建一个 Products.conn.yao 文件，内容如下。需要特别注意有部分的设置：

  • 数据库名称配置。这需要在options里配置的 db 名，需要和 mongodb 里配置的 db 名一致。

  • Collection 名称的配置，它的配置名称是connector配置文件的 ID。在这个示例中它的 ID 是Products,取.mongo.yao前面的信息。这里的 Products 对应 mongodb 中的 collection.Products 名称。如果在数据库中 Collection 不存在，会自动的创建。

  • 用户名密码，需要设置数据库访问的用户名密码，这个是必须要设置的，不能使用空用户名或是空密码。

如果有多个 collection,每一个 collection 创建一个配置文件。

json
{
  "LANG": "1.0.0",
  "VERSION": "1.0.0",
  "label": "Mongo TEST",
  "type": "mongo",
  "options": {
    "db": "odataserver", //配置数据库名称
    "hosts": [
      {
        "host": "$ENV.MONGO_TEST_HOST",
        "port": "$ENV.MONGO_TEST_PORT",
        "user": "$ENV.MONGO_TEST_USER",
        "pass": "$ENV.MONGO_TEST_PASS"
      }
    ],
    "params": { "maxPoolSize": 20, "w": "majority" } //配置其它参数
  }
}

在环境变量文件.env 中配置连接信息

sh
MONGO_TEST_HOST=127.0.0.1
MONGO_TEST_PORT=27017
MONGO_TEST_USER="admin"
MONGO_TEST_PASS="admin"

另外需要注意的是，这里的 mongodb 是用于 key-value 的存储，YAO 会自动的为Collection创建一个key的唯一索引。保存的数据结构为以下结构,所以Collection数据结构中一定要有一个唯一的 key 值。

json
{
  "key": "",
  "value": ""
}

所以它只适用于 key-value 数据结构，并不适用于其它的结构数据保存。