? upsert.diff
Index: doc/src/sgml/plpgsql.sgml
===================================================================
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/plpgsql.sgml,v
retrieving revision 1.61
diff -c -r1.61 plpgsql.sgml
*** doc/src/sgml/plpgsql.sgml	14 Feb 2005 00:54:26 -0000	1.61
--- doc/src/sgml/plpgsql.sgml	8 Mar 2005 08:19:31 -0000
***************
*** 2003,2008 ****
--- 2003,2042 ----
        don't use <literal>EXCEPTION</> without need.
       </para>
      </tip>
+     <example id="plpgsql-upsert-example">
+     <para>
+     This example uses an <literal>EXCEPTION</> to <command>UPDATE</> or
+     <command>INSERT</>, as appropriate.
+ 
+ <programlisting>
+ CREATE TABLE db (a INT PRIMARY KEY, b TEXT);
+ 
+ CREATE FUNCTION merge_db (key INT, data TEXT) RETURNS VOID AS
+ $$
+ BEGIN
+     LOOP
+         UPDATE db SET b = data WHERE a = key;
+         IF found THEN
+             RETURN;
+         END IF;
+ 
+         BEGIN
+             INSERT INTO db(a,b) VALUES (key, data);
+             RETURN;
+         EXCEPTION WHEN unique_violation THEN
+             -- do nothing
+         END;
+     END LOOP;
+ END;
+ $$
+ LANGUAGE plpgsql;
+ 
+ SELECT merge_db (1, 'david');
+ SELECT merge_db (1, 'dennis');
+ </programlisting>
+ 
+     </para>
+     </example>
    </sect2>
    </sect1>