# tMapRDBConnectionの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtMapRDBConnectionを設定するために使われます。

標準のtMapRDBConnectionコンポーネントは、ビッグデータファミリーとデータベースNoSQLファミリーに属しています。

このフレームワーク内のコンポーネントは、ビッグデータ対応のTalend 製品すべて、およびTalend Data Fabricで利用できます。

## 基本設定

| [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。<br><br>[Built-In] (組み込み): 一元的に保存されるプロパティデータはありません。<br><br>[Repository] (リポジトリー): プロパティが保存されているリポジトリーファイルを選択します。<br><br>プロパティは、[Repository] (リポジトリー)ツリーの[Hadoop Cluster] (Hadoopクラスター)ノードに一元的に保存されます。 |
| --- | --- |
| [Distribution] (ディストリビューション)と[Version] (バージョン) | 使用するMapRディストリビューションを選択します。MapR V5.2以上のみがMapRDBのコンポーネントでサポートされます。<br><br>MapRDBデータベースと併用する必要のあるディストリビューションがこのMapRBDのコンポーネントによって正式にサポートされていない場合、つまり、このディストリビューションがMapRでも、このコンポーネントの[Version] (バージョン)ドロップダウンリストに表示されていないか、このディストリビューションがMapRではない場合は、[Custom] (カスタム)を選択します。<br><br><ol> <li> <p><span>[Import from existing version] (既存のバージョンからインポート)</span>を選択すると、正式にサポートされているディストリビューションをベースとしてインポートしてから、ベースディストリビューションで提供されていない他の必要なjarファイルを追加できます。</p> </li> <li> <p><span>[Import from zip] (zipからインポート)</span>を選択すると、使用するカスタムディストリビューションの設定zipファイルをインポートできます。zipファイルには、Hadoopの各種エレメントのライブラリーおよびこれらのライブラリーのインデックスファイルが含まれている必要があります。 </p> <p><span> <span>Talend</span> </span>はカスタムバージョンを公式にサポートしていません。<span> <span>Talend</span> </span>とそのコミュニティでは、Studioからカスタムバージョンに接続するための方法を紹介していますが、Hadoopのディストリビューションとバージョンの種類は幅広いため、選択したバージョンの設定がスムーズに機能するかどうかは保証できません。そのような接続のセットアップは、Hadoopについてどんな問題でもご自身で対処できる十分な経験をお持ちの場合のみ行ってください。</p> <div><span>情報メモ</span><span>注:</span> <p>カスタムディストリビューションとこのコンポーネント間で作成する接続に関わるjarファイルがインポートされるように、このダイアログボックスのアクティブなチェックボックスをオフにしないでください。</p> </div> <p>カスタムディストリビューションの接続方法、および接続の共有方法のステップ例は、<a href="https://help.qlik.com/talend/r/ja-JP/7.3/hortonworks" target="_blank">Hortonworks</a>をご覧ください。</p> </li> </ol> |
| ディストリビューションのHadoopバージョン | Studioによってまだ正式にサポートされていないクラスターへの接続用に、ディストリビューションリストから[Custom] (カスタム)を選択した場合にしか、このリストは表示されません。その場合、このカスタムクラスターのHadoopバージョン、つまりHadoop 1またはHadoop 2を選択する必要があります。 |
| [Zookeeper quorum] (Zookeeperクォーラム) | Studioとデータベース間のトランザクションを調整するZookeeperサービスの名前またはURLを入力します。Zookeeperを設定する時に、*zookeeper.znode.parent*プロパティを明示的に設定して、作成されてデータベースで使用されているすべてのznodeを含むルートznodeへのパスを定義しなければならない場合があります。次に、[Set Zookeeper znode parent] (親Zookeeper znodeを設定)チェックボックスをオンにして、このプロパティを定義します。 |
| [Zookeeper client port] (Zookeeperクライアントポート) | 使用しているZookeeperサービスのクライアントリスニングポートの数を指定します。 |
| [Inspect the classpath for configurations] (設定用のクラスパスを検査) | *$HADOOP\_CONF\_DIR*変数で設定したディレクトリー内の設定ファイルをコンポーネントがチェックして、このディレクトリー内のこれらのファイルからパラメーターを直接読み取ることができるようにする場合は、このチェックボックスを選択します。この機能により、コンポーネントのHadoop設定を変更して、たとえばテスト環境から本番環境に切り替えるなど、環境の切り替えを容易に行うことができます。<br><br>この状況では、Hadoop接続とKerberosセキュリティ(またはそのいずれか)の設定に使われるフィールドやオプションは非表示になっています。<br><br>Kerberosパラメーターなど、特定のパラメーターを使おうとしていて、それらのパラメーターがHadoop設定ファイルに含まれていない場合は、*talend-site.xml*という名前のファイルを作成し、*$HADOOP\_CONF\_DIR*を使用して定義したのと同じディレクトリーに置く必要があります。この*talend-site.xml*ファイルは、次のようになります。<br><br>```<br><!-- Put site-specific property overrides in this file. --><br><configuration><br><property><br><name>talend.kerberos.authentication </name><br><value>kinit </value><br><description> Set the Kerberos authentication method to use. Valid values are: kinit or keytab.  </description><br></property><br><property><br><name>talend.kerberos.keytab.principal </name><br><value>user@BIGDATA.COM </value><br><description> Set the keytab's principal name.  </description><br></property><br><property><br><name>talend.kerberos.keytab.path </name><br><value>/kdc/user.keytab </value><br><description> Set the keytab's path.  </description><br></property><br><property><br><name>talend.encryption </name><br><value>none </value><br><description> Set the encryption method to use. Valid values are: none or ssl.  </description><br></property><br><property><br><name>talend.ssl.trustStore.path </name><br><value>ssl </value><br><description> Set SSL trust store path.  </description><br></property><br><property><br><name>talend.ssl.trustStore.password </name><br><value>ssl </value><br><description> Set SSL trust store password.  </description><br></property><br></configuration><br>```<br><br>これらの設定ファイルから読み取られたパラメーターは、Studioが使用しているデフォルトのパラメーターを オーバーライドします。これらの設定ファイルにパラメーターが存在しない場合は、デフォルトのパラメーターが使用されます。 |
| [Use Kerberos authentication] (Kerberos認証を使用) | 使用するデータベースでKerberosセキュリティを実行する場合は、このチェックボックスをオンにし、表示されたフィールドにプリンシパル名を入力します。この情報は、使用するクラスターの*hbase-site.xml*ファイルの中にあります。<br><br><ul> <li> <p>このクラスターが5.0.0バージョン以上のMapRクラスターである場合は、「セキュリティ対応MapRへの接続」の説明に従って、MapRチケット認証設定を追加または代替として設定できます。<a href="https://help.qlik.com/talend/ja-JP/components/7.3/mapr/connecting-to-security-enabled-mapr" target="_blank">https://help.talend.com/ja-JP/components/7.3/mapr/connecting-to-security-enabled-mapr</a> </p> <p>この設定により、ジョブで定義されたユーザー名用の新しいMapRセキュリティチケットが実行ごとに生成されます。同じユーザー名に対して発行された既存のチケットを再使用する必要がある場合は、<span>[Force MapR ticket authentication] (MapRチケット認証を強制)</span>チェックボックスと<span>[Use Kerberos authentication] (Kerberos認証を使用)</span>チェックボックスをオフにすると、そのチケットを即座に自動的に見つけることができます。</p> </li> </ul><br><br>ログインにKerberosのkeytabファイルが必要な場合は、[Use a keytab to authenticate] (認証にkeytabを使用)チェックボックスをオンにします。keytabファイルには、Kerberosのプリンシパルと暗号化されたキーのペアが含まれています。使用するプリンシパルを[Principal] (プリンシパル)フィールドに入力し、keytabファイルへのアクセスパスを[Keytab] フィールドに入力します。このkeytabファイルは、ジョブが実際に実行されているマシン、たとえば、Talend Jobserverに保存する必要があります。<br><br>keytabが有効なジョブは、プリンシパルに任命されたユーザーでなくても実行できますが、使用するkeytabファイルの読み取り権限が必要です。たとえば*user1*というユーザー名でジョブを実行し、使用するプリンシパルが*guest*の場合、*user1*に使用するキータブファイルの読み取り権限があることをご確認ください。<br><br>MapRクラスターでKerberosをデータベース用に設定する方法は、[Kerberos認証を設定](http://doc.mapr.com/display/MapR/Configure+Kerberos+Authentication+for+the+HBase+REST+Gateway) (英語のみ)をご覧ください。 |

## 詳細設定

| [Properties] (プロパティ) | データベースにカスタム設定を使用する必要がある場合は、カスタマイズするプロパティをこのテーブルで設定します。ランタイムに、カスタマイズされたプロパティは、データベース用に以前に定義した対応するプロパティを上書きします。<br><br>たとえば、データベースの設定で、*dfs.replication*プロパティの値を*1*に定義する必要があります。次に、プラスボタンを使用してこのテーブルに1行を追加し、このプロパティの名前と値をこの行に入力する必要があります。 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 |

## グローバル変数

| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入れるには、Ctrl + スペースを押して変数リストにアクセスし、リストから使用する変数を選択します。<br><br>変数の詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。 |
| --- | --- |

## 使用方法

| **使用ルール** | このコンポーネントは、通常、他のMapRDBコンポーネント、特にtMapRDBCloseと共に使います。 |
| --- | --- |
| 前提条件 | 始める前に、データベースで想定されているループバックIPの前提条件を満たしていることをご確認ください。<br><br>*Talend Studio* との操作を確実に行うには、Hadoopディストリビューションを適切にインストールする必要があります。以下のリストに、MapR関連の情報などを示します。<br><br><ul> <li> <p>MapRクライアントは必ずStudioのあるマシンにインストールして、そのマシンのPATH変数にMapRクライアントライブラリーを追加します。MapRのドキュメンテーションによると、各OSバージョンに対応するMapRクライアントのライブラリーは、<em>MAPR_INSTALL\ hadoop\hadoop-VERSION\lib\native</em>にあります。たとえば、Windows版のライブラリーは、<em>\lib\native\MapRClient.dll</em>にあるMapRクライアントのjarファイルにあります。詳細は、MapRから<a href="http://www.mapr.com/blog/basic-notes-on-configuring-eclipse-as-a-hadoop-development-environment-for-mapr" target="_blank">http://www.mapr.com/blog/basic-notes-on-configuring-eclipse-as-a-hadoop-development-environment-for-mapr</a><span> (英語のみ)</span>をご覧ください。</p> <p>指定のライブラリーを追加しないと、<span>no MapRClient in java.library.path</span>というエラーが発生する可能性があります。</p> </li> <li> <p>たとえば、<span>[Window] (ウィンドウ)</span>メニューの<span>[Preferences] (環境設定)</span>ダイアログボックスにある<span>[Run/Debug] (実行/デバッグ)</span>ビューの<span>[Job Run VM arguments] (ジョブ実行VMの引数)</span>エリアで、<span>-Djava.library.path</span>引数を設定するために使われます。この引数により、そのMapRクライアントのネイティブライブラリーへのパスがStudioに渡されるので、サブスクリプションベースのユーザーは<span>データビューアー</span>をフルに活用して、MapRに保存されたデータをStudioでローカルに表示できます。</p> </li> </ul><br><br>Hadoopディストリビューションのインストール方法は、使用しているHadoopディストリビューションに対応するマニュアルをご覧ください。 |