Restaure o Dataproc Metastore a partir de uma cópia de segurança

Esta página explica como restaurar um serviço do Dataproc Metastore a partir de uma cópia de segurança.

Uma cópia de segurança é uma imagem instantânea das definições de configuração e dos metadados armazenados num serviço do Dataproc Metastore. Pode usar a funcionalidade de restauro para configurar rapidamente um novo serviço Dataproc Metastore com os dados guardados anteriormente numa cópia de segurança.

Antes de começar

Funções necessárias

Para receber as autorizações de que precisa para restaurar um serviço do Dataproc Metastore a partir de uma cópia de segurança, peça ao seu administrador que lhe conceda as seguintes funções do IAM:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para restaurar um serviço do Dataproc Metastore a partir de uma cópia de segurança. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para restaurar um serviço do Dataproc Metastore a partir de uma cópia de segurança:

  • Para restaurar um serviço de metadados: metastore.services.restore, metastore.backups.use
  • Para usar o objeto do Cloud Storage:
    • orgpolicy.policy.get
    • resourcemanager.projects.get
    • resourcemanager.projects.list
    • storage.managedFolders.create
    • storage.managedFolders.delete
    • storage.managedFolders.get
    • storage.managedFolders.list
    • storage.multipartUploads.*
    • storage.objects.create
    • storage.objects.delete
    • storage.objects.get
    • storage.objects.list
    • storage.objects.restore
    • storage.objects.update

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções e as autorizações específicas do Dataproc Metastore, consulte a vista geral do IAM do Dataproc Metastore.

Acerca do restauro a partir de uma cópia de segurança

Quando restaura um serviço a partir de uma cópia de segurança, pode escolher uma das seguintes opções:

  • Restaurar todos os metadados e as definições de configuração guardadas na cópia de segurança.

  • Restaurar todos os metadados, mas não restaurar as definições de configuração guardadas na cópia de segurança. Em alternativa, o serviço mantém as definições de configuração atuais.

    As definições de configuração incluem parâmetros do Dataproc Metastore, como o nome do serviço, o número da porta e as definições de rede. Os metadados incluem todas as informações da base de dados e da tabela armazenadas num serviço de Metastore do Dataproc.

Considerações

  • Enquanto uma operação de restauro estiver em execução, não pode atualizar o seu serviço. Por exemplo, não pode alterar as definições de configuração. No entanto, ainda pode usar o seu serviço para operações normais, como usá-lo para aceder aos respetivos metadados a partir de clusters do Dataproc ou autogeridos anexados.

  • As etiquetas do Dataproc Metastore não são restauradas.

  • Os dados armazenados no diretório do armazém não são restaurados.

  • A restauração a partir de uma cópia de segurança não restaura nem substitui as políticas de IAM detalhadas.

  • A restauração a partir de uma cópia de segurança agendada requer que a cópia de segurança esteja localizada num contentor do Cloud Storage.

Restauro a partir de cópia de segurança

Para restaurar um serviço do Dataproc Metastore a partir de uma cópia de segurança, conclua os seguintes passos.

  • Se estiver a usar a Google Cloud consola, só pode restaurar metadados a partir de uma cópia de segurança criada no mesmo projeto e região que o seu novo serviço.

  • Se usar a Google Cloud CLI ou as APIs Dataproc Metastore, pode restaurar metadados a partir de uma cópia de segurança criada num projeto e numa região diferentes (cópia de segurança entre serviços).

Consola

  1. Na Google Cloud consola, abra a página Dataproc Metastore:

    Abra o Dataproc Metastore

  2. Na página Dataproc Metastore, clique no nome do serviço que quer restaurar a partir de uma cópia de segurança.

    É apresentada a página Detalhes do serviço.

    Página de detalhes do serviço
    Figura 1. A página de detalhes do serviço do Dataproc Metastore

  3. Para ver as suas cópias de segurança, clique no separador Cópia de segurança/restauro.

  4. Selecione a cópia de segurança que quer usar. Para tal, clique no ícone de menu e selecione Restaurar.

    É apresentada a página Restaurar.

    Também pode restaurar o seu serviço na página Detalhes da cópia de segurança. Para o fazer, clique no nome da cópia de segurança e, de seguida, em Restaurar.

  5. Selecione a operação de restauro adequada:

    • Restaure os dados do metastore. Restaura todos os metadados, mas não restaura as definições de configuração guardadas na cópia de segurança
    • Restaure os dados do metastore e a configuração do serviço. Restaura todos os metadados e todas as definições de configuração guardadas na cópia de segurança.

  6. Para atualizar o serviço, clique em Restaurar.

    Regresse à página Dataproc Metastore e confirme se foi feita uma cópia de segurança do serviço com êxito.

    Quando o restauro estiver concluído, o Dataproc Metastore regressa automaticamente ao estado ativo, independentemente de o restauro ter sido bem-sucedido ou não.

CLI gcloud

  1. Para restaurar um serviço de Metastore do Dataproc, execute o seguinte comando gcloud metastore services restore:

    gcloud metastore services restore SERVICE  \
    --project=PROJECT_ID \
    --location=LOCATION \
    --backup=BACKUP \
    --restore-type=RESTORE_TYPE \
    --backup-location=BACKUP_LOCATION

    Substitua o seguinte:

    • SERVICE: o nome do seu serviço do Dataproc Metastore.
    • PROJECT_ID: o ID do projeto do Google Cloud projeto no qual o serviço Dataproc Metastore reside.
    • LOCATION: a região em que o seu serviço Dataproc Metastore reside. Google Cloud
    • BACKUP: Opcional: o identificador do ficheiro de cópia de segurança a partir do qual está a fazer o restauro. Este valor pode ser o ID de cópia de segurança, um URL totalmente qualificado ou o nome relativo no seguinte formato: projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
    • RESTORE_TYPE: o tipo de operação de restauro a realizar. Os valores aceites incluem metadata-only ou full. O valor predefinido é metadata-only.
    • BACKUP_LOCATION: opcional: a localização do Cloud Storage da sua cópia de segurança agendada. Por exemplo: gs://my-bucket/path/to/location.

  2. Verifique se a operação de restauro foi bem-sucedida.

    Quando o restauro estiver concluído, o Dataproc Metastore regressa automaticamente ao estado ativo, independentemente de o restauro ter sido bem-sucedido ou não.

REST

Siga as instruções da API para restaurar metadados num serviço através do APIs Explorer.

Quando a restauração estiver concluída, o Dataproc Metastore volta automaticamente ao estado ativo, independentemente de a restauração ter sido bem-sucedida ou não.

Veja o histórico de restauro

Para ver o histórico de restauro de um serviço do Dataproc Metastore na Google Cloud consola, conclua os seguintes passos:

  1. Na Google Cloud Google Cloud Console, abra a página Dataproc Metastore.

  2. Na barra de navegação, clique em Cópia de segurança/restauro.

    O histórico de restauro é apresentado numa tabela em Restaurar.

    O histórico apresenta até às 25 restaurations mais recentes que concluiu.

    A eliminação de um serviço do Dataproc Metastore também elimina todo o histórico de restauro associado.

Resolva problemas comuns

O que se segue?