Choisir un protocole de point de terminaison pour Dataproc Metastore

Cette page explique comment choisir un protocole de point de terminaison pour Dataproc Metastore.

Vous choisissez d'abord le protocole de point de terminaison lorsque vous créez un service Dataproc Metastore. Ce choix affecte les fonctionnalités que vous pouvez intégrer et utiliser avec votre service. Il est important de noter qu'une fois que vous avez choisi un protocole de point de terminaison, vous devez respecter certaines restrictions si vous souhaitez le modifier. Assurez-vous de choisir le protocole adapté à vos besoins.

Pour comprendre les différences entre les protocoles de point de terminaison, consultez la section À propos des protocoles de point de terminaison.

Avant de commencer

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour créer un métastore Dataproc, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet, conformément au principe du moindre privilège:

Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation metastore.services.create, qui est requise pour créer un métastore Dataproc.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et les autorisations spécifiques de Dataproc Metastore, consultez Gérer l'accès à Dataproc avec IAM.

Choisir un protocole de point de terminaison

Les exemples suivants présentent une version abrégée des étapes à suivre pour choisir un protocole de point de terminaison. Pour obtenir des instructions détaillées sur l'ensemble du processus à suivre, consultez Créer un Dataproc Metastore.

Pour un nouveau service Dataproc Metastore

Pour créer un service Dataproc Metastore et choisir le protocole de point de terminaison pour la première fois, procédez comme suit:

Console

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

    Ouvrir Dataproc Metastore

  2. Dans le menu de navigation Dataproc Metastore, cliquez sur Créer.

    La page Create service (Créer un service) s'ouvre.

  3. Dans la section Protocole de point de terminaison, sélectionnez Thrift ou gRPC.

    Thrift est le protocole de point de terminaison présélectionné par défaut.

    Vous ne pouvez mettre à jour un protocole de point de terminaison existant que de Thrift vers gRPC. Si vous souhaitez passer de gRPC à Thrift, créez un service Dataproc Metastore.

  4. Choisissez les configurations restantes pour votre service, si nécessaire.

  5. Pour créer et démarrer le service, cliquez sur Envoyer.

    Si vous avez sélectionné un point de terminaison gRPC, vous devez accorder des autorisations IAM supplémentaires à votre service. Pour en savoir plus, consultez Accéder aux points de terminaison gRPC.

CLI gcloud

  1. Pour choisir un protocole de point de terminaison, exécutez la commande gcloud metastore services create suivante:

    gcloud metastore services create SERVICE \
   --endpoint-protocol=ENDPOINT_PROTOCOL ; default="thrift"

    Remplacez les éléments suivants :

    • SERVICE_ID: nom ou ID de votre service Dataproc Metastore.

    • ENDPOINT_PROTOCOL: protocole de point de terminaison que vous souhaitez utiliser pour votre Dataproc Metastore. Vous pouvez spécifier thrift ou grpc.

      Thrift est le protocole de point de terminaison présélectionné par défaut.

      Vous ne pouvez mettre à jour un protocole de point de terminaison existant que de Thrift vers gRPC. Si vous souhaitez passer de gRPC à Thrift, vous devez créer un service.

  2. Vérifiez que votre service a bien été créé.

    Si vous avez sélectionné un protocole de point de terminaison gRPC, vous devez ajouter des autorisations IAM supplémentaires à votre compte. Pour en savoir plus, consultez Accéder aux points de terminaison gRPC.

Pour un service Dataproc Metastore existant

Pour mettre à jour le protocole de point de terminaison d'un service Dataproc Metastore existant, procédez comme suit:

Console

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

    Ouvrir Dataproc Metastore

  2. Sur la page Dataproc Metastore, cliquez sur le service à modifier.

    La page Informations sur le service s'ouvre.

  3. Dans l'onglet Configuration, cliquez sur Modifier.

    La page Modifier le service s'ouvre.

  4. Dans la section Protocole de point de terminaison, sélectionnez gRPC.

  5. Pour mettre à jour le service, cliquez sur Envoyer.

    Après avoir migré vers le protocole de point de terminaison gRPC, vous devez ajouter des autorisations IAM supplémentaires à votre compte. Pour en savoir plus, consultez Accéder aux points de terminaison gRPC.

CLI gcloud

  1. Pour mettre à jour un protocole de point de terminaison, exécutez la commande gcloud metastore services update suivante:

    gcloud metastore services update SERVICE \
   --endpoint-protocol=ENDPOINT_PROTOCOL

    Remplacez les éléments suivants :

    • SERVICE: nom de votre service Dataproc Metastore.
    • ENDPOINT_PROTOCOL: protocole de point de terminaison que vous souhaitez mettre à jour pour votre service Dataproc Metastore. Vous ne pouvez spécifier que grpc.

  2. Vérifiez que la mise à jour a bien été effectuée.

    Après avoir migré vers un point de terminaison gRPC, vous devez accorder des autorisations IAM supplémentaires à votre service. Pour en savoir plus, consultez Accéder aux points de terminaison gRPC.

Trouver la valeur de l'URI de votre point de terminaison

Console

Vous pouvez consulter votre URI de point de terminaison sur la page Dataproc Metastore.

  • Pour les points de terminaison Thrift, la valeur de l'URL commence par thrift://.
  • Pour les points de terminaison gRPC, la valeur de l'URL commence par https://.

L'image suivante montre un exemple de service Dataproc Metastore configuré avec un protocole de point de terminaison gRPC.

Valeurs URL et hive.metastore.warehouse.dir sur la page "Informations sur le service"

CLI gcloud

Pour afficher l'URI de votre point de terminaison, exécutez la commande gcloud metastore services describe suivante:

gcloud metastore services describe SERVICE --format="get(endpointUri)"

Remplacez les éléments suivants :

  • SERVICE: nom de votre service Dataproc Metastore.

Étape suivante