5.5.4　繰返し列を含む表の配列データ形式

(a)　DAT形式の場合

DAT形式ファイルには，FF形式，又はVV形式の配列データ形式で記述できます。

FF形式のフォーマット：

指定要素数分を区切り文字で区切ってデータを記述します。列構成情報ファイルを省略，又は列構成情報ファイルで指定要素数を省略した場合，最大要素数が指定要素数になります。

VV形式のフォーマット：

要素データの先頭に実要素数０〜最大要素数で指定し，実要素数分を区切り文字でデータを区切って記述します。

(b)　バイナリ形式の場合

バイナリ形式ファイルには，FF，FV，及びVV形式の配列データ形式で記述できます。

FF形式のフォーマット：

指定要素数分のデータを表「各データ型に対する列データ・パラメタの記述形式（バイナリ形式）」に示す形式で記述します。ナル値・関数情報ファイル自体又はナル値・関数情報ファイルで指定要素数を省略した場合，最大要素数が指定要素数になります。

FV形式のフォーマット：

要素データの先頭に実要素数を2バイトの2進数で指定し，指定要素数分のデータを表「各データ型に対する列データ・パラメタの記述形式（バイナリ形式）」に示す形式で記述します。ナル値・関数情報ファイル自体又はナル値・関数情報ファイルで指定要素数を省略した場合，最大要素数が指定要素数になります。

VV形式のフォーマット：

要素データの先頭に実要素数を2バイトの2進数で指定し，実要素数分のデータを表「各データ型に対する列データ・パラメタの記述形式（バイナリ形式）」に示す形式で記述します。

(c)　固定長データ形式の場合

固定長データ形式ファイルには，FF形式又はFV形式の配列データ形式で記述できます。

列構成情報ファイル，及びナル値・関数情報ファイルを省略，又は列構成情報ファイル，及びナル値・関数情報ファイルで指定要素数を省略した場合，最大要素数が指定要素数になります。

なお，バイナリ形式でデータを記述した場合，VARCHAR，NVARCHAR，MVARCHARで指定する各要素のデータ長が定義長に満たない場合は，定義長まで埋め字をする必要があります。

FF形式のフォーマット：

指定要素数分のデータを表「各データ型に対する列データ・パラメタの記述形式（バイナリ形式）」に示す形式で記述します。

FV形式のフォーマット：

要素データの先頭に実要素数を2バイトの2進数で指定し，指定要素数分のデータを表「各データ型に対する列データ・パラメタの記述形式（バイナリ形式）」に示す形式で記述します。

(d)　固定長データ型の場合の配列データの指定例

固定長データ型の場合の配列データの指定例を次の図に示します。

なお，CHAR(3) ARRAY[5]の列の場合の例です。ナル値には３バイトの「nul」という文字を指定しています。

図5‒18　固定長データ型の場合の配列データの指定例

(e)　可変長データ型の場合の配列データの指定例

固定長データ形式，及びバイナリ形式の場合で，可変長データ型(VARCHAR，MVCHAR，NVARCHAR)のときは，FF形式及びFV形式ではデータは常に表の定義長分指定します。

有効なデータより後方には任意の埋め字をします。VV形式の場合は埋め字をしません。

可変長データ型の場合の配列データの指定例を次の図に示します。なお，VARCHAR(3) ARRAY[3]の列の場合の例です。ナル値には３バイトの「nul」という文字を指定しています。

図5‒19　可変長データ型の場合の配列データの指定例

(a)　FF形式でのナル値の扱い

FF形式の場合，入力データ中には実要素数を指定しません。

このため，後方に連続したナル値がある場合，次に示す指定によって無効な要素データとみなし，データベースに格納しないようにできます。

• 制御情報ファイルarray文のnullsetオペランド

• 列構成情報ファイルのnullsetオペランド

• ナル値・関数情報ファイルのnullsetオペランド

なお，列構成情報ファイル及びナル値・関数情報ファイルでは列単位の指定，制御情報ファイルのarray文では表単位の指定です。三つとも指定した場合，列構成情報ファイル及びナル値・関数情報ファイルでの指定が優先されます。

また，nullsetオペランドの指定を省略した場合はnullset=cが仮定されます。

ナル値オプション指定値とデータベースへの格納方法を次の表に示します。

表5‒37　FF形式でのナル値オプション指定値とナル値のデータベースへの格納方法

ナル値の種類	ナル値オプション指定値
	c（デフォルト）	e
途中のナル値	該当する要素にナル値を格納します。	該当する要素にナル値を格納します。
後方の連続したナル値(以前に有効要素データが一つでもある場合)	該当する要素(後方の連続したナル値)は，無効データとみなし，データベースに格納しません。	該当する要素(後方の連続したナル値)にナル値を格納します。※
後方の連続したナル値(要素データがすべてナル値の場合)	列をナル値とします。	全要素にナル値を格納します。※

注

FF形式の場合，入力データファイル中の要素データの数は，表定義で指定した要素数よりも少ないときがあります。

この場合，入力データファイル中の実要素数より後方の部分は，データが指定されていません。これは，ナル値ではなく，要素データがないということであるため，nullset=eが指定されてもナル値は格納しません。

注※

nullset=eを指定した場合，入力データファイルの要素データ数分のナル値がデータベースに格納されます。このため，データベースの格納効率を考慮すると，nullset=cを指定することをお勧めします。nullset=eを指定するのは，ナル値の数をそろえたい場合です。

(a)　DAT形式の場合

DAT形式のデータ記述例を次の図に示します。

表定義：CREATE TABLE T1(C1 INTEGER,C2 CHAR(1) ARRAY[10])

図5‒21　DAT形式のデータ記述例（繰返し列の場合）

(b)　バイナリ形式の場合

バイナリ形式のデータ記述例を次の図に示します。

表定義：CREATE TABLE T1(C1 CHAR(4),C2 CHAR(10),C3 CHAR(5) ARRAY[10])

図5‒22　バイナリ形式のデータ記述例（繰返し列の場合）

(c)　固定長データ形式の場合

固定長データ形式のデータ記述例を次の図に示します。

表定義：CREATE TABLE T1(C1 CHAR(4),C2 CHAR(10),C3 VARCHAR(5) ARRAY[10])

図5‒23　固定長データ形式のデータ記述例（繰返し列の場合）