---
title: "saveExternalHiveMetaStore"
slug: "cli-vhadoop-saveexternalhivemetastore"
tags: ["Cloud Hadoop"]
updated: 2026-05-21T09:01:59Z
published: 2026-05-21T09:11:30Z
canonical: "cli-gov.ncloud-docs.com/cli-vhadoop-saveexternalhivemetastore"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli-gov.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 형태의 database가 생성됩니다.
메타스토어 연동 계정은 DDL 권한만 지원됩니다.

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

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

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

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

## 예시<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>
```