错误消息

本页面介绍在使用 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 路径。如需了解详情，请参阅 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 存储桶，但没有向 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 工具包作为参考来检查数据库文件的正确 Hive 元数据架构。

与备份和恢复相关的错误

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

找不到用于恢复的备份

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

找不到备份 [BACKUP_ID]。

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

无法删除备份

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

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

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

后续步骤

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