이 페이지에서는 Dataproc Metastore에 대해 엔드포인트 프로토콜을 선택하는 방법을 설명합니다.
먼저 Dataproc Metastore 서비스를 만들 때 엔드포인트 프로토콜을 선택합니다. 이 선택에 따라 서비스에 통합 및 사용할 수 있는 기능이 달라집니다. 엔드포인트 프로토콜을 선택한 후에는 이를 변경해야 할 경우 일부 제한사항이 있는지 확인하는 것이 중요합니다. 요구사항에 따라 적합한 프로토콜을 선택해야 합니다.
엔드포인트 프로토콜 간의 차이점을 이해하려면 엔드포인트 프로토콜 정보를 참조하세요.
시작하기 전에
- 프로젝트에서 Dataproc Metastore를 사용 설정합니다.
- 프로젝트별 네트워킹 요구사항을 파악합니다.
필요한 역할
Dataproc Metastore를 만드는 데 필요한 권한을 얻으려면 최소 권한의 원칙에 따라 관리자에게 프로젝트에 대해 다음 IAM 역할을 부여해 달라고 요청하세요.
-
Dataproc Metastore 리소스 전체 제어 권한 부여(
roles/metastore.editor
) -
IAM 정책 관리를 포함한 모든 Dataproc Metastore 리소스에 대한 전체 액세스 권한 부여(
roles/metastore.admin
)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 Dataproc Metastore를 만드는 데 필요한 metastore.services.create
권한이 있습니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
특정 Dataproc Metastore 역할 및 권한에 대한 상세 설명은 IAM으로 Dataproc 액세스 관리를 참조하세요.엔드포인트 프로토콜 선택
다음 예시에서는 엔드포인트 프로토콜을 선택하기 위해 따라야 하는 단계를 요약해서 보여줍니다. 따라야 하는 전체 프로세스에 대한 자세한 단계별 안내는 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 엔드포인트의 경우 URL 값이
thrift://
로 시작합니다. - gRPC 엔드포인트의 경우 URL 값이
https://
로 시작합니다.
다음 이미지는 gRPC 엔드포인트 프로토콜로 구성된 Dataproc Metastore 서비스 예시를 보여줍니다.
gcloud CLI
엔드포인트 URI를 보려면 다음 gcloud metastore services describe
명령어를 실행합니다.
gcloud metastore services describe SERVICE --format="get(endpointUri)"
다음을 바꿉니다.
SERVICE
: Dataproc Metastore 서비스 이름입니다.