提交 22cd2596 编写于 作者: M Mel Kiyama 提交者: David Yozie

docs - update gp_toolkit AO AOCO functions (#10089)

most functions have been updated to use regclass (oid or table name)
上级 3881b8b3
...@@ -342,9 +342,7 @@ ...@@ -342,9 +342,7 @@
</body> </body>
</topic> </topic>
</topic> </topic>
<topic id="topic8" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic8" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)"
class="- topic/topic ">
<title class="- topic/title ">Checking Append-Optimized Tables</title> <title class="- topic/title ">Checking Append-Optimized Tables</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>The <codeph>gp_toolkit</codeph> schema includes a set of diagnostic functions you can use <p>The <codeph>gp_toolkit</codeph> schema includes a set of diagnostic functions you can use
...@@ -358,10 +356,9 @@ ...@@ -358,10 +356,9 @@
class="+ topic/ph pr-d/codeph ">VACUUM</codeph>. The hidden rows are tracked using an class="+ topic/ph pr-d/codeph ">VACUUM</codeph>. The hidden rows are tracked using an
auxiliary visibility map table, or visimap. </p> auxiliary visibility map table, or visimap. </p>
<p>The following functions let you access the metadata for append-optimized and <p>The following functions let you access the metadata for append-optimized and
column-oriented tables and view non-visible rows. Some of the functions have two versions: column-oriented tables and view non-visible rows. </p>
one that takes the <codeph class="+ topic/ph pr-d/codeph ">oid</codeph> of the table, and <p>For most of the functions, the input argument is <codeph>regclass</codeph>, either the
one that takes the name of the table. The latter version has "_name" appended to the table <codeph>name</codeph> or the <codeph>oid</codeph> of a table.</p>
function name.</p>
</body> </body>
<topic id="topic_ylp_gxw_yq"> <topic id="topic_ylp_gxw_yq">
<title>__gp_aovisimap_compaction_info(oid)</title> <title>__gp_aovisimap_compaction_info(oid)</title>
...@@ -372,8 +369,10 @@ ...@@ -372,8 +369,10 @@
by a <codeph>VACUUM</codeph> operation on an append-optimized table.</p> by a <codeph>VACUUM</codeph> operation on an append-optimized table.</p>
<note>Until a <cmdname>VACUUM</cmdname> operation deletes the row from the data file, <note>Until a <cmdname>VACUUM</cmdname> operation deletes the row from the data file,
deleted or updated data rows occupy physical space on disk even though they are hidden to deleted or updated data rows occupy physical space on disk even though they are hidden to
new transactions. The configuration parameter <codeph>gp_appendonly_compaction</codeph> new transactions. The configuration parameter <codeph><xref
controls the functionality of the <codeph>VACUUM</codeph> command.</note> href="config_params/guc-list.xml#gp_appendonly_compaction"
>gp_appendonly_compaction</xref></codeph> controls the functionality of the
<codeph>VACUUM</codeph> command.</note>
<p>This table describes the <cmdname>__gp_aovisimap_compaction_info</cmdname> function <p>This table describes the <cmdname>__gp_aovisimap_compaction_info</cmdname> function
output table.</p> output table.</p>
<table id="table_wr2_dcv_mq"> <table id="table_wr2_dcv_mq">
...@@ -422,13 +421,12 @@ ...@@ -422,13 +421,12 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic9" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic9" xml:lang="en">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aoseg(regclass)</title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aoseg_name('table_name')</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns metadata information contained in the append-optimized table's <p>This function returns metadata information contained in the append-optimized table's
on-disk segment file. </p> on-disk segment file. </p>
<p>The input argument is the name or the oid of an append-optimized table. </p>
<table id="ie202159" class="- topic/table "> <table id="ie202159" class="- topic/table ">
<title class="- topic/title ">__gp_aoseg_name output table</title> <title class="- topic/title ">__gp_aoseg_name output table</title>
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
...@@ -481,18 +479,14 @@ ...@@ -481,18 +479,14 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic10" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic10" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aoseg_history(regclass)</title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aoseg_history(oid)</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns metadata information contained in the append-optimized table's <p>This function returns metadata information contained in the append-optimized table's
on-disk segment file. It displays all different versions (heap tuples) of the aoseg meta on-disk segment file. It displays all different versions (heap tuples) of the aoseg meta
information. The data is complex, but users with a deep understanding of the system may information. The data is complex, but users with a deep understanding of the system may
find it usefulfor debugging.</p> find it useful for debugging.</p>
<p>The input argument is the oid of the append-optimized table. </p> <p>The input argument is the name or the oid of an append-optimized table. </p>
<p>Call __gp_aoseg_history_name('table_name') to get the same result with the table name as
an argument.</p>
<table id="ie202200" class="- topic/table "> <table id="ie202200" class="- topic/table ">
<title class="- topic/title ">__gp_aoseg_history output table</title> <title class="- topic/title ">__gp_aoseg_history output table</title>
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
...@@ -590,17 +584,13 @@ ...@@ -590,17 +584,13 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic11" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic11" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aocsseg(regclass)</title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aocsseg(oid)</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns metadata information contained in a column-oriented <p>This function returns metadata information contained in a column-oriented
append-optimized table's on-disk segment file, excluding non-visible rows. Each row append-optimized table's on-disk segment file, excluding non-visible rows. Each row
describes a segment for a column in the table.</p> describes a segment for a column in the table.</p>
<p>The input argument is the oid of a column-oriented append-optimized table. Call as <p>The input argument is the name or the oid of a column-oriented append-optimized table. </p>
__gp_aocsseg_name('table_name') to get the same result with the table name as an
argument.</p>
<table id="ie202280" class="- topic/table "> <table id="ie202280" class="- topic/table ">
<title class="- topic/title ">__gp_aocsseg(oid) output table</title> <title class="- topic/title ">__gp_aocsseg(oid) output table</title>
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
...@@ -659,18 +649,14 @@ ...@@ -659,18 +649,14 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic12" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic12" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aocsseg_history(regclass)</title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aocsseg_history(oid)</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns metadata information contained in a column-oriented <p>This function returns metadata information contained in a column-oriented
append-optimized table's on-disk segment file. Each row describes a segment for a column append-optimized table's on-disk segment file. Each row describes a segment for a column
in the table. The data is complex, but users with a deep understanding of the system may in the table. The data is complex, but users with a deep understanding of the system may
find it useful for debugging.</p> find it useful for debugging.</p>
<p>The input argument is the oid of a column-oriented append-optimized table. Call as <p> The input argument is the name or the oid of a column-oriented append-optimized table. </p>
__gp_aocsseg_history_name('table_name') to get the same result with the table name as
argument.</p>
<table id="ie202328" class="- topic/table "> <table id="ie202328" class="- topic/table ">
<title class="- topic/title ">__gp_aocsseg_history output table</title> <title class="- topic/title ">__gp_aocsseg_history output table</title>
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
...@@ -775,16 +761,12 @@ ...@@ -775,16 +761,12 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic13" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic13" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aovisimap(regclass)</title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aovisimap(oid)</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns the tuple id, the segment file, and the row number of each <p>This function returns the tuple ID, the segment file, and the row number of each
non-visible tuple according to the visibility map.</p> non-visible tuple according to the visibility map.</p>
<p>The input argument is the oid of an append-optimized table.</p> <p>The input argument is the name or the oid of an append-optimized table.</p>
<p>Use __gp_aovisimap_name('table_name') to get the same result with the table name as
argument.</p>
<table id="ie202417" class="- topic/table "> <table id="ie202417" class="- topic/table ">
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
<colspec colnum="1" colname="col1" colwidth="108pt" class="- topic/colspec "/> <colspec colnum="1" colname="col1" colwidth="108pt" class="- topic/colspec "/>
...@@ -814,16 +796,12 @@ ...@@ -814,16 +796,12 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic14" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic14" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aovisimap_hidden_info(regclass)</title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aovisimap_hidden_info(oid)</title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns the numbers of hidden and visible tuples in the segment files for <p>This function returns the numbers of hidden and visible tuples in the segment files for
an append-optimized table.</p> an append-optimized table.</p>
<p>The input argument is the oid of the append-optimized table. </p> <p>The input argument is the name or the oid of an append-optimized table. </p>
<p>Call __gp_aovisimap_hidden_info_name('table_name') to get the same result with a table
name argument.</p>
<table id="ie202442" class="- topic/table "> <table id="ie202442" class="- topic/table ">
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
<colspec colnum="1" colname="col1" colwidth="108pt" class="- topic/colspec "/> <colspec colnum="1" colname="col1" colwidth="108pt" class="- topic/colspec "/>
...@@ -854,15 +832,11 @@ ...@@ -854,15 +832,11 @@
</table> </table>
</body> </body>
</topic> </topic>
<topic id="topic15" xml:lang="en" ditaarch:DITAArchVersion="1.1" <topic id="topic15" xml:lang="en" class="- topic/topic ">
domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d)" <title class="- topic/title ">__gp_aovisimap_entry(regclass) </title>
class="- topic/topic ">
<title class="- topic/title ">__gp_aovisimap_entry(oid) </title>
<body class="- topic/body "> <body class="- topic/body ">
<p>This function returns information about each visibility map entry for the table.</p> <p>This function returns information about each visibility map entry for the table.</p>
<p>The input argument is the oid of an append-optimized table.</p> <p>The input argument is the name or the oid of an append-optimized table.</p>
<p>Call __gp_aovisimap_entry_name('table_name') to get the same result with a table name
argument.</p>
<table id="ie202467" class="- topic/table "> <table id="ie202467" class="- topic/table ">
<title class="- topic/title ">__gp_aovisimap_entry output table</title> <title class="- topic/title ">__gp_aovisimap_entry output table</title>
<tgroup cols="2" class="- topic/tgroup "> <tgroup cols="2" class="- topic/tgroup ">
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册