From: Bruce Momjian <bruce@momjian.us>
Date: Mon, 4 Sep 2006 19:58:02 +0000 (+0000)
Subject: Mention paremeterized queries do not work with partial indexes.
X-Git-Tag: REL9_0_0~7135
X-Git-Url: http://git.osdn.net/view?a=commitdiff_plain;h=a65f7db3b541541492d004275f0717d7f40d4809;p=pg-rex%2Fsyncrep.git

Mention paremeterized queries do not work with partial indexes.

Simon Riggs
---

diff --git a/doc/src/sgml/indices.sgml b/doc/src/sgml/indices.sgml
index 223bb81cfc..5d4ecb6a2a 100644
--- a/doc/src/sgml/indices.sgml
+++ b/doc/src/sgml/indices.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/indices.sgml,v 1.58 2006/08/25 04:06:44 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/indices.sgml,v 1.59 2006/09/04 19:58:02 momjian Exp $ -->
 
 <chapter id="indexes">
  <title id="indexes-title">Indexes</title>
@@ -679,7 +679,12 @@ SELECT * FROM orders WHERE order_nr = 3501;
    <quote>x &lt; 1</quote> implies <quote>x &lt; 2</quote>; otherwise
    the predicate condition must exactly match part of the query's
    <literal>WHERE</> condition
-   or the index will not be recognized to be usable.
+   or the index will not be recognized to be usable. Matching takes
+   place at query planning time, not at run time. As a result,
+   parameterized query clauses will not work with a partial index. For
+   example a prepared query with a parameter might specify 
+   <quote>x &lt; ?</quote> which will never imply 
+   <quote>x &lt; 2</quote> for all possible values of the parameter. 
   </para>
 
   <para>