# 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);

親トピック: 組み込みシステム手続き