Skip to content

Commit 7008d9f

Browse files
tatsuo-ishiitatsuo-ishii
committed
Add pcp_invalidate_query_cache manuals.
Commit 09d4e59 forgot to push those manuals.
1 parent 4d5836e commit 7008d9f

File tree

2 files changed

+159
-0
lines changed

2 files changed

+159
-0
lines changed

‎doc.ja/src/sgml/ref/pcp_invalidate_query_cache.sgml‎

Lines changed: 93 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
<!--
2+
doc/src/sgml/ref/pcp_logrotate_pgpool.sgml
3+
Pgpool-II documentation
4+
-->
5+
6+
<refentry id="PCP-INVALIDATE-QUERY-CACHE">
7+
<indexterm zone="pcp-invalidate-query-cache">
8+
<primary>pcp_invalidate_query_cache</primary>
9+
</indexterm>
10+
11+
<refmeta>
12+
<refentrytitle>pcp_invalidate_query_cache</refentrytitle>
13+
<manvolnum>1</manvolnum>
14+
<refmiscinfo>PCP Command</refmiscinfo>
15+
</refmeta>
16+
17+
<refnamediv>
18+
<refname>pcp_invalidate_query_cache</refname>
19+
<refpurpose>
20+
<!--
21+
invalidate query cache contents
22+
-->
23+
クエリキャッシュの内容を破棄する
24+
</refpurpose>
25+
</refnamediv>
26+
27+
<refsynopsisdiv>
28+
<cmdsynopsis>
29+
<command>pcp_invalidate_query_cache</command>
30+
<arg rep="repeat"><replaceable>options</replaceable></arg>
31+
</cmdsynopsis>
32+
</refsynopsisdiv>
33+
34+
<refsect1 id="R1-PCP-INVALIDATE-QUERY-CACHE-1">
35+
<!--
36+
<title>Description</title>
37+
-->
38+
<title>説明</title>
39+
<para>
40+
<!--
41+
<command>pcp_invalidate_query_cache</command> places a query cache
42+
invalidation request on the shared memory area. The request is
43+
processed by one of <productname>Pgpool-II</productname> child
44+
process, which corresponds to each pgpool client session, when a
45+
message from the client is processed. This means that if there's no
46+
client connecting to <productname>Pgpool-II</productname>, or
47+
all clients are sitting idle, the request will not be
48+
processed until next message arrives.
49+
-->
50+
<command>pcp_invalidate_query_cache</command>は、共有メモリ上にクエリキャッシュの破棄リクエストをセットします。
51+
このリクエストは、クライアントから送られてきたメッセージが処理された時に、pgpoolとの個々のセッションに関連する<productname>Pgpool-II</productname>の子プロセスによって処理されます。
52+
このことは、<productname>Pgpool-II</productname>に接続するクライアントがないか、あるいはあったしてもすべてのクライアントがアイドルのままなら、次にメッセージが到着するまでリクエストは処理されないことを意味します。
53+
</para>
54+
<para>
55+
<!--
56+
Although this command does not modifies the statistics data shown by
57+
<xref linkend="SQL-SHOW-POOL-CACHE">, part of the statistics data
58+
is affected since this command invalidate the contents of query
59+
cache. <varname>num_cache_hits</varname>
60+
and <varname>num_selects</varname> continue to increase after the
61+
query cache
62+
invalidated. <varname>used_hash_entries</varname>, <varname>num_cache_entries</varname>
63+
and <varname>used_cache_entries_size</varname> starts off with
64+
0. <varname>free_cache_entries_size</varname> will increase.
65+
-->
66+
このコマンドは<xref linkend="SQL-SHOW-POOL-CACHE">で表示される統計情報を変更しませんが、その元になるクエリキャッシュの内容を破棄するため、一部の表示データは影響を受けます。
67+
<varname>num_cache_hits</varname>と<varname>num_selects</varname>は、キャッシュの破棄後も増加し続けます。
68+
<xref linkend="guc-memqcache-method">が<literal>shmem</literal>の場合、<varname>used_hash_entries</varname>、<varname>num_cache_entries</varname>、<varname>used_cache_entries_size</varname>は一旦0となります。
69+
<varname>free_cache_entries_size</varname>は増加するでしょう。
70+
</para>
71+
<para>
72+
<!--
73+
If <xref linkend="guc-memory-cache-enabled">
74+
is <literal>false</literal>, this command emits an error and exits.
75+
-->
76+
<xref linkend="guc-memory-cache-enabled">が<literal>false</literal>なら、このコマンドはエラーを出力して終了します。
77+
</para>
78+
</refsect1>
79+
80+
<refsect1>
81+
<!--
82+
<title>Options</title>
83+
-->
84+
<title>オプション</title>
85+
<para>
86+
<!--
87+
See <xref linkend="pcp-common-options">.
88+
-->
89+
<xref linkend="pcp-common-options">をご覧ください。
90+
</para>
91+
</refsect1>
92+
93+
</refentry>

