# tMapROjaiInput MapR-DBデータベースからドキュメントを読み取り、特定のジョブにデータを読み取ります。 このコンポーネントを使う前に、MapR Clientを適切にインストールして設定しておく必要があります。クライアント設定プロセスで、MapRクラスターおよびMapR-DBデータベースへの接続情報を保存するために\opt\mapr\conf\mapr-clusters.confファイルが自動的に生成されます。実行時に、このOJAIコンポーネントは、この接続情報を単独で読み取り、使うMapR-DBデータベースに接続させます。 MapRクライアントをインストールして設定する方法は、MapRのドキュメンテーションで[Setting up the Client](http://doc.mapr.com/display/MapR/Setting+Up+the+Client)をご覧ください。 デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。 ## tMapの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtMapROjaiInputを設定するために使われます。 標準のtMapROjaiInputコンポーネントは、データベースNoSQLファミリーに属しています。 このフレームワークのコンポーネントは、すべてのビッグデータ対応のTalend製品およびTalend Data Fabricで利用できます。 ## 基本設定 | プロパティ | 説明 | | --- | --- | | [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。



スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。



このコンポーネントは、ドキュメントタイプをサポートしています。ドキュメント全体に対してフィールドがある場合は、スキーマエディターで、このフィールドの[Type] (タイプ)カラムの[Document] (ドキュメント)を選択します。

ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。 | | [Use Kerberos authentication] (Kerberos認証を使用) | Kerberosセキュリティを実行しているOJAIデータベースとしてのMapR-DBにアクセスする場合は、このチェックボックスを選択し、表示されたフィールドにKerberosのプリンシパル名とパスワードを入力します。

ジョブを起動するたびに、新しいkinitチケットを得るため、コンポーネントによってこの認証情報がKerberosに送信されます。 | | [Use a key tab to authenticate] (キータブを認証に使用) | [Use a keytab to authenticate] (Keytabを認証に使用)チェックボックスをオンにして、所定のkeytabファイルを使ってKerberos対応のシステムにログインします。keytabファイルには、Kerberosのプリンシパルと暗号化されたキーのペアが含まれています。使用するプリンシパルを[Principal] (プリンシパル)フィールドに入力し、keytabファイルへのアクセスパスを[Keytab] フィールドに入力します。このキータブファイルは、ジョブが実際に実行されているマシン(Talend JobServerなど)に保存する必要があります。

keytabが有効なジョブは、プリンシパルに任命されたユーザーでなくても実行できますが、使用するkeytabファイルの読み取り権限が必要です。たとえば*user1*というユーザー名でジョブを実行し、使用するプリンシパルが*guest*の場合、*user1*に使用するキータブファイルの読み取り権限があることをご確認ください。 | | [Restrict partial sorts with Secondary Indexes] (部分ソートをセカンダリーインデックスで制限) | このチェックボックスをオンにすると、実際のデータでクエリーが明示的にソートされます。これにより、クエリー内で非同期セカンダリーインデックスが原因で発生する可能性がある部分的なソートを回避できます。

MapR OJAIのこの部分的なソートの問題については、MapRドキュメントの[非同期セカンダリーインデックスのアップデート](https://maprdocs.mapr.com/home/MapR-DB/Indexes/indexes-consistency.html#indexes-consistency)をご覧ください。

非同期インデックスで遅延が発生しないと予想される場合、または遅延の影響が軽微であることがわかっている場合は、このチェックボックスをオンにしないでください。このチェックボックスをオフにしておくことで、クエリーはMapR-DB JSONテーブルのセカンダリーインデックスによって提供される順序付けの利点を活用できます。 | | テーブル名 | 処理するテーブルの名前を入力します。 | | クエリー | tMapROjaiInputによって実行されるクエリーのwhere句を指定します。

たとえば、"{id:{$eq: 4}}"または"{id:4}}"と入力して、*id*が*4*となっているレコードを取得します。

OJAIはクエリーにMongoDBクエリー形式を使うため、使用可能な演算子については、MongoDBドキュメントの[クエリー演算子](https://docs.mongodb.com/manual/reference/operator/query/)をご覧ください。 | | [Mapping] (マッピング) | このコンポーネント用に定義されたスキーマの各カラムは、読み取るドキュメントのフィールドを表します。このテーブルで、これらのフィールドの親ノードがあればそれを指定する必要があります。

たとえば、次のようなドキュメントがあるとします。

```
{
_id: ObjectId("5099803df3f4948bd2f98391"),
person: { first: "Joe", last: "Walker" }
}
```


フィールド*first*および*last*には親ノード*person*がありますが、*\_id*フィールドには親ノードがありません。したがって、完了すると、この[Mapping]テーブルは次のようになります。

```
Column Parent node path
_id
first "person"
last "person"
``` | ## 詳細設定 | プロパティ | 説明 | | --- | --- | | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 | ## グローバル変数 | 変数 | 説明 | | --- | --- | | グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

NB\_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。

変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 | ## 使用方法 | 使用方法のガイダンス | 説明 | | --- | --- | | **使用ルール** | tMapROjaiInputはクエリーを実行して、指定されたMapR-DBデータベースからデータを読み取ります。これはジョブの開始コンポーネントであり、次のコンポーネントにデータを送信するには送信リンクが必要です。 |