---
title: "saveExternalHiveMetaStore"
slug: "cli-vhadoop-saveexternalhivemetastore"
tags: ["Cloud DB for MySQL", "Cloud Hadoop", "VPC"]
updated: 2026-04-23T08:56:50Z
published: 2026-04-23T08:58:50Z
canonical: "cli.ncloud-docs.com/cli-vhadoop-saveexternalhivemetastore"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# saveExternalHiveMetaStore

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

## 개요<a name="개요"></a>

사용자 계정에 생성된 Cloud DB for MySQL (VPC) 데이터베이스에 Cloud Hadoop Hive 메타스토어를 연동합니다.

클러스터당 USER_ID + HOST(IP) 단위로 연동 계정 1개만 추가 가능합니다.

MySQL 8.0.x 버전에서만 연동이 가능하며, Cloud DB for MySQL (VPC) 상태가 운영중인 경우만 지원되는 기능입니다.
TEST CONNECTION 기능 수행시 hive_*_CHadoop 형태의 데이터베이스가 생성됩니다.
메타스토어 연동 계정은 DDL 권한만 지원됩니다.

사전 작업으로 Cloud DB for MySQL (VPC) ACG에 Cloud Hadoop 에서 사용하는 ACG를 추가해주시고 모든 통신을 허용하셔야 정상적인 연동이 가능합니다.

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| ----- | ----- | ----- | ----- | ----- |
| regionCode | No | String | |리전 코드<ul><li> Hive 메타스토어가 연동될 리전(Region) 결정 가능 </li><li>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 </li><li> Default: getRegionList 조회 결과의 첫 번째 리전을 선택</li></ul> |
| cloudHadoopInstanceNo | Yes | String | |Cloud Hadoop 인스턴스 번호<ul><li>  cloudHadoopInstanceNo는 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해 획득 가능</li></ul> |
| cloudMysqlInstanceNo | Yes | String | | Hive 메타스토어를 연동할 Cloud DB for MySQL (VPC) 인스턴스 번호 <ul><li>cloudMysqlInstanceNo는 [getCloudHadoopMysqlInstanceList](/docs/cli-vhadoop-getcloudhadoopmysqlinstancelist) 액션을 통해 획득 가능</li></ul>  |
| cloudMysqlUserName | Yes | String | |Hive 메타스토어를 연동할 Cloud DB for MySQL (VPC) 접근 유저명 <ul><li> cloudMysqlUserName는 [getCloudHadoopMysqlUserList](/docs/cli-vhadoop-getcloudhadoopmysqluserlist) 액션을 통해서 획득 가능 </li></ul> |
| cloudMysqlUserPassword | Yes | String | 영어/특수문자/숫자 3개 항목에 대해 1자 이상 포함되어야 함<br > \` & + \ " ' / 스페이스 는 패스워드로 사용 불가<br/> Min: 8 <br/> Max: 20 |Hive 메타스토어를 연동할 Cloud DB for MySQL (VPC) 접근 유저 패스워드 |
| output | No | String | |응답 결과의 포맷 타입  <ul><li>Options: xml \| json</li><li> Default: xml </li></ul> |

## 예시<a name="예시"></a>

### 호출<a name="호출"></a>

```http
ncloud vhadoop saveExternalHiveMetaStore --regionCode KR --cloudHadoopInstanceNo 821***  --cloudMysqlInstanceNo 823*** --cloudMysqlUserName test** --cloudMysqlUserPassword ******
```

### 응답<a name="응답"></a>

```xml
<saveExternalHiveMetaStoreResponse>
    <requestId>65544ec3-8da6-4bf1-9b0c-5957d110bd42</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
</saveExternalHiveMetaStoreResponse>
```