MySQLカーソルの使い方を徹底解説｜宣言からクローズまでの4つの基本ステップ

MySQLのストアドプロシージャやストアドファンクション内で、クエリの結果セットを1行ずつ処理したい場合に活躍するのが「カーソル」です。カーソルを正しく使うには、決められた手順に従う必要があります。本記事では、MySQLカーソルを使用する際の4つの基本ステップを、構文例とあわせてわかりやすく解説します。

MySQLカーソルを使用する4つの基本ステップ

MySQLカーソルの利用は、「宣言 → オープン → フェッチ → クローズ」という流れで行います。それぞれのステップを順番に見ていきましょう。

ステップ1：カーソルの宣言（DECLARE）

まず最初に、DECLARE文を使ってカーソルを宣言します。ここで重要なポイントは、カーソルの宣言は必ず変数宣言の後に行うということです。変数より先にカーソルを宣言するとエラーになるため、宣言の順序には注意が必要です。

カーソルを宣言する基本的な構文は以下のとおりです。

DECLARE cursor_name CURSOR FOR SELECT-statement;

このとき指定するSELECT文は、カーソルが扱う結果セットを定義します。

ステップ2：カーソルのオープン（OPEN）

次に、OPEN文を実行してカーソルを開きます。OPEN文は、宣言時に定義したSELECT文を実際に実行し、カーソル用の結果セットを初期化する役割を持っています。

そのため、結果セットから行を取得（フェッチ）する前に、必ずOPEN文を呼び出しておく必要があります。

OPEN cursor_name;

ステップ3：行の取得（FETCH）

カーソルを開いたら、FETCH文を使ってデータを取り出します。FETCH文は、カーソルが現在指している行を変数に読み込み、その後カーソルを結果セットの次の行へ移動させます。

一般的には、ループ処理と組み合わせて、結果セットの全行を順番に処理していく形になります。

FETCH cursor_name INTO variables list;

INTO句には、取得した列の値を受け取るための変数を、SELECT文の列数と同じ数だけ指定します。

ステップ4：カーソルのクローズ（CLOSE）

すべての行の処理が完了したら、最後にCLOSE文でカーソルを閉じます。CLOSE文を実行すると、カーソルは非アクティブ化され、カーソルに関連付けられたメモリが解放されます。

CLOSE cursor_name;

使い終わったカーソルは必ず閉じるようにしましょう。リソースの無駄な消費を防ぐことができます。

まとめ

MySQLカーソルの使用手順は、以下の4ステップです。

• DECLARE： 変数宣言の後にカーソルを宣言する
• OPEN： 結果セットを初期化するためにカーソルを開く
• FETCH： カーソルが指す行を取得し、次の行へ移動する
• CLOSE： カーソルを閉じてメモリを解放する

なお実務では、結果セットの終端に達したことを検知するために、NOT FOUNDハンドラを併せて定義しておくのが一般的です。これにより、全行のフェッチが完了したタイミングでループを正しく抜けられるようになります。各ステップの役割を理解し、適切な順序でカーソルを操作することが、安定したストアドプログラムを作る鍵となります。