---
title: "testConnectExternalHiveMetaStore"
slug: "cli-vhadoop-testconnectexternalhivemetastore"
updated: 2026-10-08T10:00:56Z
published: 2026-10-08T10:00: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/ja/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/ja/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/ja/cli-vhadoop-getcloudhadoopinstancelist)を参照 |
| `--cloudMysqlInstanceNo` | String | Required | Cloud DB for MySQLインスタンス番号 - [getCloudHadoopMysqlInstanceList](/docs/ja/cli-vhadoop-getcloudhadoopmysqlinstancelist)を参照 |
| `--cloudMysqlUserName` | String | Required | データベースユーザー ID - [getCloudHadoopMysqlUserList](/docs/ja/cli-vhadoop-getcloudhadoopmysqluserlist)を参照 |
| `--cloudMysqlUserPassword` | String | Required | データベースユーザーアカウントのパスワード - 英字、数字、記号を組み合わせて8~20文字以内で入力 - 記号の`&apos;` `&quot;` ``` `&amp;` `+` `/` `\`およびスペースは使用不可 |

### 共通オプション

`vhadoop`コマンドで共通して使用されるオプションの詳細は、[Cloud Hadoop (VPC)のオプション](/docs/ja/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"
  }
}
```