# tCosmosDBRow

Cosmosデータベースのコマンドを実行します。

デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。

## tCosmosDBRowの標準プロパティ

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

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

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

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Use existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。 |
| API | 使うデータベースAPIを選択します。定義が必要な対応するパラメーターが、[Component] (コンポーネント)ビューに表示されます。<br><br>このコンポーネントの現在のバージョンでは、MongoDB APIのみがサポートされています。このため、MongoDBデータベースはCosmosDBコンポーネントのドキュメンテーションで頻繁に言及されています。 |
| [Use replica set address or multiple query routers] (レプリカセットのアドレスまたは複数クエリールーターを使用します) | このチェックボックスをオンにして[Server addresses] (サーバーアドレス)テーブルを表示します。<br><br>[Server addresses] (サーバーアドレス)テーブルで、接続先とする共有のMongoDBデータベースまたはMongoDBレプリカセットを定義します。 |
| [Server] (サーバー)と[Port] (ポート) | データベースサーバーのIPアドレスとリスニングポート番号を入力します。<br><br>[Use replica set address or multiple query routers] (レプリカセットのアドレスまたは複数クエリールーターを使用します)チェックボックスがオフの時に利用できます。 |
| [Database] (データベース) | 接続先とするMongoDBデータベースの名前を入力します。 |
| [Authentication mechanism] (認証メカニズム) | Kerberosを使用していない場合は、[Authentication mechanism] (認証メカニズム)ドロップダウンリストにリスト表示されているメカニズムのうち、[NEGOTIATE]が推奨されます。使用しているMongoデータベースバージョンに最もよく対応している認証メカニズムが自動的に選択されるためです。<br><br>このリスト内の他のメカニズムについては、MongoDBのドキュメンテーションで[MongoDB Authentication](https://docs.mongodb.org/manual/reference/parameters/#param.authenticationMechanisms)をご覧ください。 |
| [Set Authentication database] (認証データベースの設定) | MongoDBへの接続に使用するユーザー名がMongoDBの特定の認証データベース内で作成済みの場合は、このチェックボックスをオンにして、表示される[Authentication database] (認証データベース)フィールドに、この認証データベースの名前を入力します。<br><br>MongoDB認証データベースについては、[User Authentication database](https://docs.mongodb.org/manual/core/security-users/#user-authentication-database)をご覧ください。 |
| [Username] (ユーザー名)と[Password] (パスワード) | DBユーザー認証データ。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。<br><br>[Use Authentication] (認証を使用)チェックボックスがオンの場合に使えます。<br><br>[Authentication mechanism] (認証方式)ドロップダウンリストから、Kerberosをセキュリティシステムに選択した場合は、[Username] (ユーザー名)と[Password] (パスワード)のフィールドではなく、[User principal] (プリンシパルを使用)、[Realm] (レルム)、[KDC server] (KDCサーバー)のフィールドに入力します。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul><br><br>ジョブで接続している先行コンポーネントからスキーマを取得するためには、[Sync columns] (カラムを同期)をクリックします。 |
| [Execute command] (コマンドの実行) | このチェックボックスをオンにすると、実行する[Command] (コマンド)フィールドにMongoDBコマンドを入力できます。<br><br><ul> <li> <p> <span>[Command] (コマンド)</span>: コマンドに1つの変数が含まれる場合、このフィールドに実行するコマンドを入力します。</p> <div>たとえば、コマンドを作成する必要がある場合<pre><code><pre><code><code>{"isMaster": 1}</code></code></pre></code></pre>単に<kbd>isMaster</kbd>を引用符で囲んで入力します。</div> </li> <li> <p> <span>[Construct command from keys and values] (キーおよび値からコマンドを構成)</span>: 実行するコマンドに複数の変数が含まれている場合は、このチェックボックスをオンにし、<span>[Command keys and values] (コマンドキーと値)</span>テーブルで、使用する変数とそれぞれの値を追加します。</p> <div>たとえば、以下のコマンドを作成する必要がある場合 										<pre><code><pre><code><code>{ renameCollection : "&lt;source_namespace&gt;" , to : "&lt;target_namespace&gt;" , dropTarget : &lt; true \| false &gt; }</code></code></pre></code></pre><span>[Command keys and values] (コマンドキーおよび値)</span>テーブルに3つの行を追加し、引用符内の各行に1つの変数と値のペアを入力する必要があります。<pre><code><pre><code><code>"renameCollection"      "old_name""to"                    "new_name""dropTarget"            "false"</code></code></pre></code></pre> </div> </li> <li> <p> <span>[Construct command from a JSON string] (JSON文字列からコマンドを設定)</span>: 使用するコマンドを直接入力する場合は、このチェックボックスをオンにし、表示される <span>[JSON string command] (JSON文字列コマンド)</span>フィールドにこのコマンドを入力します。<span>tCosmosDBRow</span>ごとに1つのコマンドのみが許可されます。</p> <div>例:<pre><code><pre><code><code>"{createIndexes: 'restaurants', indexes : [{key : {restaurant_id: 1}, name: 'id_index_2', unique: true}]}"</code></code></pre></code></pre> </div> <p>コマンドで使用する文字列の値を囲むには一重引用符を使い、コマンド自体を囲むには二重引用符を使う必要があります。</p> <p>このフィールドで使用できるMongoDBコマンドの詳細は、<a href="https://docs.mongodb.org/manual/reference/command/" target="_blank">https://docs.mongodb.org/manual/reference/command/</a>をご覧ください。</p> </li> </ul> |
| [Die on error] (エラー発生時に強制終了) | このチェックボックスはデフォルトでオフになっています。すなわち、エラーが発生した行をスキップし、エラーが発生していない行のプロセスを完了させます。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | tCosmosDBRowを使うと、MongoDBのコマンドを使ってCosmosデータベースを操作できます。 |