Escolha um protocolo de endpoint para o metastore do Dataproc

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

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, uma vez quando você escolhe um protocolo de endpoint, há algumas restrições alterá-la. Escolha o protocolo apropriado 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 ter a permissão necessária para criar um metastore do Dataproc, peça ao administrador para conceder a você papéis do IAM a seguir 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 metastore.services.create permissão, que é necessário 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 as funções e permissões específicas 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 resumida das etapas seguidas para escolher um protocolo de endpoint. Para instruções detalhadas sobre processo que precisa ser seguido, consulte Criar um metastore do Dataproc.

Para um novo serviço do metastore do Dataproc

Para criar um serviço do Dataproc Metastore e escolha o da API Cloud Endpoints pela primeira vez, siga estas instruções:

Console

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

    Abra o metastore do Dataproc

  2. No menu de navegação do 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 protocolos de endpoint atuais do Thrift para o gRPC. Se quiser migrar do gRPC para o Thrift, crie uma serviço Metastore do Dataproc.

  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, será necessário conceder permissões do IAM adicionais 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 seguinte comando gcloud metastore services create:

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

    Substitua:

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

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

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

      Só é possível atualizar protocolos de endpoint atuais do Thrift para o 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 atual do metastore do Dataproc

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

Console

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

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

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

    Depois de atualizar para o protocolo de endpoint gRPC, é preciso adicionar 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 seguinte comando gcloud metastore services update:

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

    Substitua:

    • SERVICE: o nome do seu metastore do Dataproc serviço.
    • ENDPOINT_PROTOCOL: o protocolo de endpoint que você que você quer atualizar para o serviço do metastore do Dataproc. Você pode especificar somente 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

Confira 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 metastore do Dataproc configurado com um protocolo de endpoint do gRPC.

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

CLI da gcloud

Para ver o URI do endpoint, execute este comando gcloud metastore services describe:

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

Substitua:

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

A seguir