forked from docs/doc-exports
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>
174 lines
44 KiB
HTML
174 lines
44 KiB
HTML
<a name="EN-US_TOPIC_0000001233761693"></a><a name="EN-US_TOPIC_0000001233761693"></a>
|
||
|
||
<h1 class="topictitle1">Logging Content</h1>
|
||
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001233761693__section81174139518"><h4 class="sectiontitle">debug_print_parse</h4><p id="EN-US_TOPIC_0000001233761693__p1455615276550"><strong id="EN-US_TOPIC_0000001233761693__b1336388519">Parameter description</strong>: Specifies whether to print parsing tree results.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p13167151613314"><strong id="EN-US_TOPIC_0000001233761693__b1169445112017">Type</strong>: SIGHUP</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p185191242205120"><strong id="EN-US_TOPIC_0000001233761693__b105191342145114">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__ul18519042145111"><li id="EN-US_TOPIC_0000001233761693__li5519194219515"><strong id="EN-US_TOPIC_0000001233761693__b842352706151350">on</strong> indicates the printing result function is enabled.</li><li id="EN-US_TOPIC_0000001233761693__li13519442145118"><strong id="EN-US_TOPIC_0000001233761693__b84235270615143">off</strong> indicates the printing result function is disabled.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__p25191142105119"><strong id="EN-US_TOPIC_0000001233761693__b1859316619154">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b459411612151">off</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__section1521510162517"><h4 class="sectiontitle">debug_print_rewritten</h4><p id="EN-US_TOPIC_0000001233761693__p371413378563"><strong id="EN-US_TOPIC_0000001233761693__b1553012241515">Parameter description</strong>: Specifies whether to print query rewriting results.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p7990191016331"><strong id="EN-US_TOPIC_0000001233761693__b37488186111">Type</strong>: SIGHUP</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p10315135435116"><strong id="EN-US_TOPIC_0000001233761693__b131517542517">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__ul7315195416517"><li id="EN-US_TOPIC_0000001233761693__li631511547513"><strong id="EN-US_TOPIC_0000001233761693__b438270940">on</strong> indicates the printing result function is enabled.</li><li id="EN-US_TOPIC_0000001233761693__li15315115425115"><strong id="EN-US_TOPIC_0000001233761693__b1321827916">off</strong> indicates the printing result function is disabled.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__p183151354135112"><strong id="EN-US_TOPIC_0000001233761693__b152542052171510">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b22551452101512">off</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__s9c3870d1371f42c3b0dd5d9ee05e8670"><h4 class="sectiontitle">debug_print_plan</h4><p id="EN-US_TOPIC_0000001233761693__a4b5a3767eeae48138d3bd5060c431617"><strong id="EN-US_TOPIC_0000001233761693__b278583016119">Parameter description</strong>: Specifies whether to print query execution results.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__aefc558fc3009473c824d0ebfc2898bbe"><strong id="EN-US_TOPIC_0000001233761693__b67846311411">Type</strong>: SIGHUP</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__a5f76c4722528435fbeb4960ee6e5ec7e"><strong id="EN-US_TOPIC_0000001233761693__b1080856687">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__u994b85c836024298922a5153c3709a41"><li id="EN-US_TOPIC_0000001233761693__l74dd5d84e6604e8d9b8068f636909269"><strong id="EN-US_TOPIC_0000001233761693__b934478579">on</strong> indicates the printing result function is enabled.</li><li id="EN-US_TOPIC_0000001233761693__l8d95e30f40e244c08edcb46973f79a8e"><strong id="EN-US_TOPIC_0000001233761693__b47677450">off</strong> indicates the printing result function is disabled.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__ade49f90119434d81b43d55a43f1a3f1b"><strong id="EN-US_TOPIC_0000001233761693__b55233292105553">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b842352706172155">off</strong></p>
|
||
<div class="notice" id="EN-US_TOPIC_0000001233761693__note05751148105816"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233761693__ul182267183718"><li id="EN-US_TOPIC_0000001233761693__li16227141810715">Debugging information about <strong id="EN-US_TOPIC_0000001233761693__b5219954161712">debug_print_parse</strong>, <strong id="EN-US_TOPIC_0000001233761693__b175408219181">debug_print_rewritten</strong>, and <strong id="EN-US_TOPIC_0000001233761693__b1882191691816">debug_print_plan</strong> are printed only when the log level is set to <strong id="EN-US_TOPIC_0000001233761693__b32011847132615">log</strong> or higher. When these parameters are set to <strong id="EN-US_TOPIC_0000001233761693__b07741742111818">on</strong>, their debugging information will be recorded in server logs and will not be sent to client logs. You can change the log level by setting <a href="dws_04_0915.html#EN-US_TOPIC_0000001233883395__sbd8ad9bb6b9b48ba97f998f060dc56f3">client_min_messages</a> and <a href="dws_04_0915.html#EN-US_TOPIC_0000001233883395__s1ffb0797361d413d875381200fed970b">log_min_messages</a>.</li><li id="EN-US_TOPIC_0000001233761693__li722751814720">Do not invoke the <strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0058967718_b84235270615846">gs_encrypt_aes128</strong> and <strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0058967718_b84235270615849">gs_decrypt_aes128</strong> functions when <strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0058967718_b8423527061594">debug_print_plan</strong> is set to <strong id="EN-US_TOPIC_0000001233761693__b84235270683755">on</strong>, preventing the risk of sensitive information disclosure. You are advised to filter parameter information of the <strong id="EN-US_TOPIC_0000001233761693__b155360820110724">gs_encrypt_aes128</strong> and <strong id="EN-US_TOPIC_0000001233761693__b1560946810724">gs_decrypt_aes128</strong> functions in the log files generated when <strong id="EN-US_TOPIC_0000001233761693__b84235270683921">debug_print_plan</strong> is set to <strong id="EN-US_TOPIC_0000001233761693__b84235270684133">on</strong>, and then provide the information to external maintenance engineers for fault locating. After you finish using the logs, delete them as soon as possible.</li></ul>
|
||
</div></div>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__sa2640b7cf0554b0b89715af1b59ee115"><h4 class="sectiontitle">debug_pretty_print</h4><p id="EN-US_TOPIC_0000001233761693__a6fab7137ce4b4652bc9f379f789b682b"><strong id="EN-US_TOPIC_0000001233761693__b20511637_16">Parameter description</strong>: Specifies the logs produced by <strong id="EN-US_TOPIC_0000001233761693__b842352706151651">debug_print_parse</strong>, <strong id="EN-US_TOPIC_0000001233761693__b842352706151656">debug_print_rewritten</strong>, and <strong id="EN-US_TOPIC_0000001233761693__b84235270615170">debug_print_plan</strong>. The output format is more readable but much longer than the output generated when this parameter is set to <strong id="EN-US_TOPIC_0000001233761693__b84235270615201">off</strong>.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p11463101175210"><strong id="EN-US_TOPIC_0000001233761693__b15193123712120">Type</strong>: USERSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__ad234a8fa671b47be96e039d75adcfb89"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778487_a968b64b668e64cf4b795a69bd28ef46c">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__u464b1fc24b8a4025851c996111a50d60"><li id="EN-US_TOPIC_0000001233761693__l787cf6292a684954881390cc67f5a119"><strong id="EN-US_TOPIC_0000001233761693__b125039383334559">on</strong> indicates the indentation is enabled.</li><li id="EN-US_TOPIC_0000001233761693__l05ff88b4ad0d41888d7c4e0c0f66df8a"><strong id="EN-US_TOPIC_0000001233761693__b107488474034559">off</strong> indicates the indentation is disabled.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__a6f3e2858d443422eaec04d43655b9acd"><strong id="EN-US_TOPIC_0000001233761693__b19573715114114">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b842352706172116">on</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__sda1abeeb28da4d9096867f7ab7ea3885"><h4 class="sectiontitle">log_duration</h4><p id="EN-US_TOPIC_0000001233761693__a93e99476deb048a69260bce6ea0e01d5"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778400_en-us_topic_0058967718_b4981121">Parameter description</strong>: Specifies whether to record the duration of every completed SQL statement. For clients using extended query protocols, the time required for parsing, binding, and executing steps are logged independently.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p166132013260"><strong id="EN-US_TOPIC_0000001233761693__b1877610920219">Type</strong>: SUSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__a652d598534ce4d14aacc9636d31338b4"><strong id="EN-US_TOPIC_0000001233761693__b3100152615369">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__u10df9003f53f4feda488dfc8fa2f51ee"><li id="EN-US_TOPIC_0000001233761693__l74c6622c838241d0838cb57c14220173">If this parameter is set to <strong id="EN-US_TOPIC_0000001233761693__b16946152843617">off</strong>, the difference between setting this parameter and setting <a href="dws_04_0915.html#EN-US_TOPIC_0000001233883395__s670cade0b3b84413bd2256e1fe1c8cdb">log_min_duration_statement</a> is that exceeding <strong id="EN-US_TOPIC_0000001233761693__b694742813365">log_min_duration_statement</strong> forces the text of the query to be logged, but this parameter does not.</li><li id="EN-US_TOPIC_0000001233761693__l4968a55b30ba4cc1814bc1cf826fb4f8">If this parameter is set to <strong id="EN-US_TOPIC_0000001233761693__b1826123519361">on</strong> and <strong id="EN-US_TOPIC_0000001233761693__b1582613356362">log_min_duration_statement</strong> has a positive value, all durations are logged but the query text is included only for statements exceeding the threshold. This behavior can be used for gathering statistics in high-load situation.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__a847b22aed68749ceb9d45de3b50b4cad"><strong id="EN-US_TOPIC_0000001233761693__b731390947">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b1553420568">on</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__s1f2f9699c54c4c3f973baa725d94a06a"><h4 class="sectiontitle">log_error_verbosity</h4><p id="EN-US_TOPIC_0000001233761693__a56aa0ba3fa9947e1aff9b9795012ad87"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778400_en-us_topic_0058967718_b2262347">Parameter description</strong>: Specifies the amount of detail written in the server log for each message that is logged.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p49921350132618"><strong id="EN-US_TOPIC_0000001233761693__b19596151817211">Type</strong>: SUSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__a008d0806c6ff4ac2a8764a60df50d4ef"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778091_en-us_topic_0058967545_b41199681">Value range</strong>: enumerated values</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__uedffbf40c5af4b16ac43e9815aa5578f"><li id="EN-US_TOPIC_0000001233761693__l741d8e67fe4e4720b58904ef7bd7bbcf"><strong id="EN-US_TOPIC_0000001233761693__b84235270610522">terse</strong> indicates that the output excludes the logging of DETAIL, HINT, QUERY, and CONTEXT error information.</li><li id="EN-US_TOPIC_0000001233761693__l868e7428538f40678bafb4cc11c3f92c"><strong id="EN-US_TOPIC_0000001233761693__b84235270610537">verbose</strong> indicates that the output includes the SQLSTATE error code, the source code file name, function name, and number of the line in which the error occurs.</li><li id="EN-US_TOPIC_0000001233761693__l6f5f46f379ac4fa09446b4cff8dd5a3d"><strong id="EN-US_TOPIC_0000001233761693__b8423527061061">default</strong> indicates that the output includes the logging of DETAIL, HINT, QUERY, and CONTEXT error information, and excludes the SQLSTATE error code, the source code file name, function name, and number of the line in which the error occurs.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__a413426662b5f4da6a91ee5ad03ef3935"><strong id="EN-US_TOPIC_0000001233761693__b24134234_4">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b84235270617913">default</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__s80fbcd77ad5a4cdc879fe344d17b2c13"><a name="EN-US_TOPIC_0000001233761693__s80fbcd77ad5a4cdc879fe344d17b2c13"></a><a name="s80fbcd77ad5a4cdc879fe344d17b2c13"></a><h4 class="sectiontitle">log_lock_waits</h4><p id="EN-US_TOPIC_0000001233761693__a2b3489c5be3c4fb5bc2309382b6f7b28"><strong id="EN-US_TOPIC_0000001233761693__b1921419477369">Parameter description</strong>: If the time that a session used to wait a lock is longer than the value of <a href="dws_04_0928.html#EN-US_TOPIC_0000001233563133__s34083b462e2947b5a232d8b3a1465d3b">deadlock_timeout</a>, this parameter specifies whether to record this message in the database. This is useful in determining if lock waits are causing poor performance.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p16111602712"><strong id="EN-US_TOPIC_0000001233761693__b17396733226">Type</strong>: SUSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__af37c416494754aa0a5971654bba296b2"><strong id="EN-US_TOPIC_0000001233761693__b1801355887">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__u7a93bd0a699b4b41bfb5de61ee762288"><li id="EN-US_TOPIC_0000001233761693__l06bb68dbd53c45f9b6e8d12b5a0d00f0"><strong id="EN-US_TOPIC_0000001233761693__b2139962798">on</strong> indicates the information is recorded.</li><li id="EN-US_TOPIC_0000001233761693__ld13fbd0bf5344587b0a0a395e0ea113a"><strong id="EN-US_TOPIC_0000001233761693__b1658656637">off</strong> indicates the information is not recorded.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__a0f91942a7a324e6e89e2baa45b216f90"><strong id="EN-US_TOPIC_0000001233761693__b1107966344">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b2140633723">off</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__s3dd4368238fd47a2bb1de59c2142ede5"><a name="EN-US_TOPIC_0000001233761693__s3dd4368238fd47a2bb1de59c2142ede5"></a><a name="s3dd4368238fd47a2bb1de59c2142ede5"></a><h4 class="sectiontitle">log_statement</h4><p id="EN-US_TOPIC_0000001233761693__a9122122d846c4b77882e42c8c2550e32"><strong id="EN-US_TOPIC_0000001233761693__b20511637_34">Parameter description</strong>: Specifies whether to record SQL statements. For clients using extended query protocols, logging occurs when an execute message is received, and values of the Bind parameters are included (with any embedded single quotation marks doubled).</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p990231132718"><strong id="EN-US_TOPIC_0000001233761693__b320817371821">Type</strong>: SUSET</p>
|
||
<div class="notice" id="EN-US_TOPIC_0000001233761693__n07706568b6dc4b26921f64bf2e2b1613"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233761693__aad068db2a166423abff4fbdab28a2142">Statements that contain simple syntax errors are not logged even if <strong id="EN-US_TOPIC_0000001233761693__b5510856834559">log_statement</strong> is set to <strong id="EN-US_TOPIC_0000001233761693__b84235270611648">all</strong>, because the log message is emitted only after basic parsing has been completed to determine the statement type. If the extended query protocol is used, this setting also does not log statements before the execution phase (during parse analysis or planning). Set <strong id="EN-US_TOPIC_0000001233761693__b102587881734559">log_min_error_statement</strong> to ERROR or lower to log such statements.</p>
|
||
</div></div>
|
||
<p id="EN-US_TOPIC_0000001233761693__a2292a7957fa243be9210b439a7914351"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778400_en-us_topic_0058967718_b61472055">Value range</strong>: enumerated values</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__u210ac03f52a54d7c813ae3fcdc03ec15"><li id="EN-US_TOPIC_0000001233761693__le46daaf6e17246d4b4e2b2b23fedb9dd"><strong id="EN-US_TOPIC_0000001233761693__b15043698634559">none</strong> indicates that no statement is recorded.</li><li id="EN-US_TOPIC_0000001233761693__ld601186655354eec8b0b6c479eb61380"><strong id="EN-US_TOPIC_0000001233761693__b59794239134559">ddl</strong> indicates that all data definition statements, such as CREATE, ALTER, and DROP, are recorded.</li><li id="EN-US_TOPIC_0000001233761693__lb3a726d76f4740ebb0d58bba37a433e7"><strong id="EN-US_TOPIC_0000001233761693__b42923426534559">mod</strong> indicates that all DDL statements and data modification statements, such as INSERT, UPDATE, DELETE, TRUNCATE, and COPY FROM, are recorded.</li><li id="EN-US_TOPIC_0000001233761693__l75537a2f49764feba5c05934a1b2a0c3"><strong id="EN-US_TOPIC_0000001233761693__b129363205834559">all</strong> indicates that all statements are recorded. The PREPARE, EXECUTE, and EXPLAIN ANALYZE statements are also recorded.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__ab325b167b9bb4dd0af9a1697986c10ab"><strong id="EN-US_TOPIC_0000001233761693__b37632759_4">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b84235270617103">none</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__s8d1011e76c764e8a8b2e29184fd70a95"><h4 class="sectiontitle">log_temp_files</h4><p id="EN-US_TOPIC_0000001233761693__a4a33915857884db687e1ea90d7173313"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778400_en-us_topic_0058967718_b35339169">Parameter description</strong>: Specifies whether to record the delete information of temporary files. Temporary files can be created for sorting, hashing, and temporary querying results. A log entry is generated for each temporary file when it is deleted. </p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p10656111742717"><strong id="EN-US_TOPIC_0000001233761693__b4111939223">Type</strong>: SUSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__a32940836480d464bbcf56025cdc0f825"><strong id="EN-US_TOPIC_0000001233761693__b02851984111">Value range</strong>: an integer ranging from -1 to INT_MAX. The unit is KB.</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__u48c110478f1c43b89fdf80e052bf11cb"><li id="EN-US_TOPIC_0000001233761693__l55b6e2098aaf44b9a0c808465f06dbb1">A positive value indicates that the delete information of temporary files whose values are larger than that of <strong id="EN-US_TOPIC_0000001233761693__b842352706175348">log_temp_files</strong> is recorded.</li><li id="EN-US_TOPIC_0000001233761693__ld823f961ab3d45529b99189b9a635264">If the parameter is set to <strong id="EN-US_TOPIC_0000001233761693__b101575189117">0</strong>, all the delete information of temporary files is recorded.</li><li id="EN-US_TOPIC_0000001233761693__ld172d11e43194030a23c3630d5c142a0">If the parameter is set to <strong id="EN-US_TOPIC_0000001233761693__b63022047111119">-1</strong>, the delete information of no temporary files is recorded.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__aabcfebfb75eb4c229b14474a430654e7"><strong id="EN-US_TOPIC_0000001233761693__b53628433514291">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b164450946414291">–1</strong></p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__s0f9bdfeae6b64a4ca1773a93118e25a1"><h4 class="sectiontitle">logging_module</h4><p id="EN-US_TOPIC_0000001233761693__ae497467375a54cec913d3b7cfe5809d9"><strong id="EN-US_TOPIC_0000001233761693__en-us_topic_0059778400_b1969628515824">Parameter description</strong>: Specifies whether module logs can be output on the server. This parameter is a session-level parameter, and you are not advised to use the <strong id="EN-US_TOPIC_0000001233761693__b842352706102317">gs_guc</strong> tool to set it.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p3604683302"><strong id="EN-US_TOPIC_0000001233761693__b1501341923">Type</strong>: USERSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__ae209100cb34b453090ecf92376fd3de8"><strong id="EN-US_TOPIC_0000001233761693__b571812187">Value range</strong>: a string</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__aa431c7db59fa45c78f6d5f3a08cbb188"><strong id="EN-US_TOPIC_0000001233761693__b842352706102740">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b842352706151436">off</strong>. All the module logs on the server can be viewed by running <strong id="EN-US_TOPIC_0000001233761693__b842352706103112">show logging_module</strong>.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__a7cadbde5ab104a828d6ed5e82fa49145"><strong id="EN-US_TOPIC_0000001233761693__b842352706102745">Setting method</strong>: First, you can run <strong id="EN-US_TOPIC_0000001233761693__b842352706103016">show logging_module</strong> to view which module is controllable. For example, the query output result is as follows:</p>
|
||
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233761693__s17a8924ef33246bbb21a0c3b78f018f3"><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">show</span><span class="w"> </span><span class="n">logging_module</span><span class="p">;</span>
|
||
<span class="n">logging_module</span>
|
||
<span class="c1">-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="k">ALL</span><span class="p">,</span><span class="k">on</span><span class="p">(),</span><span class="k">off</span><span class="p">(</span><span class="n">DFS</span><span class="p">,</span><span class="n">GUC</span><span class="p">,</span><span class="n">HDFS</span><span class="p">,</span><span class="n">ORC</span><span class="p">,</span><span class="n">SLRU</span><span class="p">,</span><span class="n">MEM_CTL</span><span class="p">,</span><span class="n">AUTOVAC</span><span class="p">,</span><span class="k">ANALYZE</span><span class="p">,</span><span class="k">CACHE</span><span class="p">,</span><span class="n">ADIO</span><span class="p">,</span><span class="n">SSL</span><span class="p">,</span><span class="n">GDS</span><span class="p">,</span><span class="n">TBLSPC</span><span class="p">,</span><span class="n">WLM</span><span class="p">,</span><span class="k">SPACE</span><span class="p">,</span><span class="n">OBS</span><span class="p">,</span><span class="n">EXECUTOR</span><span class="p">,</span><span class="n">VEC_EXECUTOR</span><span class="p">,</span><span class="n">STREAM</span><span class="p">,</span><span class="n">LLVM</span><span class="p">,</span><span class="n">OPT</span><span class="p">,</span><span class="n">OPT_REWRITE</span><span class="p">,</span><span class="n">OPT_JOIN</span><span class="p">,</span><span class="n">OPT_AGG</span><span class="p">,</span><span class="n">OPT_SUBPLAN</span><span class="p">,</span><span class="n">OPT_SETOP</span><span class="p">,</span><span class="n">OPT_CARD</span><span class="p">,</span><span class="n">OPT_SKEW</span><span class="p">,</span><span class="n">SMP</span><span class="p">,</span><span class="n">UDF</span><span class="p">,</span><span class="n">COOP_ANALYZE</span><span class="p">,</span><span class="n">WLMCP</span><span class="p">,</span><span class="n">ACCELERATE</span><span class="p">,</span><span class="n">PLANHINT</span><span class="p">,</span><span class="n">PARQUET</span><span class="p">,</span><span class="n">CARBONDATA</span><span class="p">,</span><span class="n">SNAPSHOT</span><span class="p">,</span><span class="n">XACT</span><span class="p">,</span><span class="n">HANDLE</span><span class="p">,</span><span class="n">CLOG</span><span class="p">,</span><span class="n">TQUAL</span><span class="p">,</span><span class="n">EC</span><span class="p">,</span><span class="n">REMOTE</span><span class="p">,</span><span class="n">CN_RETRY</span><span class="p">,</span><span class="n">PLSQL</span><span class="p">,</span><span class="n">TEXTSEARCH</span><span class="p">,</span><span class="n">SEQ</span><span class="p">,</span><span class="n">INSTR</span><span class="p">,</span><span class="n">COMM_IPC</span><span class="p">,</span><span class="n">COMM_PARAM</span><span class="p">,</span><span class="n">CSTORE</span><span class="p">,</span><span class="n">JOB</span><span class="p">,</span><span class="n">STREAMPOOL</span><span class="p">,</span><span class="n">STREAM_CTESCAN</span><span class="p">)</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>
|
||
<p id="EN-US_TOPIC_0000001233761693__a380ecc4a554443e89fe8e8e7ea3dacb5">Controllable modules are identified by uppercase letters, and the special ID ALL is used for setting all module logs. You can control module logs to be exported by setting the log modules to <strong id="EN-US_TOPIC_0000001233761693__b842352706103559">on</strong> or <strong id="EN-US_TOPIC_0000001233761693__b84235270610361">off</strong>. Enable log output for SSL:</p>
|
||
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233761693__s0c94b1aec57747a4bbaf3d12a26220ea"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'on(SSL)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
<span class="k">show</span><span class="w"> </span><span class="n">logging_module</span><span class="p">;</span><span class="w"> </span><span class="n">logging_module</span><span class="w"> </span>
|
||
<span class="c1">------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="c1">------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="w"> </span><span class="k">ALL</span><span class="p">,</span><span class="k">on</span><span class="p">(</span><span class="n">SSL</span><span class="p">),</span><span class="k">off</span><span class="p">(</span><span class="n">DFS</span><span class="p">,</span><span class="n">GUC</span><span class="p">,</span><span class="n">HDFS</span><span class="p">,</span><span class="n">ORC</span><span class="p">,</span><span class="n">SLRU</span><span class="p">,</span><span class="n">MEM_CTL</span><span class="p">,</span><span class="n">AUTOVAC</span><span class="p">,</span><span class="k">ANALYZE</span><span class="p">,</span><span class="k">CACHE</span><span class="p">,</span><span class="n">ADIO</span><span class="p">,</span><span class="n">GDS</span><span class="p">,</span><span class="n">TBLSPC</span><span class="p">,</span><span class="n">WLM</span><span class="p">,</span><span class="k">SPACE</span><span class="p">,</span><span class="n">OBS</span><span class="p">,</span><span class="n">EXECUTOR</span><span class="p">,</span><span class="n">VEC_EXECUTOR</span><span class="p">,</span><span class="n">STREAM</span><span class="p">,</span><span class="n">LLVM</span><span class="p">,</span><span class="n">OPT</span><span class="p">,</span><span class="n">OPT_REWRITE</span><span class="p">,</span><span class="n">OPT_JOIN</span><span class="p">,</span><span class="n">OPT_AGG</span><span class="p">,</span><span class="n">OPT_SUBPLAN</span><span class="p">,</span><span class="n">OPT_SETOP</span><span class="p">,</span><span class="n">OPT_CARD</span><span class="p">,</span><span class="n">OPT_SKEW</span><span class="p">,</span><span class="n">SMP</span><span class="p">,</span><span class="n">UDF</span><span class="p">,</span><span class="n">COOP_ANALYZE</span><span class="p">,</span><span class="n">WLMCP</span><span class="p">,</span><span class="n">A</span>
|
||
<span class="n">CCELERATE</span><span class="p">,</span><span class="n">PLANHINT</span><span class="p">,</span><span class="n">PARQUET</span><span class="p">,</span><span class="n">CARBONDATA</span><span class="p">,</span><span class="n">SNAPSHOT</span><span class="p">,</span><span class="n">XACT</span><span class="p">,</span><span class="n">HANDLE</span><span class="p">,</span><span class="n">CLOG</span><span class="p">,</span><span class="n">TQUAL</span><span class="p">,</span><span class="n">EC</span><span class="p">,</span><span class="n">REMOTE</span><span class="p">,</span><span class="n">CN_RETRY</span><span class="p">,</span><span class="n">PLSQL</span><span class="p">,</span><span class="n">TEXTSEARCH</span><span class="p">,</span><span class="n">SEQ</span><span class="p">,</span><span class="n">INSTR</span><span class="p">,</span><span class="n">COMM_IPC</span><span class="p">,</span><span class="n">COMM_PARAM</span><span class="p">,</span><span class="n">CSTORE</span><span class="p">,</span><span class="n">JOB</span><span class="p">,</span><span class="n">STREAMPOOL</span><span class="p">,</span><span class="n">STREAM_CTESCAN</span><span class="p">)</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>
|
||
<p id="EN-US_TOPIC_0000001233761693__a6c1e832210da48d99c43375b344dee7f">SSL log output is enabled.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__a111db0aae5c0485381367a50e7e99ecf">The ALL identifier is equivalent to a shortcut operation. That is, logs of all modules can be enabled or disabled. </p>
|
||
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233761693__sa46fcab427ad49abbdceeb573463beb5"><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></pre></div></td><td class="code"><div><pre><span></span><span class="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'off(ALL)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
<span class="k">show</span><span class="w"> </span><span class="n">logging_module</span><span class="p">;</span><span class="w"> </span><span class="n">logging_module</span><span class="w"> </span>
|
||
<span class="c1">------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="c1">-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="w"> </span><span class="k">ALL</span><span class="p">,</span><span class="k">on</span><span class="p">(),</span><span class="k">off</span><span class="p">(</span><span class="n">DFS</span><span class="p">,</span><span class="n">GUC</span><span class="p">,</span><span class="n">HDFS</span><span class="p">,</span><span class="n">ORC</span><span class="p">,</span><span class="n">SLRU</span><span class="p">,</span><span class="n">MEM_CTL</span><span class="p">,</span><span class="n">AUTOVAC</span><span class="p">,</span><span class="k">ANALYZE</span><span class="p">,</span><span class="k">CACHE</span><span class="p">,</span><span class="n">ADIO</span><span class="p">,</span><span class="n">SSL</span><span class="p">,</span><span class="n">GDS</span><span class="p">,</span><span class="n">TBLSPC</span><span class="p">,</span><span class="n">WLM</span><span class="p">,</span><span class="k">SPACE</span><span class="p">,</span><span class="n">OBS</span><span class="p">,</span><span class="n">EXECUTOR</span><span class="p">,</span><span class="n">VEC_EXECUTOR</span><span class="p">,</span><span class="n">STREAM</span><span class="p">,</span><span class="n">LLVM</span><span class="p">,</span><span class="n">OPT</span><span class="p">,</span><span class="n">OPT_REWRITE</span><span class="p">,</span><span class="n">OPT_JOIN</span><span class="p">,</span><span class="n">OPT_AGG</span><span class="p">,</span><span class="n">OPT_SUBPLAN</span><span class="p">,</span><span class="n">OPT_SETOP</span><span class="p">,</span><span class="n">OPT_CARD</span><span class="p">,</span><span class="n">OPT_SKEW</span><span class="p">,</span><span class="n">SMP</span><span class="p">,</span><span class="n">UDF</span><span class="p">,</span><span class="n">COOP_ANALYZE</span><span class="p">,</span><span class="n">WLMCP</span><span class="p">,</span>
|
||
<span class="n">ACCELERATE</span><span class="p">,</span><span class="n">PLANHINT</span><span class="p">,</span><span class="n">PARQUET</span><span class="p">,</span><span class="n">CARBONDATA</span><span class="p">,</span><span class="n">SNAPSHOT</span><span class="p">,</span><span class="n">XACT</span><span class="p">,</span><span class="n">HANDLE</span><span class="p">,</span><span class="n">CLOG</span><span class="p">,</span><span class="n">TQUAL</span><span class="p">,</span><span class="n">EC</span><span class="p">,</span><span class="n">REMOTE</span><span class="p">,</span><span class="n">CN_RETRY</span><span class="p">,</span><span class="n">PLSQL</span><span class="p">,</span><span class="n">TEXTSEARCH</span><span class="p">,</span><span class="n">SEQ</span><span class="p">,</span><span class="n">INSTR</span><span class="p">,</span><span class="n">COMM_IPC</span><span class="p">,</span><span class="n">COMM_PARAM</span><span class="p">,</span><span class="n">CSTORE</span><span class="p">,</span><span class="n">JOB</span><span class="p">,</span><span class="n">STREAMPOOL</span><span class="p">,</span><span class="n">STREAM_CTESCAN</span><span class="p">)</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="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'on(ALL)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
<span class="k">show</span><span class="w"> </span><span class="n">logging_module</span><span class="p">;</span><span class="w"> </span><span class="n">logging_module</span><span class="w"> </span>
|
||
<span class="c1">------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="c1">-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------</span>
|
||
<span class="w"> </span><span class="k">ALL</span><span class="p">,</span><span class="k">on</span><span class="p">(</span><span class="n">DFS</span><span class="p">,</span><span class="n">GUC</span><span class="p">,</span><span class="n">HDFS</span><span class="p">,</span><span class="n">ORC</span><span class="p">,</span><span class="n">SLRU</span><span class="p">,</span><span class="n">MEM_CTL</span><span class="p">,</span><span class="n">AUTOVAC</span><span class="p">,</span><span class="k">ANALYZE</span><span class="p">,</span><span class="k">CACHE</span><span class="p">,</span><span class="n">ADIO</span><span class="p">,</span><span class="n">SSL</span><span class="p">,</span><span class="n">GDS</span><span class="p">,</span><span class="n">TBLSPC</span><span class="p">,</span><span class="n">WLM</span><span class="p">,</span><span class="k">SPACE</span><span class="p">,</span><span class="n">OBS</span><span class="p">,</span><span class="n">EXECUTOR</span><span class="p">,</span><span class="n">VEC_EXECUTOR</span><span class="p">,</span><span class="n">STREAM</span><span class="p">,</span><span class="n">LLVM</span><span class="p">,</span><span class="n">OPT</span><span class="p">,</span><span class="n">OPT_REWRITE</span><span class="p">,</span><span class="n">OPT_JOIN</span><span class="p">,</span><span class="n">OPT_AGG</span><span class="p">,</span><span class="n">OPT_SUBPLAN</span><span class="p">,</span><span class="n">OPT_SETOP</span><span class="p">,</span><span class="n">OPT_CARD</span><span class="p">,</span><span class="n">OPT_SKEW</span><span class="p">,</span><span class="n">SMP</span><span class="p">,</span><span class="n">UDF</span><span class="p">,</span><span class="n">COOP_ANALYZE</span><span class="p">,</span><span class="n">WLMCP</span><span class="p">,</span><span class="n">ACCELE</span>
|
||
<span class="n">RATE</span><span class="p">,</span><span class="n">PLANHINT</span><span class="p">,</span><span class="n">PARQUET</span><span class="p">,</span><span class="n">CARBONDATA</span><span class="p">,</span><span class="n">SNAPSHOT</span><span class="p">,</span><span class="n">XACT</span><span class="p">,</span><span class="n">HANDLE</span><span class="p">,</span><span class="n">CLOG</span><span class="p">,</span><span class="n">TQUAL</span><span class="p">,</span><span class="n">EC</span><span class="p">,</span><span class="n">REMOTE</span><span class="p">,</span><span class="n">CN_RETRY</span><span class="p">,</span><span class="n">PLSQL</span><span class="p">,</span><span class="n">TEXTSEARCH</span><span class="p">,</span><span class="n">SEQ</span><span class="p">,</span><span class="n">INSTR</span><span class="p">,</span><span class="n">COMM_IPC</span><span class="p">,</span><span class="n">COMM_PARAM</span><span class="p">,</span><span class="n">CSTORE</span><span class="p">,</span><span class="n">JOB</span><span class="p">,</span><span class="n">STREAMPOOL</span><span class="p">,</span><span class="n">STREAM_CTESCAN</span><span class="p">),</span><span class="k">off</span><span class="p">()</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>
|
||
<p id="EN-US_TOPIC_0000001233761693__p223915284817">COMM_IPC logs must be enabled or disabled explicitly. You can run either of the following command to enable the log function of COMM_IPC:</p>
|
||
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233761693__screen182471213101418"><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="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'on(ALL)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
<span class="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'on(COMM_IPC)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
</pre></div></td></tr></table></div>
|
||
|
||
</div>
|
||
<p id="EN-US_TOPIC_0000001233761693__p515941141615">After the setting is performed, the log function of the COMM_IPC module will not be automatically disabled. To disable the log function of the COMM_IPC module, you must run the following commands:</p>
|
||
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233761693__screen15771635171810"><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="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'off(ALL)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
<span class="k">set</span><span class="w"> </span><span class="n">logging_module</span><span class="o">=</span><span class="s1">'off(COMM_IPC)'</span><span class="p">;</span>
|
||
<span class="k">SET</span>
|
||
</pre></div></td></tr></table></div>
|
||
|
||
</div>
|
||
<p id="EN-US_TOPIC_0000001233761693__a9e32975601864b47b161fa35d9eb634e"><strong id="EN-US_TOPIC_0000001233761693__b2342163173713">Dependency relationship</strong>: The value of this parameter depends on the settings of <a href="dws_04_0915.html#EN-US_TOPIC_0000001233883395__s1ffb0797361d413d875381200fed970b">log_min_messages</a>.</p>
|
||
</div>
|
||
<div class="section" id="EN-US_TOPIC_0000001233761693__section843517526358"><h4 class="sectiontitle">enable_unshipping_log</h4><p id="EN-US_TOPIC_0000001233761693__p1043525273520"><strong id="EN-US_TOPIC_0000001233761693__b941668363">Parameter description</strong>: Specifies whether to log statements that are not pushed down. The logs help locate performance issues that may be caused by statements not pushed down.</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p2011353582716"><strong id="EN-US_TOPIC_0000001233761693__b179555426214">Type</strong>: SUSET</p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p141570567378"><strong id="EN-US_TOPIC_0000001233761693__b5950165515171">Value range</strong>: Boolean</p>
|
||
<ul id="EN-US_TOPIC_0000001233761693__ul1115710563378"><li id="EN-US_TOPIC_0000001233761693__li13157155663711"><strong id="EN-US_TOPIC_0000001233761693__b11560256161318">on</strong>: Statements not pushed down will be logged.</li><li id="EN-US_TOPIC_0000001233761693__li51571256123711"><strong id="EN-US_TOPIC_0000001233761693__b64907001812">off</strong>: Statements not pushed down will not be logged.</li></ul>
|
||
<p id="EN-US_TOPIC_0000001233761693__p41573567373"><strong id="EN-US_TOPIC_0000001233761693__b14739191161814">Default value</strong>: <strong id="EN-US_TOPIC_0000001233761693__b16740201181816">on</strong></p>
|
||
<p id="EN-US_TOPIC_0000001233761693__p243665243515"></p>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_0913.html">Error Reporting and Logging</a></div>
|
||
</div>
|
||
</div>
|
||
|