項目名 |
必須/省略可 |
変数の使用 |
説明 |
備考 |
接続先 |
必須 |
使用不可 |
グローバルリソースを選択します。
- [追加]:
新規にグローバルリソースを追加します。
- [一覧の編集]:
「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
|
|
テーブル名 |
必須 |
使用可 |
読み取るテーブルの名前を選択または入力します。 |
-
グローバルリソースの一覧設定で指定した制限数のテーブルが表示されます。
- データベース上のスキーマ名やテーブル名に「.」が含まれる場合、スキーマ名とテーブル名を引用符で囲むと正しく扱うことができます。
たとえば引用符が「"」の場合、スキーマ名が「A.B」で、テーブル名が「C.D」とすると、正しい引用符の囲み方は「"A.B"."C.D"」となります。
|
テーブル名を引用符で囲う |
省略可 |
使用不可 |
指定したテーブル名を引用符で囲うかどうかを選択します。
- [チェックあり]:
[テーブル名]に表示されているテーブル名を引用符で囲います。
- [チェックなし]:(デフォルト)
[テーブル名]に表示されているテーブル名を引用符で囲いません。
スペースなどの文字がテーブル名に含まれていた場合には、テーブル名を引用符で囲う必要があります。
引用符で囲う必要がある文字については、各データベースベンダーに問い合わせてください。
|
- 各データベースアダプタで設定されている引用符は以下の通りです。
- Oracle、DB2、PostgreSQL、Amazon RDS for Oracle、Amazon RDS for PostgreSQL:「""」(二重引用符)
- SQL Server、Amazon RDS for SQL Server、Azure SQLデータベース:「[]」(半角大括弧)
- MySQL、Amazon RDS for MySQL、Amazon Aurora for MySQL: 「``」(バッククォート)
- JDBCアダプタには本プロパティはありません。
- 実行時には[テーブル名]に入力されたテーブル名をそのまま使用します。
[テーブル名]に入力されたテーブル名が引用符で囲われていた場合には、実行時にも引用符で囲まれたテーブル名でクエリーを発行します。
[テーブル名]に入力されたテーブル名が引用符で囲まれていない場合には、実行時に本プロパティの有効/無効を確認のうえ、本プロパティが有効であれば引用符で囲まれたテーブル名でクエリーを発行します。
- [テーブル名]に環境変数を設定した場合、本プロパティの有効/無効を切り替えた際に値が展開されます。
|
スキーマ定義 |
必須 |
- |
[テーブル名]で指定したテーブルのスキーマ定義を表示します。 |
- [スキーマ定義]で表示された列の中で、[読み取り対象]にチェックを入れた列名がMapperのスキーマに表示されます。
- 以下の場合はスキーマ定義を表示することはできません。
- 指定したテーブルに読み取り権限がない場合
- 指定したテーブルが存在しない場合
- [テーブル名]に変数が指定されている場合
- [テーブル名]が入力されていない場合
- [テーブル名]でエラーが発生している場合
|
スキーマ定義/読み取り対象 |
省略可 |
使用不可 |
[テーブル名]で指定したテーブルの各列を、読み取り対象に含めるかどうかを選択します。
- [チェックあり]:(デフォルト)
読み取り対象に含めます。
- [チェックなし]:
読み取り対象に含めません。
|
- チェックを入れた列の列名がMapperのスキーマに表示されます。
- ヘッダに表示されたチェックボックスを押下することで、一括操作を行うことができます。
- 1つ以上の列にチェックが入っている必要があります。
|
スキーマ定義/列名 |
必須 |
使用不可 |
[テーブル名]で指定したテーブルの列名を表示します。 |
|
スキーマ定義/型 |
必須 |
使用不可 |
[列名]の型を表示します。 |
- 「<Native型> (<内部データ型>)」形式で表示されます。
- Native型:
各RDBMSの固有のデータ型です。
- 内部データ型:
DataSpider Cloud内部で使用しているデータ型です。
詳細については、「内部データ型」を参照してください。
|
コンポーネント変数名 |
説明 |
備考 |
count |
読み取ったデータの件数が格納されます。 |
- デフォルト値はnullです。
- PSPでは値が格納されません。
|
error_code |
エラー(SQLException)発生時、発生したエラーに対応するエラーコードが格納されます。 |
- デフォルト値はnullです。
- 正常終了時は「0」が格納されます。
- エラーコードは各ドライバの仕様に基づいています。
|
message_category |
エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。 |
|
message_code |
エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。 |
|
message_level |
エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。 |
|
error_type |
エラー発生時、発生したエラーの種類が格納されます。 |
- デフォルト値はnullです。
- エラーの種類は、以下のような形式となります。
例:「java.io.FileNotFoundException」
- DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
error_message |
エラー発生時、発生したエラーのメッセージが格納されます。 |
- デフォルト値はnullです。
- DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
|
error_trace |
エラー発生時、発生したエラーのトレース情報が格納されます。 |
- デフォルト値はnullです。
- DataSpider Cloudのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。
|
例外名 |
原因 |
対策 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[] |
[接続先]が指定されていません。 |
[接続先]を指定してください。 |
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>] |
[接続先]で選択されたリソース定義が見つかりません。 |
[接続先]で指定したグローバルリソースを確認してください。 |
InvalidPropertyConfigurationException |
[テーブル名]が未設定です。 |
[テーブル名]を指定してください。 |
InvalidPropertyConfigurationException 読み取り対象カラムが選択されていません。 |
[スキーマ定義]の[読み取り対象]が選択されていません。 |
[スキーマ定義]の[読み取り対象]を1つ以上選択してください。 |
java.sql.SQLException |
データベースアクセスエラーまたはそのほかのエラーが発生しています。 |
SQLExceptionのメッセージを確認してください。SQLExceptionのメッセージは各ドライバの仕様に基づいています。SQLExceptionのメッセージにはエラーの原因が出力されている場合があります。
メッセージの詳細については、各データベースベンダーに問い合わせてください。 |