SYSCS_UTIL.SYSCS_EXPORT_QUERYシステム手続き

The SYSCS_UTIL.SYSCS_EXPORT_QUERY system procedure exports the results of a SELECT statement to an operating system file.

セキュリティ的な配慮と予期せぬファイルの破損を避けるため、このエクスポートを行う手続きでは既存ファイルへ情報はエキスポートされません。まだ存在しないファイルのファイル名のみ、エクスポートで指定できます。手続きを実行するとファイルが作成されて、そのファイルへ情報がエクスポートされます。

情報はデリミトされたファイル書式によりエクスポートされます。

構文

SYSCS_UTIL.SYSCS_EXPORT_QUERY(IN SELECTSTATEMENT VARCHAR(32672),
IN FILENAME VARCHAR(32672), IN COLUMNDELIMITER CHAR(1),
IN CHARACTERDELIMITER CHAR(1), IN CODESET VARCHAR(128))

この手続きは結果を返しません。

SELECTSTATEMENT: この引数の型はVARCHAR(32672)です。この引数にはエクスポートする情報を返す選択文(問合せ)を渡します。引数に空の値を渡すとエラーとなります。
FILENAME: 情報をエキスポートする新規ファイルを指定します。パスが省略された場合、現在のディレクトリが使われます。もし既存ファイルの名前が指定された場合、エクスポートの手続きはエラーを返します。ネットワークサーバを利用している場合、指定するファイルの位置はサーバ上の位置です。NULL値を指定するとエラーとなります。 FILENAMEパラメータはVARCHAR (32672)型の値を入力にとる引数です。
COLUMNDELIMITER: この引数の型はCHAR(1)で、列のデリミタを指定します。与えた文字はコンマの代わりに列の終わりを表します。空の値が渡された場合は既定値が使われ、既定値はコンマ(,)です。
CHARACTERDELIMITER: この引数の型はCHAR(1)で、文字のデリミタを指定します。与えた文字は二重引用符の代わりに文字列の囲いを表します。空の値が渡された場合は既定値が使われ、既定値は二重引用符(")です。
CODESET: この引数の型はVARCHAR(128)で、エクスポートされるファイルの情報のコードセットを表します。コードセットの名前はJavaがサポートするエンコーディングの何れかでなければなりません。情報はファイルに書き出される前に、データベースのコードセットから指定されたコードセットに変換されます。空の値を渡すと実行中のJVMと同じコードセットで情報は書き出されます。

使い方

この手続きの利用に関する更なる情報については、Derby ツールとユーティリティーガイドの「バルクインポートとエクスポートの手続きを使う」という章を参照してください。

例

次の例ではSAMPLEデータベースにあるSTAFF表から、myfile.delというファイルにエクスポートを行う方法を示します。

CALL SYSCS_UTIL.SYSCS_EXPORT_QUERY('select * from staff where dept =20',
'c:/output/awards.del', null, null, null);