8000 First-draft release notes for Postgres 9.6. · postgrespro/postgres_cluster@c311f78 · GitHub
[go: up one dir, main page]
Skip to content

Commit c311f78

Browse files
tglsfdctglsfdc
committed
First-draft release notes for Postgres 9.6.
These are just of beta quality, but we're only at beta ... the section about parallel query, in particular, could doubtless use more work.
1 parent a9ba619 commit c311f78

File tree

6 files changed

+3289
-27
lines changed

6 files changed

+3289
-27
lines changed

‎doc/src/sgml/catalogs.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7575,8 +7575,8 @@
75757575
be used by software packages that want to interface to
75767576
<productname>PostgreSQL</> to facilitate finding the required header
75777577
files and libraries. It provides the same basic information as the
7578-
<xref linkend="app-pgconfig"> <productname>PostgreSQL</> Client
7579-
Application.
7578+
<xref linkend="app-pgconfig"> <productname>PostgreSQL</> client
7579+
application.
75807580
</para>
75817581

75827582
<table>

‎doc/src/sgml/config.sgml

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -2012,7 +2012,7 @@ include_dir 'conf.d'
20122012
number of workers may not actually be available at runtime. If this
20132013
occurs, the plan will run with fewer workers than expected, which may
20142014
be inefficient. The default value is 2. Setting this value to 0
2015-
disables parallel query.
2015+
disables parallel query execution.
20162016
</para>
20172017
</listitem>
20182018
</varlistentry>
@@ -3657,32 +3657,32 @@ include_dir 'conf.d'
36573657
</listitem>
36583658
</varlistentry>
36593659

3660-
<varlistentry id="parallel-tuple-cost" xreflabel="parallel_tuple_cost">
3661-
<term><varname>parallel_tuple_cost</varname> (<type>floating point</type>)
3660+
<varlistentry id="guc-parallel-setup-cost" xreflabel="parallel_setup_cost">
3661+
<term><varname>parallel_setup_cost</varname> (<type>floating point</type>)
36623662
<indexterm>
3663-
<primary><varname>parallel_tuple_cost</> configuration parameter</primary>
3663+
<primary><varname>parallel_setup_cost</> configuration parameter</primary>
36643664
</indexterm>
36653665
</term>
36663666
<listitem>
36673667
<para>
3668-
Sets the planner's estimate of the cost of transferring a tuple
3669-
from a parallel worker process to another process.
3670-
The default is 0.1.
3668+
Sets the planner's estimate of the cost of launching parallel worker
3669+
processes.
3670+
The default is 1000.
36713671
</para>
36723672
</listitem>
36733673
</varlistentry>
36743674

3675-
<varlistentry id="parallel-setup-cost" xreflabel="parallel_setup_cost">
3676-
<term><varname>parallel_setup_cost</varname> (<type>floating point</type>)
3675+
<varlistentry id="guc-parallel-tuple-cost" xreflabel="parallel_tuple_cost">
3676+
<term><varname>parallel_tuple_cost</varname> (<type>floating point</type>)
36773677
<indexterm>
3678-
<primary><varname>parallel_setup_cost</> configuration parameter</primary>
3678+
<primary><varname>parallel_tuple_cost</> configuration parameter</primary>
36793679
</indexterm>
36803680
</term>
36813681
<listitem>
36823682
<para>
3683-
Sets the planner's estimate of the cost of launching parallel worker
3684-
processes.
3685-
The default is 1000.
3683+
Sets the planner's estimate of the cost of transferring one tuple
3684+
from a parallel worker process to another process.
3685+
The default is 0.1.
36863686
</para>
36873687
</listitem>
36883688
</varlistentry>
@@ -4048,8 +4048,8 @@ SELECT * FROM parent WHERE key = 2400;
40484048
<literal>off</> (use parallel mode only when it is expected to improve
40494049
performance), <literal>on</> (force parallel query for all queries
40504050
for which it is thought to be safe), and <literal>regress</> (like
4051-
on, but with additional behavior changes to facilitate automated
4052-
regression testing).
4051+
<literal>on</>, but with additional behavior changes as explained
4052+
below).
40534053
</para>
40544054

40554055
<para>
@@ -4067,14 +4067,14 @@ SELECT * FROM parent WHERE key = 2400;
40674067

40684068
<para>
40694069
Setting this value to <literal>regress</> has all of the same effects
4070-
as setting it to <literal>on</> plus some additional effect that are
4070+
as setting it to <literal>on</> plus some additional effects that are
40714071
intended to facilitate automated regression testing. Normally,
4072-
messages from a parallel worker are prefixed with a context line,
4073-
but a setting of <literal>regress</> suppresses this to guarantee
4074-
reproducible results. Also, the <literal>Gather</> nodes added to
4075-
plans by this setting are hidden from the <literal>EXPLAIN</> output
4076-
so that the output matches what would be obtained if this setting
4077-
were turned <literal>off</>.
4072+
messages from a parallel worker include a context line indicating that,
4073+
but a setting of <literal>regress</> suppresses this line so that the
4074+
output is the same as in non-parallel execution. Also,
4075+
the <literal>Gather</> nodes added to plans by this setting are hidden
4076+
in <literal>EXPLAIN</> output so that the output matches what
4077+
would be obtained if this setting were turned <literal>off</>.
40784078
</para>
40794079
</listitem>
40804080
</varlistentry>

‎doc/src/sgml/filelist.sgml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,7 @@
167167
<!ENTITY sourcerepo SYSTEM "sourcerepo.sgml">
168168

169169
<!ENTITY release SYSTEM "release.sgml">
170+
<!ENTITY release-9.6 SYSTEM "release-9.6.sgml">
170171
<!ENTITY release-9.5 SYSTEM "release-9.5.sgml">
171172
<!ENTITY release-9.4 SYSTEM "release-9.4.sgml">
172173
<!ENTITY release-9.3 SYSTEM "release-9.3.sgml">

‎doc/src/sgml/monitoring.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1108,7 +1108,7 @@ SELECT pid, wait_event_type, wait_event FROM pg_stat_activity WHERE wait_event i
11081108
(2 rows)
11091109
</programlisting>
11101110
</para>
1111-
1111+
11121112
<table id="pg-stat-replication-view" xreflabel="pg_stat_replication">
11131113
<title><structname>pg_stat_replication</structname> View</title>
11141114
<tgroup cols="3">
@@ -2429,7 +2429,7 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
24292429
See <xref linkend="wait-event-table"> for details.
24302430
</entry>
24312431
</row>
2432-
2432+
24332433
<row>
24342434
<entry><literal><function>pg_stat_get_backend_wait_event(integer)</function></literal></entry>
24352435
<entry><type>text</type></entry>
@@ -2524,7 +2524,7 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
25242524
view.
25252525
</para>
25262526

2527-
<table id="pg-stat-progress-vacuum" xreflabel="pg_stat_progress_vacuum">
2527+
<table id="pg-stat-progress-vacuum-view" xreflabel="pg_stat_progress_vacuum">
25282528
<title><structname>pg_stat_progress_vacuum</structname> View</title>
25292529
<tgroup cols="3">
25302530
<thead>

0 commit comments

Comments
 (0)
0