疑難排解︰透過 API 的自訂報告
API呼叫已逾時。
如果API呼叫在 60 秒內未處理完畢,呼叫將逾時,且您會接收錯誤 ()。
原因 | 解決方案 |
|---|---|
資料集的聯結次數過多。 | 限制資料集中使用的聯結數。 |
您正在擷取超過 20 個欄位的報告。 | 將報告中的欄位數限制為 10 到 20 個欄位。如果欄位計數超過 20,請使用 SFTP 擷取報告。 |
您的資料形狀不規則。範例︰您有大量的巢狀組織。 | 避免擷取異常龐大的資料集。 |
您的報告沒有篩選條件 | 使用適當的篩選條件來控制資料量的增長。範例︰擷取使用定義較小時間範圍的篩選條件(例如 昨天 或今天) 修改過的資料。 |
您已在先前的要求, 申請後 分鐘內提出了一項要求, 申請。對於傳回大量資料或具有多個聯結的報告尤其如此。 | 避免在短時間內發出多個API要求, 申請。 |
您正在擷取的報告包含多頁資料。 | 報告 API 的設計初衷是為了傳回分頁資料集。這是適用於所有 VNDLY HTTP 型 API 的標準限制條件。若要避免此問題,請執行以下操作:
|
您從正式環境用戶擷取資料時發生效能問題,而非測試用戶的資料。
效能問題在測試用戶中可能不明顯,因為測試用戶中的資料載入量會少於生產用戶「」。
解決方案︰
- 請在正式環境上線後驗證報告效能,確認結果與「測試」用戶類似。
- 為「測試」用戶載入測試資料,且測試資料的大小應可代表正式環境負載。
- 規劃正式環境中的擴充能力。將正式環境資料報告的預期載入大小與複雜度納入考量。隨著方案成熟或上線後,在門檻附近執行的報告可能會超過門檻。