Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit18ea8ae

Browse files
committed
Attached patch takes a swing at improving the autovacuum wording in
maintenance.sgml.Robert Treat[ Also fix create domain markup.]
1 parent0135cd8 commit18ea8ae

File tree

2 files changed

+23
-16
lines changed

2 files changed

+23
-16
lines changed

‎doc/src/sgml/maintenance.sgml

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.47 2005/09/16 03:12:32 alvherre Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.48 2005/09/23 02:01:34 momjian Exp $
33
-->
44

55
<chapter id="maintenance">
@@ -180,7 +180,8 @@ $PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.47 2005/09/16 03:12:32 alvh
180180
rate of data modification <command>VACUUM</command> busy tables as
181181
often as once every few minutes.) If you have multiple databases
182182
in a cluster, don't forget to <command>VACUUM</command> each one;
183-
the program <filename>vacuumdb</> may be helpful.
183+
the program <xref linkend="app-vacuumdb" endterm="app-vacuumdb-title">
184+
may be helpful.
184185
</para>
185186

186187
<para>
@@ -466,7 +467,7 @@ HINT: Stop the postmaster and use a standalone backend to VACUUM in "mydb".
466467
<para>
467468
Beginning in <productname>PostgreSQL </productname> 8.1, there is a
468469
separate optional server process called the <firstterm>autovacuum
469-
daemon</firstterm>, whose purpose is to automate theissuance of
470+
daemon</firstterm>, whose purpose is to automate theexecution of
470471
<command>VACUUM</command> and <command>ANALYZE </command> commands.
471472
When enabled, the autovacuum daemon runs periodically and checks for
472473
tables that have had a large number of inserted, updated or deleted
@@ -521,29 +522,29 @@ vacuum threshold = vacuum base threshold + vacuum scale factor * number of tuple
521522

522523
<para>
523524
Note that if any of the values in <structname>pg_autovacuum</structname>
524-
is set to a negative number, or if a tuple is not present at all in
525+
are set to a negative number, or if a tuple is not present at all in
525526
<structname>pg_autovacuum</structname> for any particular table, the
526527
equivalent value from <filename>postgresql.conf</filename> is used.
527528
</para>
528529

529530
<para>
530531
Besides the base threshold values and scale factors, there are three
531-
parameters that can be set for each table in <structname>pg_autovacuum</structname>:
532-
the vacuum cost delay
532+
parameters that can be set for each table in <structname>pg_autovacuum</structname>.
533+
The first parameter, <structname>pg_autovacuum</>.<structfield>enabled</>,
534+
can be used to instruct the autovacuum daemon to skip any particular table
535+
by setting it to <literal>false</literal>.
536+
The other two, the vacuum cost delay
533537
(<structname>pg_autovacuum</structname>.<structfield>vac_cost_delay</structfield>)
534538
and the vacuum cost limit
535-
(<structname>pg_autovacuum</structname>.<structfield>vac_cost_limit</structfield>).
536-
Theyare used to set table-specific values for the
539+
(<structname>pg_autovacuum</structname>.<structfield>vac_cost_limit</structfield>),
540+
are used to set table-specific values for the
537541
<xref linkend="runtime-config-resource-vacuum-cost" endterm="runtime-config-resource-vacuum-cost-title">
538542
feature. The above note about negative values also applies here, but
539543
also note that if the <filename>postgresql.conf</filename> variables
540544
<varname>autovacuum_vacuum_cost_limit</varname> and
541545
<varname>autovacuum_vacuum_cost_delay</varname> are also set to negative
542-
values, the <varname>vacuum_cost_limit</varname> and
546+
values, theglobal<varname>vacuum_cost_limit</varname> and
543547
<varname>vacuum_cost_delay</varname> values will be used instead.
544-
The other parameter, <structname>pg_autovacuum</>.<structfield>enabled</>,
545-
can be used to instruct the autovacuum daemon to skip any particular table
546-
by setting it to <literal>false</literal>.
547548
</para>
548549

549550
<note>

‎doc/src/sgml/ref/create_domain.sgml

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.23 2005/09/22 23:56:46 momjian Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/create_domain.sgml,v 1.24 2005/09/23 02:01:35 momjian Exp $
33
PostgreSQL documentation
44
-->
55

@@ -52,10 +52,16 @@ where <replaceable class="PARAMETER">constraint</replaceable> is:
5252
into a single location for maintenance. For example, an email address
5353
column may be used in several tables, all with the same properties.
5454
Define a domain and use that rather than setting up each table's
55-
constraints individually. <note>Keep in mind also that declaring a
56-
function result value as a domain is pretty dangerous, because none of
57-
the PLs enforce domain constraints on their results.</note>
55+
constraints individually.
5856
</para>
57+
58+
<note>
59+
<para>
60+
Keep in mind also that declaring a function result value as a domain
61+
is pretty dangerous, because none of the PLs enforce domain constraints
62+
on their results.
63+
</para>
64+
</note>
5965
</refsect1>
6066

6167
<refsect1>

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp