Read From DB

Read From DB ステージでは、データフローへの入力として、データベーステーブルまたはビューからデータを読み込みます。このステージは、ジョブ、サービス、サブフローに対して使用できますが、プロセスフローには使用できません。

[全般] タブ

フィールド名	説明
接続	使用するデータベース接続を選択します。使用できるデータベース接続は、Management Console の Connection Manager に定義されている接続によって異なります。新しいデータベース接続を作成、あるいは既存のデータベース接続を変更または削除する必要がある場合は、[管理] をクリックします。データベース接続を追加または変更する場合は、次のフィールドに必要な値を指定します。接続名接続の名前を入力します。任意の名前にすることができます。データベースドライバ適切なデータベースタイプを選択します。接続オプションデータベースへの接続に使用するホスト、ポート、インスタンス、ユーザ名、およびパスワードを指定します。
SQL	データフローの実行時にデータソースから読み込む必要のあるレコードを指定する SQL クエリを入力します。このフィールドに SQL クエリを手動で入力できます。または、[SQL の作成...] をクリックして、Visual Query Builder によってクエリを作成することもできます。 SQL クエリには、実際の列名の代わりに変数を含めることができます。変数を使用すると、クエリを実行時にカスタマイズすることができます。詳細については、クエリ変数を参照してください。
SQL の作成	[SQL の作成] をクリックすることにより、複数の列を選択し、結合や入れ子になったクエリを作成して、複雑なクエリを作成します。[Visual Query Builder] が開きます。詳細については、Visual Query Builderを参照してください。注: Visual Query Builder を使用して作成したクエリは、列やテーブルの完全修飾名とともに [SQL] フィールドに表示されます。
フィードの再生成	クエリによって取得されるデータのスキーマを表示するには、[フィールドの再生成] をクリックします。既存のクエリを編集した場合は、[フィールドの再生成] をクリックすると変更されたスキーマが取得されます。注: [フィールドの再生成] をクリックするとき、SQL クエリのエンティティ名はそのまま維持され、完全修飾名に置き換えられません。
プレビュー	SQL クエリによって取得されるレコードのサンプルを表示するには、[プレビュー] をクリックします。

注: Read From DB ステージでは、入力フィールドのタイプの変更が可能です。

注: Read from DB ステージは、date データタイプのすべての値をString 値として読み取ります。これは、Spectrum で使用されるデフォルトドライバである jTDS ドライバの動作です。すべての dateデータタイプの値をそのまま処理するには、Microsoft の JDBC ドライバを使用します。

[実行時] タブ

フィールド名	説明
フェッチサイズ:	データベーステーブルから一度に読み取るレコードの数を指定するには、このオプションを選択します。例えば、フェッチサイズの値が 100 で、読み取るレコードの総数が 1000 である場合、すべてのレコードを読むためにデータベースに 10 回アクセスすることになります。最適なフェッチサイズを設定すれば、パフォーマンスを大幅に向上できます。注: 使用している環境に最適なフェッチサイズは、Read from DB ステージと Write to Null ステージ間の実行時間をテストすることで計算できます。詳細については、最適なフェッチサイズの決定を参照してください。
ステージオプション	このセクションには、このステージの SQL クエリで使用されるデータフローオプションの一覧が表示され、そのすべてのオプションに対してデフォルト値を設定できます。[名前] 列にはオプションが表示され、そのデフォルト値を対応する [値] 列に入力できます。注: ここで設定したデフォルト値は、[データフローオプション] ダイアログボックスの [データフローオプションをステージにマッピングします] セクションにも表示されます。このダイアログボックスでも、デフォルト値を変更できます。[ステージオプション]、[データフローオプション]、および Job Executor で設定されたオプションのデフォルト値が競合する場合の優先順位は、Job Executor で指定された値 > [データフローオプション] ダイアログボックスで定義された値 > [ステージオプション] で入力された値の順になります。

フィールド名

説明

フェッチサイズ:

データベーステーブルから一度に読み取るレコードの数を指定するには、このオプションを選択します。例えば、フェッチサイズの値が 100 で、読み取るレコードの総数が 1000 である場合、すべてのレコードを読むためにデータベースに 10 回アクセスすることになります。

最適なフェッチサイズを設定すれば、パフォーマンスを大幅に向上できます。

注: 使用している環境に最適なフェッチサイズは、Read from DB ステージと Write to Null ステージ間の実行時間をテストすることで計算できます。詳細については、最適なフェッチサイズの決定を参照してください。

ステージオプション

このセクションには、このステージの SQL クエリで使用されるデータフローオプションの一覧が表示され、そのすべてのオプションに対してデフォルト値を設定できます。[名前] 列にはオプションが表示され、そのデフォルト値を対応する [値] 列に入力できます。

注: ここで設定したデフォルト値は、[データフローオプション] ダイアログボックスの [データフローオプションをステージにマッピングします] セクションにも表示されます。このダイアログボックスでも、デフォルト値を変更できます。[ステージオプション]、[データフローオプション]、および Job Executor で設定されたオプションのデフォルト値が競合する場合の優先順位は、Job Executor で指定された値 > [データフローオプション] ダイアログボックスで定義された値 > [ステージオプション] で入力された値の順になります。