Dataproc Metastore 서비스 업데이트

이 페이지에서는 Dataproc Metastore 서비스를 업데이트하는 방법을 설명합니다.

Dataproc Metastore 서비스를 업데이트하여 구성 설정을 변경하거나 선택적인 기능을 사용 설정 또는 사용 중지합니다.

시작하기 전에

필요한 역할

Dataproc Metastore 서비스를 업데이트하는 데 필요한 권한을 얻으려면 최소 권한의 원칙에 따라 관리자에게 프로젝트에 대해 다음 IAM 역할을 부여해 달라고 요청하세요.

Dataproc Metastore 리소스 전체 제어 권한 부여(roles/metastore.editor)
IAM 정책 관리를 포함한 모든 Dataproc Metastore 리소스에 대한 전체 액세스 권한 부여(roles/metastore.admin)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 Dataproc Metastore 서비스를 업데이트하는 데 필요한 metastore.services.update 권한이 포함되어 있습니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

특정 Dataproc Metastore 역할 및 권한에 대한 자세한 내용은 Dataproc Metastore IAM 개요를 참조하세요.

서비스 업데이트 정보

다음 Dataproc Metastore 매개변수를 업데이트할 수 있습니다.

포트 번호. Apache Thrift 인터페이스의 TCP 포트 번호를 업데이트합니다.
서비스 등급. 개발자 서비스 등급 또는 엔터프라이즈 서비스 등급으로 전환합니다. 이러한 등급은 서비스 용량에 영향을 줍니다.
Data Catalog 동기화. Data Catalog 동기화 기능을 설정 또는 해제합니다.
유지보수 기간. 요일 및 시간을 포함하여 유지보수 기간의 빈도를 변경합니다.
Kerberos. Kerberos 인증을 사용 설정 또는 사용 중지합니다. 이전에 사용 설정한 경우 Kerberos 구성 파일을 업데이트할 수 있습니다.
Hive 메타스토어 구성. Hive 웨어하우스 디렉터리의 위치를 업데이트합니다.
보조 버전 구성(미리보기). 추가적인 보조 버전을 사용 설정, 사용 중지, 추가합니다.
라벨. 메타데이터를 설명하는 선택적인 라벨을 추가 또는 삭제합니다.
배율. 배율을 변경합니다. 자동 확장을 사용 설정하거나 사용 중지하고 최소 또는 최대 배율을 업데이트할 수 있습니다.

서비스 업데이트

업데이트를 실행하기 전 다음 고려사항을 참조하세요.

각 Dataproc Metastore 서비스에 대해 한 번에 하나만 업데이트 작업을 실행할 수 있습니다.
단일 업데이트 작업으로 여러 매개변수를 업데이트할 수 있습니다.
업데이트 중에도 Dataproc Metastore를 계속 사용할 수 있습니다.

업데이트에 성공하면 Dataproc Metastore가 자동으로 활성 상태로 전환됩니다. 업데이트에 실패하면 Dataproc Metastore 서비스가 이전의 정상 상태로 롤백됩니다.

다음 안내에서는 Dataproc Metastore 서비스를 업데이트하는 방법을 보여줍니다.

콘솔

Google Cloud 콘솔에서 Dataproc Metastore 페이지를 엽니다.

Dataproc Metastore 열기
Dataproc Metastore 페이지에서 업데이트하려는 서비스 이름을 클릭합니다.

서비스 세부정보 페이지가 열립니다.

Dataproc Metastore 서비스 세부정보 페이지
구성 탭에서 수정을 클릭합니다.

서비스 수정 페이지가 열립니다.
서비스에 대해 업데이트할 값을 선택합니다.
제출을 클릭합니다.

Dataproc Metastore 페이지로 돌아가서 서비스가 성공적으로 업데이트되었는지 확인합니다.

gcloud CLI

