基本構文項目

VALUES (1,'A') は構文エラーにつながります。

VALUES (1,2,3) は誤った結果につながります。

VALUES (1 ,'A')

VALUES (1 ,2 ,3)

1 つの方法は標準 SQL 構文に対応しています。この場合、authorization-identifier とテーブル名はピリオドで区切ります。この形式を使用する場合、authorization-identifier を使用せずに、DDM の名前をデータベーステーブルの名前と同じにする必要があります。

例：

DEFINE DATA LOCAL 
01 PERS VIEW OF PERSONNEL 
   02 NAME 
   02 AGE 
END-DEFINE 
SELECT * 
  INTO VIEW PERS 
  FROM SQL.PERSONNEL 
...

別の方法として、authorization-identifier を DDM 名の一部として定義できます。DDM 名は、authorization-identifier とデータベーステーブル名をハイフン（-）で区切った構成です。authorization-identifier とテーブル名の間のハイフンは内部的にピリオドに変換されます。

例：

DEFINE DATA LOCAL 
01 PERS VIEW OF SQL-PERSONNEL 
   02 NAME 
   02 AGE 
END-DEFINE 
SELECT * 
  INTO VIEW PERS 
  FROM SQL-PERSONNEL 
...

authorization-identifier が明示的にも DDM 名内にも指定されていない場合、SQL データベースシステムによって決定されます。

テーブル名は、SELECT ステートメントで使用されるほか、DELETE、INSERT、および UPDATE ステートメントにも指定できます。

例：

... 
DELETE FROM SQL.PERSONNEL 
  WHERE AGE IS NULL 
 ... 
    
... 
INSERT INTO SQL.PERSONNEL (NAME,AGE) 
  VALUES ('ADKINSON',35) 
... 
    
... 
UPDATE SQL.PERSONNEL 
SET SALARY = SALARY * 1.1 
WHERE AGE > 30 
...

受信側フィールドとして（INTO 節などで）定義する場合、host-variable では値がデータベースシステムによって割り当てられている変数を識別します。

送信側フィールドとして（WHERE 節などで）定義する場合、host-variable ではプログラムからデータベースシステムに渡される値を指定します。

「Natural フォーマットと SQL データタイプ」も参照してください。

SQL 標準に準拠するために、host-variable の先頭にコロン（:）を付けることもできます。フレキシブル SQL で使用する場合、host-variables はコロンで修飾する必要があります。

例：

SELECT NAME INTO :#NAME FROM PERSONNEL 
WHERE AGE = :VALUE

変数名が SQL 予約語と同一の場合、コロンは常に必要です。host-variable または列の参照が可能な状況では、コロンなしの名前を使用すると、列への参照として解釈されます。

INDICATOR 節は、"空値"（つまり、値なし）と実際の値 0 または "空白" を区別するためのオプション機能です。

受信側 host-variable（ターゲットフィールド）で指定する場合、INDICATOR host-variable（空値インジケータフィールド）によって、取得される列が "空値" であるかどうかを調べることができます。

例：

DEFINE DATA LOCAL 
1 NAME      (A20) 
1 NAMEIND   (I2) 
END-DEFINE 
SELECT * 
  INTO NAME INDICATOR NAMEIND 
...

この例では、NAME は受信側 host-variable を表し、NAMEIND は空値インジケータフィールドを表します。

空値インジケータフィールドが指定されており、取得される列が空値の場合、空値インジケータフィールドの値は負になり、そのデータタイプに応じてターゲットフィールドが 0 または "空値" に設定されます。それ以外の場合、空値インジケータフィールドの値は 0 以上になります。

送信側 host-variable（ソースフィールド）で指定する場合、空値インジケータフィールドはこのフィールドに空値を指定するために使用されます。

例：

DEFINE DATA LOCAL 
1 NAME      (A20) 
1 NAMEIND   (I2) 
UPDATE ... 
SET NAME = :NAME INDICATOR :NAMEIND 
WHERE ...

この例では、:NAME は送信側 host-variable を表し、:NAMEIND は空値インジケータフィールドを表します。空値インジケータフィールドの入力として負の値を入力すると、空値がデータベース列に割り当てられます。

INDICATOR host-variable のフォーマット／長さは I2 です。

LINDICATOR 節は、可変長（例えば、VARCHAR または LONG VARCHAR タイプ）の列をサポートするためのオプション機能です。

受信側 host-variable（ターゲットフィールド）で指定する場合、LINDICATOR host-variable（長さインジケータフィールド）にはデータベースによってターゲットフィールドに実際に返された文字数が入ります。ターゲットフィールドは常に空白で埋められます。

VARCHAR または LONG VARCHAR 列にターゲットフィールドに収まりきらない文字が含まれている場合、長さインジケータフィールドは実際に返された長さ（つまり、ターゲットフィールドの長さ）に設定され、空値インジケータフィールド（指定されている場合）はこの列の合計長に設定されます。

例

DEFINE DATA LOCAL 
1 ADDRESSLIND (I2) 
1 ADDRESS     (A50/1:6) 
END-DEFINE 
SELECT * 
  INTO :ADDRESS(*) LINDICATOR :ADDRESSLIND 
  ...

この例では、:ADDRESS(*) はアドレス指定された VARCHAR または LONG VARCHAR 列の最初の 300 バイト（利用可能な場合）を受け取るターゲットフィールドを表し、:ADDRESSLIND は実際に返された文字数を含む長さインジケータフィールドを表します。

送信側 host-variable（ソースフィールド）で指定する場合、長さインジケータフィールドではデータベースに渡されるソースフィールドの文字数を指定します。

例：

DEFINE DATA LOCAL 
1 NAMELIND  (I2) 
1 NAME      (A20) 
1 AGE       (I2) 
END-DEFINE 
MOVE  4     TO NAMELIND 
MOVE 'ABC%' TO NAME 
SELECT AGE 
  INTO :AGE 
WHERE NAME LIKE :NAME LINDICATOR :NAMELIND 
  ...

LINDICATOR host-variable のフォーマット／長さは I2 または I4 です。パフォーマンス上の理由から、対応するターゲットフィールドまたはソースフィールドの直前に指定する必要があります。そうしないと、フィールドはランタイムに一時ストレージにコピーされます。

LINDICATOR フィールドを I2 フィールドとして定義すると、対応する列の送受信には SQL データタイプ VARCHAR が使用されます。LINDICATOR host-variable を I4 として指定すると、ラージオブジェクトデータタイプ（CLOB/BLOB）が使用されます。

フィールドを DYNAMIC として定義すると、列は内部ループでは実際の長さまで読み取られます。LINDICATOR フィールドと *LENGTH はこの長さに設定されます。固定長フィールドの場合、列は定義された長さまで読み込まれます。いずれの場合も、フィールドは LINDICATOR フィールドで定義した値まで書き込まれます。

固定長フィールドの定義には、I2 として指定した LINDICATOR フィールドを使用してください。VARCHAR 列にこの固定長フィールドに収まりきらない文字が含まれている場合、長さインジケータフィールドは実際に返された長さに設定され、空値インジケータフィールド（指定されている場合）はこの列の合計長に設定されます（取得）。これは 32 KB 以上の固定長フィールドには適用されません（長さが空値インジケータフィールドに収まらないため）。