mirror of
				https://github.com/postgres/postgres.git
				synced 2025-11-03 09:13:20 +03:00 
			
		
		
		
	docs: adjust multi-column most-common-value statistics
This commit adds a mention that the order of columns specified during multi-column most-common-value statistics is insignificant, and tries to simplify examples. Discussion: https://postgr.es/m/20190828162238.GA8360@momjian.us Backpatch-through: 12
This commit is contained in:
		@@ -1172,7 +1172,7 @@ WHERE tablename = 'road';
 | 
				
			|||||||
    <para>
 | 
					    <para>
 | 
				
			||||||
     Here is an example of collecting functional-dependency statistics:
 | 
					     Here is an example of collecting functional-dependency statistics:
 | 
				
			||||||
<programlisting>
 | 
					<programlisting>
 | 
				
			||||||
CREATE STATISTICS stts (dependencies) ON zip, city FROM zipcodes;
 | 
					CREATE STATISTICS stts (dependencies) ON city, zip FROM zipcodes;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
ANALYZE zipcodes;
 | 
					ANALYZE zipcodes;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -1262,7 +1262,7 @@ SELECT * FROM zipcodes WHERE city = 'San Francisco' AND zip = '90210';
 | 
				
			|||||||
     Continuing the previous example, the n-distinct counts in a
 | 
					     Continuing the previous example, the n-distinct counts in a
 | 
				
			||||||
     table of ZIP codes might look like the following:
 | 
					     table of ZIP codes might look like the following:
 | 
				
			||||||
<programlisting>
 | 
					<programlisting>
 | 
				
			||||||
CREATE STATISTICS stts2 (ndistinct) ON zip, state, city FROM zipcodes;
 | 
					CREATE STATISTICS stts2 (ndistinct) ON city, state, zip FROM zipcodes;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
ANALYZE zipcodes;
 | 
					ANALYZE zipcodes;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -1317,7 +1317,7 @@ nd | {"1, 2": 33178, "1, 5": 33178, "2, 5": 27435, "1, 2, 5": 33178}
 | 
				
			|||||||
     a function is required for inspection of MCV contents):
 | 
					     a function is required for inspection of MCV contents):
 | 
				
			||||||
 | 
					
 | 
				
			||||||
<programlisting>
 | 
					<programlisting>
 | 
				
			||||||
CREATE STATISTICS stts3 (mcv) ON state, city FROM zipcodes;
 | 
					CREATE STATISTICS stts3 (mcv) ON city, state FROM zipcodes;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
ANALYZE zipcodes;
 | 
					ANALYZE zipcodes;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -98,7 +98,8 @@ CREATE STATISTICS [ IF NOT EXISTS ] <replaceable class="parameter">statistics_na
 | 
				
			|||||||
    <listitem>
 | 
					    <listitem>
 | 
				
			||||||
     <para>
 | 
					     <para>
 | 
				
			||||||
      The name of a table column to be covered by the computed statistics.
 | 
					      The name of a table column to be covered by the computed statistics.
 | 
				
			||||||
      At least two column names must be given.
 | 
					      At least two column names must be given;  the order of the column names
 | 
				
			||||||
 | 
					      is insignificant.
 | 
				
			||||||
     </para>
 | 
					     </para>
 | 
				
			||||||
    </listitem>
 | 
					    </listitem>
 | 
				
			||||||
   </varlistentry>
 | 
					   </varlistentry>
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user