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 votre 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, des restrictions s'appliquent si vous souhaitez le modifier. Veillez à choisir le protocole adapté à vos besoins.

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

Avant de commencer

• Activez Dataproc Metastore dans votre projet.
• Découvrez les exigences de mise en réseau spécifiques à votre projet.

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour créer un Dataproc Metastore, demandez à votre administrateur de vous attribuer les rôles IAM suivants sur votre projet, en suivant le principe du moindre privilège:

• Accorder un contrôle complet des ressources Dataproc Metastore (roles/metastore.editor)
• Accorder un accès complet à toutes les ressources Dataproc Metastore, y compris l'administration des stratégies IAM (roles/metastore.admin)

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

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

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

Pour en savoir plus sur les rôles et autorisations Dataproc Metastore spécifiques, 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 que vous suivez afin de choisir un protocole de point de terminaison. Pour obtenir des instructions détaillées sur l'ensemble du processus à suivre, consultez la page 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 de Dataproc Metastore, cliquez sur Créer.

   La page Créer un service s'ouvre.

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

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

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

   Conseil :Nous vous recommandons d'utiliser le protocole gRPC. gRPC fournit une sécurité supplémentaire via Identity and Access Management (IAM). Il est également compatible avec les intégrations de fédération avec d'autres produits Google Cloud. Pour en savoir plus, consultez la page À propos des protocoles de point de terminaison.

4. Sélectionnez 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.

gcloud CLI

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 Dataproc Metastore. Vous pouvez spécifier thrift ou grpc.

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

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

     Conseil :Nous vous recommandons d'utiliser le protocole gRPC. gRPC fournit une sécurité supplémentaire via Identity and Access Management (IAM). Il est également compatible avec les intégrations de fédération avec d'autres produits Google Cloud. Pour en savoir plus sur le choix d'un protocole de point de terminaison, consultez À propos des points de terminaison.

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:

Remarque :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.

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 Détails du service s'ouvre.

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

   La page Modifier le service s'ouvre.

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

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

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

gcloud CLI

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 votre mise à jour a bien été effectuée.

   Après avoir effectué la mise à jour 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 URL commence par https://

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

gcloud CLI

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.

Étapes suivantes

• Accéder aux points de terminaison gRPC
• Associer un cluster Dataproc