本页介绍了如何为 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 服务的名称。