git.postgresql.org Git - postgresql.git/commitdiff

diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml

index e0ecd1f3aa2192b56cf91d8c9dfb4c7c0c1b985d..25b86398275022a004ed640f61de14f011c2e26d 100644 (file)

--- a/doc/src/sgml/plpgsql.sgml

+++ b/doc/src/sgml/plpgsql.sgml

-<!-- $PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.152 2010年04月03日 07:22:55 petere Exp $ -->

+<!-- $PostgreSQL: pgsql/doc/src/sgml/plpgsql.sgml,v 1.153 2010年04月27日 14:32:40 alvherre Exp $ -->

<chapter id="plpgsql">

<title><application>PL/pgSQL</application> - <acronym>SQL</acronym> Procedural Language</title>

is with <literal>RETURNS TABLE</>, for example:

<programlisting>

-CREATE FUNCTION extended_sales(p_itemno int) RETURNS TABLE(quantity int, total numeric) AS $$

+CREATE FUNCTION extended_sales(p_itemno int)

+RETURNS TABLE(quantity int, total numeric) AS $$

BEGIN

- RETURN QUERY SELECT quantity, quantity * price FROM sales WHERE itemno = p_itemno;

+ RETURN QUERY SELECT quantity, quantity * price FROM sales

+ WHERE itemno = p_itemno;

END;

$$ LANGUAGE plpgsql;

</programlisting>

-- Now "mviews" has one record from cs_materialized_views

- PERFORM cs_log('Refreshing materialized view ' || quote_ident(mviews.mv_name) || ' ...');

+ PERFORM cs_log('Refreshing materialized view '

+ || quote_ident(mviews.mv_name) || ' ...');

EXECUTE 'TRUNCATE TABLE ' || quote_ident(mviews.mv_name);

- EXECUTE 'INSERT INTO ' || quote_ident(mviews.mv_name) || ' ' || mviews.mv_query;

+ EXECUTE 'INSERT INTO '

+ || quote_ident(mviews.mv_name) || ' '

+ || mviews.mv_query;

END LOOP;

PERFORM cs_log('Done refreshing materialized views.');

<title><command>OPEN FOR EXECUTE</command></title>

<synopsis>

-OPEN <replaceable>unbound_cursorvar</replaceable> <optional> <optional> NO </optional> SCROLL </optional> FOR EXECUTE <replaceable class="command">query_string</replaceable> <optional> USING <replaceable>expression</replaceable> <optional>, ... </optional> </optional>;

+OPEN <replaceable>unbound_cursorvar</replaceable> <optional> <optional> NO </optional> SCROLL </optional> FOR EXECUTE <replaceable class="command">query_string</replaceable>

+ <optional> USING <replaceable>expression</replaceable> <optional>, ... </optional> </optional>;

</synopsis>

<para>

<para>

An example:

<programlisting>

-OPEN curs1 FOR EXECUTE 'SELECT * FROM ' || quote_ident(tabname) ' WHERE col1 = 1ドル' USING keyvalue;

+OPEN curs1 FOR EXECUTE 'SELECT * FROM ' || quote_ident(tabname)

+ || ' WHERE col1 = 1ドル' USING keyvalue;

</programlisting>

In this example, the table name is inserted into the query textually,

so use of <function>quote_ident()</> is recommended to guard against

END;

' LANGUAGE plpgsql;

+-- need to be in a transaction to use cursors.

BEGIN;

SELECT reffunc2();

This example will abort the transaction with the given error message

and hint:

<programlisting>

-RAISE EXCEPTION 'Nonexistent ID --> %', user_id USING HINT = 'Please check your user id';

+RAISE EXCEPTION 'Nonexistent ID --> %', user_id

+ USING HINT = 'Please check your user id';

</programlisting>

</para>

--

-- Function and trigger to amend summarized column(s) on UPDATE, INSERT, DELETE.

--

-CREATE OR REPLACE FUNCTION maint_sales_summary_bytime() RETURNS TRIGGER AS $maint_sales_summary_bytime$

+CREATE OR REPLACE FUNCTION maint_sales_summary_bytime() RETURNS TRIGGER

+AS $maint_sales_summary_bytime$

DECLARE

delta_time_key integer;

delta_amount_sold numeric(15,2);

-- (probably not too onerous, as DELETE + INSERT is how most

-- changes will be made).

IF ( OLD.time_key != NEW.time_key) THEN

- RAISE EXCEPTION 'Update of time_key : % -&gt; % not allowed', OLD.time_key, NEW.time_key;

+ RAISE EXCEPTION 'Update of time_key : % -&gt; % not allowed',

+ OLD.time_key, NEW.time_key;

END IF;

delta_time_key = OLD.time_key;

<para>

Another good way to develop in <application>PL/pgSQL</> is with a

GUI database access tool that facilitates development in a

- procedural language. One example of such as a tool is

+ procedural language. One example of such a tool is

<application>pgAdmin</>, although others exist. These tools often

provide convenient features such as escaping single quotes and

making it easier to recreate and debug functions.

IF a_running_job_count &gt; 0 THEN

COMMIT; -- free lock<co id="co.plpgsql-porting-commit">

- raise_application_error(-20000, 'Unable to create a new job: a job is currently running.');

+ raise_application_error(-20000,

+ 'Unable to create a new job: a job is currently running.');

END IF;

DELETE FROM cs_active_job;