Skip to main content

orderBy InputObject

每個 Cube 會生成 {Cube}OrderBy 輸入物件,包含 ascendingdescending 欄位。每個欄位接受 CompareFields 列舉值,命名規則為維度路徑以下劃線連線:
巢狀維度逐級拼接:
用法:

常見 CompareFields 取值

GraphQL IDE 中用自動補全檢視某 Cube 可用的全部 CompareFields——輸入 orderBy: {descending: 後 IDE 會列出可選欄位。

用法

傳入 orderBy 輸入物件,將 descendingascending 設為某個 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 }

示例:代幣持有者分頁

分頁建議

沒有穩定排序時,行間順序可能在翻頁時變化。請始終將 limit 與能產生確定順序的 orderBy 一起使用。
很大的 offset(例如 50,000+)可能拖慢查詢,因為資料庫需掃描並跳過行。對超大結果集,優先用 where 收窄查詢,而非深度 offset 翻頁。
若某頁返回行數少於請求的 count,說明已到達結果末尾。也可事先用 count 指標欄位獲取總行數。

實用示例

最新大額成交

獲取 Solana 上最近 10 筆買入名義價值超過 10,000 美元的 DEX 成交:

OHLC K 線——最近 60 分鐘

獲取某代幣 1 分鐘 K 線,按時間正序:

Top 50 代幣持有者

按 USD 餘額排序取前 50 名持有者:

下一步

篩選

將排序與篩選結合,構建精確的分析查詢。

指標與聚合

使用 count、sum、avg、min、max、uniq 對已排序資料聚合。