---
title: "testConnectExternalHiveMetaStore"
slug: "cli-vhadoop-testconnectexternalhivemetastore"
tags: ["Cloud DB for MySQL", "Cloud Hadoop", "VPC"]
updated: 2026-09-17T09:15:56Z
published: 2026-09-17T09:15:56Z
canonical: "cli.ncloud-docs.com/cli-vhadoop-testconnectexternalhivemetastore"
---

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

# testConnectExternalHiveMetaStore

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

Cloud DB for MySQL에 Cloud Hadoop Hive 메타스토어 연동이 가능한지 확인합니다.

참고

testConnectExternalHiveMetaStore API 호출 시 다음 사항을 참고해 주십시오.

- 클러스터당 USER_ID + HOST(IP) 단위로 계정 1개만 연동 가능
- 클러스터와 MySQL이 동일한 VPC에 있어야 하며, MySQL 8.0.x 버전만 지원
- 메타스토어 연동 계정에 DDL 권한 필요
- Cloud DB for MySQL ACG에 Cloud Hadoop ACG를 추가하는 [사전 작업](https://guide-fin.ncloud-docs.com/docs/hadoop-vpc-12#%EC%82%AC%EC%A0%84%EC%9E%91%EC%97%85) 선행 필요
- Cloud DB for MySQL에서 DB Config 변수 `sql_require_primary_key = OFF`로 설정. [DB Config 관리](https://guide.ncloud-docs.com/docs/database-database-5-2#DBConfig%EA%B4%80%EB%A6%AC) 참조
- 연동 테스트 시 hive_*_CHadoop 형태의 데이터베이스 생성

## 구문

`testConnectExternalHiveMetaStore` 구문은 다음과 같습니다.

```
./ncloud vhadoop testConnectExternalHiveMetaStore \
    --cloudHadoopInstanceNo <cloud-hadoop-instance-no> \
    --cloudMysqlInstanceNo <cloud-mysql-instance-no> \
    --cloudMysqlUserName <cloud-mysql-user-name> \
    --cloudMysqlUserPassword <cloud-mysql-user-password> \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## 옵션

`testConnectExternalHiveMetaStore` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`testConnectExternalHiveMetaStore`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudHadoopInstanceNo` | String | Required | 클러스터 인스턴스 번호 - [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 참조 |
| `--cloudMysqlInstanceNo` | String | Required | Cloud DB for MySQL 인스턴스 번호 - [getCloudHadoopMysqlInstanceList](/docs/cli-vhadoop-getcloudhadoopmysqlinstancelist) 참조 |
| `--cloudMysqlUserName` | String | Required | 데이터베이스 사용자 아이디 - [getCloudHadoopMysqlUserList](/docs/cli-vhadoop-getcloudhadoopmysqluserlist) 참조 |
| `--cloudMysqlUserPassword` | String | Required | 데이터베이스 사용자 계정 비밀번호 - 영문자, 숫자, 특수문자를 조합하여 8~20자 이내로 입력 - 특수문자 `'` `"` ``` `&amp;` `+` `/` `\` 및 공백 사용 불가 |

### 공통 옵션

`vhadoop` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud Hadoop (VPC) 옵션](/docs/cli-vhadoop#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

Hive 메타스토어 연동 가능 여부 확인 요청이 성공하면 요청 처리 결과가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vhadoop testConnectExternalHiveMetaStore \
    --cloudHadoopInstanceNo 34567890 \
    --cloudMysqlInstanceNo 56789012 \
    --cloudMysqlUserName hiveuser \
    --cloudMysqlUserPassword Examplepw123! \
    --regionCode KR \
    --output json
```

### 출력

출력 예시는 다음과 같습니다.

```
{
  "testConnectExternalHiveMetaStoreResponse": {
    "requestId": "293a4b5c-0d1e-f678-2345-9abcdef6789a",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```