tMongoDBGridFSGetの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtMongoDBGridFSGetを設定するために使われます。
標準のtMongoDBGridFSGetコンポーネントは、ビッグデータファミリーとデータベースNoSQLファミリーに属しています。
このフレームワーク内のコンポーネントは、ビッグデータ対応のTalend 製品すべて、およびTalend Data Fabricで利用できます。
基本設定
|
[Property type] (プロパティタイプ) |
[Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。 [Built-In] (組み込み): 一元的に保存されるプロパティデータはありません。 [Repository] (リポジトリー): プロパティが保存されているリポジトリーファイルを選択します。 |
|
[Use an existing connection] (既存の接続を使用) |
定義済みの接続の詳細を再利用する場合は、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)ドロップダウンリストから、目的の接続コンポーネントを選択します。 ジョブに親ジョブと子ジョブが含まれている場合、[Component List] (コンポーネントリスト)には同じジョブレベルの接続コンポーネントのみが表示されます。 |
|
[Use replica set address or multiple query routers] (レプリカセットのアドレスまたは複数クエリールーターを使用します) |
このチェックボックスをオンにして[Server addresses] (サーバーアドレス)テーブルを表示します。 [Server addresses] (サーバーアドレス)テーブルで、接続先とするシャードMongoDBデータベースまたはMongoDBレプリカセットを定義します。 |
|
[Server] (サーバー)と[Port] (ポート) |
データベースサーバーのIPアドレスとリスニングポート。 [Use replica set address] (レプリカセットアドレス)を使用するチェックボックスが選択されていない場合に利用できます。 認証メカニズムを使用してこのMongoDBデータベースに接続する場合は、IPアドレスではなく、データベースサーバーのホスト名を入力する必要があります。 |
|
[Database] (データベース) |
データベースの名前。 |
|
[Use SSL connection] (SSL接続を使用) |
SSLまたはTLS暗号化接続を有効にする場合は、このチェックボックスを選択します。 次に、同じジョブ内のtSetKeyStoreコンポーネントを使用して暗号化情報を指定する必要があります。 SSL接続はMongoDBのバージョン2.4 +でのみ利用可能です。 |
|
[Set read preference] (読み取り環境設定の設定) |
このチェックボックスをオンにして、[Read preference] (読み取り環境設定)ドロップダウンリストが表示されたら、読み取りオペレーションをダイレクトする必要のあるメンバーを選択します。 このチェックボックスをオフのままにすると、ジョブはデフォルトの読み取り環境設定を使用します。すなわち、レプリカセット内のプライマリーメンバーが使用されます。 詳細は、MongoDBのドキュメンテーションで複製とその読み取り環境設定に関する説明をご覧ください。 |
|
[Required authentication] (必要な認証) |
このチェックボックスをオンにすると、データベース認証が有効になります。 Kerberosを使用していない場合は、[Authentication mechanism] (認証メカニズム)ドロップダウンリストにリスト表示されているメカニズムのうち、[NEGOTIATE]が推奨されます。使用しているMongoデータベースバージョンに最もよく対応している認証メカニズムが自動的に選択されるためです。 SCRAM-SHA-256認証メカニズムがMongoDB 4.x以降のみにサポートされているため、SCRAM-SHA-256 SASLオプションは[DB Version] (データベースバージョン)ドロップダウンリストからMongoDB 4.4.X and laterが選択されている時のみ利用できます。
情報メモ注: SCRAM-SHA-256 SASLオプションは、TalendのR2021-08以降のStudioマンスリーアップデートをインストールした時のみ利用できます。詳細は管理者にお問い合わせください。
このリスト内の他のメカニズムについては、MongoDBのドキュメンテーションでMongoDB Authentication (英語のみ)をご覧ください。 |
|
[Set Authentication database] (認証データベースの設定) |
MongoDBへの接続に使用するユーザー名がMongoDBの特定の認証データベース内で作成済みの場合は、このチェックボックスをオンにして、表示される[Authentication database] (認証データベース)フィールドに、この認証データベースの名前を入力します。 MongoDB認証データベースについては、User Authentication database (英語のみ)をご覧ください。 |
|
[Username] (ユーザー名)と[Password] (パスワード) |
DBユーザー認証データ。 パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。 [Required authentication] (必要な認証)チェックボックスが選択されている場合に利用できます。 [Authentication mechanism] (認証方式)ドロップダウンリストでKerberosをセキュリティシステムに選択した場合は、[Username] (ユーザー名)と[Password] (パスワード)のフィールドではなく、[User principal] (プリンシパルを使用)、[Realm] (レルム)、[KDC server] (KDCサーバー)のフィールドに入力します。 |
|
[Bucket] (バケット) |
ファイルを読み取る必要があるバケットの名前を入力します。GridFSのバケットはフォルダに似ています。 |
|
[Query type] (クエリータイプ) |
tMongoDBGridFSGetで実行するクエリーのタイプを選択して、コピーするデータを選択します。
ファイル名の競合の問題を回避するために、[Overwrite local files] (ローカルファイルを上書き)および[Use Document ID as output filename] (ドキュメントIDを出力ファイル名として使用)チェックボックスとともにクエリーを使用することをお勧めします。 |
|
[Local Folder] (ローカルフォルダー) |
GridFSからコピーしたデータを書き込むフォルダーへのパスを入力します。 |
|
[Overwrite local files] (ローカルファイルを上書き) |
使用しているローカルフォルダ内の同じファイル名を使用してファイルを上書きするには、このチェックボックスをオンにします。オフの場合、このタイプの状況では例外が返されます。 |
|
[Use Document ID as output filename] (ドキュメントIDを出力ファイル名として使用) |
オブジェクトIDの値を使用して、受信ファイルの名前をオンザフライで変更するには、このボックスを選択します。これにより、同じファイル名を持つファイルを保持できます。 |
詳細設定
|
[tStatCatcher Statistics] (tStatCatcher統計) |
このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 |
|
[No query timeout] (クエリータイムアウトなし) |
アイドルカーソルの非アクティブ状態が10分間続いた時にMongoデータベースサーバーがカーソルを停止することを防ぐ場合は、このチェックボックスを選択します。この状況では、このカーソルの結果が枯渇するか、またはcursor.close()方式を使用して手動で閉じるまで、アイドルカーソルが開いたままとなります。 MongoDBのカーソルはクエリーの結果セットを指すポインターです。デフォルトでは、すなわち、このチェックボックスがオフの場合、Mongoデータベースサーバーは、メモリの過剰使用を避けるために、非アクティブ状態が特定の期間続くと、アイドルカーソルを自動的に停止します。MongoDBカーソルの詳細は、https://docs.mongodb.org/manual/core/cursors/ (英語のみ)をご覧ください。 |
グローバル変数
|
グローバル変数 |
NB_FILE: 処理されたファイルの数。これはAfter変数で、整数を返します。 ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。 Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。 フィールドまたは式に変数を入れるには、Ctrl + スペースを押して変数リストにアクセスし、リストから使用する変数を選択します。 変数の詳細は、Talend Studioユーザーガイドをご覧ください。 |
使用方法
|
使用ルール |
このコンポーネントは、MongoDB GridFS接続とデータ抽出を組み合わせます。したがって通常は、ユーザーが定義したローカルディレクトリーへGridFSからデータをコピーするために単一コンポーネントサブジョブとして使われます。 ほとんどの場合、コンテキストに応じて、OnSubjobOkまたはOnComponentOkリンクを使ってジョブに接続します。 |