DB2 SQLでのDECLARE CURSORとFETCH INTOの項目数の関係と注意点

DB2でカーソルを使ったSQL処理を行う際、DECLARE CURSORで定義した列数とFETCH INTOで受け取る列数の関係は重要です。本記事では、項目数の一致が必要か、部分的に受け取る方法があるかなど、具体例を交えて解説します。

DECLARE CURSORとFETCH INTOの基本

DECLARE CURSORではSELECT文で取得する列を定義し、FETCH INTOでその結果を変数に格納します。一般的な構文は以下の通りです。

DECLARE myCursor CURSOR FOR SELECT col1, col2, col3 FROM myTable;
FETCH myCursor INTO :var1, :var2, :var3;

この例では、カーソルで3列取得し、3つの変数に格納しています。

項目数は一致させる必要があるか

基本的には、FETCH INTOで指定する変数の数はSELECT文で取得する列の数と一致させる必要があります。不一致の場合、SQLCODE -504やエラーが発生します。

つまり、DECLAREで10列定義していても、INTOで1つだけ受け取ることはできません。DB2では列と変数の数が一致している必要があります。

部分的に列を取得したい場合の方法

全列をFETCH INTOで受け取る必要はありますが、使わない列は無視することが可能です。具体的には、変数をダミーで用意するか、必要な列だけをSELECTで取得する方法があります。

• ダミー変数を使う方法: 使わない列を格納するためのプレースホルダ変数を宣言してFETCH INTOに含める。
• 必要な列だけSELECTする方法: カーソル定義時に必要な列だけ指定する。

まとめ

DB2のDECLARE CURSORで定義した列数とFETCH INTOで指定する変数数は基本的に一致させる必要があります。一部だけ取得したい場合は、不要な列をダミー変数に格納するか、最初から必要な列だけをSELECTする方法が推奨されます。これによりエラーを回避しつつ必要なデータだけを処理できます。