docs - add guc optimizer_use_gpdb_allocators (#8767)

* docs - add guc optimizer_use_gpdb_allocators * docs - add information about improved GPDB query mem. mgmt.

docs - add guc optimizer_use_gpdb_allocators (#8767)
* docs - add guc optimizer_use_gpdb_allocators * docs - add information about improved GPDB query mem. mgmt.
7927eb4b · Mel Kiyama · David Yozie · e06fc220 · 7927eb4b · 7927eb4b
3 changed file
--- a/gpdb-doc/dita/ref_guide/config_params/guc-list.xml
+++ b/gpdb-doc/dita/ref_guide/config_params/guc-list.xml
@@ -465,6 +465,9 @@
            </li>
            <li>
              <xref href="#optimizer_sort_factor" format="dita">optimizer_sort_factor</xref></li>
+            <li>
+              <xref href="#optimizer_use_gpdb_allocators" format="dita"
+                >optimizer_use_gpdb_allocators</xref></li>
            <li>
              <xref href="#password_encryption"/>
            </li>
@@ -7503,6 +7506,41 @@
      </table>
    </body>
  </topic>
+  <topic id="optimizer_use_gpdb_allocators">
+    <title>optimizer_use_gpdb_allocators</title>
+    <body>
+      <p>When GPORCA is enabled (the default) and this parameter is <codeph>true</codeph> (the
+        default), GPORCA uses Greenplum Database memory management when executing queries. When set
+        to <codeph>false</codeph>, GPORCA uses GPORCA-specific memory management. Greenplum Database
+        memory management allows for faster optimization, reduced memory usage during optimization,
+        and improves GPORCA support of vmem limits when compared to GPORCA-specific memory
+        management.</p>
+      <p>For information about GPORCA, see <xref
+          href="../../admin_guide/query/topics/query-piv-optimizer.xml">About GPORCA</xref><ph
+          otherprops="op-print"> in the <cite>Greenplum Database Administrator Guide</cite></ph>. </p>
+      <table id="table_xlm_qxh_gjb">
+        <tgroup cols="3">
+          <colspec colnum="1" colname="col1" colwidth="1*"/>
+          <colspec colnum="2" colname="col2" colwidth="1*"/>
+          <colspec colnum="3" colname="col3" colwidth="1*"/>
+          <thead>
+            <row>
+              <entry colname="col1">Value Range</entry>
+              <entry colname="col2">Default</entry>
+              <entry colname="col3">Set Classifications</entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry colname="col1">Boolean</entry>
+              <entry colname="col2">true</entry>
+              <entry colname="col3">master<p>system</p><p>restart</p></entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+    </body>
+  </topic>
  <topic id="password_encryption">
    <title>password_encryption</title>
    <body>

--- a/gpdb-doc/dita/ref_guide/config_params/guc_category-list.xml
+++ b/gpdb-doc/dita/ref_guide/config_params/guc_category-list.xml
@@ -365,6 +365,8 @@
            </p>
            <p><xref href="guc-list.xml#optimizer_sort_factor" format="dita"
                >optimizer_sort_factor</xref></p>
+            <p><xref href="guc-list.xml#optimizer_use_gpdb_allocators" format="dita"
+                >optimizer_use_gpdb_allocators</xref></p>
          </stentry>
        </strow>
      </simpletable>
@@ -377,10 +379,10 @@
    <topic id="topic22" xml:lang="en">
      <title>Postgres Planner Control Parameters</title>
      <body>
-        <p>The following parameters control the types of plan operations the Postgres Planner
-          can use. Enable or disable plan operations to force the Postgres Planner to choose a
-          different plan. This is useful for testing and comparing query performance using different
-          plan types.</p>
+        <p>The following parameters control the types of plan operations the Postgres Planner can
+          use. Enable or disable plan operations to force the Postgres Planner to choose a different
+          plan. This is useful for testing and comparing query performance using different plan
+          types.</p>
        <simpletable id="kh158625" frame="none">
          <strow>
            <stentry>
@@ -1056,19 +1058,16 @@
    <body>
      <simpletable id="d1e1187" frame="none">
        <strow>
-          <stentry>
-            <p>
+          <stentry><p>
              <xref href="guc-list.xml#deadlock_timeout" type="section">deadlock_timeout</xref>
            </p><xref href="guc-list.xml#gp_enable_global_deadlock_detector" type="section"
              >gp_enable global_deadlock_detector</xref><p>
              <xref href="guc-list.xml#gp_global_deadlock_detector_period" type="section"
                >gp_global_deadlock_detector_period</xref>
-            </p>
-          </stentry>
+            </p></stentry>
          <stentry>
            <p>
-              <xref href="guc-list.xml#lock_timeout" type="section"
-                >lock_timeout</xref>
+              <xref href="guc-list.xml#lock_timeout" type="section">lock_timeout</xref>
            </p>
            <p>
              <xref href="guc-list.xml#max_locks_per_transaction" type="section"
@@ -1564,23 +1563,23 @@
      </simpletable>
    </body>
  </topic>
-    <topic id="topic_t3n_qml_rz">
-      <title>XML Data Parameters</title>
-      <body>
-        <p>The parameters in this topic control the configuration of the Greenplum Database XML data
-          type. </p>
-        <simpletable frame="none" id="simpletable_yyd_tml_rz">
-          <strow>
-            <stentry>
-              <p>
-                <xref href="guc-list.xml#xmlbinary">xmlbinary</xref>
-              </p>
-              <p>
-                <xref href="guc-list.xml#xmloption">xmloption</xref>
-              </p>
-            </stentry>
-          </strow>
-        </simpletable>
-      </body>
-    </topic>
+  <topic id="topic_t3n_qml_rz">
+    <title>XML Data Parameters</title>
+    <body>
+      <p>The parameters in this topic control the configuration of the Greenplum Database XML data
+        type. </p>
+      <simpletable frame="none" id="simpletable_yyd_tml_rz">
+        <strow>
+          <stentry>
+            <p>
+              <xref href="guc-list.xml#xmlbinary">xmlbinary</xref>
+            </p>
+            <p>
+              <xref href="guc-list.xml#xmloption">xmloption</xref>
+            </p>
+          </stentry>
+        </strow>
+      </simpletable>
+    </body>
+  </topic>
 </topic>
--- a/gpdb-doc/dita/ref_guide/config_params/guc_config.ditamap
+++ b/gpdb-doc/dita/ref_guide/config_params/guc_config.ditamap
@@ -238,6 +238,7 @@
            <topicref href="guc-list.xml#optimizer_print_missing_stats"/>
            <topicref href="guc-list.xml#optimizer_print_optimization_stats"/>
            <topicref href="guc-list.xml#optimizer_sort_factor"/>
+            <topicref href="guc-list.xml#optimizer_use_gpdb_allocatorsr"/>
            <topicref href="guc-list.xml#password_encryption"/>
            <topicref href="guc-list.xml#password_hash_algorithm"/>
            <topicref href="guc-list.xml#pljava_classpath"/>