Actualiza un servicio de Dataproc Metastore

En esta página, se explica cómo actualizar un servicio de Dataproc Metastore.

Puedes actualizar tu servicio de Dataproc Metastore para cambiar parámetros de configuración de la red o habilitar o inhabilitar funciones opcionales.

Antes de comenzar

Roles obligatorios

A fin de obtener el permiso que necesitas para actualizar un servicio de Dataproc Metastore, haz lo siguiente: solicita a tu administrador que te otorgue el los siguientes roles de IAM en tu proyecto, según el principio de privilegio mínimo:

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

Este rol predefinido contiene el permiso metastore.services.update, que se requiere para actualizar un servicio de Metastore de Dataproc.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

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

Información para actualizar un servicio

Puedes actualizar los siguientes parámetros de Dataproc Metastore.

  • Número de puerto. Actualiza el número de puerto TCP de la interfaz de Apache Thrift.
  • Nivel de servicio. Cambia entre el nivel de servicio Desarrollador o el nivel de servicio Empresa. Estos niveles influyen en la capacidad del servicio.
  • Sincronización de Data Catalog. Activa o desactiva la función de sincronización de Data Catalog.
  • Período de mantenimiento. Cambia la frecuencia del período de mantenimiento, incluidas las opciones Día de la semana y Hora del día.
  • Kerberos Habilita o inhabilita la autenticación de Kerberos. Si se habilitó anteriormente, puedes actualizar tus archivos de configuración de Kerberos.
  • Configuración del almacén de metadatos de Hive. Actualiza la ubicación del directorio de tu almacén de Hive.
  • Configuración de la versión auxiliar (versión preliminar). Habilita, inhabilita o agrega versiones auxiliares adicionales.
  • Etiquetas. Agrega o quita etiquetas opcionales que describen tus metadatos.
  • Factor de escala: Cambia el factor de escala. Puedes habilitar o inhabilitar el ajuste de escala automático y actualizar los factores de escalamiento mínimo o máximo.

Actualizar un servicio

Antes de ejecutar una actualización, ten en cuenta las siguientes consideraciones:

  • Solo puedes ejecutar un trabajo de actualización a la vez (para cada servicio de Dataproc Metastore).
  • Puedes actualizar varios parámetros en un solo trabajo de actualización.
  • Puedes seguir usando tu Dataproc Metastore mientras se actualiza.

Cuando la actualización se realiza correctamente, Dataproc Metastore ingresa automáticamente a un estado activo. Si la actualización falla, el servicio de Dataproc Metastore se revierte a su estado correcto anterior.

En las siguientes instrucciones, se muestra cómo actualizar un Dataproc Metastore servicio.

Console

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

    Abrir Dataproc Metastore

  2. En la página Dataproc Metastore, haz clic en el nombre del servicio de la servicio que quieres actualizar.

    Se abrirá la página Detalles del servicio.

    Página de detalles del servicio
    Página de detalles del servicio de Dataproc Metastore

  3. En la pestaña Configuración, haz clic en Editar.

    Se abrirá la página Editar servicio.

  4. Elige los valores que quieres actualizar para tu servicio.

  5. Haz clic en Enviar.

    Regresa a la página Dataproc Metastore y verifica que tu servicio se haya actualizado correctamente.

