From: Tatsuo Ishii <ishii@postgresql.org>
Date: Fri, 9 May 2025 01:55:38 +0000 (+0900)
Subject: Doc: enhance query cache doc.
X-Git-Tag: V4_7_0_BETA1~126
X-Git-Url: http://waps.l3s.uni-hannover.de/gitweb/faq.html?a=commitdiff_plain;h=174772d6c231e0825d0e5db95336b6ef28530664;p=pgpool2.git

Doc: enhance query cache doc.

Pgpool refuses to cache a query calling functions returning TIMESTAMP
WITH TIMEZONE, TIME WITH TIMEZONE. If there are multiple functions
having same name and one of them returns TIMESTAMP WITH TIMEZONE, TIME
WITH TIMEZONE, pgpool refuses to cache even if one of them does not
return the data types. So add a note on this along with workaround.
---

diff --git a/doc.ja/src/sgml/memcache.sgml b/doc.ja/src/sgml/memcache.sgml
index d7c9a493e..26e3b79bf 100644
--- a/doc.ja/src/sgml/memcache.sgml
+++ b/doc.ja/src/sgml/memcache.sgml
@@ -136,6 +136,13 @@
   </para>
  </note>
 
+ <note>
+  <para>
+   関数が同じ名前で複数登録されていて、その中にTIMESTAMP WITH TIMEZONE、TIME WITH TIMEZONEを返す関数が含まれている場合、実際にSQL文の中で使われている関数がTIMESTAMP WITH TIMEZONEを返さないものであっても、<productname>Pgpool-II</productname>は、キャッシュできないと判断します。
+   その場合は、その関数のラッパー関数を作成し、TIMESTAMP WITHOUT TIMEZONEあるいはTIME WITHOUT TIMEZONEを返すようにするか、/*FORCE QUERY CACHE*/コメントを使用することによってクエリキャッシュが使えます。
+  </para>
+ </note>
+
  <para>
   <!--
   In memory cache saves the pair of SELECT statement
diff --git a/doc/src/sgml/memcache.sgml b/doc/src/sgml/memcache.sgml
index 6cd920531..b1a48ed7d 100644
--- a/doc/src/sgml/memcache.sgml
+++ b/doc/src/sgml/memcache.sgml
@@ -99,6 +99,19 @@
   </para>
  </note>
 
+ <note>
+  <para>
+   If multiple functions having the same name are registered and one
+   of them returns TIMESTAMP WITH TIMEZONE or TIME WITH
+   TIMEZONE, <productname>Pgpool-II</productname> thinks that the
+   query cannot be cached even if it uses a version of function which
+   does not return TIMESTAMP WITH TIMEZONE or TIME WITH TIMEZONE. In
+   this case you can create a wrapper function returning TIMESTAMP
+   WITHOUT TIMEZONE or TIME WITHOUT TIMEZONE, or use /*FORCE QUERY
+   CACHE*/ comment so that you can use the query cache.
+  </para>
+ </note>
+
  <para>
   On the other hand, it might be slower than the normal path
   in some cases, because it adds some overhead to store cache.