本頁說明如何為 Dataproc Metastore 選擇端點通訊協定。
建立 Dataproc Metastore 服務時，您會先選擇端點通訊協定。這項選擇會影響您可與服務整合及使用的功能。請注意，選擇端點通訊協定後，如要變更，會有一些限制。請務必選擇符合需求的通訊協定。
如要瞭解端點通訊協定之間的差異，請參閱「關於端點通訊協定」。
事前準備
必要的角色
如要取得建立 Dataproc Metastore 所需的權限，請要求管理員根據最低權限原則，授予您專案的下列 IAM 角色：
-
授予 Dataproc Metastore 資源的完整控制權 (
roles/metastore.editor) -
授予所有 Dataproc Metastore 資源的完整存取權，包括身分與存取權管理政策管理權 (
roles/metastore.admin)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
這個預先定義的角色具備 metastore.services.create 權限，這是建立 Dataproc Metastore 的必要權限。
選擇端點通訊協定
以下範例簡要說明選擇端點通訊協定的步驟。如需完整逐步操作說明，請參閱建立 Dataproc Metastore。
適用於新的 Dataproc Metastore 服務
如要建立 Dataproc Metastore 服務並首次選擇端點通訊協定，請按照下列操作說明進行：
控制台
在 Google Cloud 控制台中，開啟 Dataproc Metastore 頁面：
在「Dataproc Metastore」導覽選單中，按一下「建立」。
「建立服務」頁面隨即開啟。
在「端點通訊協定」部分，選取「Thrift」或「gRPC」。
Thrift 是預先選取的預設端點通訊協定。
您只能將現有端點通訊協定從 Thrift 更新為 gRPC。如要從 gRPC 遷移至 Thrift，請建立新的 Dataproc Metastore 服務。
視需要選擇服務的其餘設定。
如要建立並啟動服務，請按一下「Submit」(提交)。
如果您選取 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」頁面中，按一下要更新的服務。
「服務詳細資料」頁面隨即開啟。
在「Configuration」分頁中，按一下「Edit」。
「編輯服務」頁面隨即開啟。
在「Endpoint protocol」(端點通訊協定) 專區中，選取「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 服務的名稱。