tCosmosDBSQLAPIInputの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtCosmosDBSQLAPIInputを設定するために使われます。
標準のtCosmosDBSQLAPIInputコンポーネントは、データベースNoSQLファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのTalend製品で使用できます。
基本設定
|
[Property type] (プロパティタイプ) |
[Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。
|
| [Edit Schema] (スキーマを編集) |
スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。 スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。
JSONドキュメント全体カラムとしてすべて読み取る必要がある場合は、引用符を使用せずに[DB column] (DBカラム)内でアスタリスク(*)を付けます。 ダイナミックスキーマは、Talendが提供する8.0.1-R2024-04以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 |
|
[Guess Schema] (推測スキーマ) |
このボタンをクリックすると、ドキュメントからスキーマを取得できます。 |
|
URI |
CosmosユーザーアカウントのURIを入力します。フィールドでプロンプトが表示されると、CosmosデータベースユーザーアカウントのURIはhttps://{アカウント名}.document.azure.com:443という形式になります。URIは、[Azure Portal]の[Keys] (キー)ペインで取得できます。関連情報は、Create an Azure Cosmos DB accountをクリックしてください。 |
|
[Primary key] (プライマリキー) |
Cosmosユーザーアカウントのプライマリキーを入力します。プライマリキーは、[Azure Portal]の[Keys] (キー)ペインで取得できます。関連情報は、Create an Azure Cosmos DB accountをクリックしてください。 プライマリキーを入力するには、[Primary key] (プライマリキー)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにプライマリキーを入力して[OK]をクリックします。プライマリキーは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。
情報メモ注:
|
|
[Database ID] (データベースID) |
データベースの名前を入力します |
|
[Collection ID] (コレクション ID) |
コレクション名を入力します。 |
|
[Use query] (クエリーを使用) |
このオプションを選択すると、クエリーステートメントを使ってデータを取得できます。[Query] (クエリー)フィールドにクエリーステートメントを入力できます。 |
詳細設定
|
[tStatCatcher Statistics] (tStatCatcher統計) |
このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 |
|
[Connection mode] (接続モード) |
使用する接続モードを指定します。GatewayとDirectHttpsの2つのオプションを利用できます。関連情報を参照するには、ConnectionModeをクリックしてください。 |
|
[Max connection pool size] (最大接続プールサイズ) |
最大接続プールサイズを設定するために使われます。デフォルトは1000です。 |
|
[Consistency level] (一貫性レベル) |
一貫性レベルを設定するために使われます。関連情報は、 [Consistency levels] (一貫性レベル) をクリックしてください。 |
Global Variables
|
ERROR_MESSAGE |
エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |
|
NB_LINE |
処理された行数。これはAfter変数で、整数を返します。 |
使用方法
|
使用ルール |
開始コンポーネントとしてtCosmosDBSQLAPIInputを使うと、SQL APIを介してCosmosデータベース内のコレクションからデータを取得し、後続コンポーネントに転送して表示または保管できます。 |