vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0055.html
Lu, Huayi a24ca60074 DWS DEVELOPER 811 version 
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2023-01-19 13:37:49 +00:00

66 lines
6.9 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001145710791"></a><a name="EN-US_TOPIC_0000001145710791"></a>
<h1 class="topictitle1">Server Signaling Functions</h1>
<div id="body1553151203303"><p id="EN-US_TOPIC_0000001145710791__ab3c76df4dd9a46b18421b9cf63db958b">Server signaling functions send control signals to other server processes. Only system administrators can use these functions.</p>
<ul id="EN-US_TOPIC_0000001145710791__udf03a0ac54c941f3aff7a343a0ad9687"><li id="EN-US_TOPIC_0000001145710791__la08c593438244968adcf177bd7eb90b8">pg_cancel_backend(pid int)<p id="EN-US_TOPIC_0000001145710791__a24f4393e158b425b8619fadcad990a97"><a name="EN-US_TOPIC_0000001145710791__la08c593438244968adcf177bd7eb90b8"></a><a name="la08c593438244968adcf177bd7eb90b8"></a>Description: Cancels the current query of a backend.</p>
<p id="EN-US_TOPIC_0000001145710791__a88b88c786ca54478a6e50de41df65f15">Return type: <span id="EN-US_TOPIC_0000001145710791__text2262153814228">boolean</span></p>
<p id="EN-US_TOPIC_0000001145710791__a50f3db0649be4b6db67ae1bb30ff5770">Note: <strong id="EN-US_TOPIC_0000001145710791__b1958256164212">pg_cancel_backend</strong> sends a query cancellation (SIGINT) signal to the backend process identified by <strong id="EN-US_TOPIC_0000001145710791__b1558376144213">pid</strong>. The PID of an active backend process can be found in the <strong id="EN-US_TOPIC_0000001145710791__b256644144215">pid</strong> column of the <strong id="EN-US_TOPIC_0000001145710791__b1568114144219">pg_stat_activity</strong> view, or can be found by listing the database process using <strong id="EN-US_TOPIC_0000001145710791__b195691741194217">ps</strong> on the server.</p>
</li><li id="EN-US_TOPIC_0000001145710791__l8a8cc7774e0c4b15972d42f31cc50798">pg_reload_conf()<p id="EN-US_TOPIC_0000001145710791__a8030cd1fd9924d8ab4dea65226904f87"><a name="EN-US_TOPIC_0000001145710791__l8a8cc7774e0c4b15972d42f31cc50798"></a><a name="l8a8cc7774e0c4b15972d42f31cc50798"></a>Description: Causes all server processes to reload their configuration files.</p>
<p id="EN-US_TOPIC_0000001145710791__a9233563977f9494a8d07be6619b03cf5">Return type: <span id="EN-US_TOPIC_0000001145710791__text563113932217">boolean</span></p>
<p id="EN-US_TOPIC_0000001145710791__aedf70f8099694647bce97c1fe66325fb">Note: <strong id="EN-US_TOPIC_0000001145710791__b195811718114319">pg_reload_conf</strong> sends a SIGHUP signal to the server. As a result, all server processes reload their configuration files.</p>
</li><li id="EN-US_TOPIC_0000001145710791__lec7b18995bee472c9ca15b0920402f04">pg_rotate_logfile()<p id="EN-US_TOPIC_0000001145710791__a8e1bd351a2f1403a953f0f1a34077dda"><a name="EN-US_TOPIC_0000001145710791__lec7b18995bee472c9ca15b0920402f04"></a><a name="lec7b18995bee472c9ca15b0920402f04"></a>Description: Rotates the log files of the server.</p>
<p id="EN-US_TOPIC_0000001145710791__a144a34a77120453dba66041ba4d255b0">Return type: <span id="EN-US_TOPIC_0000001145710791__text13720153914223">boolean</span></p>
<p id="EN-US_TOPIC_0000001145710791__ad6aaeea684a24c5e933a54c7973388be">Note: pg_rotate_logfile instructs the log file manager to immediately switch to a new output file. This function is valid only if the built-in log collector is running.</p>
</li><li id="EN-US_TOPIC_0000001145710791__l091c981c5102454f98fbd9322ded0b2e">pg_terminate_backend(pid int)<p id="EN-US_TOPIC_0000001145710791__a2e68e08159724faca7f3e02d03e9cb2d"><a name="EN-US_TOPIC_0000001145710791__l091c981c5102454f98fbd9322ded0b2e"></a><a name="l091c981c5102454f98fbd9322ded0b2e"></a>Description: Terminates a backend thread.</p>
<p id="EN-US_TOPIC_0000001145710791__a6af214970f8543fe841d4899bfa8846e">Return type: <span id="EN-US_TOPIC_0000001145710791__text194733409227">boolean</span></p>
<p id="EN-US_TOPIC_0000001145710791__afa2110743644447296904353e1763095">Note: Each of these functions returns <strong id="EN-US_TOPIC_0000001145710791__en-us_topic_0058965547_b84235270692911">true</strong> if they are successful and <strong id="EN-US_TOPIC_0000001145710791__en-us_topic_0058965547_b84235270692917">false</strong> otherwise.</p>
<p id="EN-US_TOPIC_0000001145710791__p1502193720110">For example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001145710791__screen1432915151118"><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>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">pid</span><span class="w"> </span><span class="k">from</span><span class="w"> </span><span class="n">pg_stat_activity</span><span class="p">;</span><span class="w"></span>
<span class="w"> </span><span class="n">pid</span><span class="w"> </span>
<span class="c1">-----------------</span>
<span class="w"> </span><span class="mi">140657876268816</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433774061312</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433587902208</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433656592128</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433723717376</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433637189376</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433552770816</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433481983744</span><span class="w"></span>
<span class="w"> </span><span class="mi">140433349310208</span><span class="w"></span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span><span class="w"></span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">pg_terminate_backend</span><span class="p">(</span><span class="mi">140657876268816</span><span class="p">);</span><span class="w"></span>
<span class="w"> </span><span class="n">pg_terminate_backend</span><span class="w"> </span>
<span class="c1">----------------------</span>
<span class="w"> </span><span class="n">t</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><span class="w"></span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0052.html">System Administration Functions</a></div>
</div>
</div>
View Git Blame Copy Permalink