J.4.20 pgxa_import_fixed

機能

カラムナテーブルに、固定長形式のレコードを格納します。

書式

pgxa_import_fixed_data(tablename, inputfile, lfcode, encoding, format, ignore_uniq)

引数

詳細は以下のとおりです。

引数	データ型	意味
tablename	text	格納先テーブル名(外部テーブル名)
inputfile	text	入力ファイル名
lfcode	text	改行コード 'LF' 'CRLF' ''
encoding	text	文字コード 'SJIS' 'UTF8'
format	text	入力ファイルのレコードフォーマット
ignore_uniq	boolean	一意性制約に違反するレコードの扱い TRUE:除外して格納 FALSE:エラー終了

戻り値

戻り値	意味
TRUE	正常終了
FALSE	異常終了

説明

テーブル名は、すでに定義済の外部テーブル名を指定してください。
未定義の外部テーブル名を指定した場合はエラーとなります。
カラムナテーブルが未定義の場合はエラーとなります。
入力ファイル名は、DWHサーバ上のファイルを絶対パスで指定してください。
入力ファイル名で指定したファイルが存在しない場合、または、ファイルの読込み権限が無い場合はエラーとなります。
改行コードに''を指定した場合、入力ファイルに、行の区切りとしての改行コードを含めないでください。
以下のいずれかの条件を満たす場合、ログが出力されます。
- 文字コードに'SJIS'を指定し、かつ入力データに不当なデータが確認された場合
  出力内容：不当なデータの情報
- 文字コードに'SJIS'を指定し、かつ一意性制約に違反するレコードの扱いにTRUEを指定した場合
  出力内容：一意性制約に違反するレコードの情報
ログの出力先は、パラメーター symas_ext.logdirで指定します。symas_ext.logdirに指定がない場合は、ログはDWHサーバのセットアップで設定した[データベースのデータ格納先ディレクトリ]に出力されます。パラメーターの変更方法に関しては、“3.12.14.2 システム関数制御パラメーター”を参照してください。
ログのファイル名は“J.4.29 各システム関数が出力するログファイル”を参照してください。
一意性制約に違反するレコードの扱いにFALSEを指定した場合、一意性制約に違反したデータを検出すると、ファンクションの実行がロールバックされます。
文字コードに'SJIS'を指定した場合、格納するデータの中間ファイルが出力されます。中間ファイルはパラメーター symas_ext.workdirで指定した作業用ディレクトリに出力されます。symas_ext.workdirに指定がない場合は、中間ファイルはDWHサーバのセットアップで設定した[データベースのデータ格納先ディレクトリ]に出力されます。パラメーターの変更方法に関しては、“3.12.14.2 システム関数制御パラメーター”を参照してください。
作業用ディレクトリは、入力ファイルのサイズの1.5倍以上の空きが必要です。
入力ファイルのフォーマットは、以下の様に列ごとのデータ長をカンマ区切りで記述します。
テーブルの構造
```
列名   データ型
num    int,
pref_e char(10)
pref_j char(10)
```
入力ファイルの内容
```
00001tokyo     東京＿＿＿↓
00002kanagawa  神奈川＿＿↓
00003osaka     大阪＿＿＿↓
```
注)↓は改行
入力ファイルのフォーマットの記述例
```
'5,10,10'
```

J.4.20 pgxa_import_fixed_data