共用方式為


執行查詢

總結: 瞭解執行查詢作業,此作業是通話品質儀錶板數據 API 的一部分。 通話品質儀錶板是一種可 商務用 Skype Server 的工具。

執行查詢作業是通話品質儀錶板數據 API 的一部分。

執行查詢

執行查詢作業可讓您根據指定的維度、度量及篩選器,在 Cube 上執行查詢,並傳回數據。

方法 要求 URI HTTP 版本
發佈
<https:// portal>/QoEDataService/RunQuery
HTTP/1.1

URI 參數 - 無。

要求頁首 - 無額外標頭。

要求內文 - 以下是 JSON 中的範例要求承載。 它包含查詢所需的維度、篩選和度量單位。

{
"Filters": [{
"DataModelName": "[StartDate].[Month]",
"Caption": "July 2013",
"Value": "[2015-03-01T00:00:00]",
"Operand": 0,
"UnionGroup": ""
}],
"Dimensions": [{
"DataModelName": "[StartDate].[Month]"
}],
"Measurements": [{
"DataModelName": "[Measures].[Audio Good Streams Count]"
},
{
"DataModelName": "[Measures].[Audio UnClassified Streams Count]"
},
{
"DataModelName": "[Measures].[Audio Poor Streams Count]"
},
{
"DataModelName": "[Measures].[AudioPoorPercentage]"
}],
"Trend": {
"EnableTrend": true,
"SpanCount": 7,
"TrendDate": "2015-3",
"Type": 0
}
}

篩選 : 要套用的篩選表達式清單,如此結果數據集只會反映感興趣的數據子集。

維度 - 用於匯總數據的維度清單。 至少需要一個維度,但可能會指定多個維度以取得額外的分區層級。

度量 單位 - 度量單位清單,也稱為事實,是根據您指定的維度來匯總所需的度量。

趨勢 - 自定義結果數據的其他控制指示。

回應 - 回應包含 HTTP 狀態代碼和一組回應標頭。

狀態代碼 - 成功的作業會傳回狀態代碼 200 (OK) 。

響應標頭 - 無額外標題。

回應內文 - 以下是 JSON 中的範例響應承載。 它包含包含數據的數據表,也包含元數據,它會顯示查詢執行時間,以及數據是否來自快取。

{
"ExecutionTime": "00:00:00.2102630",
"DataResult": [["September 2014",
        1792,
        34,
        78,
        4.171],
        ["October 2014",
        37017,
        1731,
        3305,
        8.197],
        ["November 2014",
        79184,
        3033,
        5556,
        6.557],
        ["December 2014",
        122253,
        4050,
        5444,
        4.263],
        ["January 2015",
        31246,
        1069,
        1342,
        4.118]],
"ResultIsFromCache": false,
"ErrorType": 0
}

執行時間 - 伺服器傳回資料所需的總時間。 這可能涉及快取,也可能不涉及快取。

數據結果 - 查詢的結果。 這是二維陣列,包含維度成員的所有排列,每個元素都包含維度成員名稱和指定度量單位的匯總值。

結果為 [從快取 ] - 用於診斷。 指出結果是來自快取還是 QoE Cube。