orderBy InputObject
每個 Cube 會生成{Cube}OrderBy 輸入物件,包含 ascending 與 descending 欄位。每個欄位接受 CompareFields 列舉值,命名規則為維度路徑以下劃線連線:
常見 CompareFields 取值
用法
傳入orderBy 輸入物件,將 descending 或 ascending 設為某個 CompareFields 值:
orderBy 僅接受單一方向/欄位對。不支援多列排序——查詢每次只按一個維度排序。limit 引數
limit 控制返回行數,並支援基於 offset 的分頁:
預設與最大限制
每個 Cube 在省略limit 時有預設行數,並有最大上限:
若請求的
count 超過最大值,服務端會靜默截斷為最大允許值。基於 Offset 的分頁
使用offset 翻頁,模式很直接:
- 第 1 頁:
limit: { count: 50, offset: 0 } - 第 2 頁:
limit: { count: 50, offset: 50 } - 第 3 頁:
limit: { count: 50, offset: 100 }
示例:代幣持有者分頁
- 第 1 頁
- 第 2 頁
分頁建議
分頁務必配合 orderBy
分頁務必配合 orderBy
沒有穩定排序時,行間順序可能在翻頁時變化。請始終將
limit 與能產生確定順序的 orderBy 一起使用。避免過大 offset
避免過大 offset
很大的
offset(例如 50,000+)可能拖慢查詢,因為資料庫需掃描並跳過行。對超大結果集,優先用 where 收窄查詢,而非深度 offset 翻頁。用 count 判斷是否到底
用 count 判斷是否到底
若某頁返回行數少於請求的
count,說明已到達結果末尾。也可事先用 count 指標欄位獲取總行數。實用示例
最新大額成交
獲取 Solana 上最近 10 筆買入名義價值超過 10,000 美元的 DEX 成交:OHLC K 線——最近 60 分鐘
獲取某代幣 1 分鐘 K 線,按時間正序:Top 50 代幣持有者
按 USD 餘額排序取前 50 名持有者:下一步
篩選
將排序與篩選結合,構建精確的分析查詢。
指標與聚合
使用 count、sum、avg、min、max、uniq 對已排序資料聚合。

