構文SYSCS_UTIL.SYSCS_IMPORT_DATA_LOBS_FROM_EXTFILE (
IN SCHEMANAME VARCHAR(128),
IN TABLENAME VARCHAR(128),
IN INSERTCOLUMNS VARCHAR(32672),
IN COLUMNINDEXES VARCHAR(32672),
IN FILENAME VARCHAR(32672),
IN COLUMNDELIMITER CHAR(1),
IN CHARACTERDELIMITER CHAR(1),
IN CODESET VARCHAR(128),
IN REPLACE SMALLINT)
)
インポートユーティリティはLOBの情報がある場所への参照を主となるインポートファイルから探します。
- SCHEMANAME
- 表のスキーマを指定します。既定のスキーマ名を利用するために、NULLの値を指定することができます。
SCHEMANAMEパラメータは、VARCHAR (128)型の引数を入力にとります。
- TABLENAME
- 情報がインポートされる表の名前を指定します。
表はシステム表や一時表であってはなりません。
文字列は表名と大文字小文字が一致していなければなりません。NULL値を指定するとエラーとなります。
TABLENAMEパラメータは、VARCHAR (128)型の引数を入力にとります。
- INSERTCOLUMNS
- 情報がインポートされる表の列の名前を、コンマで区切って指定します。
表の全列へインポートする場合、NULL値を指定することができます。
INSERTCOLUMNSパラメータは、VARCHAR (32672)型の引数を入力にとります。
- COLUMNINDEXES
- 入力される情報のうち、インポートされる欄の列番号(1から数えます。)をコンマで区切って指定します。
ファイルの全欄を指定する場合、NULL値を指定することもできます。COLUMNINDEXESパラメータは、VARCHAR (32762)型の引数を入力にとります。
- FILENAME
- インポートする情報のあるファイルの名前を指定します。パスが省略された場合、現在の作業ディレクトリが使われます。ネットワークサーバで利用する場合、ファイルの位置はサーバサイドの位置を参照します。
NULLを指定するとエラーになります。
fileNameパラメータは、VARCHAR (32672)型の引数を入力にとります。
- COLUMNDELIMITER
- 列のデリミタを指定します。指定された文字はコンマの代わりに列の終わりを表します。既定値のコンマを利用する場合、NULL値を指定できます。
COLUMNDELIMITERパラメータは、CHAR (1)型の引数を入力にとります。
- CHARACTERDELIMITER
- 文字のデリミタを指定します。指定された文字は二重引用符の代わりに列の終わりを表します。既定値の二重引用符を利用する場合、NULL値を指定できます。
CHARACTERDELIMITERパラメータは、
CHAR (1)型の引数を入力にとります。
- CODESET
- 入力ファイル中の情報のコードセットを指定します。コードセットの名前はJavaで利用可能な文字円コーディングでなければなりません。
情報は指定されたコードセットから、データベースのコードセット(UTF-8)へと変換されます。
実行するJVMと同じコードセットでデータファイルを解釈する場合、NULL値を指定することができます。
CODESETパラメータは、VARCHAR (128)データ型を入力にとります。
- REPLACE
- このパラメータに0以外の値を指定すると、インポートがREPLACEモードで行われます。一方で0を指定すると、インポートはINSERTモードで行われます。
REPLACEモードでは表にある既存の情報はすべて切り捨てられたのち、インポートした情報が挿入されます。
表の定義や索引の定義には変更がありません。表が既にある場合のみ、REPLACEモードで情報をインポートすることができます。INSERTモードでは既存の表の情報に変更を加えずに、インポートした情報を追加します。
パラメータにNULL値を指定するとエラーが発生します。
REPLACEパラメータは、SMALLINTデータ型を入力にとります。
デリミトされない識別子でスキーマ、表、列が作成された場合、インポートの手続きに渡す名前はすべて大文字でなければなりません。
デリミトされた識別子でスキーマ、表、列が作成された場合、インポートの手続きに渡す名前は作成された名前と大文字と小文字が一致しなければなりません。