Earth Engine 配額

配額類型

Earth Engine 平台設有多項配額限制,確保資源公平分配給所有使用者。Earth Engine 提供許多不同類型的資源 (運算、儲存空間等),因此也有許多不同類型的配額限制。

不同配額類型的主要區別在於是否可調整。對於某些類型的配額,我們可以依使用者或專案變更限制,而其他類型則是全系統限制,無法變更。

可調整的配額限制

每項專案的限制如下。

配額類型 預設值 (每個專案)
並行要求數量上限 (標準端點) 40 項並行要求
並行要求數量上限 (高用量端點) 40 項並行要求
要求率上限 (每項專案) 每秒 100 個要求 (每分鐘 6,000 個要求)
要求速率上限 (每個帳戶) 每秒 100 個要求 (每分鐘 6,000 個要求)
平均並行批次工作數 2 項工作 (平均)
素材資源儲存空間上限 250 GB
素材資源數量上限 10,000
每日 Earth Engine 運算時間 (EECU 時間),以秒為單位 無限制

並行互動式要求

每個專案可平行處理互動式要求,但不得超過配額限制。如果超出限制,Earth Engine 會傳回 「HTTP 429: Too Many Requests」錯誤。一般來說,這些錯誤會由 Earth Engine 用戶端程式庫處理,該程式庫會以指數輪詢方式包裝要求,並重試查詢,直到成功為止。Earth Engine 用戶端程式庫最多會重試要求五次。

為避免收到這些 429 錯誤,建議您為應用程式啟用快取功能 (例如使用 memcache),盡可能避免重複查詢。如果您使用的 Earth Engine 用戶端程式庫版本較舊,不會自動重試查詢,或者查詢在重試五次後仍未完成,您可能需要對要求實作指數輪詢。

要求率 (QPS)

除了並行限制外,Earth Engine 也會在專案和使用者層級限制互動式要求的速率。您可以在 Cloud 控制台中調整這些設定

並行批次工作

批次工作使用的資源比互動式要求多,因此平行處理量有限。

將 Earth Engine 用於非商業用途時,可同時執行的批次工作數量上限,取決於您的非商業級別。

將 Earth Engine 用於商業用途時,可同時執行的批次工作數量上限取決於定價方案,但您可以設定每項專案的批次工作並行限制,進一步降低這項上限。根據預設,專案的批次工作並行限制會設為專案帳單帳戶所設付費方案允許的上限。如要查看或更新專案的這項限制,請參閱指令列工具說明文件。

資產儲存空間配額

每個 Earth Engine 資產都有對應的資料儲存空間大小,以位元組為單位。資產可由雲端專案或個人 (舊版資產) 擁有,每項資產都會計入擁有者的 Earth Engine 整體儲存空間和資產數量限制。

如要申請額外的資產儲存空間配額,用於非商業或研究用途,請參閱「非商業或研究用途」。

每天的 EECU 時間

如要控管費用,可以限制專案每天在 Earth Engine 可消耗的 EECU 時間。根據預設,這項配額沒有限制。配額管理員可以在 Cloud 控制台中設定這項限制,方法是篩選 earthengine.googleapis.com/daily_eecu_usage_time 配額指標。設定完成後,這項配額會累計專案中所有使用者成功提出 Earth Engine 要求所耗用的 EECU 時間。如果超出配額,要求就會失敗,直到隔天配額重設或上限提高為止。如要進一步瞭解如何設定這項配額,請參閱成本控管指南。

固定配額限制

這類配額限制是在平台層級設定,因此無法依使用者或專案調整。不太可能隨著時間大幅改變。

運算時間

不同類型的要求有不同的時間長度上限,詳情請參閱處理環境說明文件。

如需修正逾時錯誤的相關協助,請參閱偵錯指南。

每項要求的記憶體用量

如果要求失敗,並顯示「User memory limit exceeded」(超出使用者記憶體限制),表示 Earth Engine 無法在允許的記憶體用量內計算答案。EE 運算平台的 RAM 容量有限,為確保系統穩定,每項要求只能使用一定數量。可用記憶體上限取決於要求類型 (例如批次工作的記憶體用量高於地圖圖塊),但這些是系統層級的限制。

如需修正記憶體錯誤的相關協助,請參閱偵錯指南。

匯總資料

處理 Earth Engine 要求時,我們會區分出某些類型的子運算,這些運算需要大量運算資源。這些子運算稱為「匯總」,在 EE 系統中會特別處理。系統會快取匯總結果,避免重新計算。

並行匯總

為避免運算扇出失控,我們限制個別使用者可同時執行的匯總數量,且這項限制無法變更。如果要求失敗,並顯示「Too many concurrent aggregations」(並行匯總過多),表示要求者同時執行的匯總過多。

如需修正並行匯總錯誤的說明,請參閱偵錯指南。

大型匯總結果

如果要求失敗並顯示「Computed value too large」,表示匯總傳回的結果過大,無法放入快取。運算結果的大小上限為 100 MiB,這是系統層級的限制。

表格匯入限制

如要瞭解表格上傳限制,請參閱匯入表格資料指南。

要求酬載大小

單一 Earth Engine 查詢的大小上限為 10 MB。通常只有在查詢中直接加入大型額外資料 (例如內嵌在查詢中的 shapefile 或 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 呼叫會失敗,直到隔天配額重設或管理員提高上限為止。