Mensagens de erro

Esta página explica as mensagens de erro comuns que pode receber quando usa o Dataproc Metastore. Cada secção inclui mais informações sobre o significado das mensagens e as ações recomendadas para resolver os erros.

Erros gerais:

  • Entradas de cliente inválidas:

    • "ResourceName error Path [RESOURCE_NAME] does not match template [RESOURCE_TEMPLATE]." (Erro de ResourceName: o caminho [RESOURCE_NAME] não corresponde ao modelo [RESOURCE_TEMPLATE].)
    • "Invalid warehouse directory override: [GCS_URI]." (Substituição do diretório do armazém inválida: [GCS_URI].)
    • "O objeto krb5.conf krb5Config fornecido era inválido."
  • Estado do recurso da API inválido:

    • "O estado atual do recurso [RESOURCE_NAME] não é um estado válido para esta operação. Os estados válidos são [RESOURCE_STATE]."
    • Tentou executar uma atualização, uma importação, uma exportação, uma cópia de segurança ou um restauro num serviço do Dataproc Metastore, mas o serviço não estava ACTIVE.
    • "A cópia de segurança [BACKUP_ID] não está pronta."
  • Autorização de acesso à API:

    • Não tinha autorização suficiente para chamar as APIs Dataproc Metastore.
  • Autorizações de agente do serviço insuficientes:

    • "O agente do serviço do Dataproc Metastore [SERVICE_AGENT] não tem autorizações da IAM suficientes para aceder à rede [NETWORK]. Certifique-se de que o agente de serviço tem a função roles/metastore.serviceAgent no projeto [PROJECT_NUMBER]."

    • "O agente do serviço do Dataproc Metastore não consegue aceder ao URI do Cloud Storage [GCS_URI] com as autorizações [SERVICE_AGENT_PERMISSIONS]; verifique as autorizações ou o perímetro de serviço dos VPC Service Controls."

    • "O contentor do Cloud Storage do diretório do armazém fornecido [GCS_URI] não é legível nem gravável pelo agente do serviço Dataproc Metastore."

Erros relacionados com a importação e a exportação:

Erros relacionados com cópias de segurança e restauro:

Erros gerais

Esta secção explica os erros gerais.

Entradas de cliente inválidas

Este é um erro genérico que significa que algo no seu pedido é inválido, independentemente do estado do servidor. Este tipo de erro pode ser acionado por vários aspetos diferentes, como:

  • Quando usou a API REST, especificou o nome de uma rede num formato inválido.

    O caminho [RESOURCE_NAME] do erro ResourceName não corresponde ao modelo [RESOURCE_TEMPLATE].

  • O diretório do armazém não era um caminho do Cloud Storage válido. Para mais informações, consulte o artigo Hive Metastore.

    Substituição do diretório do armazém inválida: [GCS_URI].

  • Especificou configurações de Kerberos inválidas (consulte o artigo Configure o Kerberos para um serviço).

    O objeto krb5.conf krb5Config fornecido era inválido.

Ação recomendada: corrija o seu pedido.

Estado do recurso da API inválido

Este é um erro genérico que significa que algo no pedido não é compatível com o estado atual do recurso do servidor.

O estado atual do recurso [RESOURCE_NAME] não é um estado válido para esta operação. Os estados válidos são [RESOURCE_STATE].

Isto pode acontecer se o recurso da API (serviço Dataproc Metastore, importação, exportação, cópia de segurança ou restauro) não estiver no estado correto para realizar a ação, por exemplo:

  • Tentou executar uma atualização, uma importação, uma exportação, uma cópia de segurança ou um restauro num serviço do Dataproc Metastore, mas o serviço não estava ACTIVE.
  • Tentou restaurar uma cópia de segurança e o serviço Dataproc Metastore estava ACTIVE, mas a cópia de segurança não estava ACTIVE.

    A cópia de segurança [BACKUP_ID] não está pronta.

Ação recomendada: verifique se o recurso da API está no estado correto antes de tentar novamente o pedido.

Autorização de acesso à API

Não tinha autorização suficiente para chamar as APIs do Dataproc Metastore.

Ação recomendada: conceda ao utilizador as autorizações de IAM do Dataproc Metastore corretas.

