本页介绍了如何为 Dataproc Metastore 选择端点协议。
您可以在创建 Dataproc Metastore 服务时先选择端点协议。此选择会影响您可以与服务集成和使用的功能。请务必注意,选择端点协议后,如果您想更改该协议,则会受到一些限制。请务必选择适合您需求的协议。
如需了解端点协议之间的差异,请参阅关于端点协议。
准备工作
- 在您的项目中启用 Dataproc Metastore。
- 了解与您的项目相关的特定网络要求。
所需的角色
如需获得创建 Dataproc Metastore 所需的权限,请让管理员根据最小权限原则向您授予项目的以下 IAM 角色:
- 
  
  
    
      授予对 Dataproc Metastore 资源的完全控制权  (roles/metastore.editor)
- 
  
  
    
      授予对所有 Dataproc Metastore 资源的完整访问权限,包括 IAM 政策管理  (roles/metastore.admin)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
      
        此预定义角色包含创建 Dataproc Metastore 所需的  metastore.services.create 权限。
      
    
  
  
    
      
选择端点协议
以下示例简要展示了您选择端点协议时需要遵循的步骤。如需查看有关整个流程的完整分步说明,请参阅创建 Dataproc Metastore。
对于新的 Dataproc Metastore 服务
如需首次创建 Dataproc Metastore 服务并选择端点协议,请按照以下说明操作:
控制台
- 在 Google Cloud 控制台中,打开 Dataproc Metastore 页面: 
- 在 Dataproc Metastore 导航菜单中,点击创建。 - 此时会打开创建服务页面。 
- 在端点协议部分中,选择 Thrift 或 gRPC。 - Thrift 是默认预选的端点协议。 - 您只能将现有端点协议从 Thrift 更新为 gRPC。如果您想从 gRPC 迁移到 Thrift,请创建新的 Dataproc Metastore 服务。 
- 根据需要,为您的服务选择其余配置。 
- 如需创建并启动服务,请点击提交。 - 如果您选择了 gRPC 端点,则必须向您的服务授予额外的 IAM 权限。如需了解详情,请参阅访问 gRPC 端点。 
gcloud CLI
- 如需选择端点协议,请运行以下 - gcloud metastore services create命令:- gcloud metastore services create SERVICE \ --endpoint-protocol=ENDPOINT_PROTOCOL ; default="thrift" - 替换以下内容: - SERVICE_ID:Dataproc Metastore 服务的名称或 ID。
- ENDPOINT_PROTOCOL:您要为 Dataproc Metastore 使用的端点协议。您可以指定- thrift或- grpc。- Thrift 是默认预选的端点协议。 - 您只能将现有端点协议从 Thrift 更新为 gRPC。如果您想从 gRPC 迁移到 Thrift,则必须创建新服务。 
 
- 验证您的服务是否已成功创建。 - 如果您选择了 gRPC 端点协议,则必须向您的账号添加额外的 IAM 权限。如需了解详情,请参阅访问 gRPC 端点。 
对于现有 Dataproc Metastore 服务
如需更新现有 Dataproc Metastore 服务的端点协议,请按照以下说明操作:
控制台
- 在 Google Cloud 控制台中,打开 Dataproc Metastore 页面: 
- 在 Dataproc Metastore 页面上,点击要更新的服务。 - 服务详细信息页面会打开。 
- 在配置标签页中,点击修改。 - 系统随即会打开修改服务页面。 
- 在端点协议部分,选择 gRPC。 
- 如需更新服务,请点击提交。 - 更新为 gRPC 端点协议后,您必须向自己的账号添加额外的 IAM 权限。如需了解详情,请参阅访问 gRPC 端点。 
gcloud CLI
- 如需更新端点协议,请运行以下 - gcloud metastore services update命令:- gcloud metastore services update SERVICE \ --endpoint-protocol=ENDPOINT_PROTOCOL - 替换以下内容: - SERVICE:Dataproc Metastore 服务的名称。
- ENDPOINT_PROTOCOL:您要为 Dataproc Metastore 服务更新的端点协议。您只能指定- grpc。
 
- 验证更新是否成功。 - 更新为 gRPC 端点后,您必须向服务授予额外的 IAM 权限。如需了解详情,请参阅访问 gRPC 端点。 
查找端点 URI 值
控制台
您可以在 Dataproc Metastore 页面上查看端点 URI。
- 对于 Thrift 端点,网址值以 thrift://开头
- 对于 gRPC 端点,网址值以 https://开头
下图展示了配置了 gRPC 端点协议的 Dataproc Metastore 服务示例。

gcloud CLI
如需查看端点 URI,请运行以下 gcloud metastore services describe 命令:
gcloud metastore services describe SERVICE --format="get(endpointUri)"
替换以下内容:
- SERVICE:Dataproc Metastore 服务的名称。