Questa pagina spiega come scegliere un protocollo endpoint per Dataproc Metastore.
Devi prima scegliere il protocollo degli endpoint quando crei Servizio Dataproc Metastore. Questa scelta influisce sulle funzionalità che puoi integrare e utilizzare con il tuo servizio. È importante notare che, una volta scegli un protocollo endpoint, esistono alcune restrizioni se vuoi modificarlo. Assicurati di scegliere il protocollo appropriato per le tue esigenze.
Per comprendere le differenze tra i protocolli degli endpoint, consulta Informazioni sui protocolli degli endpoint.
Prima di iniziare
- Abilita Dataproc Metastore nel tuo progetto.
- Informazioni sui requisiti di rete specifiche del tuo progetto.
Ruoli obbligatori
Per ottenere l'autorizzazione necessaria per creare un Dataproc Metastore, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto, in base al principio del privilegio minimo:
-
Concedi il controllo completo delle risorse Dataproc Metastore (
roles/metastore.editor
) -
Concedi l'accesso completo a tutte le risorse Dataproc Metastore, inclusa l'amministrazione dei criteri IAM (
roles/metastore.admin
)
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene
metastore.services.create
autorizzazione,
che è obbligatorio
per creare un Dataproc Metastore.
Potresti anche riuscire a ottenere questa autorizzazione con ruoli personalizzati e altri ruoli predefiniti.
Per ulteriori informazioni su ruoli e autorizzazioni specifici di Dataproc Metastore, consulta Gestire l'accesso a Dataproc con IAM.Scegli un protocollo endpoint
Gli esempi riportati di seguito mostrano una versione abbreviata dei passaggi da seguire per scegliere un protocollo endpoint. Per istruzioni passo passo complete sul l'intero processo da seguire, consulta Creare un Dataproc Metastore.
Per un nuovo servizio Dataproc Metastore
Per creare un servizio Dataproc Metastore e scegliere il per la prima volta, segui queste istruzioni:
Console
Nella console Google Cloud, apri la pagina Dataproc Metastore:
Nel menu di navigazione di Dataproc Metastore, fai clic su Crea.
Viene visualizzata la pagina Crea servizio.
Nella sezione Protocollo endpoint, seleziona Thrift o gRPC.
Thrift è il protocollo predefinito degli endpoint preselezionati.
Puoi aggiornare un protocollo endpoint esistente solo da Thrift a gRPC. Se vuoi passare da gRPC a Thrift, crea un nuovo Servizio Dataproc Metastore.
Scegli le configurazioni rimanenti per il tuo servizio, se necessario.
Per creare e avviare il servizio, fai clic su Invia.
Se hai selezionato un endpoint gRPC, devi concedere autorizzazioni IAM aggiuntive al tuo servizio. Per ulteriori informazioni, consulta Accedere agli endpoint gRPC.
Interfaccia a riga di comando gcloud
Per scegliere un protocollo 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 tuo Servizio Dataproc Metastore.ENDPOINT_PROTOCOL
: il protocollo dell'endpoint da utilizzare per Dataproc Metastore. Puoi specificarethrift
ogrpc
.Thrift è il protocollo predefinito degli endpoint preselezionati.
Puoi aggiornare un protocollo endpoint esistente solo da Thrift a gRPC. Se vuoi passare da gRPC a Thrift, devi creare un nuovo servizio.
Verifica che il servizio sia stato creato correttamente.
Se hai selezionato un protocollo endpoint gRPC, devi aggiungere altre autorizzazioni IAM per il tuo account. Per ulteriori informazioni, consulta Accedere agli endpoint gRPC.
Per un servizio Dataproc Metastore esistente
Aggiornamento del protocollo dell'endpoint di un Dataproc Metastore esistente segui queste istruzioni:
Console
Nella console Google Cloud, apri la pagina Dataproc Metastore:
Nella pagina Dataproc Metastore, fai clic sul servizio da aggiornare.
Viene visualizzata la pagina Dettagli del servizio.
Nella scheda Configurazione, fai clic su Modifica.
Viene visualizzata la pagina Modifica servizio.
Nella sezione Protocollo endpoint, seleziona gRPC.
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 ulteriori informazioni, consulta Accedere agli endpoint gRPC.
Interfaccia a riga di comando gcloud
Per aggiornare un protocollo degli endpoint, esegui questo comando
gcloud metastore services update
:gcloud metastore services update SERVICE \ --endpoint-protocol=ENDPOINT_PROTOCOL
Sostituisci quanto segue:
SERVICE
: il nome del tuo Dataproc Metastore completamente gestito di Google Cloud.ENDPOINT_PROTOCOL
: il protocollo dell'endpoint aggiornamento per il servizio Dataproc Metastore. Puoi specificare sologrpc
.
Verifica che l'aggiornamento sia andato a buon fine.
Dopo l'aggiornamento a un endpoint gRPC, devi concedere ulteriori autorizzazioni IAM autorizzazioni al tuo servizio. Per ulteriori informazioni, consulta 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.
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 tuo Dataproc Metastore completamente gestito di Google Cloud.