Error messages

This page explains common error messages that you might receive when using Dataproc Metastore. Each section includes more information on what the messages mean and the recommended actions for resolving the errors.

General errors:

  • Invalid client inputs:

    • "ResourceName error Path [RESOURCE_NAME] does not match template [RESOURCE_TEMPLATE]."
    • "Invalid warehouse directory override: [GCS_URI]."
    • "The provided krb5.conf object krb5Config was invalid."
  • Invalid API resource state:

    • "Current state of resource [RESOURCE_NAME] is not a valid state for this operation. Valid state(s) are [RESOURCE_STATE]."
    • You tried to run update, import, export, backup, or restore on a Dataproc Metastore service, but the service was not ACTIVE.
    • "Backup [BACKUP_ID] not ready."
  • API access permission:

    • You didn't have enough permission to call the Dataproc Metastore APIs.
  • Insufficient service agent permissions:

    • "The Dataproc Metastore service agent [SERVICE_AGENT] does not have sufficient IAM permissions to access the network [NETWORK]. Please make sure the service agent is granted roles/metastore.serviceAgent in the project [PROJECT_NUMBER]."

    • "Dataproc Metastore Service Agent cannot access Cloud Storage URI [GCS_URI] with permissions [SERVICE_AGENT_PERMISSIONS]; Please check permissions or VPC Service Controls service perimeter."

    • "The provided warehouse directory's Cloud Storage bucket [GCS_URI] is not readable and writable by the Dataproc Metastore service agent."

Errors relating to import and export:

  • Import and export Cloud Storage permissions:

    • ""Dataproc Metastore Service Agent" or "Caller" does not have enough permissions of the Cloud Storage URI for import/export ([SERVICE_AGENT] cannot access Cloud Storage URI [GCS_URI] with permissions [SERVICE_AGENT_PERMISSIONS])."
  • Run Avro import or export on an unsupported Hive version:

    • "Importing from Avro files is not supported for Hive version [HIVE_METASTORE_VERSION], supported versions are [SUPPORT_HIVE_VERSIONS]."
  • Missing import tables:

    • "Avro source files not found for tables [MISSING_TABLE_LIST]."
    • "Hive schema validation failed, missing tables: [MISSING_TABLE_LIST]."

Errors relating to backup and restore:

General errors

This section explains general errors.

Invalid client inputs

This is a generic error that means something about your request is invalid, independent of the server's state. This error type could be triggered by many different things, such as:

  • When using the REST API, you specified the name of a network in an invalid format.

    ResourceName error Path [RESOURCE_NAME] does not match template [RESOURCE_TEMPLATE].

  • The warehouse directory was not a valid Cloud Storage path. For more information, see Hive Metastore.

    Invalid warehouse directory override: [GCS_URI].

  • You specified invalid Kerberos configurations (see Configure Kerberos for a service.

    The provided krb5.conf object krb5Config was invalid.

Recommended action: Fix your request.

Invalid API resource state

This is a generic error that means that something about the request is not compatible with the current state of the server resource.

Current state of resource [RESOURCE_NAME] is not a valid state for this operation. Valid state(s) are [RESOURCE_STATE].

This can happen if the API resource (Dataproc Metastore service, import, export, backup, or restore) is not in the correct state to perform the action, for example:

  • You tried to run update, import, export, backup, or restore on a Dataproc Metastore service, but the service was not ACTIVE.
  • You tried to restore a backup, and the Dataproc Metastore service was ACTIVE, but the backup was not ACTIVE.

    Backup [BACKUP_ID] not ready.

Recommended action: Check that your API resource is in the correct state before retrying the request.

API access permission

You didn't have enough permission to call the Dataproc Metastore APIs.

Recommended action: Grant the user the correct Dataproc Metastore IAM permissions.

Insufficient service agent permissions

You received a permission error when creating resources in your project. The error is usually caused by a deleted service account, or modified service account permissions, for example:

  • You used a network belonging to a different project, but didn't grant the Dataproc Metastore service agent permission to access it. For more information, see Cross project deployment.

    The Dataproc Metastore service agent [SERVICE_AGENT] does not have sufficient IAM permissions to access the network [NETWORK]. Please make sure the service agent is granted roles/metastore.serviceAgent in the project [PROJECT_NUMBER].

  • You provided a custom data warehouse Cloud Storage bucket, but you didn't grant the Dataproc Metastore service agent permission to access it. For more information, see Hive warehouse directory.

    Dataproc Metastore Service Agent cannot access Cloud Storage URI [GCS_URI] with permissions [SERVICE_AGENT_PERMISSIONS]; Please check permissions or VPC Service Controls service perimeter.

Or Dataproc Metastore couldn't access the warehouse directory Cloud Storage path.

The provided warehouse directory's Cloud Storage bucket [GCS_URI] is not readable and writable by the Dataproc Metastore service agent.

Recommended action: Check your service account permissions or VPC Service Controls service perimeter.

Errors relating to import and export

This section explains errors relating to import and export.

Import and export Cloud Storage permissions

Your Dataproc Metastore service agent didn't have enough permissions to perform the import or export.

"Dataproc Metastore Service Agent" or "Caller" does not have enough permissions of the Cloud Storage URI for import/export ([SERVICE_AGENT] cannot access Cloud Storage URI [GCS_URI] with permissions [SERVICE_AGENT_PERMISSIONS]).

Recommended action: Check your service account permissions or VPC Service Controls service perimeter.

Run Avro import or export on an unsupported Hive version

Importing from Avro files is not supported for Hive version [HIVE_METASTORE_VERSION], supported versions are [SUPPORT_HIVE_VERSIONS].

Recommended action: See Version policy for the most up-to-date Hive version support. Update your database files to a supported version.

Missing import tables

  • For Avro import

    Avro source files not found for tables [MISSING_TABLE_LIST].

  • For SQL import

    Hive schema validation failed, missing tables: [MISSING_TABLE_LIST].

Recommended action: Use the Dataproc Metastore Toolkit as a reference to check the correct Hive metadata schemas of your database files.

Errors relating to backup and restore

This section explains errors relating to backup and restore.

Backup not found for restore

When restoring a backup in a service, Dataproc Metastore couldn't find your provided backup resource.

Backup [BACKUP_ID] not found.

Recommended action: Check that your backup exists within your Dataproc Metastore service.

Cannot delete a backup

You couldn't delete a backup when it was being used to restore a service.

Cannot delete a backup in a state [RESOURCE_STATE].

Recommended action: Wait for the restore job to complete before attempting to delete the backup.

What's next

  • To find solutions for common issues that you might encounter when using Dataproc Metastore, see Troubleshooting.