對于支持讀取的數(shù)據(jù)類型，數(shù)據(jù)集成在讀取時：

• 基本類型的數(shù)據(jù)，會根據(jù)同步任務配置的讀取字段（column，詳見下文的附錄：MongoDB腳本Demo與參數(shù)說明）中的name自動讀取對應path下的數(shù)據(jù)，并根據(jù)數(shù)據(jù)類型做自動轉換，您無需指定column的type屬性。

  類型	離線讀（MongoDB Reader）	說明
  ObjectId	支持	對象ID類型。
  Double	支持	64位浮點數(shù)類型。
  32-bit integer	支持	32位整數(shù)。
  64-bit integer	支持	64位整數(shù)。
  Decimal128	支持	Decimal128類型。 說明 如果配置為嵌套類型、Combine類型，JSON序列化時會被當做對象處理，需增加參數(shù)decimal128OutputType為bigDecimal，才能輸出為decimal。
  String	支持	字符串類型。
  Boolean	支持	布爾類型。
  Timestamp	支持	時間戳類型。 說明 BsonTimestamp存儲的是時間戳，無需考慮時區(qū)影響，詳情請參見MongoDB中的時區(qū)問題。
  Date	支持	日期類型。

• 部分復雜類型的數(shù)據(jù)，您可通過配置column的type屬性，進行自定義處理。

  類型	離線讀（MongoDB Reader）	說明
  Document	支持	嵌入文檔類型。 如果沒有配置type屬性，則直接將Document轉JSON序列化處理。 如果配置了type屬性為document，則屬于嵌套類型，MongoDB Reader會按path讀取Document屬性。詳細示例請參見下文的數(shù)據(jù)類型示例2：遞歸解析處理多層嵌套的Document。
  Array	支持	數(shù)組類型。 如果type配置為array.json、arrays，直接JSON序列化處理。 如果type配置為array、document.array，則拼接為字符串，分隔符（column中的splitter）默認為英文逗號。

  重要

  數(shù)據(jù)集成本身不支持數(shù)組類型，但MongoDB支持數(shù)組類型，并且數(shù)組類型具有強大的索引功能。您可以通過參數(shù)的特殊配置，將字符串轉換為MongoDB中的數(shù)組。轉換類型后，即可并行寫入MongoDB。

結合上文可見，MongoDB Reader針對MongoDB類型的轉換列表，如下表所示。

MongoDB Reader插件的Combine數(shù)據(jù)類型支持將MongoDB document中的多個字段合并成一個JSON串。例如，導入MongoDB中的字段至MaxCompute，有字段如下（下文均省略了value使用key來代替整個字段）的三個document，其中a、b是所有document均有的公共字段，x_n是不固定字段。

• doc1： a b x_1 x_2

• doc2: a b x_2 x_3 x_4

• doc3: a b x_5

配置文件中要明確指出需要一一對應的字段，需要合并的字段則需另取名稱（不可以與document中已存在字段同名），并指定類型為COMBINE，如下所示。

"column": [
{
"name": "a",
"type": "string",
},
{
"name": "b",
"type": "string",
},
{
"name": "doc",
"type": "combine",
}
]

最終導出的MaxCompute結果如下所示。

當MongoDB中Document存在多層嵌套時，可通過配置document類型進行遞歸解析處理。示例如下：

• MongoDB源端數(shù)據(jù)為：

  {
      "name": "name1",
      "a":
      {
          "b":
          {
              "c": "this is value"
          }
      }
  }

• MongoDB列可配置為：

  {"name":"_id","type":"string"}
  {"name":"name","type":"string"}
  {"name":"a.b.c","type":"document"}

  

如上配置，可將源端嵌套字段a.b.c的值寫入目標端c字段中，同步任務運行后，目標端寫入數(shù)據(jù)為this is value。

配置一個從MongoDB抽取數(shù)據(jù)到本地的作業(yè)，詳情請參見下文的參數(shù)說明。

{
    "type":"job",
    "version":"2.0",//版本號。
    "steps":[
        {
            "category": "reader",
            "name": "Reader",
            "parameter": {
                "datasource": "datasourceName", //數(shù)據(jù)源名稱。
                "collectionName": "tag_data", //集合名稱。
                "query": "", // 數(shù)據(jù)查詢過濾。
                "column": [
                    {
                        "name": "unique_id", //字段名稱。
                        "type": "string" //字段類型。
                    },
                    {
                        "name": "sid",
                        "type": "string"
                    },
                    {
                        "name": "user_id",
                        "type": "string"
                    },
                    {
                        "name": "auction_id",
                        "type": "string"
                    },
                    {
                        "name": "content_type",
                        "type": "string"
                    },
                    {
                        "name": "pool_type",
                        "type": "string"
                    },
                    {
                        "name": "frontcat_id",
                        "type": "array",
                        "splitter": ""
                    },
                    {
                        "name": "categoryid",
                        "type": "array",
                        "splitter": ""
                    },
                    {
                        "name": "gmt_create",
                        "type": "string"
                    },
                    {
                        "name": "taglist",
                        "type": "array",
                        "splitter": " "
                    },
                    {
                        "name": "property",
                        "type": "string"
                    },
                    {
                        "name": "scorea",
                        "type": "int"
                    },
                    {
                        "name": "scoreb",
                        "type": "int"
                    },
                    {
                        "name": "scorec",
                        "type": "int"
                    },
                    {
                        "name": "a.b",
                        "type": "document.int"
                    },
                    {
                        "name": "a.b.c",
                        "type": "document.array",
                        "splitter": " "
                    }
                ]
            },
            "stepType": "mongodb"
        },
        { 
            "stepType":"stream",
            "parameter":{},
            "name":"Writer",
            "category":"writer"
        }
    ],
    "setting":{
        "common": { 
            "column": { 
                "timeZone": "GMT+0" //時區(qū)
            } 
        },
        "errorLimit":{
            "record":"0"http://錯誤記錄數(shù)。
        },
        "speed":{
            "throttle":true,//當throttle值為false時，mbps參數(shù)不生效，表示不限流；當throttle值為true時,表示限流。
            "concurrent":1 //作業(yè)并發(fā)數(shù)。
            "mbps":"12"http://限流，此處1mbps = 1MB/s。
        }
    },
    "order":{
        "hops":[
            {
                "from":"Reader",
                "to":"Writer"
            }
        ]
    }
}

