Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 628462b

Browse files
bmomjianbmomjian
committed
doc PG 10: adjustments to BRIN, WAL, JSON, XML items, syntax
Reported-by: Alvaro Herrera
1 parent 09f8421 commit 628462b

File tree

1 file changed

+64
-81
lines changed

1 file changed

+64
-81
lines changed

‎doc/src/sgml/release-10.sgml

Lines changed: 64 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -458,13 +458,13 @@
458458
<para>
459459
Add <acronym>GUC</> <xref linkend="guc-max-parallel-workers">
460460
to limit the number of worker processes that can be used for
461-
parallelism (Julien Rouhaud)
461+
query parallelism (Julien Rouhaud)
462462
</para>
463463

464464
<para>
465465
This can be set lower than <xref
466466
linkend="guc-max-worker-processes"> to reserve worker processes
467-
for non-parallel purposes.
467+
for purposes other than parallel queries.
468468
</para>
469469
</listitem>
470470

@@ -477,22 +477,6 @@
477477

478478
<itemizedlist>
479479

480-
<listitem>
481-
<!--
482-
Author: Andrew Dunstan <andrew@dunslane.net>
483-
2017-03-31 [e306df7f9] Full Text Search support for <type>JSON</> and <type>JSONB</>
484-
-->
485-
<para>
486-
Add full text search support for <type>JSON</> and <type>JSONB</>
487-
(Dmitry Dolgov)
488-
</para>
489-
490-
<para>
491-
This is accessed via <function>ts_headline()</> and
492-
<function>to_tsvector</>. RIGHT SECTION?
493-
</para>
494-
</listitem>
495-
496480
<listitem>
497481
<!--
498482
Author: Tom Lane <tgl@sss.pgh.pa.us>
@@ -525,12 +509,14 @@
525509
2017-04-01 [7526e1022] BRIN auto-summarization
526510
-->
527511
<para>
528-
Cause <acronym>BRIN</> index summarization to happen more
529-
aggressively (&Aacute;lvaro Herrera)
512+
Add option to allow <acronym>BRIN</> index summarization to happen
513+
more aggressively (&Aacute;lvaro Herrera)
530514
</para>
531515

