創(chuàng)建表級別的預(yù)降采樣規(guī)則（SQL方式）

示例

• 設(shè)置預(yù)降采樣精度為1小時，并對預(yù)降采樣周期執(zhí)行sum和max預(yù)計算。

  CREATE PREDOWNSAMPLE `1h` AGGREGATORS (`sum`, `max`) ON sensor;

• 設(shè)置預(yù)降采樣的數(shù)據(jù)有效期（TTL）為90天。

  CREATE PREDOWNSAMPLE `1h` AGGREGATORS (`sum`, `max`) TTL `90d` ON sensor;

語法參考

CREATE PREDOWNSAMPLE

創(chuàng)建數(shù)據(jù)庫級別的預(yù)降采樣規(guī)則（API方式）

請求路徑和方法

請求參數(shù)

預(yù)降采樣規(guī)則參數(shù)

請求示例

PUT /api/database

{
    "name": "default",
    "downsampleRules": {
        "rules": [
            {
                "aggregator": "sum",
                "intervals": [
                    "1m",
                    "1h"
                ]
            },
            {
                "aggregator": "max",
                "intervals": [
                    "1m",
                    "1h"
                ]
            }
        ]
    }
}

響應(yīng)說明

響應(yīng)狀態(tài)碼為200。

查詢表級別的預(yù)降采樣規(guī)則（SQL方式）

示例

• 查詢數(shù)據(jù)庫所有的預(yù)降采樣規(guī)則。

  SHOW PREDOWNSAMPLES;

• 查詢指定數(shù)據(jù)表sensor的預(yù)降采樣規(guī)則。

  SHOW PREDOWNSAMPLES ON sensor;

語法參考

SHOW PREDOWNSAMPLES

查詢數(shù)據(jù)庫級別的預(yù)降采樣規(guī)則（API方式）

請求路徑和方法

返回示例

[{
    "name": "default",
    "downsampleRules": {
        "rules": [
            {
                "aggregator": "sum",
                "intervals": [
                    "1m",
                    "1h"
                ]
            },
            {
                "aggregator": "max",
                "intervals": [
                    "1m",
                    "1h"
                ]
            }
        ]
    }
}]

響應(yīng)說明

響應(yīng)狀態(tài)碼為204。

刪除表級別的預(yù)降采樣規(guī)則（SQL方式）

示例

DROP PREDOWNSAMPLE `1h` AGGREGATORS (`sum`, `max`) ON sensor;

語法參考

DROP PREDOWNSAMPLE

刪除數(shù)據(jù)庫級別的預(yù)降采樣規(guī)則（API方式）

刪除數(shù)據(jù)庫級別的預(yù)降采樣規(guī)則，請求路徑、請求方法、請求參數(shù)和響應(yīng)說明，與創(chuàng)建數(shù)據(jù)庫級別的預(yù)降采樣規(guī)則相同，區(qū)別為需要將downsampleRules的值置為空。請求路徑等詳細(xì)信息，請參見創(chuàng)建數(shù)據(jù)庫級別的預(yù)降采樣規(guī)則（API方式）。

請求示例

PUT /api/database

{
    "name": "default",
    "downsampleRules": {
    }
}

SQL查詢預(yù)降采樣數(shù)據(jù)

默認(rèn)情況下，降采樣查詢數(shù)據(jù)是從原始數(shù)據(jù)中進(jìn)行查詢。如果要從預(yù)降采樣數(shù)據(jù)中查詢數(shù)據(jù)需要在查詢語句中使用Hint（/*+ PREDOWNSAMPLE */）。

SELECT /*+ PREDOWNSAMPLE */ sum(temperature) from sensor
WHERE time >= 1619074800000 AND time <= 1619085600000
SAMPLE BY 1h;

TSDB兼容查詢預(yù)降采樣數(shù)據(jù)

兼容時間序列數(shù)據(jù)庫TSDB的接口支持通過API多值查詢、API單值查詢、SDK查詢?nèi)N方式查詢預(yù)降采樣數(shù)據(jù)。

SDK多值查詢預(yù)降采樣數(shù)據(jù)

查詢降采樣數(shù)據(jù)時，需要在MultiFieldSubQuery Builder設(shè)定downsampleDataSource參數(shù)。

示例

long startTime = 1619074800000L;
long endTime = 1619085600000L;
final String metric = "wind";
final String field = "speed";
MultiFieldSubQueryDetails fieldSubQueryDetails = MultiFieldSubQueryDetails
        .field(field)
        .aggregator(Aggregator.SUM)
        .downsample("1h-sum")
        .build();
MultiFieldSubQuery subQuery = MultiFieldSubQuery
        .metric(metric)
        .fieldsInfo(fieldSubQueryDetails)
        // 從預(yù)降采樣查詢
        .downsampleDataSource(DownsampleDataSource.DOWNSAMPLE)
        .build();
MultiFieldQuery query = MultiFieldQuery.
        start(startTime).
        end(endTime).
        sub(subQuery).
        build();
List<MultiFieldQueryResult> result = tsdb.multiFieldQuery(query); 

參數(shù)說明

DownsampleDataSource 參數(shù)的取值說明：

• DOWNSAMPLE：預(yù)降采樣數(shù)據(jù)查詢。

• RAW：原始數(shù)據(jù)查詢。如果參數(shù)沒有被指定，默認(rèn)為RAW。

SDK多值的更多內(nèi)容，請參見SDK多值讀取。

API多值查詢預(yù)降采樣數(shù)據(jù)

使用API進(jìn)行多值查詢時，添加downsampleSource參數(shù)并定義參數(shù)為downsample，即可查詢預(yù)降采樣數(shù)據(jù)。具體操作，請參見多值數(shù)據(jù)查詢。

請求路徑和方法

請求參數(shù)

請求示例

POST /api/mquery

{
  "start": 1346846400000, 
  "end": 1346846402000,
    "queries": [
        {
            "downsampleDataSource" : "downsample",
            "metric": "wind",
            "fields" : [
                {
                    "field" : "speed",
                    "aggregator" : "none",
                    "downsample" : "1h-sum"
                }
            ],
                      "tags":{
                    "sensor":"IOTE_8859_0002"
                  }
        }
    ]
}