gcloud CLI

  1. Para actualizar un servicio, ejecuta el siguiente comando gcloud metastore services update:

    gcloud metastore services update SERVICE \
    --location=LOCATION \
    --port=PORT \
    --tier=TIER \
    --maintenance-window-day=MAINTENANCE_WINDOW_DAY \
    --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR \
    --kerberos_principal=KERBEROS_PRINCIPAL \
    --keytab=KEYTAB \
    --krb5-config=KRB5_CONFIG \
    --update-hive-metastore-configs-from-file=[KEY=VALUE, ...] \
    --clear-hive-metastore-configs \
    --remove-hive-metastore-configs=[KEY, ...] \
    --update-labels=[KEY=VALUE, ...] \
    --clear-labels \
    --remove-labels=[KEY, ...]

    Reemplaza lo siguiente:

    • SERVICE: Es el nombre de tu servicio de Dataproc Metastore.
    • LOCATION: Es la región de Google Cloud en la que reside tu servicio de Dataproc Metastore.
    • PORT: (Opcional) Es el puerto TCP de la interfaz de Thrift que usas con tu servicio de Dataproc Metastore.
    • TIER: Es la capacidad del nivel de tu servicio de Dataproc Metastore (opcional).
    • MAINTENANCE_WINDOW_DAY: Opcional: Es el día de la semana en que se inicia la ventana de servicio.
    • MAINTENANCE_WINDOW_HOUR: Es opcional. Es la hora del día en que se inicia la ventana de servicio.
    • KERBEROS_PRINCIPAL: (Opcional) Un principal de Kerberos que existe en el archivo keytab y en el KDC. Un principal tiene el formato “primary/instance@REALM”, pero no hay formato exacto.
    • KEYTAB: Es un archivo keytab de Kerberos que (opcional) se utiliza para autenticar un servicio principal con una clave Kerberos de distribución de Google Cloud.
    • KRB5_CONFIG: (Opcional) El archivo krb5.config especifica el KDC y la información del dominio de Kerberos, que incluye ubicaciones del KDC y configuraciones predeterminadas para las aplicaciones de Kerberos y el dominio.
    • [KEY, ...]: (Opcional) La configuración del almacén de metadatos de Hive que deseas actualizar. Si existe una variable en este campo, se actualiza su valor. De lo contrario, se crea una nueva variable. Si se establece esta marca, entonces -clear-hive-metastore-configs es configurar automáticamente.
    • [KEY, ...]: (Opcional) Las configuraciones del almacén de metadatos de Hive que deseas quitar.
    • [KEY=VALUE, ...]: Las etiquetas o El par clave-valor del almacén de metadatos de Hive te configura quieres actualizar.
    • [KEY, ...]: (Opcional) Las etiquetas o las configuraciones de par clave-valor del almacén de metadatos de Hive que deseas quitar.

  2. Verifica que la actualización se haya realizado correctamente.

REST

Sigue las instrucciones de la API para actualizar un servicio mediante el Explorador de API.

Actualiza la configuración del almacén de Hive Metastore

Si tu directorio de almacenes de Hive está en Cloud Storage, debes configurar una anulación de configuración de Metastore. Esta anulación establece tu almacén de datos específico como el directorio de almacenes predeterminado para Dataproc Metastore.

Antes de configurar esta anulación, asegúrate de que tu servicio de Dataproc Metastore tiene permisos de lectura y escritura de objetos para acceder al directorio del almacén. Para obtener más información, consulta el directorio del almacén de Hive.

En las siguientes instrucciones, se muestra cómo actualizar una anulación de configuración de Hive Metastore.

Console

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

    Abrir Dataproc Metastore

  2. En la página Dataproc Metastore, haz clic en el nombre del servicio que quieres actualizar.

    Se abrirá la página Detalles del servicio.

  3. En la pestaña Configuración, haz clic en Editar.

    Se abrirá la página Editar servicio.

  4. En Anulaciones de configuración de Metastore, ingresa lo siguiente:

    • Clave: Ingresa el siguiente valor: hive.metastore.warehouse.dir.
    • Valor: Es la ubicación de Cloud Storage de tu directorio de almacén. Por ejemplo: gs://my-bucket/path/to/location.

  5. Haz clic en Enviar.

    Regresa a la página Dataproc Metastore. verificarás que tu servicio se haya actualizado correctamente.

gcloud

  1. Para actualizar un servicio, ejecuta el siguiente comando gcloud metastore services update:

    gcloud metastore services update SERVICE \
    --location=LOCATION \
    --update-hive-metastore-configs="hive.metastore.warehouse.dir=CUSTOMER_DIR"

    Reemplaza lo siguiente:

    • SERVICE: Es el nombre de tu servicio de Dataproc Metastore.
    • LOCATION: Es la región de Google Cloud en la que reside tu servicio de Dataproc Metastore.
    • CUSTOMER_DIR: Es la ubicación de Cloud Storage de tu directorio de almacén. Por ejemplo: gs://my-bucket/path/to/location.

  2. Verifica que la actualización se haya realizado correctamente.

¿Qué sigue?