‎doc/src/sgml/ref/pcp_invalidate_query_cache.sgml‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
<!--
2+
doc/src/sgml/ref/pcp_logrotate_pgpool.sgml
3+
Pgpool-II documentation
4+
-->
5+
6+
<refentry id="PCP-INVALIDATE-QUERY-CACHE">
7+
<indexterm zone="pcp-invalidate-query-cache">
8+
<primary>pcp_invalidate_query_cache</primary>
9+
</indexterm>
10+
11+
<refmeta>
12+
<refentrytitle>pcp_invalidate_query_cache</refentrytitle>
13+
<manvolnum>1</manvolnum>
14+
<refmiscinfo>PCP Command</refmiscinfo>
15+
</refmeta>
16+
17+
<refnamediv>
18+
<refname>pcp_invalidate_query_cache</refname>
19+
<refpurpose>
20+
invalidate query cache contents</refpurpose>
21+
</refnamediv>
22+
23+
<refsynopsisdiv>
24+
<cmdsynopsis>
25+
<command>pcp_invalidate_query_cache</command>
26+
<arg rep="repeat"><replaceable>options</replaceable></arg>
27+
</cmdsynopsis>
28+
</refsynopsisdiv>
29+
30+
<refsect1 id="R1-PCP-INVALIDATE-QUERY-CACHE-1">
31+
<title>Description</title>
32+
<para>
33+
<command>pcp_invalidate_query_cache</command> places a query cache
34+
invalidation request on the shared memory area. The request is
35+
processed by one of <productname>Pgpool-II</productname> child
36+
process, which corresponds to each pgpool client session, when a
37+
message from the client is processed. This means that if there's no
38+
client connecting to <productname>Pgpool-II</productname>, or
39+
all clients are sitting idle, the request will not be
40+
processed until next message arrives.
41+
</para>
42+
<para>
43+
Although this command does not modifies the statistics data shown by
44+
<xref linkend="SQL-SHOW-POOL-CACHE">, part of the statistics data
45+
is affected since this command invalidate the contents of query
46+
cache. <varname>num_cache_hits</varname>
47+
and <varname>num_selects</varname> continue to increase after the
48+
query cache
49+
invalidated. <varname>used_hash_entries</varname>, <varname>num_cache_entries</varname>
50+
and <varname>used_cache_entries_size</varname> starts off with
51+
0. <varname>free_cache_entries_size</varname> will increase.
52+
</para>
53+
<para>
54+
If <xref linkend="guc-memory-cache-enabled">
55+
is <literal>false</literal>, this command emits an error and exits.
56+
</para>
57+
</refsect1>
58+
59+
<refsect1>
60+
<title>Options</title>
61+
<para>
62+
See <xref linkend="pcp-common-options">.
63+
</para>
64+
</refsect1>
65+
66+
</refentry>

0 commit comments

Comments
 (0)