Escolher um protocolo de endpoint para o Dataproc Metastore

Nesta página, explicamos como escolher um protocolo de endpoint para o metastore do Dataproc.

Primeiro, escolha o protocolo de endpoint ao criar um serviço do Dataproc Metastore. Essa escolha afeta os recursos que você pode integrar e usar com seu serviço. É importante observar que, depois de escolher um protocolo de endpoint, há algumas restrições se você quiser mudá-lo. Escolha o protocolo adequado às suas necessidades.

Para entender as diferenças entre os protocolos de endpoint, consulte Sobre protocolos de endpoint.

Antes de começar

Papéis necessários

Para receber a permissão necessária para criar um metastore do Dataproc, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto, com base no princípio de privilégio mínimo:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão metastore.services.create, que é necessária para criar um metastore do Dataproc.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre papéis e permissões específicos do metastore do Dataproc, consulte Gerenciar o acesso do Dataproc com o IAM.

Escolher um protocolo de endpoint

Os exemplos a seguir mostram uma versão abreviada das etapas que você segue para escolher um protocolo de endpoint. Para instruções detalhadas sobre todo o processo, consulte Criar um metastore do Dataproc.

Para um novo serviço do metastore do Dataproc

Para criar um serviço do metastore do Dataproc e escolher o protocolo de endpoint pela primeira vez, siga estas instruções:

Console

  1. No console do Google Cloud , abra a página Metastore do Dataproc:

    Abrir o metastore do Dataproc

  2. No menu de navegação do Dataproc Metastore, clique em Criar.

    A página Criar serviço é aberta.

  3. Na seção Protocolo de endpoint, selecione Thrift ou gRPC.

    O Thrift é o protocolo de endpoint pré-selecionado padrão.

    Só é possível atualizar um protocolo de endpoint de Thrift para gRPC. Se você quiser migrar do gRPC para o Thrift, crie um novo serviço do metastore do Dataproc.

  4. Escolha as configurações restantes para seu serviço, conforme necessário.

  5. Para criar e iniciar o serviço, clique em Enviar.

    Se você selecionou um endpoint gRPC, conceda outras permissões do IAM ao seu serviço. Para mais informações, consulte Acessar endpoints gRPC.

CLI da gcloud

  1. Para escolher um protocolo de endpoint, execute o seguinte comando gcloud metastore services create:

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

    Substitua:

    • SERVICE_ID: o nome ou ID do seu serviço do Dataproc Metastore.

    • ENDPOINT_PROTOCOL: o protocolo de endpoint que você quer usar para o metastore do Dataproc. É possível especificar thrift ou grpc.

      O Thrift é o protocolo de endpoint pré-selecionado padrão.

      Só é possível atualizar um protocolo de endpoint de Thrift para gRPC. Se você quiser migrar do gRPC para o Thrift, crie um novo serviço.

  2. Verifique se o serviço foi criado com sucesso.

    Se você selecionou um protocolo de endpoint gRPC, adicione mais permissões do IAM à sua conta. Para mais informações, consulte Acessar endpoints gRPC.

Para um serviço do metastore do Dataproc atual

Para atualizar o protocolo de endpoint de um serviço do metastore do Dataproc, siga estas instruções:

Console

  1. No console do Google Cloud , abra a página Metastore do Dataproc:

    Abrir o metastore do Dataproc

  2. Na página Metastore do Dataproc, clique no serviço que você quer atualizar.

    A página Detalhes do serviço é aberta.

  3. Na guia Configuração, clique em Editar.

    A página Editar serviço é aberta.

  4. Na seção Protocolo de endpoint, selecione gRPC.

  5. Para atualizar o serviço, clique em Enviar.

    Depois de atualizar para o protocolo de endpoint gRPC, adicione mais permissões do IAM à sua conta. Para mais informações, consulte Acessar endpoints gRPC.

CLI da gcloud

  1. Para atualizar um protocolo de endpoint, execute o seguinte comando gcloud metastore services update:

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

    Substitua:

    • SERVICE: o nome do seu serviço do metastore do Dataproc.
    • ENDPOINT_PROTOCOL: o protocolo de endpoint que você quer atualizar para o serviço do metastore do Dataproc. É possível especificar apenas grpc.

  2. Verifique se a atualização foi concluída.

    Depois de atualizar para um endpoint gRPC, conceda outras permissões do IAM ao seu serviço. Para mais informações, consulte Acessar endpoints gRPC.

Encontrar o valor do URI do endpoint

Console

É possível conferir o URI do endpoint na página Metastore do Dataproc.

  • Para endpoints Thrift, o valor URL começa com thrift://.
  • Para endpoints gRPC, o valor URL começa com https://

A imagem a seguir mostra um exemplo de serviço do Dataproc Metastore configurado com um protocolo de endpoint gRPC.

URL de detalhes do serviço e valores hive.metastore.warehouse.dir

CLI da gcloud

Para conferir o URI do endpoint, execute o seguinte comando gcloud metastore services describe:

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

Substitua:

  • SERVICE: o nome do seu serviço do metastore do Dataproc.

A seguir