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

> ## 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.

# testConnectExternalHiveMetaStore

VPC 환경에서 이용 가능합니다.

## 개요

사용자 계정에 생성된 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를 추가해주시고 모든 통신을 허용하셔야 정상적인 연동이 가능합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| 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 (VPC) 인스턴스 번호 - cloudMysqlInstanceNo는 [getCloudHadoopMysqlInstanceList](/docs/cli-vhadoop-getcloudhadoopmysqlinstancelist) 액션을 통해 획득 가능 |
| cloudMysqlUserName | Yes | String |  | - Hive 메타스토어를 연동 가능한 지 테스트할 Cloud DB for MySQL (VPC) 접근 유저명 - cloudMysqlUserName는 [getCloudHadoopMysqlUserList](/docs/cli-vhadoop-getcloudhadoopmysqluserlist) 액션을 통해 획득 가능 |
| cloudMysqlUserPassword | Yes | String | 영어/특수문자/숫자 3개 항목에 대해 1자 이상 포함되어야 함 ` & + \ " ' / 스페이스는 패스워드로 사용 불가 Min: 9 Max: 20 | - Hive 메타스토어를 연동 가능한 지 테스트할 Cloud DB for MySQL (VPC) 접근 유저 패스워드 |
| output | No | String |  | - 응답 결과의 포맷 타입 - Options: xml \| json - Default: xml |

## 예시

### 호출

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

### 응답

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