配置寫入MongoDB的數(shù)據(jù)同步作業(yè)，詳情請參見下文的參數(shù)說明。

{
    "type": "job",
    "version": "2.0",//版本號。
    "steps": [
        {
            "stepType": "stream",
            "parameter": {},
            "name": "Reader",
            "category": "reader"
        },
        {
            "stepType": "mongodb",//插件名。
            "parameter": {
                "datasource": "",//數(shù)據(jù)源名。
                "column": [
                    {
                        "name": "_id",//列名。
                        "type": "ObjectId"http://數(shù)據(jù)類型。如果replacekey為_id，則此處的type必須配置為ObjectID。如果配置為string，會無法進行替換。
                    },
                    {
                        "name": "age",
                        "type": "int"
                    },
                    {
                        "name": "id",
                        "type": "long"
                    },
                    {
                        "name": "wealth",
                        "type": "double"
                    },
                    {
                        "name": "hobby",
                        "type": "array",
                        "splitter": " "
                    },
                    {
                        "name": "valid",
                        "type": "boolean"
                    },
                    {
                        "name": "date_of_join",
                        "format": "yyyy-MM-dd HH:mm:ss",
                        "type": "date"
                    }
                ],
                "writeMode": {//寫入模式。
                    "isReplace": "true",
                    "replaceKey": "_id"
                },
                "collectionName": "datax_test"http://連接名稱。
            },
            "name": "Writer",
            "category": "writer"
        }
    ],
    "setting": {
        "errorLimit": {//錯誤記錄數(shù)。
            "record": "0"
        },
        "speed": {
            "throttle": true,//當throttle值為false時，mbps參數(shù)不生效，表示不限流；當throttle值為true時,表示限流。
            "concurrent": 1,//作業(yè)并發(fā)數(shù)。
            "mbps": "1"http://限流的速度，此處1mbps = 1MB/s。
        }，
       "jvmOption": "-Xms1024m -Xmx1024m"
    },
    "order": {
        "hops": [
            {
                "from": "Reader",
                "to": "Writer"
            }
        ]
    }
}

After applying the update, the (immutable) field '_id' was found to have been altered to _id: "2"

執(zhí)行數(shù)據(jù)集成作業(yè)時，會首先執(zhí)行您已配置的preSql。完成preSql的執(zhí)行后，才可以進入實際的數(shù)據(jù)寫出階段。preSql本身不會影響寫出的數(shù)據(jù)內容。數(shù)據(jù)集成通過preSql參數(shù)，可以具備冪等執(zhí)行特性。例如，您的preSql在每次任務執(zhí)行前都會清理歷史數(shù)據(jù)（根據(jù)您的業(yè)務規(guī)則進行清理）。此時，如果任務失敗，您只需要重新執(zhí)行數(shù)據(jù)集成作業(yè)即可。

preSql的格式要求如下：

• 需要配置type字段，表示前置操作類別，支持drop和remove，例如"preSql":{"type":"remove"}：

  • drop：表示刪除集合和集合內的數(shù)據(jù)，collectionName參數(shù)配置的集合即是待刪除的集合。

  • remove：表示根據(jù)條件刪除數(shù)據(jù)。

  • json：您可以通過JSON控制待刪除的數(shù)據(jù)條件，例如"preSql":{"type":"remove", "json":"{'operationTime':{'$gte':ISODate('${last_day}T00:00:00.424+0800')}}"}。此處的${last_day}為DataWorks調度參數(shù)，格式為$[yyyy-mm-dd]。您可以根據(jù)需要具體使用其它MongoDB支持的條件操作符號（$gt、$lt、$gte和$lte等）、邏輯操作符（and和or等）或函數(shù)（max、min、sum、avg和ISODate等）。

    數(shù)據(jù)集成通過如下MongoDB標準API執(zhí)行您的數(shù)據(jù)，刪除query。

    query=(BasicDBObject) com.mongodb.util.JSON.parse(json);        
    col.deleteMany(query);

    說明

    如果您需要條件刪除數(shù)據(jù)，建議優(yōu)先使用JSON配置形式。

  • item：您可以在item中配置數(shù)據(jù)過濾的列名（name）、條件（condition）和列值（value）。例如"preSql":{"type":"remove","item":[{"name":"pv","value":"100","condition":"$gt"},{"name":"pid","value":"10"}]}。

    數(shù)據(jù)集成會基于您配置的item條件項，構造查詢query條件，進而通過MongoDB標準API執(zhí)行刪除。例如col.deleteMany(query);。

• 不識別的preSql，無需進行任何前置刪除操作。