錯誤訊息

本頁面說明您在使用 Dataproc Metastore 時可能會收到的常見錯誤訊息。每個部分都會提供更多資訊，說明訊息的含意，以及建議的錯誤解決方法。

一般錯誤：

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

    • 「ResourceName error Path [RESOURCE_NAME] does not match template [RESOURCE_TEMPLATE].」
    • 「無效的倉儲目錄覆寫值：[GCS_URI]」。
    • 「The provided krb5.conf object krb5Config was invalid.」

  • 無效的 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 無法使用權限 [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 身分與存取權管理權限。

服務代理權限不足

在專案中建立資源時收到權限錯誤。這類錯誤通常是因為刪除服務帳戶或修改服務帳戶權限，例如：

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

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

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

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

或者，Dataproc Metastore 無法存取倉庫目錄的 Cloud Storage 路徑。

Dataproc Metastore 服務代理無法讀取及寫入提供的倉庫目錄的 Cloud Storage 值區 [GCS_URI]。

建議的動作：檢查您的服務帳戶權限或 VPC Service Controls 服務範圍。

匯入和匯出相關錯誤

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

匯入及匯出 Cloud Storage 權限

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

「Dataproc Metastore Service Agent」或「Caller」沒有足夠的 Cloud Storage URI 權限可用於匯入/匯出作業 ([SERVICE_AGENT] 無法使用 [SERVICE_AGENT_PERMISSIONS] 權限存取 Cloud Storage URI [GCS_URI])。

建議的動作：檢查您的服務帳戶權限或 VPC Service Controls 服務範圍。

在未支援的 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 時可能遇到的常見問題解決方案，請參閱疑難排解。