testConnectExternalHiveMetaStore

Prev Next

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を追加する事前作業の先行作業が必要
  • Cloud DB for MySQLで DB Config変数sql_require_primary_key = OFFを設定。DB Configの管理を参照
  • 連携テスト時、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 クラスタインスタンス番号
--cloudMysqlInstanceNo String Required Cloud DB for MySQLインスタンス番号
--cloudMysqlUserName String Required データベースユーザー ID
--cloudMysqlUserPassword String Required データベースユーザーアカウントのパスワード
  • 英字、数字、記号を組み合わせて8~20文字以内で入力
  • 記号の' " ` & + / \およびスペースは使用不可

共通オプション

vhadoopコマンドで共通して使用されるオプションの詳細は、Cloud Hadoop (VPC)のオプションをご参照ください。

例

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"
  }
}