docs - changes default value of optimier_force_mutlistate_agg GUC to off (#8513)

c3f4e161 · Chuck Litzell · David Yozie · 460360e8 · c3f4e161 · c3f4e161
2 changed file
--- a/gpdb-doc/dita/admin_guide/query/topics/query-piv-opt-notes.xml
+++ b/gpdb-doc/dita/admin_guide/query/topics/query-piv-opt-notes.xml
@@ -25,8 +25,10 @@
      <li><codeph>optimizer_cte_inlining_bound</codeph> controls the amount of inlining performed
        for common table expression (CTE) queries (queries that contain a <codeph>WHERE</codeph>
        clause).</li>
-      <li><codeph>optimizer_force_multistage_agg</codeph> forces GPORCA to choose a 3 stage
-        aggregate plan for a scalar distinct qualified aggregate. </li>
+      <li><codeph>optimizer_force_multistage_agg</codeph> forces GPORCA to choose a multi-stage
+        aggregate plan for a scalar distinct qualified aggregate. When the value is
+          <codeph>off</codeph> (the default), GPORCA  chooses between a one-stage and two-stage
+        aggregate plan based on cost.</li>
      <li><codeph>optimizer_force_three_stage_scalar_dqa</codeph> forces GPORCA to choose a plan
        with multistage aggregates when such a plan alternative is generated. </li>
      <li><codeph>optimizer_join_order</codeph> sets the query optimization level for join ordering

--- a/gpdb-doc/dita/ref_guide/config_params/guc-list.xml
+++ b/gpdb-doc/dita/ref_guide/config_params/guc-list.xml
@@ -6945,10 +6945,10 @@
  <topic id="optimizer_force_multistage_agg">
    <title>optimizer_force_multistage_agg</title>
    <body>
-      <p>For the default settings, GPORCA is enabled and this parameter is <codeph>true</codeph>,
-        GPORCA chooses a 3 stage aggregate plan for scalar distinct qualified aggregate when such a
-        plan alternative is generated. When the value is <codeph>false</codeph>, GPORCA makes a cost
-        based choice rather than a heuristic choice.</p>
+      <p>For the default settings, GPORCA is enabled and this parameter is <codeph>false</codeph>,
+        GPORCA makes a cost-based choice between a one- or two-stage aggregate plan for a scalar
+        distinct qualified aggregate. When <codeph>true</codeph>, GPORCA chooses a multi-stage
+        aggregate plan when such a plan alternative is generated.</p>
      <p>The parameter can be set for a database system, an individual database, or a session or
        query. </p>
      <table id="table_kmz_vnr_tz">