4.38.1　UPDATE文 形式3，形式4の形式と規則

(a)　形式3のオペランド及びオペランド規則

SET句

列の値を更新します。

更新値

更新値の列の値として，次に示す項目が指定できます。

• ：埋込み変数配列〔：標識変数配列〕

• 列名

• 定数

• 値式（四則演算，連結演算を含みます）

• スカラ副問合せ

• USER値関数

• CURRENT_DATE値関数

• CURRENT_TIME値関数

• CURRENT_TIMESTAMP値関数

• NULL（ナル値を表します）

• DEFAULT（更新対象の列の既定値を表します）

• ?パラメタ

ただし，更新値には配列形式でない埋込み変数は指定できません。

(b)　形式4のオペランド及びオペランド規則

SET句

列の値を更新します。

ROW

行単位でデータを更新する場合に指定します。

行更新値

ROWに対応した行更新値として，次に示す項目が指定できます。

：埋込み変数配列〔：標識変数配列〕

ROWを指定する場合の規則を次に示します。

1. 行単位の更新は，FIX属性の実表に対してだけ使用できます。ROWは行全体（予備列を含む）を意味し，これを指定すると行全体を一つのデータとして，一つの領域のデータで更新します。更新するデータのデータ型は，各列のデータ型に関係なく，ROW型になります。ROW型に対しては，CHAR（n）〔nは行長〕に対する変数，又は同じ長さの構造体を指定できます。ただし，構造体中に境界調整による空きがあってはいけません。また，データ長は，行長（各列のデータ長の総和）になります。

2. UAPが動作するプラットフォームとHiRDBサーバが動作するプラットフォームのエンディアンを同じにしてください。異なるエンディアン間では，ROWは使用できません。例えば，WindowsのUAPでROWを使用する場合は，HiRDBサーバも同じエンディアンのWindows版を使用してください。

(c)　形式3及び形式4に共通するオペランド及びオペランド規則

FOR ：埋込み変数

埋込み変数配列を使用して更新を行う回数を設定した埋込み変数を指定します。SMALLINT型の埋込み変数を指定してください。設定値は1から4,096までの範囲で，かつ埋込み変数配列，及び標識変数配列の要素数以下にしてください。0及び負の値は設定できません。範囲外の値を設定した場合は実行時にエラーとなります。

埋込み変数配列

配列形式で宣言した埋込み変数です。NULL値以外の更新値を指定するための配列変数を指定します。それぞれの行を更新する値を埋込み変数配列の各要素に設定してください。更新する値にNULL値を含む場合は，埋込み変数配列と標識変数配列を両方指定します。

標識変数配列

配列形式で宣言した標識変数です。埋込み変数配列の各要素を更新する値が，NULL値かどうかを示す値を，標識変数配列の対応する要素に設定してください。設定する値については，「標識変数の値の設定」を参照してください。

〔IN （RDエリア名指定）〕

RDエリア名指定を埋込み変数で行う場合は，埋込み変数配列にしてください。配列でない埋込み変数を指定した場合はエラーとなります。そのほかのオペランド規則については，形式１を参照してください。

〔 WHERE探索条件 〕

省略すると，指定した表のすべての行が更新されます。

探索条件

更新の対象となる行を選択する条件を指定します。この探索条件を満足するすべての行を更新します。探索条件に埋込み変数を使用する場合，配列形式でない埋込み変数は指定できません。

(a)　形式3の規則

1. 埋込み変数配列のデータ型は対応する列のデータ型，又は変換できるデータ型にしてください。

2. 配列を使用したUPDATEでは，BLOB型，最大長が32,001バイト以上のBINARY型及び抽象データ型は扱えません。

3. 配列を使用したUPDATEでは，繰返し列の複数要素の更新はできません。

4. INTEGER，又はSMALLINTのデータ型の列を，固定小数点，又は浮動小数点数のデータで更新する場合は，端数（小数）部分は更新前に切り捨てられます。また，DECIMALデータ型の列を固定小数点のデータで更新する場合には，列の位取りから下位のけたの部分が更新前に切り捨てられます。

5. 更新する列の値として，表の定義時に指定した長さ以上の文字データ又はBINARYデータは入力できません。

6. 更新する列の値として，定義域の範囲外の数データは入力できません。

7. 固定長文字列（各国文字列，混在文字列を含む）の列を更新するデータが列の長さより短い場合は，左詰めに挿入され，余りの部分に余白が設定されます。

8. SET句は，一つのSQL文中にそれぞれ1回だけ指定できます。

9. SET句内の項目は，それぞれ最大30,000個指定できます。

