54.6. pg_cursors #

pg_cursorsビューは現在利用可能なカーソルを列挙します。 以下のようにカーソルは複数の方法で定義可能です。

pg_cursorsビューは、上のいずれかの方法で作成されたカーソルを表示します。 カーソルは、WITH HOLDと宣言されていない限り、それを定義したトランザクション期間しか存在しません。 したがって、保持不可能なカーソルは、作成元トランザクションが終わるまでの間のみ、このビューに現れます。

注記

手続き言語など、一部のPostgreSQLの要素を実装するために内部的にカーソルが使用されています。 したがって、pg_cursorsにはユーザが明示的に作成していないカーソルも含まれる可能性があります。

表54.6 pg_cursorsの列

列 型

説明

name text

カーソルの名前

statement text

カーソル宣言の際に投稿された逐語的問い合わせ文字列

is_holdable bool

trueの場合は、保持可能カーソル(つまりカーソルを宣言したトランザクションがコミットされた後でもアクセス可能なカーソル)。 それ以外はfalse

is_binary bool

trueの場合は、カーソルがBINARYで宣言されている。 それ以外はfalse

is_scrollable bool

trueの場合は、カーソルがスクロール可能(順序通り以外の方法に行を取り出すことが可能)。 それ以外はfalse

creation_time timestamptz

カーソルが宣言された時間。


pg_cursorsビューは読み取り専用です。