Autorizações de agente do serviço insuficientes

Recebeu um erro de autorização ao criar recursos no seu projeto. Normalmente, o erro é causado por uma conta de serviço eliminada ou por autorizações da conta de serviço modificadas, por exemplo:

  • Usou uma rede pertencente a um projeto diferente, mas não concedeu autorização ao agente do serviço Dataproc Metastore para aceder à mesma. Para mais informações, consulte o artigo Implementação entre projetos.

    O agente do serviço Dataproc Metastore [SERVICE_AGENT] não tem autorizações da IAM suficientes para aceder à rede [NETWORK]. Certifique-se de que o agente de serviço tem a função roles/metastore.serviceAgent no projeto [PROJECT_NUMBER].

  • Forneceu um contentor do Cloud Storage do armazém de dados personalizado, mas não concedeu ao agente de serviço do Dataproc Metastore autorização para aceder ao mesmo. Para mais informações, consulte o artigo Diretório do armazém de dados do Hive.

    O agente do serviço do Dataproc Metastore não consegue aceder ao URI do Cloud Storage [GCS_URI] com as autorizações [SERVICE_AGENT_PERMISSIONS]; verifique as autorizações ou o perímetro de serviço dos VPC Service Controls.

Ou o Dataproc Metastore não conseguiu aceder ao diretório do armazém no caminho do Cloud Storage.

O contentor do Cloud Storage do diretório do armazém [GCS_URI] fornecido não é legível nem gravável pelo agente de serviço do Dataproc Metastore.

Ação recomendada: verifique as autorizações da conta de serviço ou o perímetro de serviço do VPC Service Controls.

Erros relacionados com a importação e a exportação

Esta secção explica os erros relacionados com a importação e a exportação.

Importe e exporte autorizações do Cloud Storage

O agente de serviço do Dataproc Metastore não tinha autorizações suficientes para realizar a importação ou a exportação.

O "agente do serviço Dataproc Metastore" ou o "autor da chamada" não tem autorizações suficientes do URI do Cloud Storage para importação/exportação ([SERVICE_AGENT] não pode aceder ao URI do Cloud Storage [GCS_URI] com as autorizações [SERVICE_AGENT_PERMISSIONS]).

Ação recomendada: verifique as autorizações da conta de serviço ou o perímetro de serviço do VPC Service Controls.

Executar a importação ou a exportação de Avro numa versão do Hive não suportada

A importação de ficheiros Avro não é suportada para a versão do Hive [HIVE_METASTORE_VERSION]. As versões suportadas são [SUPPORT_HIVE_VERSIONS].

Ação recomendada: consulte a Política de Versões para ver o suporte da versão do Hive mais atualizado. Atualize os ficheiros da base de dados para uma versão suportada.

Tabelas de importação em falta

  • Para importação de ficheiros Avro

    Não foram encontrados ficheiros de origem Avro para as tabelas [MISSING_TABLE_LIST].

  • Para importação de SQL

    Falha na validação do esquema do Hive. Tabelas em falta: [MISSING_TABLE_LIST].

Ação recomendada: use o Dataproc Metastore Toolkit como referência para verificar os esquemas de metadados do Hive corretos dos seus ficheiros de base de dados.

Erros relacionados com a cópia de segurança e o restauro

Esta secção explica os erros relacionados com a cópia de segurança e o restauro.

Não foi encontrada nenhuma cópia de segurança para restaurar

Ao restaurar uma cópia de segurança num serviço, o Dataproc Metastore não conseguiu encontrar o recurso de cópia de segurança fornecido.

Não foi possível encontrar a cópia de segurança [BACKUP_ID].

Ação recomendada: verifique se a cópia de segurança existe no serviço Dataproc Metastore.

Não é possível eliminar uma cópia de segurança

Não podia eliminar uma cópia de segurança quando estava a ser usada para restaurar um serviço.

Não é possível eliminar uma cópia de segurança no estado [RESOURCE_STATE].

Ação recomendada: aguarde pela conclusão da tarefa de restauro antes de tentar eliminar a cópia de segurança.

O que se segue?

  • Para encontrar soluções para problemas comuns que pode encontrar ao usar o Dataproc Metastore, consulte a secção Resolução de problemas.