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 devez d'abord choisir votre protocole de point de terminaison lorsque vous créez un service Dataproc Metastore. Ce choix a une incidence sur 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 êtes soumis à certaines restrictions si vous souhaitez le modifier. Veillez à choisir le protocole adapté à vos besoins.

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

Avant de commencer

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

Rôles requis

Pour obtenir l'autorisation nécessaire pour créer un service Dataproc Metastore, demandez à votre administrateur de vous attribuer les rôles IAM suivants pour votre projet, selon le principe du moindre privilège:

• Accorder un contrôle complet sur les ressources Dataproc Metastore (roles/metastore.editor)
• Accordez un accès complet à toutes les ressources Dataproc Metastore, y compris pour 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, 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 autorisations spécifiques de Dataproc Metastore, consultez la page Gérer l'accès à Dataproc avec IAM.

Choisir un protocole de point de terminaison

Les exemples suivants illustrent 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 la page Créer un service Dataproc Metastore.

Pour un nouveau service Dataproc Metastore

Si vous souhaitez 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 Create (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 présélectionné par défaut.

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

   Conseil :Nous vous recommandons d'utiliser le protocole gRPC, qui 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 la section À propos des protocoles de point de terminaison.

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 la section 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 du service Dataproc Metastore.

   • ENDPOINT_PROTOCOL: protocole du 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 présélectionné par défaut.

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

     Conseil :Nous vous recommandons d'utiliser le protocole gRPC, qui offre 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 la section Accéder aux points de terminaison gRPC.

Pour un service Dataproc Metastore existant

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

Remarque :Vous ne pouvez mettre à jour qu'un protocole de point de terminaison existant de Thrift à 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 effectué la mise à jour vers le protocole de point de terminaison gRPC, vous devez ajouter des autorisations IAM supplémentaires à votre compte. Pour en savoir plus, consultez la section 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 du service Dataproc Metastore.
   • ENDPOINT_PROTOCOL: protocole du point de terminaison que vous souhaitez mettre à jour pour le 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 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 la section 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 montre 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 du service Dataproc Metastore.

Étapes suivantes

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