서비스를 업데이트하려면 다음 gcloud metastore services update 명령어를 실행합니다.
```
gcloud metastore services update SERVICE \
    --location=LOCATION \
    --port=PORT \
    --tier=TIER \
    --maintenance-window-day=MAINTENANCE_WINDOW_DAY \
    --maintenance-window-hour=MAINTENANCE_WINDOW_HOUR \
    --kerberos_principal=KERBEROS_PRINCIPAL \
    --keytab=KEYTAB \
    --krb5-config=KRB5_CONFIG \
    --update-hive-metastore-configs-from-file=[KEY=VALUE, ...] \
    --clear-hive-metastore-configs \
    --remove-hive-metastore-configs=[KEY, ...] \
    --update-labels=[KEY=VALUE, ...] \
    --clear-labels \
    --remove-labels=[KEY, ...]
```
다음을 바꿉니다.
- SERVICE: Dataproc Metastore 서비스 이름입니다.
- LOCATION: Dataproc Metastore 서비스가 있는 Google Cloud 리전입니다.
- PORT: 선택사항: Dataproc Metastore 서비스에 사용 중인 Thrift 인터페이스의 TCP 포트입니다.
- TIER: 선택사항: Dataproc Metastore 서비스의 등급 용량입니다.
- MAINTENANCE_WINDOW_DAY: 선택사항: 서비스 범위가 시작되는 요일입니다.
- MAINTENANCE_WINDOW_HOUR: 선택사항: 서비스 범위가 시작되는 시간입니다.
- KERBEROS_PRINCIPAL: 선택사항: Keytab 및 KDC 모두에 있는 Kerberos 주 구성원입니다. 일반적으로 'primary/instance@REALM' 주 구성원 형식이 사용되지만, 정확한 형식은 없습니다.
- KEYTAB: 선택사항: Kerberos 키 배포 센터로 서비스 주 구성원을 인증하기 위해 사용되는 Kerberos Keytab 파일입니다.
- KRB5_CONFIG: 선택사항: krb5.config 파일은 KDC 위치와 렐름 및 Kerberos 애플리케이션의 기본값이 포함된 KDC 및 Kerberos 렐름 정보를 지정합니다.
- [KEY, ...]: 선택사항: 업데이트할 Hive 메타스토어 구성입니다. 이 필드에 변수가 있으면 해당 값이 업데이트됩니다. 그렇지 않으면 새 변수가 생성됩니다. 이 플래그를 설정하면 -clear-hive-metastore-configs도 자동으로 설정됩니다.
- [KEY, ...]: 선택사항: 삭제하려는 Hive 메타스토어 구성입니다.
- [KEY=VALUE, ...]: 선택사항: 업데이트할 라벨 또는 Hive 메타스토어 키-값 쌍 구성입니다.
- [KEY, ...]: 선택사항: 삭제하려는 라벨 또는 Hive 메타스토어 키-값 쌍 구성입니다.
업데이트가 성공했는지 확인합니다.

REST

API 안내에 따라 API 탐색기를 사용하여 서비스를 업데이트합니다.

Hive 메타스토어 웨어하우스 구성 업데이트

Hive 웨어하우스 디렉터리가 Cloud Storage에 있으면 Metastore 구성 재정의를 설정해야 합니다. 이 재정의는 특정 데이터 웨어하우스를 Dataproc Metastore의 기본 웨어하우스 디렉터리로 설정합니다.

이 재정의를 설정하려면 먼저 Dataproc Metastore 서비스에 웨어하우스 디렉터리에 액세스하기 위한 객체 읽기 및 쓰기 권한이 있는지 확인합니다. 자세한 내용은 Hive 웨어하우스 디렉터리를 참조하세요.

다음 안내에서는 Hive Metastore 구성 재정의를 업데이트하는 방법을 보여줍니다.

콘솔

Google Cloud 콘솔에서 Dataproc Metastore 페이지를 엽니다.

Dataproc Metastore 열기
Dataproc Metastore 페이지에서 업데이트하려는 서비스 이름을 클릭합니다.

서비스 세부정보 페이지가 열립니다.
구성 탭에서 수정을 클릭합니다.

서비스 수정 페이지가 열립니다.
Metastore 구성 재정의에 다음을 입력합니다.
- 키: hive.metastore.warehouse.dir 값을 입력합니다.
- 값: 웨어하우스 디렉터리의 Cloud Storage 위치입니다. 예를 들면 gs://my-bucket/path/to/location입니다.
제출을 클릭합니다.

Dataproc Metastore 페이지로 돌아가서 서비스가 성공적으로 업데이트되었는지 확인합니다.

gcloud

서비스를 업데이트하려면 다음 gcloud metastore services update 명령어를 실행합니다.
```
gcloud metastore services update SERVICE \
    --location=LOCATION \
    --update-hive-metastore-configs="hive.metastore.warehouse.dir=CUSTOMER_DIR"
```
다음을 바꿉니다.
- SERVICE: Dataproc Metastore 서비스 이름입니다.
- LOCATION: Dataproc Metastore 서비스가 있는 Google Cloud 리전입니다.
- CUSTOMER_DIR: 웨어하우스 디렉터리의 Cloud Storage 위치입니다. 예를 들면 gs://my-bucket/path/to/location입니다.
업데이트가 성공했는지 확인합니다.