---
title: "saveExternalHiveMetaStore"
slug: "cli-vhadoop-saveexternalhivemetastore"
tags: ["Cloud DB for MySQL ", "Cloud Hadoop", "Hive"]
updated: 2026-04-23T09:04:50Z
published: 2026-04-23T09:07:28Z
canonical: "cli-fin.ncloud-docs.com/cli-vhadoop-saveexternalhivemetastore"
---

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

# saveExternalHiveMetaStore

## 개요

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

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

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

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

## 요청

### 요청 파라미터

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

## 예시

### 호출

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

### 응답

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