# HBaseへの接続の作成

利用対象...

* Big Data
* Big Data Platform
* Cloud Big Data
* Cloud Big Data Platform
* Cloud Data Fabric
* Data Fabric
* Real-Time Big Data Platform

## 手順

1. [Repository] (リポジトリー)ツリーで、[Metadata] (メタデータ)ノードの下の[Hadoop cluster] (Hadoopクラスター)ノードを展開し、使用するHadoop接続を右クリックしてコンテキストメニューから[Create Hive] (Hiveを作成)を選択します。
2. 接続ウィザードが表示されます。ここで、[Name] (名前)、[Purpose] (目的)、[Description] (説明)など、ジェネリックプロパティを入力します。[Status] (ステータス)フィールドは、[File] (ファイル) > [Edit project properties] (プロジェクトプロパティを編集)で定義できます。

   ![\[New Database Connection on repository - Step 1/2\] (リポジトリーでの新しいデータベース接続 - ステップ1/2)ダイアログボックスに一般的なプロパティが表示されている状態。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/hbase-connection-metadata1.png)
3. [Next] (次へ)をクリックして次の手順に進みます。ここでは、HBaseの接続情報を入力します。[DB Type] (データベースタイプ), [Hadoop cluster] (Hadoopクラスター), Distribution[Distribution] (ディストリビューション), [HBase version] (HBaseのバージョン)、[Server] (サーバー)は、前のステップで選択したHadoop接続から継承されたプロパティが自動的に入力されます。

   [Hadoop cluster] (Hadoopクラスター)リストから[None] (なし)を選択すると、手動モードに切り替わり、継承されたプロパティが破棄されるので、すべてのプロパティを手動で入力しなければなりません。作成された接続は、[Db connection] (データベース接続)ノードの下だけに表示されます。

   ![\[New Database Connection on repository - Step 2/2\] (リポジトリーでの新しいデータベース接続 - ステップ2/2)ダイアログボックスにHBase接続の詳細が表示されている状態。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/hbase-connection-metadata2.png)
4. [Port] (ポート)フィールドには、接続するHBaseデータベースのポート番号を入力します。

   情報メモ注:

   Hadoopサーバーのホスト名をクライアントやホストのコンピューターで識別可能にするには、クライアントとホストのコンピューターの関連するhostsファイルにそのホスト名でIPアドレスとホスト名のマッピングエントリーを追加する必要があります。たとえば、Hadoopサーバーのホスト名がtalend-all-hdpで、IPアドレスが192.168.x.xの場合、マッピングエントリーは192.168.x.x talend-all-hdpとなります。Windowsシステムでは、このエントリーをC:\WINDOWS\system32\drivers\etc\hostsに追加します(WindowsがCドライブにインストールされている場合)。Linuxシステムでは、このエントリーを/etc/hostsのファイルに追加します。
5. カラムをフィルターしたい場合は、[Column family] (カラムファミリー)フィールドにカラムファミリーを入力し、[Check] (確認)をクリックして接続を確認します。
6. Kerberosセキュリティを実行しているHadoopディストリビューションにアクセスする場合は、このチェックボックスをオンにし、表示されるフィールドにネームノードとしてKerberosのプリンシパル名を入力します。これにより、ユーザー名を使って、Kerberosに保存された認証情報に対して認証を実行できます。

   ログインにkeytabファイルが必要な場合は、[Use a keytab to authenticate] (認証にkeytabを使用)チェックボックスをオンにします。keytabファイルには、Kerberosのプリンシパルと暗号化されたキーのペアが含まれています。使用するプリンシパルを[Principal] (プリンシパル)フィールドに入力し、keytabファイルへのパスを[Keytab]フィールドに入力します。

   keytabが有効なジョブは、プリンシパルに任命されたユーザーでなくても実行できますが、使用するkeytabファイルの読み取り権限が必要です。たとえば、user1というユーザー名でジョブを実行し、使用するプリンシパルがguestの場合、user1に使用するkeytabファイルの読み取り権限があることをご確認ください。
7. 使用するHadoopまたはHBaseディストリビューションの設定をカスタマイズする必要がある場合は、[Hadoop properties] (Hadoopのプロパティ)の横の[...]ボタンをクリックしてプロパティテーブルを開き、カスタマイズするプロパティを追加します。その後、実行時にStudioがHadoopのエンジンに使用するデフォルトのプロパティが、カスタマイズした設定に上書きされます。

   [Parent Hadoop properties] (親Hadoopのプロパティ)テーブルは、現在編集中のプロパティテーブルの上部に表示されます。この親テーブルは読み取り専用で、現在のHBase接続のベースとなる親Hadoop接続のウィザードで定義されたHadoopのプロパティがリストされます。

   Hadoopのプロパティの詳細は、[Apache Hadoopに関するドキュメンテーション](https://hadoop.apache.org/docs/current/) (英語のみ)か、使用するHadoopディストリビューションのドキュメンテーションをご覧ください。たとえば、[このページ](https://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-common/core-default.xml) (英語のみ)にはデフォルトのHadoopプロパティがいくつか記載されています。

   HBaseのプロパティの詳細は、HBaseに関するApacheのドキュメンテーションをご覧ください。たとえば、[HBase Configuration Files](https://hbase.apache.org/book.html#_configuration_files) (英語のみ)にはHBaseの設定プロパティがいくつか記述されています。

   このプロパティテーブルの活用方法の詳細は、[再利用可能なHadoopのプロパティの設定](https://help.qlik.com/talend/ja-JP/studio-user-guide/8.0-R2024-04-and-earlier/setting-reusable-hadoop-properties)をご覧ください。
8. [Finish] (終了)をクリックして変更を確定します。

   新しく作成されたHBase接続は、[Repository] (リポジトリー)ツリーの[Hadoop cluster] (Hadoopクラスター)ノードの下に表示されます。また、HBase接続はデータベース接続のため、この接続は[Db connections] (データベース接続)ノードの下にも表示されます。

   ![HBase接続が\[Repository\] (リポジトリー)ツリービューに表示されている状態。](https://help.qlik.com/talend/ja-JP/studio-user-guide/Resources/images/hbase-connection-metadata3.png)

   情報メモ注:

   この[Repository] (リポジトリー)ビューは、使用しているTalend Studioのエディションによって異なる場合があります。

## タスクの結果

環境コンテキストを使用してこの接続のパラメーターを定義する必要がある場合は、[Export as context] (コンテキストとしてエクスポート)ボタンをクリックして対応するウィザードを開き、以下のオプションから選択します。

* [Create a new repository context] (新しいリポジトリーコンテキストを作成): 現在のHadoop接続からこの環境コンテキストを作成します。つまり、ウィザードで設定するパラメーターは、これらのパラメーターに設定した値と共にコンテキスト変数として取られます。

* [Reuse an existing repository context] (既存のリポジトリーコンテキストを再利用): 特定の環境コンテキストの変数を使用して現在の接続を設定します。

コンテキストの実装をキャンセルする必要がある場合は、[Revert Context] (コンテキストを復元)をクリックします。使用中のコンテキスト変数の値は、このウィザードに直接入力されます。

この[Export as context] (コンテキストとしてエクスポート)機能の使い方に関するステップバイステップの説明は、[メタデータのコンテキストとしてエクスポート、およびコンテキストパラメーターを再利用して接続を設定](https://help.qlik.com/talend/ja-JP/studio-user-guide/8.0-R2024-04-and-earlier/exporting-metadata-as-context-and-reusing-context-parameters-to-set-up-connection)をご覧ください。