# tDSQL4JSON

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

DSQLを使ってJSON入力データをJSON出力データに変換します。

## tDSQL4JSONの標準プロパティ

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

標準のtDSQL4JSONコンポーネントは、変換処理ファミリーに属しています。

このコンポーネントは、Talend Data Management Platform、Talend Big Data Platform、Talend Real-Time Big Data Platform、Talend Data Services Platform、Talend Data Fabricで利用できます。

このコンポーネントは、Talendが提供する8.0.1-R2025-09以降のStudioマンスリーアップデートをインストール済みである場合に利用できます。詳細は管理者にお問い合わせください。

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Schema] (スキーマ)と[Edit Schema] (スキーマを編集) | スキーマは行の説明のことで、処理された後に次のコンポーネントに渡されるフィールド(カラム)の数を定義するものです。ドロップダウンリストから、スキーマのタイプを選択します。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。<br><br>[Guess Schema] (推測スキーマ)をクリックすると、ソースコンポーネントからテーブルスキーマが取得されます。 |
| [Script] (スクリプト) | 入力JSONデータを変換するDSQLスクリプトを入力してください。DSQLの詳細は、[Talend Data Shaping Languageリファレンスガイド](https://help.qlik.com/talend/ja-JP/data-shaping-language-reference-guide/8.0/introduction-data-shaping-language)をご覧ください。<br><br>たとえば、FROM order WHERE shipto.city = 'London' UNNEST item SELECT { orderid, itemno, total\_price = quantity \* price }というDSQLスクリプトは、ロンドンに出荷されるアイテムのリストを返します。<br><br>追加演算子である+を使用する場合は、スクリプトを二重引用符で囲んで入力する必要があります。たとえば、"SELECT a + 1"となります。<br><br>スクリプトでは、単一行コメントである//はサポートされていないものの、複数行コメントである/\*\*/はサポートされています。<br><br>バイト配列入力とストリーム入力はサポートされていません。<br><br>現在のところ、スクリプトではDSQLのオートコンプリートはサポートされていないほか、構文および構文エラーも強調表示されません。 |
| [Enable Test Run] ([実行をテスト]を有効化) | このチェックボックスをオンにすると、指定したファイルに対し、DSQLスクリプトの結果をプレビューして検証できます。Sample data fileパラメーター内のファイルを参照し、[Test Run] (実行をテスト)をクリックする必要があります。<br><br>[Test Run] (実行をテスト)の出力結果が65535バイトを超える場合は、エラーを回避できるよう、ジョブの実行時にチェックボックスをオフにする必要があります。 |
| テスト実行コンテキスト変数を設定 | このチェックボックスを選択すると、[テスト実行] におけるスクリプト内でコンテキスト変数の値を定義して使用できます。[コンテキスト変数]プロパティに、VariableName = valueの形式で変数を入力する必要があります。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルとコンポーネントレベルでログデータを収集できます。 |
| [Input JSON root name] (入力JSONルート名) | スクリプト内でJSON全体の参照として使用する名前を入力します。この名前は一意であること、そして選択された入力JSONデータ内に存在することが必要です。デフォルトの入力名はinです。<br><br>たとえば、スクリプト内でSELECTと記述すれば、inはすべての入力JSONデータを指すようになります。 |
| [Input JSON column] (入力JSONカラム) | ドロップダウンリストから、ソースコンポーネントスキーマで入力JSONデータが含まれているカラム名を選択します。スキーマにカラムが1つしか含まれていない場合は、そのカラムがデフォルトで使用されます。 |
| 出力カラムを設定 | JSON結果が出力スキーマにどのように出力されるかを指定するには、このチェックボックスを選択します。有効にする場合は、出力カラムモードプロパティを設定します。<br><br>このチェックボックスをオフのままにしておくと、JSON結果は入力JSONカラムと同じ名前のカラムに設定されます。同じ名前のカラムが存在しない場合は、エラーが表示されます。 |
| 出力カラムモード | JSON結果を出力するモードを選択します。<br><br><ul> <li><span>単一カラムに結果を出力</span>: JSONの結果全体を、単一の出力カラムに出力します。これはデフォルトの動作です。</li> <li><span>結果をスキーマカラムにマップする</span>: JSON結果の各フィールドを、出力スキーマ内の対応するカラムにマッピングします。このモードは、JSONレコード出力、またはレコードの配列([<span>複数の行を出力</span>]と組み合わせた場合)にのみ対応しています。</li> </ul><br><br>情報メモ注: [結果をスキーマカラムにマップする]モードを使用する際は、DSQLスクリプトがJSONレコードを出力すること、および出力スキーマにJSON結果内のフィールド名と一致するカラムが含まれていることを確認してください。フィールド値は文字列として出力されます。<br><br>このプロパティは、[出力カラムを設定]を選択した場合にのみ利用できます。 |
| 出力JSONカラム | このプロパティは、[出力カラムを設定]が選択され、[出力カラムモード]が[結果を1つのカラムに出力]に設定されている場合に利用できます。JSON結果を格納するカラム名を、ドロップダウンリストから選択します。<br><br>出力スキーマに単一カラムがある場合は、そのカラムがデフォルトで使用されます。 |
| 複数の行を出力 | このチェックボックスを選択して、ジョブ実行時に配列出力を個別の行に分割します。<br><br>[出力カラムモード]を[結果をスキーマカラムにマップする]に設定して併用する場合、配列内の各レコードは個別の行として出力され、そのフィールドは対応するスキーマカラムにマッピングされます。 |
| [Enable Java functions calls] (Java関数呼び出しを有効化) | このチェックボックスを選択すると、DSQLスクリプトでJava関数の呼び出しが有効になります。たとえば、次のメソッドの呼び出しが可能です:<br><br><ul> <li>Java静的メソッド: <kbd>java:call(java:call('java.lang.String' , 'valueOf', 100), 'concat', '$')</kbd></li> <li>Java非静的メソッド: <kbd>java:call(java:call(java:new('java.text.SimpleDateFormat', 'yyyy-MM-dd'), 'parse', '2018-10-15'), 'getDate')</kbd></li> </ul><br><br><br>Java関数の呼び出しに関する詳細については、「[式内でJava関数を呼び出し](https://help.qlik.com/talend/en-US/data-shaping-language-reference-guide/8.0/calling-java-functions)」を参照してください。 |

## [Global Variables] (グローバル変数)

| 変数 | 説明 |
| --- | --- |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |
| NB\_LINE | 処理された行数。これはAfter変数で、整数を返します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| 使用ルール | このコンポーネントでは、単一の入力と単一の出力のみがサポートされています。 |