テーブル読み取り処理

オペレーション名

テーブル読み取り

機能概要

テーブルに格納されているデータを読み取ります。

データモデル

本コンポーネントのデータモデルはテーブルモデル型です。

チュートリアル

MySQLデータベースへのコネクションの作成方法については、以下のチュートリアルを参照してください。

MySQLデータベースへのコネクションを作成してみよう

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	コネクションリソースを選択します。 [追加] 新規にコネクションリソースを追加します。 [一覧の編集] > HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。
テーブル名	必須	使用可	読み取るテーブルの名前を選択または入力します。	コネクションリソースの一覧設定で指定した制限数のテーブルが表示されます。データベース上のスキーマ名やテーブル名に「.」が含まれる場合、スキーマ名とテーブル名を引用符で囲むと正しく扱うことができます。たとえば引用符が「"」の場合、スキーマ名が「A.B」で、テーブル名が「C.D」とすると、正しい引用符の囲み方は「"A.B"."C.D"」となります。
テーブル名を引用符で囲う	省略可	使用不可	指定したテーブル名を引用符で囲うかどうかを選択します。 [チェックあり] [テーブル名]に表示されているテーブル名を引用符で囲います。 [チェックなし] (デフォルト) [テーブル名]に表示されているテーブル名を引用符で囲いません。スペースなどの文字がテーブル名に含まれていた場合には、テーブル名を引用符で囲う必要があります。引用符で囲う必要がある文字については、各データベースベンダーに問い合わせてください。	各データベースコネクターで設定されている引用符は以下のとおりです。 Oracle、DB2、PostgreSQL、Amazon Athena、Amazon RDS for Oracle、Amazon RDS for PostgreSQL 「""」(二重引用符) SQL Server、Amazon RDS for SQL Server、Azure SQL Database 「[]」(半角大括弧) MySQL、Amazon RDS for MySQL、Amazon Aurora for MySQL 「``」(バッククォート) 注意 JDBCコネクターには本プロパティはありません。実行時には[テーブル名]に入力されたテーブル名をそのまま使用します。 [テーブル名]に入力されたテーブル名が引用符で囲われていた場合には、実行時にも引用符で囲まれたテーブル名でクエリーを発行します。 [テーブル名]に入力されたテーブル名が引用符で囲まれていない場合には、実行時に本プロパティのチェックあり/なしを確認のうえ、本プロパティがチェックありであれば引用符で囲まれたテーブル名でクエリーを発行します。 [テーブル名]に環境変数を設定した場合、本プロパティのチェックあり/なしを切り替えた際に値が展開されます。
スキーマ定義	必須	-	[テーブル名]で指定したテーブルのスキーマ定義を表示します。	[スキーマ定義]で表示された列の中で、[読み取り対象]にチェックを入れた列名がMapperのスキーマに表示されます。以下の場合はスキーマ定義を表示することはできません。指定したテーブルに読み取り権限がない場合指定したテーブルが存在しない場合 [テーブル名]に変数が指定されている場合 [テーブル名]が入力されていない場合 [テーブル名]でエラーが発生している場合
スキーマ定義/読み取り対象	省略可	使用不可	[テーブル名]で指定したテーブルの各列を、読み取り対象に含めるかどうかを選択します。 [チェックあり] (デフォルト) 読み取り対象に含めます。 [チェックなし] 読み取り対象に含めません。	チェックを入れた列の列名がMapperのスキーマに表示されます。ヘッダに表示されたチェックボックスをクリックすることで、一括操作を行うことができます。注意 1つ以上の列にチェックが入っている必要があります。
スキーマ定義/列名	必須	使用不可	[テーブル名]で指定したテーブルの列名を表示します。
スキーマ定義/型	必須	使用不可	[列名]の型を表示します。	「<Native型> (<内部データ型>)」形式で表示されます。 Native型各RDBMSの固有のデータ型です。内部データ型内部で使用しているデータ型です。詳細については、「内部データ型」を参照してください。

プロパティアクション

項目名	説明	備考
抽出テスト	指定したテーブルに対してSELECT文を発行します。結果として取得した件数が表示されます。	以下の場合には実行することができません。指定したテーブルに読み取り権限がない場合指定したテーブルが存在しない場合 [テーブル名]に変数が指定されている場合 [テーブル名]が入力されていない場合 [テーブル名]でエラーが発生している場合
スキーマ定義の更新	[テーブル名]で指定したテーブルのスキーマ定義を更新します。	以下の場合には実行することができません。指定したテーブルが存在しない場合 [テーブル名]に変数が指定されている場合 [テーブル名]が入力されていない場合 [テーブル名]でエラーが発生している場合

読み取り設定

