Gérer un service

Cette page explique comment mettre à jour et supprimer un service Dataproc Metastore existant.

Avant de commencer

Contrôle des accès

  • Pour mettre à jour et supprimer un service, vous devez disposer de rôles IAM contenant respectivement les autorisations IAM metastore.services.update et metastore.services.delete. Les rôles spécifiques à Dataproc Metastore roles/metastore.admin et roles/metastore.editor incluent des autorisations de mise à jour et de suppression.

  • Vous pouvez accorder des autorisations de mise à jour et de suppression à des utilisateurs ou des groupes à l'aide des anciens rôles roles/owner et roles/editor.

Pour en savoir plus, consultez la page IAM et contrôle des accès Dataproc Metastore.

Mettre à jour un service

Vous pouvez mettre à jour un service en modifiant les paramètres de service dans l'onglet "Configuration" de la page "Informations sur le service" ouverte dans un navigateur local, à l'aide de l'outil de ligne de commande gcloud du SDK Cloud, ou en émettant une méthode API Dataproc Metastore services.patch.

Vous ne pouvez effectuer qu'une seule tâche de mise à jour à la fois, et chaque tâche peut effectuer plusieurs mises à jour de propriété. Vous pouvez continuer à utiliser le service pendant l'exécution des mises à jour.

Vous pouvez mettre à jour les paramètres de service suivants:

  • Numéro du port
  • Niveau de service
  • Synchronisation de Data Catalog
  • Intervalle de maintenance
  • Champs Kerberos
  • Configurations du métastore Hive
  • Libellés

Vous devez recréer un service si vous souhaitez modifier les paramètres qui ne peuvent pas être mis à jour.

Les instructions suivantes montrent comment mettre à jour un service Dataproc Metastore:

Console

  1. Dans Cloud Console, ouvrez la page "Dataproc Metastore" :

    Ouvrir Dataproc Metastore dans Cloud Console

  2. Sur la page Dataproc Metastore, cliquez sur le nom du service que vous souhaitez mettre à jour. La page Service detail (Informations sur le service) s'ouvre pour ce service.

    Page d'informations sur le service
  3. Dans l'onglet Configuration, cliquez sur le bouton Edit (Modifier). La page Mettre à jour le service s'ouvre.

  4. Choisissez les valeurs de paramètre de service mises à jour.

  5. Cliquez sur le bouton Envoyer pour mettre à jour le service.

  6. Vérifiez que vous êtes revenu sur la page Dataproc Metastore et que votre service mis à jour apparaît dans la liste.

gcloud

  1. Exécutez la commande gcloud metastore services update suivante pour mettre à jour un service:

    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 une variable existe, sa valeur est mise à jour. Sinon, une nouvelle variable est créée.
    • --clear-hive-metastore-configs : cette erreur se produit en premier si le paramètre update-hive-metastore-configs-from-file est également défini.

    Remplacez l'élément suivant :

    • SERVICE : nom du service.
    • LOCATION : fait référence à une région Google Cloud.
    • PORT : (facultatif) port TCP sur lequel l'interface Thrift de Dataproc Metastore est disponible.
    • TIER : capacité du niveau du service.
    • MAINTENANCE_WINDOW_DAY : jour de la semaine du début de la période.
    • MAINTENANCE_WINDOW_HOUR : heure de la journée du début de la période.
    • KERBEROS_PRINCIPAL : (facultatif) principal Kerberos existant dans le fichier keytab et le KDC. Un principal se présente généralement sous la forme "primary/instance@REALM", mais il n'existe pas de format strictement défini.
    • KEYTAB : (facultatif) fichier keytab Kerberos pouvant être utilisé pour authentifier un compte principal de service avec un centre de distribution de clés Kerberos.
    • KRB5_CONFIG : (facultatif) le fichier krb5.config spécifie les informations du KDC et du domaine Kerberos, qui incluent les emplacements des KDC et les valeurs par défaut du domaine et des applications Kerberos.
    • [KEY, ...] : (facultatif) configurations du métastore Hive utilisées.
    • [KEY=VALUE, ...] : (facultatif) libellés ou configurations de paires clé-valeurs du métastore Hive utilisées.
  2. Vérifiez que la mise à jour a bien été effectuée.

REST

Suivez les instructions de l'API pour mettre à jour un service à l'aide de l'explorateur d'API.

Une fois la mise à jour réussie, le service passe automatiquement en mode actif. En cas d'échec, le service revient à son état opérationnel précédent.

Supprimer un service

Vous pouvez supprimer un service en cliquant sur "Supprimer" sur la page "Informations sur le service" ouverte dans un navigateur local, à l'aide de l'outil de ligne de commande gcloud du SDK Cloud ou en émettant une méthode API Dataproc Metastore.services.delete.

Vous pouvez supprimer votre service si vos configurations, telles que le nom du service, le réseau ou la version du métastore Hive, sont incorrectes et ne peuvent pas être modifiées.

Les instructions suivantes montrent comment supprimer un service Dataproc Metastore:

Console

  1. Dans Cloud Console, ouvrez la page "Dataproc Metastore" :

    Ouvrir Dataproc Metastore dans Cloud Console

  2. Sélectionnez le service en cochant la case située à gauche de son nom.

  3. En haut de la page Dataproc Metastore, cliquez sur Supprimer pour supprimer le service.

  4. Dans la boîte de dialogue, cliquez sur Supprimer pour confirmer la suppression.

Vous pouvez également supprimer votre service sur la page d'informations sur le service.

  1. Sur la page Dataproc Metastore, cliquez sur le nom du service que vous souhaitez mettre à jour. La page Service detail (Informations sur le service) s'ouvre pour ce service.

    Page d'informations sur le service
  2. En haut de la page, dans l'onglet Configuration, cliquez sur Supprimer le service.

  3. Dans la boîte de dialogue, cliquez sur Supprimer pour confirmer la suppression.

  4. Vérifiez que vous êtes revenu sur la page Dataproc Metastore et que votre service supprimé n'apparaît plus dans la liste.

gcloud

  1. Exécutez la commande gcloud metastore services delete suivante pour supprimer un service:

    gcloud metastore services delete SERVICE \
        --location=LOCATION
    

    Remplacez les éléments suivants :

    • SERVICE : nom du nouveau service.
    • LOCATION : fait référence à une région Google Cloud.
  2. Vérifiez que la suppression a bien été effectuée.

REST

Suivez les instructions de l'API pour supprimer un service à l'aide de l'explorateur d'API.

Toutes les suppressions sont effectives immédiatement.

Étape suivante