カーソル (SQL Server)
適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed Instance
リレーショナル データベースで操作を実行する場合、行の完全なセットが操作の対象になります。 たとえば、SELECT ステートメントでは、WHERE 句で指定した条件を満たすすべての行のセットが返されます。 このステートメントが返す行の完全なセットを結果セットと呼びます。 アプリケーション、特に対話型のオンライン アプリケーションでは、必ずしも、結果セット全体をひとまとめに使用して作業することが効率的であるとは限りません。 そのため、このようなアプリケーションでは、一度に 1 行または少数の行のブロックを使用するためのメカニズムが必要になります。 カーソルはそのメカニズムを提供する結果セットの拡張機能です。
カーソルでは、次のように結果の処理が拡張されます。
結果セット内の特定の行に位置付けることができます。
結果セット内の現在位置から 1 行または 1 ブロックの行を取得します。
結果セット内の現在位置の行データを修正できます。
結果セット内のデータベース データに対して他のユーザーが行った変更をさまざまなレベルで表示できます。
スクリプト、ストアド プロシージャ、およびトリガー内の Transact-SQL ステートメントから、結果セット内のデータにアクセスできます。
解説
一部のシナリオでは、テーブルに主キーがある場合、カーソルの代わりに WHILE ループを使用して、カーソルのオーバーヘッドを除去できます。
ただし、カーソルを回避できないだけでなく、実際に必要となるシナリオもあります。 そのようなとき、カーソルに基づいてテーブルを更新する必要がない場合は、"ファイアホース" カーソル、つまり高速順方向の読み取り専用カーソルを使用します。
カーソルの実装
SQL Server では、3 つのカーソルの実装がサポートされています。
| カーソルの実装 | 説明 |
|---|---|
| Transact-SQL カーソル | Transact-SQL カーソルは、DECLARE CURSOR 構文に基づいており、主に Transact-SQL スクリプト、ストアド プロシージャ、トリガーで使用されます。 Transact-SQL カーソルはサーバー上で実装され、クライアントからサーバーに送信される Transact-SQL ステートメントによって管理されます。 また、バッチ、ストアド プロシージャ、またはトリガーにも含まれている場合があります。 |
| アプリケーション プログラミング インターフェイス (API) サーバー カーソル | API カーソルでは、OLE DB および ODBC の API カーソル関数がサポートされます。 API サーバー カーソルはサーバー上に実装されます。 クライアント アプリケーションから API カーソル関数が呼び出されるたびに、SQL Server Native Client の OLE DB プロバイダーまたは ODBC ドライバーによって、API サーバー カーソルに対するアクションの要求がサーバーに送信されます。 |
| クライアント カーソル | クライアント カーソルは、SQL Server Native Client の ODBC ドライバーおよび ADO API を実装する DLL によって、内部的に実装されます。 クライアント カーソルは、結果セットのすべての行をクライアント上でキャッシュすることによって実装されます。 クライアント アプリケーションによって API カーソル関数が呼び出されるたびに、SQL Server Native Client の ODBC ドライバーまたは ADO DLL によって、クライアント上にキャッシュされた結果セットの行に対してカーソル操作が実行されます。 |
カーソルの種類
SQL Server では、4 種類のカーソルがサポートされています。
カーソルは tempdb 作業テーブルを使用できます。 スピルする集計操作や並べ替え操作と同じように、これらでは I/O が発生し、パフォーマンス ボトルネックになる可能性があります。 STATIC カーソルでは、最初から作業テーブルが使用されます。 詳しくは、「クエリ処理アーキテクチャ ガイドの作業テーブル」をご覧ください。
順方向専用
順方向専用カーソルは、FORWARD_ONLY および READ_ONLY と指定され、スクロールをサポートしていません。 これらは "ファイアホース" カーソルとも呼ばれ、カーソルの開始から終了まで、シリアルな行のフェッチのみをサポートします。 行はフェッチされるまで、データベースから取得されません。 現在のユーザーが作成または別のユーザーがコミットした INSERT、UPDATE、および DELETE ステートメントが、結果セット内の行に与えた影響は、カーソルから行をフェッチした際に確認できます。
カーソルは後方にスクロールできないので、データベース内の行のフェッチ後にその行に対して行われた変更内容の大部分は、カーソル内で確認できません。 クラスター化インデックスに含まれる列の更新など、結果セット内の行の位置の判定に使用する値が変更されるような場合は、変更された値がカーソル内で表示されます。
データベース API カーソル モデルでは、順方向専用カーソルが特殊な種類のカーソルと見なされますが、SQL Server では違います。 SQL Server では、順方向専用とスクロールの両方が静的カーソル、キーセット ドリブン カーソル、および動的カーソルに適用できるオプションと見なされます。 Transact-SQL カーソルは、順方向専用の静的カーソル、キーセット ドリブン カーソル、および動的カーソルをサポートします。 データベース API カーソル モデルでは、静的カーソル、キーセット ドリブン カーソル、および動的カーソルが常にスクロール可能であることを前提としています。 データベース API カーソルの属性またはプロパティを順方向専用に設定すると、SQL Server により、カーソルは順方向専用の動的カーソルとして実装されます。
Static
静的カーソルを開くと、そのカーソルの完全な結果セットが tempdb に作成されます。 静的カーソルは常に、カーソルを開いた時点の結果セットの状態を表示します。 静的カーソルは変更をほとんど検出しませんが、スクロール中に消費するリソースは比較的少なくなります。
このカーソルは、結果セットのメンバーシップに影響を与えるデータベース内の変更や、結果セットを構成する行の列内の値に対する変更を反映しません。 静的カーソルを開いた後にデータベースに新しい行が挿入されると、カーソルの SELECT ステートメントの検索条件に一致していても、静的カーソルにそれらの行は表示されません。 結果セットを構成する行が他のユーザーによって更新された場合、その新しいデータ値は静的カーソルに表示されません。 静的カーソルを開いた後にデータベースから削除された行は、静的カーソルに表示されます。 UPDATE、INSERT、または DELETE による操作は、静的カーソルを閉じてから再度開かない限り、静的カーソルに反映されません。これは、その静的カーソルを開いたのと同じ接続を使用して変更を行った場合でも同様です。
Note
SQL Server の静的カーソルは常に読み取り専用です。
静的カーソルの結果セットは tempdb の作業テーブルに格納されるので、結果セット内の行のサイズを SQL Server テーブルの最大行サイズより大きくすることはできません。
詳しくは、「クエリ処理アーキテクチャ ガイドの作業テーブル」をご覧ください。 最大行サイズについて詳しくは、「SQL Server の最大容量仕様」をご覧ください。
Transact-SQL では、静的カーソルについて非反映型 という用語を用います。 一部のデータベース API では、スナップショット カーソルとも呼びます。
Keyset
キーセット ドリブン カーソルの構成要素と行の順序は、カーソルを開いたときに固定されます。 キーセット ドリブン カーソルは、キーセットという一意の識別子 (キー) のセットにより制御されます。 これらのキーは、結果セットの行を一意に識別する列のセットから構築されます。 キーセットは、カーソルを開いた時点で SELECT ステートメントにより限定されたすべての行から取り出したキー値のセットです。 キーセット ドリブン カーソルのキーセットは、カーソルを開いたときに tempdb に構築されます。
動的
動的カーソルは静的カーソルと対照的です。 動的カーソルは、スクロールされるときに、結果セット内の行に対して行われたすべての変更を反映します。 結果セット内の行のデータ値、順序、およびメンバーシップは、フェッチを実行するたびに変化する可能性があります。 UPDATE、INSERT、および DELETE ステートメントをどのユーザーが実行しても、その実行結果はすべてカーソルに表示されます。 更新が SQLSetPos などの API 関数または Transact-SQL の WHERE CURRENT OF 句を使用して、カーソルによって行われた場合、それらの更新結果はすぐに表示されます。 カーソルの外部から行った更新は、コミットされるまで表示されません。ただし、カーソルのトランザクション分離レベルが READ UNCOMMITTED に設定されている場合は、その限りではありません。 分離レベルの詳細については、「SET TRANSACTION ISOLATION LEVEL (Transact-SQL)」を参照してください。
Note
動的カーソル プランが空間インデックスを使用することはありません。
カーソルを要求する
SQL Server では、カーソルの要求方法として、次の 2 つの方法がサポートされます。
-
Transact-SQL
Transact-SQL 言語では、ISO カーソル構文以降にモデル化されたカーソルを使用するための構文がサポートされます。
データベース API (アプリケーション プログラミング インターフェイス) のカーソル機能
SQL Server では、次のデータベース API のカーソル機能がサポートされます。
ADO (Microsoft ActiveX Data Object)
OLE DB
ODBC (Open Database Connectivity)
アプリケーションでは、カーソルを要求するこれら 2 つの方法を混在して使用しないでください。 また、API を使用してカーソル動作を指定しているアプリケーションでは、Transact-SQL の DECLARE CURSOR ステートメントを実行してさらに Transact-SQL カーソルを要求しないでください。 アプリケーションで DECLARE CURSORステートメントを実行できるのは、API カーソル属性をすべて既定値に戻した場合だけです。
Transact-SQL カーソルも API カーソルも要求されない場合、既定では、SQL Server によって既定の結果セットと呼ばれる完全な結果セットがアプリケーションに返されます。
カーソル処理
Transact-SQL カーソルと API カーソルでは構文が異なりますが、どの SQL Server カーソルでも、以下の一般的な処理を行います。
カーソルを Transact-SQL ステートメントの結果セットに関連付け、カーソル内の行を更新可能にするかどうかなど、そのカーソルの特性を定義します。
カーソルを設定する Transact-SQL ステートメントを実行します。
参照するカーソル内の行を取得します。 カーソルから 1 行または 1 ブロックの行を取得する操作をフェッチと言います。 フェッチを連続して実行し、順方向または逆方向に行を取得することをスクロールと呼びます。
必要に応じて、カーソル内の現在位置の行に対して、更新または削除の変更操作を行います。
カーソルを閉じます。
関連するコンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示