时序多值模型

多值的模型是针对数据源建模，我们每一行数据针对的是一个数据源，它的被测量的多个指标在同一列上，所以每一个数据源，数据的来源在每一个时间点上都有一行，这就是多值的模型。比如某个机器的cpu ，mem 和load 指标。每次是数据操作可以使用多个指标数据。

多值模型数据写入

请求路径和方法

注意：

• 多值模型数据和原来写入的单值模型数据不兼容。单值模型数据需要通过原有的 /api/put 进口进行写入。同时多值写入数据需要通过 /api/mquery 接口进行查询，单值写入的数据需要通过 /api/query 进行查询。

请求参数

注意：

• 所有“无类型”的参数，只要提供，都被视为 true，比如 summary=false 以及 summary=true 都被当做 summary=true。
• 如果 details 和 summary 都设置，API 将返回 details 信息。

  请求内容

  数据点格式为 JSON 格式，各参数说明如下：

时间戳说明

本说明适用于读写数据 (/api/put & /api/mput) 和查询数据 (/api/query & /api/mquery) 两个接口。时间戳的单位可以是秒或者毫秒。TSDB 会通过数值大小来判断时间戳的单位，规则如下：

• 时间戳区间为 [4284768,9999999999]: 判断为秒，表示的时间区间为: [1970-02-20 00:59:28, 2286-11-21 01:46:39]
• 时间戳区间为 [10000000000,9999999999999]：判断为毫秒，表示的时间区间为: [1970-04-27 01:46:40.000, 2286-11-21 01:46:39.999]
• 时间戳区间为 (-∞,4284768)和(9999999999999,+∞)：判断为非法时间戳区间

  数据点值说明

• 在同一个metric下，一个field只允许写入同一种数据类型
• String数值类型的数据值可以为任意字符，支持JSON字符串存储，最大为20KB

  写入数据示例

  请求：POST/api/mput请求体：

   [
       {
           "metric" : "wind",
           "fields" : {
               "speed" : 20.8,
               "level" : 4,
               "direction" : "East",
               "description" : "Fresh breeze"
           },
           "tags" : {
                 "sensor":"IOTE_8859_0001",
               "city":"hangzhou",
                "province":"zhejiang",
               "country":"china"
           },
           "timestamp" : 1346846400
       },
       {
           "metric" : "wind",
           "fields" : {
               "speed" : 40.2,
               "level" : 6,
               "direction" : "South",
               "description" : "Fresh breeze"
           },
           "tags" : {
               "sensor":"IOTE_8859_0002",
                  "city":"hangzhou",
                  "province":"zhejiang",
               "country":"china"
           },
           "timestamp" : 1346846401
       }
   ]

  响应说明

  如果所有数据点写入成功，返回码为204，如果有部分写入失败，返回码400，响应内容为具体错误信息。如果请求参数包含 summary 或者 details，返回信息包括如下属性：名称|数据类型|描述-|-|-success|Integer|写入成功的数据点数failed|Integer|未写入的数据点数errors|Array|一个描述哪些数据点未写入以及其原因的数组，仅在指定 details 有效。

  响应示例

  指定 summary 的响应示例：

  请求： POST/api/mput?summary请求体：

```json Invalid Timestamp [ { “metric” : “wind”, “fields” : { “speed” : 50.2, “level” : 7, “direction” : “North”, “description” : “Fresh breeze” }, “tags” : { “sensor”:”IOTE_8859_0003”, “city”:”hangzhou”, “province”:”zhejiang”, “country”:”china” }, “timestamp” : 401 } ]

**响应内容：**
```json
        {
            "failed": 1,
            "success": 0
        }

表示0个点写入成功，1个点写入失败。

指定 details 的返回示例：

请求：POST/api/mput?details请求体：

    [
        {
            "metric" : "wind",
            "fields" : {
                "speed" : 50.2_string,
                "level" : 7,
                "direction" : "North",
                "description" : "Fresh breeze"
            },
            "tags" : {
                "sensor":"IOTE_8859_0003",
                   "city":"hangzhou",
                   "province":"zhejiang",
                "country":"china"
            },
            "timestamp" : 400
        }
    ]

响应内容：

        {
            "errors": [
                {
                    "datapoint": {
                        "metric" : "wind",
                        "fields" : {
                            "speed" : 50.2,
                            "level" : 7,
                            "direction" : "North",
                            "description" : "Fresh breeze"
                        },
                        "tags" : {
                            "sensor":"IOTE_8859_0003",
                               "city":"hangzhou",
                               "province":"zhejiang",
                            "country":"china"
                        },
                        "timestamp" : 400
                    },
                    "error": "Invalid timestamp"
                }
            ],
            "failed": 1,
            "success": 0
        }

表示0个点写入成功，1个点写入失败。失败的点由 datapoint 指定。该点写入失败的原因由 error 字段指定。