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 Metastore do Dataproc. 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, conceda 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 um 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