错误消息

本页面介绍在使用 Dataproc Metastore 时可能收到的常见错误消息。每个部分均包含关于消息含义以及解决错误的建议操作的详细信息。

一般错误:

  • 无效的客户端输入

    • “ResourceName 错误路径 [RESOURCE_NAME] 与模板 [RESOURCE_TEMPLATE] 不匹配。”
    • “仓库目录替换无效:[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 存储桶 [GCS_URI]。”

与导入和导出相关的错误:

  • 导入和导出 Cloud Storage 权限

    • “Dataproc Metastore Service Agent 或 Caller 没有足够的 Cloud Storage URI 权限进行导入/导出([SERVICE_AGENT] 无法使用 [SERVICE_AGENT_PERMISSIONS] 权限访问 Cloud Storage URI [GCS_URI])。”
  • 在不受支持的 Hive 版本上运行 Avro 导入或导出

    • “Hive 版本 [HIVE_METASTORE_VERSION] 不支持从 Avro 文件导入,受支持的版本为 [SUPPORT_HIVE_VERSIONS]。”
  • 缺少导入表

    • “找不到表 [MISSING_TABLE_LIST] 的 Avro 源文件。”
    • “Hive 架构验证失败,缺少表:[MISSING_TABLE_LIST]。”

与备份和恢复相关的错误:

一般错误

本部分介绍一般错误。

客户端输入无效

这是一个泛指的错误,表示您的请求无效,而与服务器的状态无关。触发此错误类型的原因多种多样,例如:

  • 使用 REST API 时,您使用无效格式指定了网络名称。

    ResourceName 错误路径 [RESOURCE_NAME] 与模板 [RESOURCE_TEMPLATE] 不匹配。

  • 仓库目录不是有效的 Cloud Storage 路径。如需了解详情,请参阅内部表的数据存储空间

    仓库目录替换值无效:[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 权限

服务代理权限不足

在项目中创建资源时,收到权限错误。此错误通常是由于服务帐号被删除或服务帐号权限被修改引起的,例如:

  • 您提供了自定义数据仓库 Cloud Storage 存储桶,但没有向 Dataproc Metastore 服务代理授予它的访问权限。如需了解详情,请参阅 Hive 仓库目录

    Dataproc Metastore 服务代理 [SERVICE_AGENT] 没有足够的 IAM 权限来访问网络 [NETWORK]。请确保服务代理在项目 [PROJECT_NUMBER] 中被授予 roles/metastore.serviceAgent。

  • 您使用的网络属于另一个项目,但您并未向 Dataproc Metastore 服务代理授予它的访问权限。如需了解详情,请参阅创建服务

    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 工具包作为参考来检查数据库文件的正确 Hive 元数据架构。

与备份和恢复相关的错误

本部分介绍与备份和恢复相关的错误。

找不到用于恢复的备份

在服务中恢复备份时,Dataproc Metastore 找不到您提供的备份资源。

找不到备份 [BACKUP_ID]。

建议执行的操作:检查您的 Dataproc Metastore 服务中是否存在备份。

无法删除备份

用于恢复服务的备份无法删除。

无法删除状态为 [RESOURCE_STATE] 的备份。

建议执行的操作:等待恢复作业完成后,再尝试删除备份。

后续步骤

  • 如需了解您在使用 Dataproc Metastore 时可能会遇到的常见问题的解决方案,请参阅问题排查