Restablece Dataproc Metastore a partir de una copia de seguridad

En esta página, se explica cómo restablecer un servicio de Dataproc Metastore a partir de una copia de seguridad.

Una copia de seguridad es una instantánea de la configuración y los metadatos almacenados en un servicio de Dataproc Metastore. Puedes usar la función de restablecimiento para configurar rápidamente un nuevo servicio de Dataproc Metastore con los datos guardados anteriormente en una copia de seguridad.

Antes de comenzar

Roles obligatorios

Para obtener los permisos que necesitas para restablecer un servicio de Dataproc Metastore a partir de una copia de seguridad, pídele a tu administrador que te otorgue los siguientes roles de IAM:

  • Para otorgar control total de los recursos de Dataproc Metastore para completar una copia de seguridad, se debe cumplir con una de las siguientes condiciones:
  • Para usar el objeto de Cloud Storage que almacena copias de seguridad programadas, haz lo siguiente: Usuario de objeto de Cloud Storage (roles/storage.objectUser) en el agente de servicio de Dataproc Metastore

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para restablecer un servicio de Dataproc Metastore desde una copia de seguridad. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para restablecer un servicio de Dataproc Metastore desde una copia de seguridad:

  • Para restablecer un servicio de metadatos, haz lo siguiente: metastore.services.restore, metastore.backups.use
  • Para usar el objeto de Cloud Storage, haz lo siguiente:
    • 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

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre los roles y permisos específicos de Dataproc Metastore, consulta la Descripción general de IAM de Dataproc Metastore.

Acerca del restablecimiento desde una copia de seguridad

Cuando restableces un servicio a partir de una copia de seguridad, puedes elegir una de las siguientes opciones:

  • Restablece todos los metadatos y la configuración guardados en la copia de seguridad.

  • Restablece todos los metadatos, pero no restablece la configuración guardada en la copia de seguridad. En cambio, el servicio conserva la configuración actual.

    La configuración incluye parámetros de Dataproc Metastore, como el nombre del servicio, el número de puerto y la configuración de red. Los metadatos incluyen toda la información de la base de datos y la tabla almacenada en un servicio de Dataproc Metastore.

Consideraciones

  • Mientras se ejecuta una operación de restablecimiento, no puedes actualizar tu servicio. Por ejemplo, no puedes cambiar la configuración. Sin embargo, puedes seguir usando tu servicio para operaciones normales, como acceder a sus metadatos desde clústeres de Dataproc adjuntos o autoadministrados.

  • No se restablecen las etiquetas de Dataproc Metastore.

  • No se restablecen los datos almacenados en el directorio del almacén.

  • El restablecimiento desde una copia de seguridad no restablece ni reemplaza las políticas de IAM detalladas.

  • Para restablecer desde una copia de seguridad programada, esta debe estar ubicada en un bucket de Cloud Storage.

Restablecer copia de seguridad

Para restablecer un servicio de Dataproc Metastore desde una copia de seguridad, completa los siguientes pasos.

  • Si usas la consola de Google Cloud , solo puedes restablecer metadatos desde una copia de seguridad que se creó en el mismo proyecto y región que tu servicio nuevo.

  • Si usas Google Cloud CLI o las APIs de Dataproc Metastore, puedes restablecer metadatos desde una copia de seguridad creada en otro proyecto y región (copia de seguridad entre servicios).

Console

  1. En la Google Cloud consola, abre la página Dataproc Metastore:

    Abrir Dataproc Metastore

  2. En la página Dataproc Metastore, haz clic en el nombre del servicio que deseas restablecer desde una copia de seguridad.

    Se abrirá la página Detalles del servicio.

    Página de detalles del servicio
    Figura 1: La página de detalles del servicio de Dataproc Metastore

  3. Para ver tus copias de seguridad, haz clic en la pestaña Copias de seguridad/restablecimiento.

  4. Selecciona la copia de seguridad que quieres usar. Para ello, haz clic en el ícono de menú y selecciona Restaurar.

    Se abrirá la página Restaurar.

    También puedes restablecer tu servicio en la página Detalles de la copia de seguridad. Para ello, haz clic en el nombre de la copia de seguridad y, luego, en Restablecer.

  5. Selecciona la operación de restablecimiento adecuada:

    • Restablece los datos del metastore. Restablece todos los metadatos, pero no restablece la configuración guardada en la copia de seguridad.
    • Restablece la configuración del servicio y los datos de Metastore. Restablece todos los metadatos y la configuración guardados en la copia de seguridad.

  6. Para actualizar el servicio, haz clic en Restablecer.

    Regresa a la página Dataproc Metastore y verifica que se haya creado correctamente la copia de seguridad de tu servicio.

    Cuando se completa el restablecimiento, Dataproc Metastore vuelve automáticamente al estado activo, independientemente de si el restablecimiento se realizó correctamente o no.

gcloud CLI

  1. Para restablecer un servicio de Dataproc Metastore, ejecuta el siguiente 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

    Reemplaza lo siguiente:

    • SERVICE: Es el nombre de tu servicio de Dataproc Metastore.
    • PROJECT_ID: Es el ID del proyecto de Google Cloud en el que reside tu servicio de Dataproc Metastore.
    • LOCATION: Es la región en la que reside tu servicio de Dataproc Metastore. Google Cloud
    • BACKUP: Opcional: Es el identificador del archivo de copia de seguridad desde el que restableces. Este valor puede ser el ID de la copia de seguridad, una URL completamente calificada o el nombre relativo en el siguiente formato: projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}.
    • RESTORE_TYPE: Es el tipo de operación de restablecimiento que se realizará. Los valores aceptados incluyen metadata-only o full. El valor predeterminado es metadata-only.
    • BACKUP_LOCATION: Opcional: Es la ubicación de Cloud Storage de tu copia de seguridad programada. Por ejemplo: gs://my-bucket/path/to/location.

  2. Verifica que la operación de restablecimiento se haya realizado correctamente.

    Cuando se completa el restablecimiento, Dataproc Metastore vuelve automáticamente al estado activo, independientemente de si el restablecimiento se realizó correctamente o no.

REST

Sigue las instrucciones de la API para restablecer metadatos a un servicio con el Explorador de APIs.

Cuando se completa el restablecimiento, Dataproc Metastore vuelve automáticamente al estado activo, independientemente de si el restablecimiento se realizó correctamente o no.

Cómo ver el historial de restablecimiento

Para ver el historial de restablecimiento de un servicio de Dataproc Metastore en la consola de Google Cloud , completa los siguientes pasos:

  1. En la Google Cloud consola, abre la página Dataproc Metastore.

  2. En la barra de navegación, haz clic en Backup/Restore.

    Tu historial de restablecimientos aparece en una tabla en Restablecer.

    El historial muestra hasta los 25 restablecimientos más recientes que completaste.

    Borrar un servicio de Dataproc Metastore también borra todo el historial de restauración asociado.

Soluciona los problemas comunes.

¿Qué sigue?