配額類型
Earth Engine 平台設有多項配額限制,確保資源在使用者之間公平分配。Earth Engine 提供許多不同類型的資源 (運算、儲存空間等),因此配額限制也分為許多不同類型。
不同配額類型的主要差異在於是否可調整。對於某些類型的配額,我們能夠以使用者或專案為單位變更限制,但其他類型的配額是系統全域限制,無法變更。
可調整的配額限制
以下限制可能會調整,且每項專案的限制可能不同。如要瞭解如何申請更多配額,請參閱說明頁面。
配額類型 | 預設值 (每個專案) |
---|---|
並行要求數量上限 (標準端點) | 40 項並行要求 |
並行要求數量上限 (大量端點) | 40 項並行要求 |
要求速率上限 (每項專案) | 每秒 100 個要求 (每分鐘 6,000 個要求) |
要求速率上限 (每個帳戶) | 每秒 100 個要求 (每分鐘 6,000 個要求) |
平均並行批次工作數 | 2 項工作 (平均) |
素材資源儲存空間上限 | 250 GB |
素材資源數量上限 | 10,000 |
每日 Earth Engine 運算時間 (EECU 時間),以秒為單位 | 無限制 |
並行互動式要求
每個專案最多可平行發出 互動式要求,但不得超過配額限制。如果超過限制,Earth Engine 會傳回 「HTTP 429:要求過多」錯誤。一般來說,Earth Engine 用戶端程式庫會處理這些錯誤,程式庫會將要求包裝在指數式退避中,並重試查詢,直到成功為止。Earth Engine 用戶端程式庫最多會重試要求五次。
為避免收到這些 429 錯誤,您可能需要為應用程式啟用快取 (例如使用 memcache),盡可能避免多餘的查詢。如果使用舊版 Earth Engine 用戶端程式庫,且該程式庫不會自動重試查詢,或是查詢在重試五次後仍未完成,您可能需要針對要求實作指數輪詢。
要求率 (QPS)
除了並行限制外,Earth Engine 也會在專案和使用者層級限制互動式要求的頻率。您可以在 Cloud 控制台中調整這些設定
並行批次工作
批次工作的平行處理量有限,因為這類工作使用的資源比互動式要求多。
使用 Earth Engine 進行非商業用途時,除非您已獲得配額提升,否則可同時執行的批次工作數量上限會設為預設值。
使用 Earth Engine 進行商業活動時,可同時執行的批次工作數量上限取決於價格方案,但設定每個專案的批次工作並行限制後,上限可能會進一步降低。根據預設,專案的批次工作並行上限會設為專案帳單帳戶所設定付款方案允許的最大值。如要查看或更新專案的這項限制,請參閱指令列工具說明文件。
資產儲存空間配額
每個 Earth Engine 資產都有對應的資料儲存空間大小 (以位元組為單位)。資產可由 Cloud 專案或個人 (舊版資產) 擁有,且每項資產都會計入擁有者的 Earth Engine 整體儲存空間和資產數量限制。
每日 EECU 時間
如要控管費用,您可以限制專案每天在 Earth Engine 上可消耗的 EECU 時間量。這項配額預設為無上限。配額管理員可以在 Cloud 控制台中設定這項限制,方法是篩選 earthengine.googleapis.com/daily_eecu_usage_time
配額指標。設定完成後,這個配額會累計專案中所有使用者成功發出的 Earth Engine 要求所耗用的 EECU 時間。超過配額時,要求會失敗,直到隔天配額重設或上限提高為止。如要進一步瞭解如何設定這項配額,請參閱費用控管指南。
使用者席位
使用 Earth Engine 進行商業活動時,每個訂閱方案都附帶一定數量的使用者席位,但您也可以購買額外的席位。
服務管理員應購買足夠的席位,以因應特定帳單週期內的 Code Editor 使用者人數。
常見問題
問:哪些使用者會計入席位?
答:只有使用程式碼編輯器執行 Earth Engine 運算作業 (查看地圖圖塊、傳送運算查詢等) 的不同使用者,才會計入席位限制。
問:如果使用者在不同月份的狀態不同,該如何處理?
答:席位不會分配給特定使用者,也不是具名的運算單元。只要您在當月未超過上限,個別使用者身分並不重要。
問:服務帳戶呢?
答:服務帳戶不計入席位數。不會計入執行運算的真人使用者。
問:透過 Python 存取 Earth Engine 的使用者呢?
答:如果使用者只透過 Python API 存取 Earth Engine,且未使用程式碼編輯器,就不會計入席位用量。座位數與 Code Editor 使用量相關。
問:座位數的計算範圍為何?
答:座位數量適用於帳單帳戶層級。貴機構中所有使用程式碼編輯器的使用者,都會計入帳單帳戶的總席位數。
問:如果超出座位數上限會怎麼樣?
答:我們會監控持續違規行為,並在帳單帳戶層級強制執行限制。
問:如何購買更多或更少的座位?
答:詳情請參閱 Earth Engine 定價頁面。
固定配額限制
這類配額限制是在平台層級設定,因此無法針對個別使用者或專案調整。這些指標不太可能隨著時間大幅變動。
運算時間
不同類型的要求有不同的最長時限,詳情請參閱處理環境說明文件。
如需修正逾時錯誤的相關協助,請參閱偵錯指南。
每個要求的記憶體用量
如果要求失敗並顯示「超過使用者記憶體限制」,表示 Earth Engine 無法在允許的記憶體用量內計算出答案。EE 運算平台可用的 RAM 數量有限,為確保系統保持穩定,每個要求只能使用一定數量。可用的最大記憶體量取決於要求類型 (例如,批次工作比地圖圖塊多),但這些是全系統限制。
如需修正記憶體錯誤的相關協助,請參閱偵錯指南。
匯總資料
處理 Earth Engine 要求時,我們會將已知需要大量運算的特定類型子運算作業分開處理。這些子運算稱為「匯總」,在 EE 系統中會特別處理。系統會快取匯總結果,避免重新計算。
並行匯總
為避免運算扇出不受控,我們會限制個別使用者可同時執行的匯總數量,且這項限制無法變更。如果要求失敗並顯示「Too many concurrent aggregations」(並行匯總作業過多),表示要求者同時執行的匯總作業過多。
如需修正並行匯總錯誤的相關說明,請參閱偵錯指南。
大型匯總結果
如果要求失敗並顯示「計算值過大」,表示匯總作業傳回的結果過大,無法放入快取。計算結果的大小上限為 100 MiB,這是全系統的限制。
資料表匯入限制
如要瞭解資料表上傳限制,請參閱資料表資料匯入指南。
要求酬載大小
單一 Earth Engine 查詢的大小上限為 10 MB。只有在查詢中直接納入某些大型額外資料時,才會超出這項限制,例如已內嵌至查詢中的形狀檔或 GeoJSON 結構。請改為上傳這些物件並轉換為 FeatureCollection 資產,然後以資產 ID 參照。
工作佇列長度
等待排程的工作 (處於 READY
狀態) 會形成「工作佇列」。每個專案的佇列最多可支援 3,000 項工作。也就是說,READY
狀態的工作數量不得超過 3,000 項。
BigQuery 點陣函式配額限制
下列配額適用於從 BigQuery 呼叫 Earth Engine,例如使用 ST_REGIONSTATS
SQL 函式時。
配額類型 | 預設值 (每個專案) |
---|---|
每日 BigQuery 運算單元時數 | 1,260,000 個運算單元秒數 (350 個運算單元時數) |
每日 BigQuery 運算單元時數
每日 BigQuery 運算單元時間配額是一種自訂配額,可限制 BigQuery 光柵函式在特定專案的 Earth Engine 上,於特定日期可消耗的運算單元時間量。每日配額會累計所有查詢的總時間,即使查詢失敗也一樣。您可以在 Cloud 控制台的 earthengine.googleapis.com/bigquery_slot_usage_time
指標下方查看配額,配額管理員可以調高或調低配額值。如要將值提高至預設值以上,請建立配額提高要求,系統會自動核准。變更應會在 10 分鐘內生效。
如果超出配額,BigQuery 會傳回下列錯誤訊息:
From Earth Engine: Custom quota exceeded: Your usage exceeded the custom quota for
'earthengine.googleapis.com/bigquery_slot_usage_time', which is adjustable by your administrator in the Google Cloud console: https://console.cloud.google.com/quotas/?project=_.
一旦超出配額,ST_REGIONSTATS
呼叫就會失敗,直到配額在隔天重設,或是管理員提高限制為止。