Administrar un servicio

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

Control de acceso

  • Para actualizar y borrar un servicio, debes tener las funciones de IAM que contengan los permisos de IAM metastore.services.update y metastore.services.delete respectivamente. Las funciones específicas de Dataproc Metastore roles/metastore.admin y roles/metastore.editor se pueden usar para otorgar permisos de actualización y eliminación.

  • También puedes otorgar permisos de actualización y eliminación a usuarios o grupos mediante las funciones heredadas roles/owner y roles/editor.

Para obtener más información, consulta la IAM y el control de acceso de Dataproc Metastore.

Actualiza un servicio

Puedes actualizar un servicio editando parámetros de servicio en la pestaña Configuración de la página de detalles del servicio desde un navegador local, con la herramienta de línea de comandos de gcloud del SDK de Cloud o con un método de la API de Dataproc Metastore services.patch.

Solo se admite un trabajo de actualización a la vez y cada trabajo puede tener varias actualizaciones de propiedad. Puedes seguir usando el servicio mientras se está actualizando.

Se pueden actualizar los siguientes parámetros de servicio:

  • Número de puerto
  • Nivel de servicio
  • Sincronización de Data Catalog
  • Período de mantenimiento
  • Campos de Kerberos
  • Configuraciones del almacén de metadatos de Hive
  • Etiquetas

En las siguientes instrucciones, se muestra cómo actualizar un servicio de Dataproc Metastore con Google Cloud Console, la herramienta de gcloud o la API de Dataproc Metastore.

Console

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

    Abre Dataproc Metastore en Cloud Console

  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 de ese servicio.

    Página de detalles del servicio
  3. En la pestaña Configuración, haz clic en el botón Editar. Se abrirá la página Editar servicio.

  4. Elige los valores actualizados del parámetro del servicio.

  5. Haz clic en el botón Enviar para actualizar el servicio.

  6. Verifica que hayas regresado a la página Dataproc Metastore y que tu servicio actualizado aparezca en la lista.

gcloud

  1. Usa el siguiente comando de gcloud metastore services update para actualizar un servicio:

    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, ...]
    
    • --update-hive-metastore-configs-from-file: Si existe una variable, su valor se actualiza. De lo contrario, se crea una variable nueva.
    • --clear-hive-metastore-configs: Esto sucede primero si también se configura update-hive-metastore-configs-from-file.

    Reemplaza lo siguiente:

    • SERVICE: Nombre del servicio.
    • LOCATION: Se refiere a una región de Google Cloud.
    • PORT: (Opcional) El puerto TCP en el que está disponible la interfaz de Thrift de Dataproc Metastore.
    • TIER: Capacidad de nivel del servicio.
    • MAINTENANCE_WINDOW_DAY: Día de la semana en que se inicia la ventana.
    • MAINTENANCE_WINDOW_HOUR: Hora del día en que se inicia la ventana.
    • KERBEROS_PRINCIPAL: (Opcional) Un principal de Kerberos que existe en el archivo keytab y en el KDC. Un principal típico tiene la forma “principal/instancia@DOMINIO”, pero no hay un formato exacto.
    • KEYTAB: (Opcional) Un archivo keytab de Kerberos que se puede usar para autenticar un principal de servicio con un centro de distribución de claves de Kerberos.
    • 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 de almacén de metadatos de Hive que se usa.
    • [KEY=VALUE, ...]: (Opcional) Las etiquetas o las configuraciones de par clave-valor del almacén de metadatos de Hive que se usan.
  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.

Cuando la actualización se realiza con éxito, el servicio ingresa automáticamente el estado activo. Si falla, el servicio se revierte a su estado correcto anterior.

Borra un servicio

Puedes borrar un servicio haciendo clic en Borrar en la página de detalles del servicio desde un navegador local con la herramienta de línea de comandos de gcloud del SDK de Cloud o con un método de la API de Dataproc Metastore services.delete.

Te recomendamos borrar el servicio si tus opciones de configuración, como el nombre del servicio, la red o la versión del almacén de metadatos de Hive, son incorrectas y no pueden cambiarse.

En las siguientes instrucciones, se muestra cómo borrar un servicio de Dataproc Metastore con Google Cloud Console, la herramienta de gcloud o la API de Dataproc Metastore.

Console

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

    Abre Dataproc Metastore en Cloud Console

  2. Para seleccionar el servicio, marca la casilla a la izquierda del nombre del servicio.

  3. En la parte superior de la página Dataproc Metastore, haz clic en Borrar para borrar el servicio.

  4. En el cuadro de diálogo, haz clic en Borrar para confirmar la eliminación.

También puedes borrar tu servicio en la página de detalles del servicio.

  1. En la página Dataproc Metastore, haz clic en el nombre del servicio que quieres borrar. Se abrirá la página Detalles del servicio de ese servicio.

    Página de detalles del servicio
  2. En la parte superior de la página, en la pestaña Configuración, haz clic en Borrar servicio.

  3. En el cuadro de diálogo, haz clic en Borrar para confirmar la eliminación.

  4. Verifica que hayas regresado a la página Dataproc Metastore y que tu servicio borrado aparezca en la lista.

gcloud

  1. Usa el siguiente comando de gcloud metastore services delete para borrar un servicio:

    gcloud metastore services delete SERVICE \
        --location=LOCATION
    

    Reemplaza lo siguiente:

    • SERVICE: Nombre del servicio nuevo.
    • LOCATION: Se refiere a una región de Google Cloud.
  2. Verifica que la eliminación se haya realizado correctamente.

REST

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

Todas las eliminaciones se completa de forma exitosa de inmediato.

Próximos pasos