# tCouchbaseInputの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtCouchbaseInputを設定するために使われます。 標準のtCouchbaseInputコンポーネントは、データベースNoSQLファミリーに属しています。 このフレームワーク内のコンポーネントは、ビッグデータ対応のTalend 製品すべて、およびTalend Data Fabricで利用できます。 ## 基本設定 | [Bootstrap nodes] (ブートストラップノード) | Couchbase SDKでブートストラップするノードの名前かIPを入力します。Couchbaseはブートストラップに複数のノードを指定するよう推奨しているので、ノードの名前かIPをコンマ( , )で区切ってこのフィールドに入力してください。

Couchbaseブートストラップの詳しい情報は、[How Couchbase SDKs connect to the cluster](https://developer.couchbase.com/documentation/server/4.1/developer-guide/connection-advanced.html)をご覧ください。

ノード名はCouchbase Web Consoleの[Servers] (サーバー)ページで見つかります。詳しい情報は、Couchbaseクラスターの管理者に連絡するか、Couchbaseのドキュメンテーションをご覧ください。

Clouchbaseサーバーはプロキシをサポートしないことにご注意ください。この理由により、TalendからのCouchbaseのコンポーネントもプロキシをサポートしません。 | | --- | --- | | [Username] (ユーザー名)と[Password] (パスワード) | 認証情報を自分のCouchbaseクラスターに入力します。

パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。

Couchbase V5.0以降ではパスワードがバケットに関連付けられなくなったため、該当するバージョンを使用している場合は、[Bucket] (バケット)フィールドに同じ値をパスワードとして入力してください。ただしCouchbaseでは、バケットにアクセスできるロールを持つユーザーを作成する必要があります。

Couchbaseサイドでのアクセスコントロールやその他の重要要件に関する詳細は、お使いのバージョンのCouchbaseリリースノートをご覧ください。 | | [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

JSON以外のドキュメントを使用する場合は、[String] (文字列)型のidカラムを定義してから、contentカラムを定義します。このcontentカラムのタイプは、文字列ドキュメントの場合は[String] (文字列)バイナリドキュメントの場合はbyte[] である必要があります。

JSONドキュメントについては、使用するJSONドキュメントに存在するフィールドを定義します。 | | [Bucket] (バケット) | Couchbaseデータベースにあるデータバケットの名前を二重引用符で囲んで入力します。

使用している認証情報に、このバケットにアクセスできる適切な権限があることを確認します。

Couchbase V5.0以降を使用している場合、使用するCouchbase UIの[Security] (セキュリティ)タブで作成したユーザー名がこのバケットの名前になります。 | | [Document type] (ドキュメントタイプ) | Couchbaseデータベースに保存されるデータは、JSON、文字列、バイナリのいずれかを入力します。このドロップダウンリストから、Couchbaseで使用する必要があるデータのタイプを選択します。

JSON、バイナリ、文字列のドキュメントを同じバケットに混在させることはお勧めしません。この混合により、ドキュメント処理でエラーが発生しやすくなる可能性があります。

N1QLを使用して文字列またはバイナリドキュメントをクエリーする必要がある場合、唯一の方法は、ドキュメントIDを使用してドキュメントを取得することです。たとえば、ID番号が2のドキュメントを取得する必要がある場合、N1QLクエリーは次のようになります。

```
SELECT meta().id as `_meta_id_` FROM `bucket_name` where meta().id = '2';
```

\_meta\_id\_とbucket\_nameを囲む引用符はバッククォート(`)であることにご注意ください。 | | [Query Type] (クエリータイプ) | 使うするクエリーのタイプを次のオプションから選択します。



情報メモ注:

| | [Query] (クエリー) | N1QL queryステートメントまたはN1QL for Analyticsステートメントを入力して、複雑なアクションを実行します。

許可されるステートメントは1つだけです。ステートメントを引用符で囲まないでください。



情報メモ注: このフィールドは、[Query type] (クエリータイプ)ドロップダウンリストから[N1QL]または[N1QL Analytics] (N1QL統計)を選択する時に使用できます。 | ## 詳細設定 | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 | | --- | --- | | [Use custom connection parameters] (カスタム接続パラメーターを使用) | このオプションを選択すれば、[Connection timeout] (接続タイムアウト)、[Query timeout] (クエリータイムアウト)、[Analytics timeout] (アナリティクスタイムアウト)、[Query threshold] (クエリーしきい値)といった接続パラメーターを設定できます。

接続パラメーターを設定する場合は、テーブルの下部にあるプラスボタンをクリックして[Connection parameters] (接続パラメーター)テーブルに行を追加し、[Parameter name] (パラメーター名)カラムをクリックしてドロップダウンリストから目的のパラメーターを選択し、[Parameter value] (パラメーター値)カラムにパラメーター値を入力します。 | | [Limit rows] (行を制限) | 読み取る最大行数を入力します。N1QLクエリーを使う場合、このフィールドは使えません。 | | [Create primary index] (プライマリインデックスを作成) | このチェックボックスを選択して、データベースのプライマリインデックスまたはプライマリインデックスが既に存在する場合、新しいプライマリインデックスをコンポーネントに作成させます。

セカンダリーインデックスが存在する場合、プライマリインデックスの作成がオプションである可能性があるため、デフォルトでこのチェックボックスは消去されています。

プライマリインデックスに関する詳細は、公式Couchbaseドキュメンテーションから[Create primary index (プライマリインデックスを作成)](https://docs.couchbase.com/server/current/n1ql/n1ql-language-reference/createprimaryindex.html) (英語のみ)をご覧ください。 | ## グローバル変数 | グローバル変数 | NB\_LINE: 入力コンポーネントによって読み取られた行の数、または出力コンポーネントに転送された行の数。これはAfter変数で、整数を返します。

ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

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

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

変数の詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。 | | --- | --- | ## 使用方法 | **使用ルール** | 開始コンポーネントとして、tCouchbaseInputがCouchbaseデータベースからドキュメントを読み取ります。 | | --- | --- |