項目名	必須/省略可	変数の使用	説明	備考
フェッチサイズ	省略可	使用可	JDBCフェッチサイズを指定します。	入力できる値は「0～2147483647」です。本プロパティで入力した値は、JDBCのsetFetchSize()メソッドの引数に指定されます。一般的に、フェッチサイズは一度にデータベースから取得する行数を設定しますが、データベースや使用するJDBCドライバによって動作が異なる場合があります。省略した場合、または数値以外を入力した場合は、JDBCドライバのフェッチサイズを指定しない場合の動作にしたがいます。注意 [フェッチサイズ]に大きな値を設定した場合、メモリ使用量が増大し、メモリ不足エラーが発生する場合があります。以下のコネクターには本プロパティはありません。 SQL Serverコネクター Amazon RDS for SQL Serverコネクター Azure SQL Databaseコネクター
クエリタイムアウトを有効にする	必須	使用不可	クエリタイムアウトを有効にするかどうかを選択します。 [チェックあり] クエリタイムアウトを設定します。 [チェックなし] (デフォルト) クエリタイムアウトを設定しません。	[チェックなし]とした場合、JDBCドライバのクエリタイムアウトを指定しない場合の動作にしたがいます。
クエリタイムアウト(秒)	必須	使用可	クエリタイムアウトを設定します。	[クエリタイムアウトを有効にする]を[チェックあり]とした場合、有効になります。入力できる値は「0～2147483647」です。本プロパティで入力した値は、JDBCのsetQueryTimeout()メソッドの引数に指定されます。一般的に、クエリタイムアウトは実行を待つ秒数を設定しますが、データベースや使用するJDBCドライバによって動作が異なる場合があります。

項目名

必須/省略可

変数の使用

説明

備考

フェッチサイズ

省略可

使用可

JDBCフェッチサイズを指定します。

入力できる値は「0～2147483647」です。
本プロパティで入力した値は、JDBCのsetFetchSize()メソッドの引数に指定されます。
一般的に、フェッチサイズは一度にデータベースから取得する行数を設定しますが、データベースや使用するJDBCドライバによって動作が異なる場合があります。
省略した場合、または数値以外を入力した場合は、JDBCドライバのフェッチサイズを指定しない場合の動作にしたがいます。

注意

[フェッチサイズ]に大きな値を設定した場合、メモリ使用量が増大し、メモリ不足エラーが発生する場合があります。
以下のコネクターには本プロパティはありません。
- SQL Serverコネクター
- Amazon RDS for SQL Serverコネクター
- Azure SQL Databaseコネクター

クエリタイムアウトを有効にする

必須

使用不可

クエリタイムアウトを有効にするかどうかを選択します。

[チェックあり]

クエリタイムアウトを設定します。

[チェックなし]

(デフォルト)

クエリタイムアウトを設定しません。

[チェックなし]とした場合、JDBCドライバのクエリタイムアウトを指定しない場合の動作にしたがいます。

クエリタイムアウト(秒)

必須

使用可

クエリタイムアウトを設定します。

[クエリタイムアウトを有効にする]を[チェックあり]とした場合、有効になります。
入力できる値は「0～2147483647」です。
本プロパティで入力した値は、JDBCのsetQueryTimeout()メソッドの引数に指定されます。
一般的に、クエリタイムアウトは実行を待つ秒数を設定しますが、データベースや使用するJDBCドライバによって動作が異なる場合があります。

データ処理方式

項目名	必須/省略可	変数の使用	説明	備考
データ処理方式	必須	使用不可	データ処理方式を選択します。 [スクリプトの設定を使用する] (デフォルト) スクリプトプロパティの大容量データ処理の設定をコネクターに使用します。 [大容量データ処理を行わない] 大容量データ処理を行いません。 [大容量データ処理を行う] 大容量データ処理を行います。

項目名

必須/省略可

変数の使用

説明

備考

データ処理方式

必須

使用不可

データ処理方式を選択します。

[スクリプトの設定を使用する]

(デフォルト)

スクリプトプロパティの大容量データ処理の設定をコネクターに使用します。

[大容量データ処理を行わない]

大容量データ処理を行いません。

[大容量データ処理を行う]

大容量データ処理を行います。

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このコネクターの簡単な説明を記述することができます。

スキーマ

入力スキーマ

ありません。

出力スキーマ

[スキーマ定義]の設定により、カラム数が異なります。

= 備考 =

スキーマ構造については、「テーブルモデル型」を参照してください。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

= 備考 =

詳細については、「スキーマ編集」を参照してください。

トランザクション

トランザクションをサポートしています。

大容量データ処理

大容量データ処理に対応しています。

PSPでの使用について

PSPで使用できます。

= 備考 =

PSPについては、「パラレルストリーミング処理」を参照してください。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
count	読み取ったデータの件数が格納されます。	デフォルト値はnullです。注意 PSPでは値が格納されません。
error_code	エラー(SQLException)発生時、発生したエラーに対応するエラーコードが格納されます。	デフォルト値はnullです。正常終了時は「0」が格納されます。注意エラーコードは各ドライバの仕様に基づいています。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。

メッセージコード、例外メッセージ、制限事項

コネクター	メッセージコード	例外メッセージ	制限事項
DB2 コネクターのメッセージおよび制限事項
MySQL コネクターのメッセージおよび制限事項
Oracle コネクターのメッセージおよび制限事項
PostgreSQL コネクターのメッセージおよび制限事項
SQL Server コネクターのメッセージおよび制限事項
JDBC コネクターのメッセージおよび制限事項
Amazon Athenaコネクターのメッセージおよび制限事項
Amazon Aurora for MySQL コネクターのメッセージおよび制限事項
Amazon RDS for MySQL コネクターのメッセージおよび制限事項
Amazon RDS for Oracle コネクターのメッセージおよび制限事項
Amazon RDS for PostgreSQL コネクターのメッセージおよび制限事項
Amazon RDS for SQL Server コネクターのメッセージおよび制限事項
Azure SQL Database コネクターのメッセージおよび制限事項
Snowflake コネクターのメッセージおよび制限事項