SYSCS_UTIL.SYSCS_EXPORT_TABLE システム手続き

SYSCS_UTIL.SYSCS_EXPORT_TABLEシステム手続きは、デリミトされたデータファイルの書式で、表から基本ソフト(OS)のファイルへエクスポートを行います。

セキュリティ的な配慮と意図せぬファイルの破壊を避けるため、このエクスポートの手続きは情報を既存ファイルへエクスポートしません。エクスポートの手続きでは新規のファイル名を指定する必要があります。この手続きを実行すると、作成した新規ファイルへ情報がエクスポートされます。

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

構文

SYSCS_UTIL.SYSCS_EXPORT_TABLE (IN SCHEMANAME  VARCHAR(128),
IN TABLENAME VARCHAR(128), IN FILENAME VARCHAR(32672),
IN COLUMNDELIMITER CHAR(1), IN CHARACTERDELIMITER CHAR(1),
IN CODESET VARCHAR(128)) 

このシステム手続きは結果を返しません。

SCHEMANAME

An input argument of type VARCHAR(128) that specifies the schema name of the table. Passing a NULL value will use the default schema name.

TABLENAME

この引数の型はVARCHAR(128)で、この引数により情報をエクスポートする表やビューの名前を指定します。空の値を渡すとエラーになります。

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_TABLE (null, 'STAFF', 'myfile.del', null, null, null);