10. 改竄防止表に対してUPDATE文は実行できません。ただし，更新可能列は更新できます。

    改竄防止表でUPDATE ONLY FROM NULL指定した列の値の更新可否を次に示します。

    更新前の列の値	更新後の列の値	更新可否
    ナル値	ナル値	○
    ナル値	非ナル値	○
    非ナル値	ナル値	×
    非ナル値	非ナル値※	×

    （凡例）

    ○：更新できます。

    ×：更新できません。

    注

    繰返し列の場合は，ナル値（要素数が0の値）から添え字指定無しでの列単位更新だけ実行できます。

    改竄防止表で，指定した探索条件を満たす行のうち，UPDATE ONLY FROM NULLを指定した列の値に非ナル値の行がある場合，エラーになります。

    注※

    更新前の値と同値を含みます。

11. 更新対象列を含む表にWITHOUT ROLLBACKを指定し，かつ更新対象列にインデクスを定義している場合にエラーとなります。

12. WITHOUT ROLLBACKを指定した表のインデクス構成列を更新対象列とする場合，インデクス構成列に対する更新値が同値更新以外のときは実行できません。詳細は「CREATE TABLE（表定義）」のWITHOUT ROLLBACKの規則を参照してください。

13. 更新対象表が共用表で，かつ更新対象列にインデクスを定義している場合，更新前にその共用表に対するLOCK文を排他モードで実行してください。LOCK文を実行しないで共用表のインデクスを定義した列の値を更新した場合，エラーとなります。ただし，インデクスを定義している列の値に変更がない場合はLOCK文を実行する必要はありません。共用表に対する更新については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。共用表に対してLOCK文を実行した場合の排他制御の対象については「LOCK文（表の排他制御）」の留意事項を参照してください。

14. 更新対象表が次の条件をすべて満たす場合，その列をDEFAULTで更新するには更新前にその共用表に対するLOCK文を排他モードで実行してください。LOCK文を実行しないで更新した場合，エラーとなります。

    • 更新対象表が共用表である

    • 更新対象列が時刻印データ型である

    • 表定義時に既定値としてCURRENT_TIMESTAMP USING BESを指定している

(b)　形式4の規則

1. WITHOUT ROLLBACKを指定し，かつインデクスを定義した表を表識別子に指定する場合，インデクス構成列に対する更新値が同値更新以外の場合は実行できません。詳細は「CREATE TABLE（表定義）」のWITHOUT ROLLBACKの規則を参照してください。

2. 更新対象表が共用表で，かつどれかの列にインデクスを定義している場合，更新前にその共用表に対するLOCK文を排他モードで実行してください。LOCK文を実行しないで共用表を行単位（ROW指定）で更新した場合，エラーとなります。ただし，インデクスを定義している列の値に変更がない場合はLOCK文を実行する必要はありません。共用表に対する更新については，マニュアル「HiRDB システム導入・設計ガイド」を参照してください。共用表に対してLOCK文を実行した場合の排他制御の対象については「LOCK文（表の排他制御）」の留意事項を参照してください。

3. 行単位でのUPDATE文はすべての列の値を更新するため，1列でも更新不可である改竄防止表に対して，行単位でのUPDATE文は実行できません。

4. 既定文字集合以外の文字データ型の列を含む表に対しては，行単位でのUPDATE文は実行できません。

(c)　形式3及び形式4の共通規則

1. FOR句以外に埋込み変数配列を一つ以上指定してください。指定しない場合はエラーとなります。

2. FOR句以外に配列形式でない埋込み変数を指定するとエラーとなります。

3. 埋込み変数配列，及び標識変数配列の要素数は1から4,096までの範囲にしてください。範囲外の値を指定した場合はエラーとなります。また，”FOR ：埋込み変数”で指定する要素数の最大値以上になるようにしてください。

4. 各埋込み変数配列，及び標識変数配列で１回の更新処理によって評価される要素は同じ要素番号の要素となります。

5. 配列の先頭の要素から順に評価されます。

6. 複数回更新を行う場合の更新対象は，前回の配列要素を使用して更新が行われた後の更新対象となります。

7. SQL連絡領域のSQLERRD[2]領域には，重複して更新された行数も含めた更新行数の総和が設定されます。

8. UPDATE文形式３は埋込み変数配列，及び標識変数配列を含むため，PREPARE文で前処理することはできません。動的に実行する場合については，「EXECUTE文　形式2（配列を使用したSQLの実行）」を参照してください。

9. 配列を使用したUPDATEは手続きの中では使えません。

10. 更新するどれかの行で警告する必要のある事象が発生した場合，SQL連絡領域のSQLWARNに警告情報が設定されます。

11. 更新するどれかの行でエラーが発生した場合，ロールバックされます。

12. UPDATE文は改竄防止表に対して指定できません。ただし，更新可能列を定義している場合は形式３及び形式4の規則に従ってください。

13. RDエリア名指定を指定した場合，分割数が表の分割数と異なるインデクスは利用できません。RDエリア名指定を指定した問合せのためにインデクスを定義する場合は，分割数が表の分割数と等しいインデクスを定義してください。