doc-exports/docs/dws/dev/dws_04_0034.html
Lu, Huayi ef0ada5a59 DWS DEV 20240716 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-11-02 09:07:47 +00:00

123 lines
29 KiB
HTML

<a name="EN-US_TOPIC_0000001510162977"></a><a name="EN-US_TOPIC_0000001510162977"></a>
<h1 class="topictitle1">Viewing a System Catalog</h1>
<div id="body8662426"><p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_ae980e1a43a884b39b5f435b15277eef2">In addition to the created tables, a database contains many system catalogs These system catalogs contain cluster installation information and information about various queries and processes in <span id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_text1093275459">GaussDB(DWS)</span>. You can collect information about the database by querying the system catalog.</p>
<div class="section" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_sa8ee1f08a3e74ba1ba2ff4920ee1054b"><h4 class="sectiontitle">Querying Database Tables</h4><p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_p143354763216">For example, query the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_b15601359195415">PG_TABLES</strong> system catalog for all tables in the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_b15833133575513">public</strong> schema.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_sf44fb4207ae14ea895df3fa026f79728"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">distinct</span><span class="p">(</span><span class="n">tablename</span><span class="p">)</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_tables</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">SCHEMANAME</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'public'</span><span class="p">;</span><span class="w"> </span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_p335347103213">Information similar to the following is displayed:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_sd7ec8e21d0d44a5c844a70cbc5fb5983"><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></pre></div></td><td class="code"><div><pre><span></span><span class="w"> </span><span class="n">tablename</span>
<span class="c1">-------------------</span>
<span class="w"> </span><span class="n">err_hr_staffs</span>
<span class="w"> </span><span class="n">test</span>
<span class="w"> </span><span class="n">err_hr_staffs_ft3</span>
<span class="w"> </span><span class="n">web_returns_p1</span>
<span class="w"> </span><span class="n">mig_seq_table</span>
<span class="w"> </span><span class="n">films4</span>
<span class="p">(</span><span class="mi">6</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s81b82ca0080346e397ff2c3313239101"><h4 class="sectiontitle">Viewing Database Users</h4><p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_a77389c483fb54cf49203dac0c87cda81">You can run the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270695257">PG_USER</strong> command to view the list of all users in the database, and view the user ID (<strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_b96099368575">USESYSID</strong>) and permissions.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s737b1dfd4ede4c558aa03127ab48b783"><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></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_user</span><span class="p">;</span><span class="w"> </span>
<span class="n">usename</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usesysid</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usecreatedb</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usesuper</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usecatupd</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">userepl</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">passwd</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">valbegin</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">valuntil</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">respool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">parent</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">spacelimit</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">useconfig</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">nodegroup</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">tempspacelimit</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">spillspacelim</span>
<span class="n">it</span>
<span class="c1">---------+----------+-------------+----------+-----------+---------+----------+----------+----------+--------------+--------+------------+-----------+-----------+----------------+--------------</span>
<span class="c1">---</span>
<span class="w"> </span><span class="n">Ruby</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">10</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">t</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">t</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">dbadmin</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">16393</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">lily</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">16691</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">jack</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">70694</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="p">(</span><span class="mi">4</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_p335144793215"><span id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_text821667906">GaussDB(DWS)</span> uses Ruby to perform routine management and maintenance. You can add <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270695818">WHERE usesysid &gt; 10</strong> to the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270695843">SELECT</strong> statement to filter queries so that only specified user names are displayed.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s24ee0dc1d2f84b7a9ce403e35c299414"><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></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_user</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">usesysid</span><span class="w"> </span><span class="o">&gt;</span><span class="w"> </span><span class="mi">10</span><span class="p">;</span><span class="w"> </span>
<span class="w"> </span><span class="n">usename</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usesysid</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usecreatedb</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usesuper</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">usecatupd</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">userepl</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">passwd</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">valbegin</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">valuntil</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">respool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">parent</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">spacelimit</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">useconfig</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">nodegroup</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">tempspacelimit</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">spillspacelim</span>
<span class="n">it</span>
<span class="c1">---------+----------+-------------+----------+-----------+---------+----------+----------+----------+--------------+--------+------------+-----------+-----------+----------------+--------------</span>
<span class="c1">---</span>
<span class="w"> </span><span class="n">dbadmin</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">16393</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">lily</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">16691</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">jack</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">70694</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">********</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">default_pool</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span>
<span class="p">(</span><span class="mi">3</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s1b3d6bd2b52e4a72ac757510c65946e8"><h4 class="sectiontitle">Viewing and Stopping the Running Query Statements</h4><p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_p15751841493">You can view the running query statements in the <a href="dws_04_0755.html">PG_STAT_ACTIVITY</a> view. Do as follows:</p>
<ol id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_ol4911599615"><li id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_l66435131bbcf4c2392f0e993b49df1bc"><span>Set the parameter <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270617325">track_activities</strong> to <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270617331">on</strong>.</span><p><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s8e01a272003b4e4486b3c2620b42792a"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SET</span><span class="w"> </span><span class="n">track_activities</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">on</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_af670d4cf94794f4784b7e07a529ac954">The database collects the running information about active queries only if the parameter is set to <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b842352706102059">on</strong>.</p>
</p></li><li id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_ld2e98835f3994a039545608291001dc3"><span>View the running query statements. Run the following command to view the database names, users, query statuses, and PIDs of the running query statements:</span><p><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_sc0d197d66e97482c842e552059ee04cd"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">datname</span><span class="p">,</span><span class="w"> </span><span class="n">usename</span><span class="p">,</span><span class="w"> </span><span class="k">state</span><span class="p">,</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>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_a6e7feb6c488d4e2994bfb839e1cc7b33">If the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270617455">state</strong> column is <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b842352706113432">idle</strong>, the connection is idle and requires a user to enter a command.</p>
<p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_a64668f7f1609417092332c2482b65926">To identify only active query statements, run the following command:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_sc436077ab0d84e7cb4268fb30b873889"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">datname</span><span class="p">,</span><span class="w"> </span><span class="n">usename</span><span class="p">,</span><span class="w"> </span><span class="k">state</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_stat_activity</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="k">state</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="s1">'idle'</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</p></li><li id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_lb1d9874cfd5f4ab3b0a60507a2fff2d1"><span>To cancel queries that have been running for a long time, use the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b84235270614827">PG_TERMINATE_BACKEND</strong> function to end sessions based on the thread ID.</span><p><div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s3a8d2575846e4e8d8775980655550299"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">PG_TERMINATE_BACKEND</span><span class="p">(</span><span class="mi">139834759993104</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_ac3edfdcdfbf542e7974ef962fc9f9e17">If information similar to the following is displayed, the session is successfully terminated:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_sa32eca25959c47b2a9c5216e77c59fd4"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">PG_TERMINATE_BACKEND</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="p" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_p205727191681">If information similar to the following is displayed, a user has terminated the current session.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s9493c1d58b234964b69411ba6eb0f73b"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><span class="n">FATAL</span><span class="p">:</span><span class="w"> </span><span class="n">terminating</span><span class="w"> </span><span class="k">connection</span><span class="w"> </span><span class="n">due</span><span class="w"> </span><span class="k">to</span><span class="w"> </span><span class="n">administrator</span><span class="w"> </span><span class="n">command</span>
<span class="n">FATAL</span><span class="p">:</span><span class="w"> </span><span class="n">terminating</span><span class="w"> </span><span class="k">connection</span><span class="w"> </span><span class="n">due</span><span class="w"> </span><span class="k">to</span><span class="w"> </span><span class="n">administrator</span><span class="w"> </span><span class="n">command</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_nff00792959ee47f8acf42b49a212e23b"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_a66709dd5c91841db983b6368abcdda10">If the <strong id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_en-us_topic_0100315815_b842352706143550">PG_TERMINATE_BACKEND</strong> function is used to terminate the backend threads of the current session, the gsql client will be reconnected automatically rather than be logged out. The message "The connection to the server was lost." is returned. Attempting reset: Succeeded."</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510162977__en-us_topic_0000001233761821_s7a418a861e944b4f82fecf05d22aeda8"><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></pre></div></td><td class="code"><div><pre><span></span><span class="n">FATAL</span><span class="p">:</span><span class="w"> </span><span class="n">terminating</span><span class="w"> </span><span class="k">connection</span><span class="w"> </span><span class="n">due</span><span class="w"> </span><span class="k">to</span><span class="w"> </span><span class="n">administrator</span><span class="w"> </span><span class="n">command</span>
<span class="n">FATAL</span><span class="p">:</span><span class="w"> </span><span class="n">terminating</span><span class="w"> </span><span class="k">connection</span><span class="w"> </span><span class="n">due</span><span class="w"> </span><span class="k">to</span><span class="w"> </span><span class="n">administrator</span><span class="w"> </span><span class="n">command</span>
<span class="n">The</span><span class="w"> </span><span class="k">connection</span><span class="w"> </span><span class="k">to</span><span class="w"> </span><span class="n">the</span><span class="w"> </span><span class="n">server</span><span class="w"> </span><span class="n">was</span><span class="w"> </span><span class="n">lost</span><span class="p">.</span><span class="w"> </span><span class="n">Attempting</span><span class="w"> </span><span class="k">reset</span><span class="p">:</span><span class="w"> </span><span class="n">Succeeded</span><span class="p">.</span>
</pre></div></td></tr></table></div>
</div>
</div></div>
</div>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_0016.html">Defining Database Objects</a></div>
</div>
</div>