diff options
| author | Neil Conway <neilc@samurai.com> | 2006-01-18 06:49:30 +0000 |
|---|---|---|
| committer | Neil Conway <neilc@samurai.com> | 2006-01-18 06:49:30 +0000 |
| commit | 33e06ebccbc21677be6dbc112e3d150bd13b17cb (patch) | |
| tree | b55b21dfeefca076512b2cc8f597eace12f3eeb4 /doc/src/sgml/ref | |
| parent | 558bc2584d7e79801acb8344b79838cd3511915b (diff) | |
Add a new system view, pg_cursors, that displays the currently available
cursors. Patch from Joachim Wieland, review and ediorialization by Neil
Conway. The view lists cursors defined by DECLARE CURSOR, using SPI, or
via the Bind message of the frontend/backend protocol. This means the
view does not list the unnamed portal or the portal created to implement
EXECUTE. Because we do list SPI portals, there might be more rows in
this view than you might expect if you are using SPI implicitly (e.g.
via a procedural language).
Per recent discussion on -hackers, the query string included in the
view for cursors defined by DECLARE CURSOR is based on
debug_query_string. That means it is not accurate if multiple queries
separated by semicolons are submitted as one query string. However,
there doesn't seem a trivial fix for that: debug_query_string
is better than nothing. I also changed SPI_cursor_open() to include
the source text for the portal it creates: AFAICS there is no reason
not to do this.
Update the documentation and regression tests, bump the catversion.
Diffstat (limited to 'doc/src/sgml/ref')
| -rw-r--r-- | doc/src/sgml/ref/close.sgml | 7 | ||||
| -rw-r--r-- | doc/src/sgml/ref/declare.sgml | 7 |
2 files changed, 12 insertions, 2 deletions
diff --git a/doc/src/sgml/ref/close.sgml b/doc/src/sgml/ref/close.sgml index 3376476e26d..35f0993e6a2 100644 --- a/doc/src/sgml/ref/close.sgml +++ b/doc/src/sgml/ref/close.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/close.sgml,v 1.22 2005/01/04 00:39:53 tgl Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/close.sgml,v 1.23 2006/01/18 06:49:26 neilc Exp $ PostgreSQL documentation --> @@ -76,6 +76,11 @@ CLOSE <replaceable class="PARAMETER">name</replaceable> <xref linkend="sql-declare" endterm="sql-declare-title"> statement to declare a cursor. </para> + + <para> + You can see all available cursors by querying the + <structname>pg_cursors</structname> system view. + </para> </refsect1> <refsect1> diff --git a/doc/src/sgml/ref/declare.sgml b/doc/src/sgml/ref/declare.sgml index 0263145927d..f43e08f970d 100644 --- a/doc/src/sgml/ref/declare.sgml +++ b/doc/src/sgml/ref/declare.sgml @@ -1,5 +1,5 @@ <!-- -$PostgreSQL: pgsql/doc/src/sgml/ref/declare.sgml,v 1.33 2005/01/04 00:39:53 tgl Exp $ +$PostgreSQL: pgsql/doc/src/sgml/ref/declare.sgml,v 1.34 2006/01/18 06:49:26 neilc Exp $ PostgreSQL documentation --> @@ -253,6 +253,11 @@ DECLARE <replaceable class="parameter">name</replaceable> [ BINARY ] [ INSENSITI the standard SQL cursor conventions, including those involving <command>DECLARE</command> and <command>OPEN</command> statements. </para> + + <para> + You can see all available cursors by querying the + <structname>pg_cursors</structname> system view. + </para> </refsect1> <refsect1> |