vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0348.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-16 07:24:04 +00:00

217 lines
19 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001444933648"></a><a name="EN-US_TOPIC_0000001444933648"></a>
<h1 class="topictitle1">Functions for Verifying Residual Files</h1>
<div id="body0000001444933648"><div class="section" id="EN-US_TOPIC_0000001444933648__section985219571500"><h4 class="sectiontitle">pg_verify_residualfiles(filepath)</h4><p id="EN-US_TOPIC_0000001444933648__p283912577500">Description: Verifies whether the file recorded in the parameter specified file is a residual file. This function is an instance-level function and is related to the current database. It can run on any instance.</p>
<p id="EN-US_TOPIC_0000001444933648__p18839205715503">Parameter type: text</p>
<p id="EN-US_TOPIC_0000001444933648__p10839205713508">Return type: bool</p>
<p id="EN-US_TOPIC_0000001444933648__p3839195716503">The following table describes return columns.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001444933648__table12841185705012" frame="border" border="1" rules="all"><caption><b>Table 1 </b>pg_verify_residualfiles (filepath) return fields</caption><thead align="left"><tr id="EN-US_TOPIC_0000001444933648__row08402057105013"><th align="left" class="cellrowborder" valign="top" width="19.09%" id="mcps1.3.1.6.2.4.1.1"><p id="EN-US_TOPIC_0000001444933648__p148391957125018">Column</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.1.6.2.4.1.2"><p id="EN-US_TOPIC_0000001444933648__p198391757105017">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.91%" id="mcps1.3.1.6.2.4.1.3"><p id="EN-US_TOPIC_0000001444933648__p88404578502">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001444933648__row1584118573508"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.1.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p2840757115016">isverified</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.1.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p18841957165015">bool</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.1.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p1284116577504">Verification completed or not</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001444933648__p18411157105013">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444933648__screen4841957125016"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_verify_residualfiles</span><span class="p">(</span><span class="s1">'pgrf_20200908160211441546'</span><span class="p">);</span>
<span class="w"> </span><span class="n">isverified</span><span class="w"> </span>
<span class="c1">------------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001444933648__note11841105717509"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001444933648__p3841057165014">This function only verifies whether the recorded file is a residual file in the current database. If the recorded file is not in the current database, the verification is not applicable.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444933648__section76191617155115"><h4 class="sectiontitle">pg_verify_residualfiles()</h4><p id="EN-US_TOPIC_0000001444933648__p761118174517">Description: Verifies whether recorded files on all residual file lists of the current instance are residual files. This function is an instance-level function and is related to the current database. It can run on any instance.</p>
<p id="EN-US_TOPIC_0000001444933648__p1761118179516">Parameter type: none</p>
<p id="EN-US_TOPIC_0000001444933648__p2611151745116">Return type: record</p>
<p id="EN-US_TOPIC_0000001444933648__p146129175517">The following table describes return columns.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001444933648__table156131317205112" frame="border" border="1" rules="all"><caption><b>Table 2 </b>pg_verify_residualfiles () return fields</caption><thead align="left"><tr id="EN-US_TOPIC_0000001444933648__row761217170519"><th align="left" class="cellrowborder" valign="top" width="19.09%" id="mcps1.3.2.6.2.4.1.1"><p id="EN-US_TOPIC_0000001444933648__p561281765110">Column</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.2.6.2.4.1.2"><p id="EN-US_TOPIC_0000001444933648__p1261211715118">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.91%" id="mcps1.3.2.6.2.4.1.3"><p id="EN-US_TOPIC_0000001444933648__p661231719517">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001444933648__row8612517115119"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.2.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p06121417195110">result</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p18612717195117">bool</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.2.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p461251712519">Verification completed or not</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001444933648__row206131117155112"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.2.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p6612817135112">filepath</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p17612191765111">text</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.2.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p7612191716512">Residual file path</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001444933648__row166131217115119"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.2.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p661341765110">notes</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.2.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p126131717165111">text</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.2.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p96131917185120">Notes</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001444933648__p20613131715511">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444933648__screen8613817185119"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_verify_residualfiles</span><span class="p">();</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">filepath</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">notes</span><span class="w"> </span>
<span class="c1">--------+---------------------------+-------</span>
<span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">pgrf_20200908160211441546</span><span class="w"> </span><span class="o">|</span><span class="w"> </span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001444933648__note5613121711514"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001444933648__p19613151720519">This function only verifies whether the recorded file is a residual file in the current database. If the recorded file is not in the current database, the verification is not applicable.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444933648__section19309148115117"><h4 class="sectiontitle">pgxc_verify_residualfiles()</h4><p id="EN-US_TOPIC_0000001444933648__p23061748125116">Description: Unified CN query function of pg_verify_residualfiles() This function is a cluster-level function and is related to the current database. It runs on CNs.</p>
<p id="EN-US_TOPIC_0000001444933648__p43061948115110">Parameter type: none</p>
<p id="EN-US_TOPIC_0000001444933648__p13061048195116">Return type: record</p>
<p id="EN-US_TOPIC_0000001444933648__p133061348195114">The following table describes return columns.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001444933648__table1308948175115" frame="border" border="1" rules="all"><caption><b>Table 3 </b>pgxc_verify_residualfiles () return fields</caption><thead align="left"><tr id="EN-US_TOPIC_0000001444933648__row15307154835113"><th align="left" class="cellrowborder" valign="top" width="19.09%" id="mcps1.3.3.6.2.4.1.1"><p id="EN-US_TOPIC_0000001444933648__p03071548195115">Column</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.3.6.2.4.1.2"><p id="EN-US_TOPIC_0000001444933648__p153079488515">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.91%" id="mcps1.3.3.6.2.4.1.3"><p id="EN-US_TOPIC_0000001444933648__p14307134819512">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001444933648__row19307184815110"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p173071648175115">nodename</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p330711486517">text</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p1030734805117">Node name</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001444933648__row1130844810512"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p930713484510">result</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p230812487517">bool</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p130819484513">Verification completed or not</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001444933648__row14308448125119"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p130816481514">filepath</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p530884865119">text</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p14308748115115">Residual file path</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001444933648__row1830816481512"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.3.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p173081248115120">notes</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.3.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p4308248125111">text</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.3.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p1530824810511">Notes</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001444933648__p730914875119">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444933648__screen1130994835113"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pgxc_verify_residualfiles</span><span class="p">();</span>
<span class="w"> </span><span class="n">nodename</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">result</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">filepath</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">notes</span><span class="w"> </span>
<span class="c1">--------------+--------+---------------------------+-------</span>
<span class="w"> </span><span class="n">cn_5001</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">pgrf_20200910170129360401</span><span class="w"> </span><span class="o">|</span><span class="w"> </span>
<span class="w"> </span><span class="n">dn_6001_6002</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">pgrf_20200908160211441546</span><span class="w"> </span><span class="o">|</span><span class="w"> </span>
<span class="p">(</span><span class="mi">2</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001444933648__note7309104813518"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001444933648__p113094484510">This function only verifies whether the recorded file is a residual file in the current database. If the recorded file is not in the current database, the verification is not applicable.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001444933648__section946334410514"><h4 class="sectiontitle">pg_is_residualfiles(residualfile)</h4><p id="EN-US_TOPIC_0000001444933648__p9460144445111">Description: Queries whether a specified <strong id="EN-US_TOPIC_0000001444933648__b6526896593858">relfilenode</strong> is a residual file in the current database. This function is an instance-level function and is related to the current database. It can run on any instance.</p>
<p id="EN-US_TOPIC_0000001444933648__p6460444115112">Parameter type: text</p>
<p id="EN-US_TOPIC_0000001444933648__p746014444512">Return type: bool</p>
<p id="EN-US_TOPIC_0000001444933648__p15460154465117">The following table describes return columns.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001444933648__table1046184412513" frame="border" border="1" rules="all"><caption><b>Table 4 </b>pg_is_residualfiles (residualfile) return fields</caption><thead align="left"><tr id="EN-US_TOPIC_0000001444933648__row5461194455115"><th align="left" class="cellrowborder" valign="top" width="19.09%" id="mcps1.3.4.6.2.4.1.1"><p id="EN-US_TOPIC_0000001444933648__p54604441514">Column</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21%" id="mcps1.3.4.6.2.4.1.2"><p id="EN-US_TOPIC_0000001444933648__p3461644165116">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="59.91%" id="mcps1.3.4.6.2.4.1.3"><p id="EN-US_TOPIC_0000001444933648__p846114416515">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001444933648__row14611544195110"><td class="cellrowborder" valign="top" width="19.09%" headers="mcps1.3.4.6.2.4.1.1 "><p id="EN-US_TOPIC_0000001444933648__p446124410514">result</p>
</td>
<td class="cellrowborder" valign="top" width="21%" headers="mcps1.3.4.6.2.4.1.2 "><p id="EN-US_TOPIC_0000001444933648__p17461124435113">bool</p>
</td>
<td class="cellrowborder" valign="top" width="59.91%" headers="mcps1.3.4.6.2.4.1.3 "><p id="EN-US_TOPIC_0000001444933648__p144611448516">Residual file or not</p>
</td>
</tr>
</tbody>
</table>
</div>
<p id="EN-US_TOPIC_0000001444933648__p94617444516">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001444933648__screen846224411517"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_is_residualfiles</span><span class="p">(</span><span class="s1">'base/49155/114691'</span><span class="p">);</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="n">t</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001444933648__note1446364495112"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001444933648__p1246264415112">This function only verifies whether the recorded file is a residual file in the current database. If the recorded file is not in the current database, it is verified as a residual file.</p>
<p id="EN-US_TOPIC_0000001444933648__p5462154414517">For example, the file <strong id="EN-US_TOPIC_0000001444933648__b96219595993858">base/15092/14790</strong> is not regarded as a residual file in a <strong id="EN-US_TOPIC_0000001444933648__b206009839693858"></strong><strong id="EN-US_TOPIC_0000001444933648__b191829974593858"><span id="EN-US_TOPIC_0000001444933648__text7487067793858">gaussdb</span></strong> database, but it is regarded as a residual file in other databases.</p>
<pre class="screen" id="EN-US_TOPIC_0000001444933648__screen156089175464"><span id="EN-US_TOPIC_0000001444933648__text1452842316469"></span>SELECT * FROM pg_is_residualfiles('base/15092/14790');
result
--------
f
(1 row)
<span id="EN-US_TOPIC_0000001444933648__text14529182318463"></span>\c db2
db2=# SELECT * FROM pg_is_residualfiles('base/15092/14790');
result
--------
t
(1 row)</pre>
</div></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0060.html">Residual File Management Functions</a></div>
</div>
</div>
View Git Blame Copy Permalink