創建表級別的預降采樣規則（SQL方式）

示例

• 設置預降采樣精度為1小時，并對預降采樣周期執行sum和max預計算。

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

• 設置預降采樣的數據有效期（TTL）為90天。

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

語法參考

CREATE PREDOWNSAMPLE

創建數據庫級別的預降采樣規則（API方式）

請求路徑和方法

請求參數

預降采樣規則參數

請求示例

PUT /api/database

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

響應說明

響應狀態碼為200。

查詢表級別的預降采樣規則（SQL方式）

示例

• 查詢數據庫所有的預降采樣規則。

  SHOW PREDOWNSAMPLES;

• 查詢指定數據表sensor的預降采樣規則。

  SHOW PREDOWNSAMPLES ON sensor;

語法參考

SHOW PREDOWNSAMPLES

查詢數據庫級別的預降采樣規則（API方式）

請求路徑和方法

返回示例

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

響應說明

響應狀態碼為204。

刪除表級別的預降采樣規則（SQL方式）

示例

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

語法參考

DROP PREDOWNSAMPLE

刪除數據庫級別的預降采樣規則（API方式）

刪除數據庫級別的預降采樣規則，請求路徑、請求方法、請求參數和響應說明，與創建數據庫級別的預降采樣規則相同，區別為需要將downsampleRules的值置為空。請求路徑等詳細信息，請參見創建數據庫級別的預降采樣規則（API方式）。

請求示例

PUT /api/database

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

SQL查詢預降采樣數據

默認情況下，降采樣查詢數據是從原始數據中進行查詢。如果要從預降采樣數據中查詢數據需要在查詢語句中使用Hint（/*+ PREDOWNSAMPLE */）。

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

TSDB兼容查詢預降采樣數據

兼容時間序列數據庫TSDB的接口支持通過API多值查詢、API單值查詢、SDK查詢三種方式查詢預降采樣數據。

SDK多值查詢預降采樣數據

查詢降采樣數據時，需要在MultiFieldSubQuery Builder設定downsampleDataSource參數。

示例

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)
        // 從預降采樣查詢
        .downsampleDataSource(DownsampleDataSource.DOWNSAMPLE)
        .build();
MultiFieldQuery query = MultiFieldQuery.
        start(startTime).
        end(endTime).
        sub(subQuery).
        build();
List<MultiFieldQueryResult> result = tsdb.multiFieldQuery(query); 

參數說明

DownsampleDataSource 參數的取值說明：

• DOWNSAMPLE：預降采樣數據查詢。

• RAW：原始數據查詢。如果參數沒有被指定，默認為RAW。

SDK多值的更多內容，請參見SDK多值讀取。

API多值查詢預降采樣數據

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

請求路徑和方法

請求參數

請求示例

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"
                  }
        }
    ]
}