Scegliere un protocollo di endpoint per Dataproc Metastore

Questa pagina spiega come scegliere un protocollo endpoint per Dataproc Metastore.

Scegli il protocollo dell'endpoint quando crei un servizio Dataproc Metastore. Questa scelta influisce sulle funzionalità che puoi integrare e utilizzare con il tuo servizio. È importante notare che una volta scelto un protocollo endpoint, esistono alcune limitazioni se vuoi modificarlo. Assicurati di scegliere il protocollo appropriato per le tue esigenze.

Per comprendere le differenze tra i protocolli endpoint, consulta Informazioni sui protocolli endpoint.

Prima di iniziare

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per creare un Dataproc Metastore, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto, in base al principio del privilegio minimo:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione metastore.services.create necessaria per creare un Dataproc Metastore.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più su ruoli e autorizzazioni specifici di Dataproc Metastore, consulta Gestire l'accesso a Dataproc con IAM.

Scegliere un protocollo endpoint

Gli esempi riportati di seguito mostrano una versione abbreviata dei passaggi da seguire per scegliere un protocollo dell'endpoint. Per istruzioni passo passo complete sull'intera procedura da seguire, consulta Crea un Dataproc Metastore.

Per un nuovo servizio Dataproc Metastore

Per creare un servizio Dataproc Metastore e scegliere il protocollo dell'endpoint per la prima volta, segui queste istruzioni:

Console

  1. Nella console Google Cloud , apri la pagina Dataproc Metastore:

    Apri Dataproc Metastore

  2. Nel menu di navigazione Dataproc Metastore, fai clic su Crea.

    Viene visualizzata la pagina Crea servizio.

  3. Nella sezione Protocollo endpoint, seleziona Thrift o gRPC.

    Thrift è il protocollo endpoint preselezionato predefinito.

    Puoi aggiornare un protocollo endpoint esistente solo da Thrift a gRPC. Se vuoi passare da gRPC a Thrift, crea un nuovo servizio Dataproc Metastore.

  4. Scegli le configurazioni rimanenti per il servizio, se necessario.

  5. Per creare e avviare il servizio, fai clic su Invia.

    Se hai selezionato un endpoint gRPC, devi concedere ulteriori autorizzazioni IAM al tuo servizio. Per saperne di più, vedi Accedere agli endpoint gRPC.

Interfaccia a riga di comando gcloud

  1. Per scegliere un protocollo dell'endpoint, esegui questo comando gcloud metastore services create:

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

    Sostituisci quanto segue:

    • SERVICE_ID: il nome o l'ID del servizio Dataproc Metastore.

    • ENDPOINT_PROTOCOL: il protocollo dell'endpoint che vuoi utilizzare per Dataproc Metastore. Puoi specificare thrift o grpc.

      Thrift è il protocollo endpoint preselezionato predefinito.

      Puoi aggiornare un protocollo endpoint esistente solo da Thrift a gRPC. Se vuoi passare da gRPC a Thrift, devi creare un nuovo servizio.

  2. Verifica che il servizio sia stato creato correttamente.

    Se hai selezionato un protocollo endpoint gRPC, devi aggiungere ulteriori autorizzazioni IAM al tuo account. Per saperne di più, vedi Accedere agli endpoint gRPC.

Per un servizio Dataproc Metastore esistente

Per aggiornare il protocollo dell'endpoint di un servizio Dataproc Metastore esistente, segui queste istruzioni:

Console

  1. Nella console Google Cloud , apri la pagina Dataproc Metastore:

    Apri Dataproc Metastore

  2. Nella pagina Dataproc Metastore, fai clic sul servizio da aggiornare.

    Viene visualizzata la pagina Dettagli del servizio.

  3. Nella scheda Configurazione, fai clic su Modifica.

    Viene visualizzata la pagina Modifica servizio.

  4. Nella sezione Protocollo endpoint, seleziona gRPC.

  5. Per aggiornare il servizio, fai clic su Invia.

    Dopo l'aggiornamento al protocollo dell'endpoint gRPC, devi aggiungere ulteriori autorizzazioni IAM al tuo account. Per saperne di più, vedi Accedere agli endpoint gRPC.

Interfaccia a riga di comando gcloud

  1. Per aggiornare un protocollo endpoint, esegui questo comando gcloud metastore services update:

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

    Sostituisci quanto segue:

    • SERVICE: il nome del servizio Dataproc Metastore.
    • ENDPOINT_PROTOCOL: il protocollo dell'endpoint che vuoi aggiornare per il servizio Dataproc Metastore. Puoi specificare solo grpc.

  2. Verifica che l'aggiornamento sia andato a buon fine.

    Dopo l'aggiornamento a un endpoint gRPC, devi concedere ulteriori autorizzazioni IAM al tuo servizio. Per saperne di più, vedi Accedere agli endpoint gRPC.

Trovare il valore dell'URI dell'endpoint

Console

Puoi visualizzare l'URI dell'endpoint nella pagina Dataproc Metastore.

  • Per gli endpoint Thrift, il valore URL inizia con thrift://
  • Per gli endpoint gRPC, il valore URL inizia con https://

L'immagine seguente mostra un esempio di servizio Dataproc Metastore configurato con un protocollo endpoint gRPC.

Valori di URL dei dettagli del servizio e hive.metastore.warehouse.dir

Interfaccia a riga di comando gcloud

Per visualizzare l'URI dell'endpoint, esegui questo comando gcloud metastore services describe:

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

Sostituisci quanto segue:

  • SERVICE: il nome del servizio Dataproc Metastore.

Passaggi successivi