532516
<para>
533-
Specifically, summarize the previous page range when a new page
517+
Specifically, a new <link linkend="SQL-ALTERINDEX"><command>CREATE
518+
INDEX</></> option allows auto-summarizion of the
519+
previous <acronym>BRIN</> page range when a new page
534520
range is created.
535521
</para>
536522
</listitem>
@@ -541,14 +527,18 @@
541527
2017-04-01 [c655899ba] BRIN de-summarization
542528
-->
543529
<para>
544-
Add function <function>brin_desummarize_range()</> to remove
545-
<acronym>BRIN</> summarization of a specified range (&Aacute;lvaro
530+
Add functions to remove and re-add <acronym>BRIN</>
531+
summarization for <acronym>BRIN</> index ranges (&Aacute;lvaro
546532
Herrera)
547533
</para>
548534

549535
<para>
550-
This allows future <acronym>BRIN</> index summarization to be
551-
more compact. CLARIFY
536+
New <acronym>SQL</> function <link
537+
linkend="functions-admin-index-table"><function>brin_summarize_range()</></>
538+
updates <acronym>BRIN</> index summarization for a specified
539+
range and <function>brin_desummarize_range()</> removes it.
540+
This is helpful to update summarization of a range that is now
541+
smaller due to <command>UPDATE</>s and <command>DELETE</>s.
552542
</para>
553543
</listitem>
554544

@@ -860,22 +850,12 @@
860850

861851
<itemizedlist>
862852

863-
<listitem>
864-
<!--
865-
Author: Peter Eisentraut <peter_e@gmx.net>
866-
2016-11-18 [67dc4ccbb] Add pg_sequences view
867-
-->
868-
<para>
869-
Add <link
870-
linkend="view-pg-sequences"><structname>pg_sequences</></> view
871-
to show all sequences (Peter Eisentraut)
872-
</para>
873-
</listitem>
874-
875853
<listitem>
876854
<!--
877855
Author: Peter Eisentraut <peter_e@gmx.net>
878856
2016-12-20 [1753b1b02] Add pg_sequence system catalog
857+
Author: Peter Eisentraut <peter_e@gmx.net>
858+
2016-11-18 [67dc4ccbb] Add pg_sequences view
879859
-->
880860
<para>
881861
Create a <link
@@ -884,9 +864,11 @@
884864
</para>
885865

886866
<para>
887-
Sequence metadata includes start, increment, etc, which is now
888-
transactional. Sequence counters are still stored in separate
889-
heap relations.
867+
Sequence metadata includes start, increment, etc,
868+
which is now transactional. Sequence counters are
869+
still stored in separate heap relations. Also add <link
870+
linkend="view-pg-sequences"><structname>pg_sequences</></> view
871+
to show all sequences.
890872
</para>
891873
</listitem>
892874

@@ -1167,7 +1149,7 @@
11671149
</para>
11681150

11691151
<para>
1170-
This proves better security than the existing <literal>md5</>
1152+
This provides better security than the existing <literal>md5</>
11711153
negotiation and storage method.
11721154
</para>
11731155
</listitem>
@@ -1238,8 +1220,8 @@
12381220
2017-01-04 [6667d9a6d] Re-allow SSL passphrase prompt at server start, but not
12391221
-->
12401222
<para>
1241-
Allow <acronym>SSL</> configuration to be updated at
1242-
<literal>SIGHUP</> (Andreas Karlsson, Tom Lane)
1223+
Allow <acronym>SSL</> configuration to be updated during
1224+
configuration reload (Andreas Karlsson, Tom Lane)
12431225
</para>
12441226

12451227
<para>
@@ -1317,23 +1299,6 @@
13171299
</para>
13181300
</listitem>
13191301

1320-
<listitem>
1321-
<!--
1322-
Author: Robert Haas <rhaas@postgresql.org>
1323-
2016-11-21 [a734fd5d1] autovacuum: Drop orphan temp tables more quickly but wit
1324-
Author: Tom Lane <tgl@sss.pgh.pa.us>
1325-
2016-11-27 [dafa0848d] Code review for early drop of orphaned temp relations in
1326-
-->
1327-
<para>
1328-
Remove orphaned temporary tables more aggressively (Robert Haas,
1329-
Tom Lane)
1330-
</para>
1331-
1332-
<para>
1333-
Previously such tables were removed only when necessary. SECTION?
1334-
</para>
1335-
</listitem>
1336-
13371302
</itemizedlist>
13381303

13391304
<sect5>
@@ -1376,8 +1341,14 @@
13761341
2017-04-05 [00b6b6feb] Allow \-\-with-wal-segsize=n up to n=1024MB
13771342
-->
13781343
<para>
1379-
Increase the maximum configurable <acronym>WAL</> size to 1
1380-
gigabyte (Beena Emerson)
1344+
Increase the maximum configurable <acronym>WAL</> segment size
1345+
to one gigabyte (Beena Emerson)
1346+
</para>
1347+
1348+
<para>
1349+
Larger <acronym>WAL</> segment sizes allows for fewer
1350+
<xref linkend="guc-archive-command"> invocations and fewer
1351+
<acronym>WAL</> files to manage.
13811352
</para>
13821353
</listitem>
13831354

@@ -1569,6 +1540,19 @@
15691540

15701541
<itemizedlist>
15711542

1543+
<listitem>
1544+
<!--
1545+
Author: Alvaro Herrera <alvherre@alvh.no-ip.org>
1546+
2017-03-08 [fcec6caaf] Support XMLTABLE query expression
1547+
-->
1548+
<para>
1549+
Add <link
1550+
linkend="functions-xml-processing-xmltable"><function>XMLTABLE</></>
1551+
function that converts <type>XML</>-formatted data into a row set
1552+
(Pavel Stehule, &Aacute;lvaro Herrera)
1553+
</para>
1554+
</listitem>
1555+
15721556
<listitem>
15731557
<!--
15741558
Author: Tom Lane <tgl@sss.pgh.pa.us>
@@ -1821,6 +1805,22 @@
18211805

18221806
<itemizedlist>
18231807

1808+
<listitem>
1809+
<!--
1810+
Author: Andrew Dunstan <andrew@dunslane.net>
1811+
2017-03-31 [e306df7f9] Full Text Search support for <type>JSON</> and <type>JSONB</>
1812+
-->
1813+
<para>
1814+
Add full text search support for <type>JSON</> and <type>JSONB</>
1815+
(Dmitry Dolgov)
1816+
</para>
1817+
1818+
<para>
1819+
This is accessed via <function>ts_headline()</> and
1820+
<function>to_tsvector</>.
1821+
</para>
1822+
</listitem>
1823+
18241824
<listitem>
18251825
<!--
18261826
Author: Stephen Frost <sfrost@snowman.net>
@@ -1937,23 +1937,6 @@
19371937
</para>
19381938
</listitem>
19391939

1940-
<listitem>
1941-
<!--
1942-
Author: Alvaro Herrera <alvherre@alvh.no-ip.org>
1943-
2017-03-08 [fcec6caaf] Support XMLTABLE query expression
1944-
-->
1945-
<para>
1946-
Add support for converting <type>XML</>-formatted data into a row
1947-
set (Pavel Stehule, &Aacute;lvaro Herrera)
1948-
</para>
1949-
1950-
<para>
1951-
This is done by referencing the new <link
1952-
linkend="functions-xml-processing-xmltable"><function>XMLTABLE</></>
1953-
function.
1954-
</para>
1955-
</listitem>
1956-
19571940
<listitem>
19581941
<!--
19591942
Author: Magnus Hagander <magnus@hagander.net>
@@ -2572,7 +2555,7 @@
25722555
</para>
25732556

25742557
<para>
2575-
Also add <option>-nosync</> option to disable fsync.
2558+
Also add <option>--nosync</> option to disable fsync.
25762559
</para>
25772560
</listitem>
25782561

@@ -2617,7 +2600,7 @@
26172600
2016-10-19 [0be22457d] pg_ctl: Add long options for -w and -W
26182601
-->
26192602
<para>
2620-
Add log options for <application>pg_ctl</> wait (<option>--wait</>)
2603+
Add long options for <application>pg_ctl</> wait (<option>--wait</>)
26212604
and no-wait (<option>--no-wait</>) (Vik Fearing)
26222605
</para>
26232606
</listitem>

0 commit comments

Comments
 (0)