En esta página, se explica cómo elegir un protocolo de extremo para Dataproc Metastore.
Primero debes elegir el protocolo de extremo cuando creas un servicio de Dataproc Metastore. Esta elección afecta las funciones que puedes integrar y usar con tu servicio. Es importante tener en cuenta que, una vez que eliges un protocolo de extremo, existen algunas restricciones si deseas cambiarlo. Asegúrate de elegir el protocolo adecuado según tus necesidades.
Para comprender las diferencias entre los protocolos de extremos, consulta Acerca de los protocolos de extremos.
Antes de comenzar
- Habilita Dataproc Metastore en tu proyecto.
- Comprende los requisitos de herramientas de redes específicos de tu proyecto.
Funciones requeridas
A fin de obtener el permiso necesario para crear un Dataproc Metastore, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto, según el principio de privilegio mínimo:
-
Otorga control total de los recursos de Dataproc Metastore (
roles/metastore.editor) -
Otorga acceso completo a todos los recursos de Dataproc Metastore, incluida la administración de políticas de IAM (
roles/metastore.admin).
Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.
Esta función predefinida contiene el permiso metastore.services.create, que se necesita para crear un Dataproc Metastore.
Es posible que también puedas obtener este permiso con funciones personalizadas o con otras funciones predefinidas.
Para obtener más información sobre las funciones y los permisos específicos de Dataproc Metastore, consulta Administra el acceso a Dataproc con la IAM.Elige un protocolo de extremo
En los siguientes ejemplos, se muestra una versión abreviada de los pasos que debes seguir para elegir un protocolo de extremo. Para obtener instrucciones paso a paso sobre todo el proceso que debes seguir, consulta Crea un Dataproc Metastore.
Para un servicio nuevo de Dataproc Metastore
Para crear un servicio de Dataproc Metastore y elegir el protocolo de extremos por primera vez, sigue estas instrucciones:
Console
En la consola de Google Cloud, abre la página de Dataproc Metastore:
En el menú de navegación de Dataproc Metastore, haz clic en Crear.
Se abrirá la página Crear servicio.
En la sección Protocolo de extremos, selecciona Thrift o gRPC.
Thrift es el protocolo de extremo preseleccionado predeterminado.
Solo puedes actualizar un protocolo de extremo existente de Thrift a gRPC. Si deseas pasar de gRPC a Thrift, crea un servicio nuevo de Dataproc Metastore.
Elige los parámetros de configuración restantes de tu servicio, según sea necesario.
Para crear e iniciar el servicio, haz clic en Enviar.
Si seleccionaste un extremo de gRPC, debes otorgar permisos de IAM adicionales a tu servicio. Para obtener más información, consulta Cómo acceder a los extremos de gRPC.
CLI de gcloud
Para elegir un protocolo de extremo, ejecuta el siguiente comando
gcloud metastore services create:gcloud metastore services create SERVICE \ --endpoint-protocol=ENDPOINT_PROTOCOL ; default="thrift"
Reemplaza lo siguiente:
SERVICE_ID: El nombre o ID del servicio de Dataproc MetastoreENDPOINT_PROTOCOL: Es el protocolo de extremo que deseas usar para tu Dataproc Metastore. Puedes especificarthriftogrpc.Thrift es el protocolo de extremo preseleccionado predeterminado.
Solo puedes actualizar un protocolo de extremo existente de Thrift a gRPC. Si quieres pasar de gRPC a Thrift, debes crear un servicio nuevo.
Verifica que tu servicio se haya creado correctamente.
Si seleccionaste un protocolo de extremo de gRPC, debes agregar permisos de IAM adicionales a tu cuenta. Para obtener más información, consulta Cómo acceder a los extremos de gRPC.
Para un servicio existente de Dataproc Metastore
Para actualizar el protocolo de extremos de un servicio existente de Dataproc Metastore, sigue estas instrucciones:
Console
En la consola de Google Cloud, abre la página de Dataproc Metastore:
En la página Dataproc Metastore, haz clic en el servicio que deseas actualizar.
Se abrirá la página Detalles del servicio.
En la pestaña Configuración, haz clic en Editar.
Se abrirá la página Editar servicio.
En la sección Protocolo de extremos, selecciona gRPC.
Para actualizar el servicio, haz clic en Enviar.
Después de actualizar el protocolo de extremo de gRPC, debes agregar permisos de IAM adicionales a tu cuenta. Para obtener más información, consulta Cómo acceder a los extremos de gRPC.
CLI de gcloud
Para actualizar un protocolo de extremo, ejecuta el siguiente comando
gcloud metastore services update:gcloud metastore services update SERVICE \ --endpoint-protocol=ENDPOINT_PROTOCOL
Reemplaza lo siguiente:
SERVICE: Es el nombre de tu servicio de Dataproc Metastore.ENDPOINT_PROTOCOL: Es el protocolo de extremo que deseas actualizar para el servicio de Dataproc Metastore. Solo puedes especificargrpc.
Verifica que la actualización se haya realizado correctamente.
Después de actualizar a un extremo de gRPC, debes otorgar permisos de IAM adicionales a tu servicio. Para obtener más información, consulta Cómo acceder a los extremos de gRPC.
Busca el valor del URI del extremo
Console
Puedes ver el URI de tu extremo en la página Dataproc Metastore.
- En el caso de los extremos de Thrift, el valor URL comienza con
thrift://. - Para los extremos de gRPC, el valor de la URL comienza con
https://.
En la siguiente imagen, se muestra un ejemplo de un servicio de Dataproc Metastore configurado con un protocolo de extremo de gRPC.
CLI de gcloud
Para ver el URI de tu extremo, ejecuta el siguiente comando gcloud metastore services describe:
gcloud metastore services describe SERVICE --format="get(endpointUri)"
Reemplaza lo siguiente:
SERVICE: Es el nombre de tu servicio de Dataproc Metastore.