Escolher um protocolo de endpoint para o Dataproc Metastore

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

Primeiro, escolha o protocolo de endpoint ao criar um serviço do Dataproc Metastore. Essa escolha afeta os recursos que podem ser integrados e usados com seu serviço. É importante observar que, depois de escolher um protocolo de endpoint, há algumas restrições se você quiser mudar. Escolha o protocolo adequado para suas necessidades.

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

Antes de começar

Papéis necessários

Para receber a permissão necessária para criar uma 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 uma 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 Dataproc Metastore, consulte Gerenciar o acesso ao 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 conferir instruções detalhadas sobre todo o processo, consulte Criar uma 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:

    Metastore do Dataproc aberta

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

    A página Criar serviço é aberta.

  3. Na seção Protocolo do 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 mudar do gRPC para o Thrift, crie um novo serviço do Dataproc Metastore.

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

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

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

CLI da gcloud

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

    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 mudar do gRPC para o Thrift, crie um novo serviço.

  2. Verifique se o serviço foi criado.

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

Para um serviço do metastore do Dataproc

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:

    Metastore do Dataproc aberta

  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 do endpoint, selecione gRPC.

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

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

CLI da gcloud

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

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

    Substitua:

    • SERVICE: o nome do serviço do metastore do Dataproc.
    • ENDPOINT_PROTOCOL: o protocolo de endpoint que você quer atualizar para o serviço do Dataproc Metastore. Só é possível especificar 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 do gRPC.

Encontrar o valor do URI do endpoint

Console

Você pode conferir o URI do endpoint na página Metastore do Dataproc.

  • Para endpoints Thrift, o valor do URL começa com thrift://
  • Para endpoints gRPC, o valor do 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 serviço do metastore do Dataproc.

A seguir