Escolha um protocolo de ponto final para o Dataproc Metastore

Esta página explica como escolher um protocolo de ponto final para o Dataproc Metastore.

Primeiro, escolha o protocolo do ponto final quando criar um serviço Dataproc Metastore. Esta escolha afeta as funcionalidades que pode integrar e usar com o seu serviço. É importante ter em atenção que, depois de escolher um protocolo de ponto final, existem algumas restrições se quiser alterá-lo. Certifique-se de que escolhe o protocolo adequado às suas necessidades.

Para compreender as diferenças entre os protocolos de pontos finais, consulte o artigo Acerca dos protocolos de pontos finais.

Antes de começar

Funções necessárias

Para receber a autorização de que precisa para criar um Dataproc Metastore, peça ao seu administrador que lhe conceda as seguintes funções de IAM no seu projeto, com base no princípio do menor privilégio:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém a autorização metastore.services.create , que é necessária para criar um Dataproc Metastore.

Também pode obter esta autorização com funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções e as autorizações específicas do Dataproc Metastore, consulte o artigo Faça a gestão do acesso ao Dataproc com a IAM.

Escolha um protocolo de ponto final

Os exemplos seguintes mostram uma versão abreviada dos passos que segue para escolher um protocolo de ponto final. Para ver instruções passo a passo completas sobre todo o processo que tem de seguir, consulte o artigo Crie um Dataproc Metastore.

Para um novo serviço de Metastore do Dataproc

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

Consola

  1. Na Google Cloud consola, abra a página Dataproc Metastore:

    Abra o Dataproc Metastore

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

    É apresentada a página Criar serviço.

  3. Na secção Protocolo de ponto final, selecione Thrift ou gRPC.

    O Thrift é o protocolo de ponto final pré-selecionado predefinido.

    Só pode atualizar um protocolo de ponto final existente de Thrift para gRPC. Se quiser mudar de gRPC para Thrift, crie um novo serviço Dataproc Metastore.

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

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

    Se selecionou um ponto final gRPC, tem de conceder autorizações de IAM adicionais ao seu serviço. Para mais informações, consulte o artigo Aceda aos pontos finais gRPC.

CLI gcloud

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

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

    Substitua o seguinte:

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

    • ENDPOINT_PROTOCOL: o protocolo de ponto final que quer usar para o seu Dataproc Metastore. Pode especificar thrift ou grpc.

      O Thrift é o protocolo de ponto final pré-selecionado predefinido.

      Só pode atualizar um protocolo de ponto final existente de Thrift para gRPC. Se quiser mudar do gRPC para o Thrift, tem de criar um novo serviço.

  2. Verifique se o serviço foi criado com êxito.

    Se selecionou um protocolo de ponto final gRPC, tem de adicionar autorizações de IAM adicionais à sua conta. Para mais informações, consulte o artigo Aceda aos pontos finais gRPC.

Para um serviço de Metastore do Dataproc existente

Para atualizar o protocolo do ponto final de um serviço Dataproc Metastore existente, siga estas instruções:

Consola

  1. Na Google Cloud consola, abra a página Dataproc Metastore:

    Abra o Dataproc Metastore

  2. Na página Dataproc Metastore, clique no serviço a atualizar.

    É apresentada a página Detalhes do serviço.

  3. No separador Configuração, clique em Editar.

    É apresentada a página Editar serviço.

  4. Na secção Protocolo de ponto final, selecione gRPC.

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

    Após a atualização para o protocolo de ponto final gRPC, tem de adicionar autorizações da IAM adicionais à sua conta. Para mais informações, consulte o artigo Aceda aos pontos finais gRPC.

CLI gcloud

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

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

    Substitua o seguinte:

    • SERVICE: o nome do seu serviço de Metastore do Dataproc.
    • ENDPOINT_PROTOCOL: o protocolo de ponto final que quer atualizar para o seu serviço Dataproc Metastore. Só pode especificar grpc.

  2. Verifique se a atualização foi bem-sucedida.

    Depois de fazer a atualização para um ponto final gRPC, tem de conceder autorizações do IAM adicionais ao seu serviço. Para mais informações, consulte o artigo Aceda aos pontos finais gRPC.

Encontre o valor do URI do ponto final

Consola

Pode ver o URI do ponto final na página Dataproc Metastore.

  • Para pontos finais Thrift, o valor URL começa por thrift://
  • Para pontos finais gRPC, o valor URL começa com https://

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

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

CLI gcloud

Para ver o URI do ponto final, execute o seguinte comando gcloud metastore services describe:

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

Substitua o seguinte:

  • SERVICE: o nome do seu serviço de Metastore do Dataproc.

O que se segue?