錯誤訊息

本頁說明使用 Dataproc Metastore 時可能收到的常見錯誤訊息，各節會進一步說明訊息的意義，以及解決錯誤的建議做法。

一般錯誤：

  • 無效的用戶端輸入內容：

    • 「ResourceName error Path [RESOURCE_NAME] does not match template [RESOURCE_TEMPLATE].」(ResourceName 錯誤：路徑「[RESOURCE_NAME]」與範本「[RESOURCE_TEMPLATE]」不符。)
    • 「Invalid warehouse directory override: [GCS_URI]」。
    • 「提供的 krb5.conf 物件 krb5Config 無效。」

  • API 資源狀態無效：

    • 「資源 [RESOURCE_NAME] 的目前狀態不適合執行這項作業。有效狀態為 [RESOURCE_STATE]。」
    • 您嘗試在 Dataproc Metastore 服務上執行更新、匯入、匯出、備份或還原作業，但服務並未ACTIVE。
    • 「備份 [BACKUP_ID] 尚未就緒。」

  • API 存取權限：

    • 您沒有足夠的權限呼叫 Dataproc Metastore API。

  • 服務代理權限不足：

    • 「Dataproc Metastore 服務代理 [SERVICE_AGENT] 沒有足夠的 IAM 權限，無法存取網路 [NETWORK]。請確認服務代理人在專案 [PROJECT_NUMBER] 中已獲派 roles/metastore.serviceAgent 角色。」

    • Dataproc Metastore 服務代理無法使用權限 [SERVICE_AGENT_PERMISSIONS] 存取 Cloud Storage URI [GCS_URI]；請檢查權限或 VPC Service Controls 服務周圍區域。

    • 「Dataproc Metastore 服務代理程式無法讀取及寫入所提供的資料倉儲目錄的 Cloud Storage bucket [GCS_URI]。」

匯入和匯出相關錯誤：

備份與還原相關錯誤：

一般錯誤

本節說明一般錯誤。

用戶端輸入內容無效

這是一般錯誤，表示您的要求無效，而且與伺服器當前狀態無關。引起這類錯誤的原因很多，例如：

  • 使用 REST API 時，您指定的網路名稱格式無效。

    ResourceName 錯誤：路徑「[RESOURCE_NAME]」與範本「[RESOURCE_TEMPLATE]」不符。

  • 倉庫目錄不是有效的 Cloud Storage 路徑。詳情請參閱「Hive Metastore」。

    倉儲目錄覆寫無效：[GCS_URI]。

  • 您指定的 Kerberos 設定無效 (請參閱「設定服務的 Kerberos」)。

    提供的 krb5.conf 物件 krb5Config 無效。

建議做法：修正您的要求。

API 資源狀態無效

這是一般錯誤，代表要求內容與伺服器資源當前的狀態不相容。

資源「[RESOURCE_NAME]」的目前狀態不適用於這項作業。有效狀態為 [RESOURCE_STATE]。

如果 API 資源 (Dataproc Metastore 服務、匯入、匯出、備份或還原) 的狀態不正確，就無法執行動作，例如：

  • 您嘗試在 Dataproc Metastore 服務上執行更新、匯入、匯出、備份或還原作業，但服務並未ACTIVE。

  • 您嘗試還原備份，但 Dataproc Metastore 服務為 ACTIVE，備份則不是 ACTIVE。

    備份 [BACKUP_ID] 尚未就緒。

應變措施建議：請先確認 API 資源處於正確狀態，再重試要求。

API 存取權限

您沒有足夠的權限呼叫 Dataproc Metastore API。

建議做法：授予使用者正確的 Dataproc Metastore IAM 權限。

服務代理權限不足

在專案中建立資源時發生權限錯誤。這個錯誤通常是由於服務帳戶遭刪除，或是服務帳戶權限遭到修改所致，例如：

  • 您使用了其他專案的網路，但未授予 Dataproc Metastore 服務代理存取權。詳情請參閱「跨專案部署」。

    Dataproc Metastore 服務代理「[SERVICE_AGENT]」沒有足夠的 IAM 權限，無法存取網路「[NETWORK]」。請確認服務代理人在專案 [PROJECT_NUMBER] 中已獲得 roles/metastore.serviceAgent 角色。

  • 您提供了自訂資料倉儲 Cloud Storage bucket，但未授予 Dataproc Metastore 服務代理人存取權。詳情請參閱「Hive 倉庫目錄」。

    Dataproc Metastore 服務代理無法使用權限 [SERVICE_AGENT_PERMISSIONS] 存取 Cloud Storage URI [GCS_URI]；請檢查權限或 VPC Service Controls 服務範圍。

或者 Dataproc Metastore 無法存取資料倉儲目錄 Cloud Storage 路徑。

Dataproc Metastore 服務代理無法讀取及寫入所提供的資料倉儲目錄 Cloud Storage bucket [GCS_URI]。

建議採取的行動：檢查您的 服務帳戶權限或 VPC Service Controls service perimeter。

匯入和匯出相關錯誤

本節說明匯入和匯出相關錯誤。

匯入及匯出 Cloud Storage 權限

您的 Dataproc Metastore 服務代理權限不足，無法執行匯入或匯出作業。

「Dataproc Metastore 服務代理程式」或「呼叫端」沒有足夠的 Cloud Storage URI 匯入/匯出權限 ([SERVICE_AGENT] 無法使用權限 [SERVICE_AGENT_PERMISSIONS] 存取 Cloud Storage URI [GCS_URI])。

建議採取的行動：檢查您的 服務帳戶權限或 VPC Service Controls service perimeter。

在不支援的 Hive 版本上執行 Avro 匯入或匯出作業

Hive 版本 [HIVE_METASTORE_VERSION] 不支援從 Avro 檔案匯入資料，支援的版本為 [SUPPORT_HIVE_VERSIONS]。

建議採取下列行動：請參閱版本政策，瞭解最新的 Hive 版本支援資訊。將資料庫檔案更新為支援的版本。

缺少匯入資料表

  • Avro 匯入作業

    找不到資料表 [MISSING_TABLE_LIST] 的 Avro 來源檔案。

  • 匯入 SQL

    Hive 結構定義驗證失敗，缺少資料表：[MISSING_TABLE_LIST]。

建議做法：參考 Dataproc Metastore Toolkit，檢查資料庫檔案的 Hive 中繼資料結構定義是否正確。

備份與還原相關錯誤

本節說明備份和還原相關錯誤。

找不到可供還原的備份

在服務中還原備份時，Dataproc Metastore 找不到您提供的備份資源。

找不到備份 [BACKUP_ID]。

建議做法：確認備份是否位於 Dataproc Metastore 服務中。

無法刪除備份

如果備份正在用於還原服務，您就無法刪除該備份。

無法刪除處於「[RESOURCE_STATE]」狀態的備份。

應變措施建議：請等待還原工作完成，再嘗試刪除備份。

後續步驟

  • 如要瞭解使用 Dataproc Metastore 時可能遇到的常見問題解決方案，請參閱這篇文章。