BATSQL (バッチ SQL) バッチ・コマンド

ヒント

2 から 10000 までの AUTOCOMMIT 値が指定されている場合、行セット処理が自動的に選択されます。

DELETE、INSERT、UPDATE 処理では、FM/Db2 は、1 回の取り出しで行セットの行数を取り出します。DELETE 処理および UPDATE 処理の場合のみ、FM/Db2 は 1 つの SQL ステートメントを使用して、行セットの行数を削除または更新しようと試みます。

INSERT では、それぞれの行が常に 1 行の INSERT ステートメントで挿入されます。

行セット処理で大きな行セット・サイズを使用する場合、大きな領域サイズが必要になる可能性があります。FM/Db2 は、指定された行セットの行数のデータを保管するために十分なストレージを必要とします。

行セットを使用する DELETE 処理および UPDATE 処理では、それらの行セットに対する DELETE 操作または UPDATE 操作が失敗する可能性があります。この障害が発生すると、FM/Db2 は単一行処理を使用して、行セットの行ごとに DELETE 操作および UPDATE 操作を再試行します。行セットの DELETE 操作または UPDATE 操作で検出されたエラーが、エラー・カウンターを増やすことはありません。ただし、単一行の DELETE または UPDATE に対するエラーは、エラー・カウンターを増やします。

例(X)

これらの例は、以下の表定義を参照します。

CREATE TABLE RFM0681A."Names"
  ("Name_Identifier" INTEGER NOT NULL
  ,"Last_Name"       VARCHAR(16) NOT NULL
  ,"First_Name"      VARCHAR(16) NOT NULL
  ,"Second_Name"     VARCHAR(16) NOT NULL
  ,"Sex"             CHAR(1)     NOT NULL
  ,"Date_Of_Birth"   DATE        NOT NULL
  );

CREATE TABLE RFM0681B."Names"
  ("Name_Identifier" INTEGER NOT NULL
  ,"Date_Of_Birth"   DATE
  ,"Sex"             CHAR(1)
  ,"First_Name"      VARCHAR(16)
  ,"Second_Name"     VARCHAR(16)
  ,"Last_Name"       VARCHAR(16)
  );

例 1

有効な性別 (「F」または「M」) を持っていない行のすべてを表から削除します。50 個の削除操作が完了するたびに、Db2® コミットを出します。何らかのエラーがあれば、停止します。

//FMNDB2   EXEC PGM=FMNDB2,PARM=('SSID=DFXX,SQID=XXXXXXX')
//SYSPRINT DD SYSOUT=*
//FMNTSPRT DD SYSOUT=*
//DDINWHR  DD *
WHERE ("Sex" <> 'M'
  AND  "Sex" <> 'F')
/*
//SYSIN DD *
$$FILEM BATSQL TYPE=DELETE,
$$FILEM OBJIN=RFM0681A."Names",
$$FILEM AUTOCOMMIT=50,
$$FILEM MAXERRORS=1

例 2

以下の項目を持つ行のすべてを表で更新します。

• 姓「Smith」
• 性別「m」

これらの行を、以下の項目を持つように変更します。

• 姓「SMITH」
• 名前「JAMES」
• セカンドネームなし
• 性別「M」

100 個の更新操作が完了するたびに、Db2® コミットを出します。10 個を超えるエラーがあれば、停止します。

//FMNDB2   EXEC PGM=FMNDB2,PARM=('SSID=DFXX,SQID=XXXXXXX')
//SYSPRINT DD SYSOUT=*
//FMNTSPRT DD SYSOUT=*
//DDINSET  DD *
SET ("Last_Name", "First_Name", "Second_Name", "Sex") =
    ('SMITH',     'JAMES',      '',            'M')
/*
//DDINWHR  DD *
WHERE "Last_Name" = 'Smith'
  AND "Sex" = 'm'
/*
//SYSIN DD *
$$FILEM BATSQL TYPE=UPDATE,
$$FILEM OBJIN=RFM0681A."Names",
$$FILEM AUTOCOMMIT=100,
$$FILEM MAXERRORS=10
/*

例 3

RFM0681A."Names" に対する SELECT を使用して行を RFM0681B."Names" に挿入し、結果表を作成します。

"Name_Identifier" の値が 100,000 以下である場合のみ、行を挿入します。

//FMNDB2   EXEC PGM=FMNDB2,PARM=('SSID=DFXX,SQID=XXXXXXX')
//SYSPRINT DD SYSOUT=*
//FMNTSPRT DD SYSOUT=*
//DDININS  DD *
(
 "First_Name",
 "Second_Name",
 "Last_Name",
 "Sex",
 "Date_Of_Birth",
 "Name_Identifier"
)
/*
//DDINSEL DD *
SELECT
 "First_Name",
 "Second_Name",
 "Last_Name",
 "Sex",
 "Date_Of_Birth",
 "Name_Identifier"
FROM RFM0681A."Names"
WHERE "Name_Identifier" <= 100000
/*
//SYSIN DD *
$$FILEM BATSQL TYPE=INSERT,
$$FILEM OBJOUT=RFM0681B."Names",
$$FILEM AUTOCOMMIT=50,
$$FILEM MAXERRORS=100
/*