QueryStreamData
描述
您可以使用此服務來根據指定的輸入參數查詢串流項目。查詢與篩選器類似於 QueryStreamEntriesWithData;但是,產生的資料負載僅包含在與串流相關聯之資料形式中定義的時間戳記與欄位。
輸入
參數名稱
描述
基礎類型
maxItems
要在結果集中傳回的最大項目數。預設值為 500。此參數會在套用其他所有篩選器之後套用。
NUMBER
source
串流項目的來源。建立串流項目時,應已選取有效的 source_type。此來源可以有與其相關聯的模型標籤。
STRING
tags
與串流項目相關聯的資料標籤。
TAGS
sourceTags
與此項目的來源相關聯的模型標籤。
TAGS
startDate
在其之後建立串流項目的時間戳記。
DATETIME
endDate
在其之前建立串流項目的時間戳記。
DATETIME
oldestFirst
從最舊或最新的記錄中擷取。預設值是 False。
BOOLEAN
query
用來篩選資料的查詢條件。
如需詳細資訊,請參閱查詢服務的查詢參數
QUERY
輸出
參數名稱
描述
基礎類型
result
傳回資料負載,其中包含在與串流相關聯之資料形式中定義的時間戳記與欄位。
INFOTABLE
範例
在下列範例中,TestStream 具有包含 Property1Property2Property3 欄位的資料形式。
實體
ModelTags
Administrator
System
Thing1
{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}
entry_id
來源
source_type
location
DataTags
Property1
Property2
Property3
1
System
使用者
1
2
3
2
Administrator
使用者
a
b
c
3
Thing1
物件
{vocabulary: "DataTag1", vocabularyTerm: "DT1-Term1"}
1
2
3
4
AAA
不明
aa
bb
cc
5
Thing1
物件
{vocabulary: "DataTag1", vocabularyTerm: "DT1-Term1"}
1
2
3
下列範例顯示使用所有支援參數查詢串流項目。此 API 呼叫會傳回包含時間戳記、Property1Property2Property3 的資料負載:
result = Things["TestStream"].QueryStreamData({
maxItems: 50,
source: 'Thing1',
tags: "DataTag1:DT1-Term1", /* Data tags on Stream Entry */
sourceTags: "MT1:MT1-MTerm1", /* Model tags on Source entity */
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now(),
oldestFirst: false,
query: "{ \"sorts\": [{\"fieldName\": \"Property1\"}]}"
});
這是否有幫助?