Choisir un protocole de point de terminaison pour Dataproc Metastore

Cette page explique comment choisir un protocole de point de terminaison 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 À propos des protocoles de point de terminaison.

Avant de commencer

Rôles requis

Pour obtenir l'autorisation nécessaire pour créer un Dataproc Metastore, demandez à votre administrateur de vous accorder le les rôles IAM suivants sur votre projet, selon le 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 metastore.services.create les autorisations, qui est nécessaire pour créer un Dataproc Metastore.

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 tout le processus que vous devez suivre, consultez Créer un service 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 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, selon les besoins.

  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 autre 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 pour votre compte. Pour en savoir plus, consultez la page 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 à mettre à jour.

    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 la page 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 pouvez ne spécifiez 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 afficher l'URI de votre point de terminaison sur la page Dataproc Metastore.

  • Pour les points de terminaison Thrift, la valeur 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és 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