Elige un protocolo de extremo para Dataproc Metastore

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 elijas un protocolo de extremo, habrá algunas restricciones si deseas cambiarlo. Asegúrate de elegir el protocolo adecuado para tus necesidades.

Para comprender las diferencias entre los protocolos de extremos, consulta Acerca de los protocolos de extremos.

Antes de comenzar

Funciones requeridas

Para obtener el permiso que necesitas para crear un almacén de metadatos de Dataproc, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto, según el principio de privilegio mínimo:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso metastore.services.create, que se requiere para crear un metastore de Dataproc.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre los roles y permisos específicos de Dataproc Metastore, consulta Administra el acceso a Dataproc con 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 completas sobre todo el proceso que debes seguir, consulta Crea un Dataproc Metastore.

Para un servicio de Dataproc Metastore nuevo

Para crear un servicio de Dataproc Metastore y elegir el protocolo de extremo por primera vez, sigue estas instrucciones:

Console

  1. En la Google Cloud consola, abre la página Dataproc Metastore:

    Abrir Dataproc Metastore

  2. En el menú de navegación de Dataproc Metastore, haz clic en Crear.

    Se abrirá la página Crear servicio.

  3. En la sección Protocolo de extremo, 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 migrar de gRPC a Thrift, crea un servicio nuevo de Dataproc Metastore.

  4. Elige las configuraciones restantes para tu servicio, según sea necesario.

  5. Haz clic en Enviar para crear y, luego, iniciar el servicio.

    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.

gcloud CLI

  1. Para elegir un protocolo de extremo, ejecuta el siguiente comando de gcloud metastore services create:

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

    Reemplaza lo siguiente:

    • SERVICE_ID: Es el nombre o ID de tu servicio de Dataproc Metastore.

    • ENDPOINT_PROTOCOL: Es el protocolo de extremo que deseas usar para tu Dataproc Metastore. Puedes especificar 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 cambiar de gRPC a Thrift, debes crear un servicio nuevo.

  2. Verifica que tu servicio se haya creado correctamente.

    Si seleccionaste un protocolo de extremo 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 de Dataproc Metastore existente

Para actualizar el protocolo de extremo de un servicio de Dataproc Metastore existente, sigue estas instrucciones:

Console

  1. En la Google Cloud consola, abre la página Dataproc Metastore:

    Abrir Dataproc Metastore

  2. En la página Dataproc Metastore, haz clic en el servicio que quieres actualizar.

    Se abrirá la página Detalles del servicio.

  3. En la pestaña Configuración, haz clic en Editar.

    Se abrirá la página Editar servicio.

  4. En la sección Protocolo de extremo, selecciona gRPC.

  5. Para actualizar el servicio, haz clic en Enviar.

    Después de actualizar el protocolo del 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.

gcloud CLI

  1. Para actualizar un protocolo de extremo, ejecuta el siguiente comando de 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 para el que deseas actualizar tu servicio de Dataproc Metastore. Solo puedes especificar grpc.

  2. Verifica que la actualización se haya realizado correctamente.

    Después de actualizar a un extremo de gRPC, debes otorgar permisos adicionales de IAM a tu servicio. Para obtener más información, consulta Cómo acceder a los extremos de gRPC.

Cómo encontrar el valor del URI de tu extremo

Console

Puedes ver el URI de tu extremo en la página Dataproc Metastore.

  • Para los extremos de Thrift, el valor de URL comienza con thrift://.
  • En el caso de los extremos de gRPC, el valor de 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.

URL de detalles del servicio y valores hive.metastore.warehouse.dir

gcloud CLI

Para ver el URI de tu extremo, ejecuta el siguiente comando de 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.

¿Qué sigue?