Escolha um protocolo de endpoint para o metastore do Dataproc

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

Primeiro, você escolhe seu protocolo de endpoint ao criar uma serviço Metastore do Dataproc. Essa escolha afeta os recursos que 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 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 do 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.

Escolha 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 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 um protocolo de endpoint de Thrift para gRPC. Se você quiser mudar do gRPC para o Thrift, crie um novo serviço do 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 do 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 protocolos de endpoint atuais do Thrift para o gRPC. Se quiser migrar do gRPC para o Thrift, é necessário criar 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 serviço do metastore do Dataproc, siga estas instruções:

Console

  1. No console do Google Cloud, abra a página do 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, é 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 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. 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 do 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 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