doc-exports/docs/dws/dev/dws_04_0938.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

38 lines
8.5 KiB
HTML

<a name="EN-US_TOPIC_0000001510162589"></a><a name="EN-US_TOPIC_0000001510162589"></a>
<h1 class="topictitle1">Audit Switch</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001510162589__s47eb5bd8caa94feb9ff1f36c224b687e"><h4 class="sectiontitle">audit_enabled</h4><p id="EN-US_TOPIC_0000001510162589__aef2d92e8217f43e89297515d68700048"><strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_en-us_topic_0058967712_b29280198">Parameter description</strong>: Specifies whether to enable or disable the audit process. After the audit process is enabled, the auditing information written by the background process can be read from the pipe and written into audit files.</p>
<p id="EN-US_TOPIC_0000001510162589__p2525314115220"><strong id="EN-US_TOPIC_0000001510162589__b7970141653017">Type</strong>: SIGHUP</p>
<p id="EN-US_TOPIC_0000001510162589__af5fdd04694b94139b77678935e59917b"><strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_en-us_topic_0058967712_b4938529">Value range</strong>: Boolean</p>
<ul id="EN-US_TOPIC_0000001510162589__u37307aca970e4f57a86da97195ff9d75"><li id="EN-US_TOPIC_0000001510162589__l9d2712b9508b40a0bd91db2bfd42d262"><strong id="EN-US_TOPIC_0000001510162589__b187243896642718">on</strong> indicates that the auditing function is enabled.</li><li id="EN-US_TOPIC_0000001510162589__l68a9a22ff7ea4231a5feb76ea7314d4d"><strong id="EN-US_TOPIC_0000001510162589__b28413185442718">off</strong> indicates that the auditing function is disabled.</li></ul>
<p id="EN-US_TOPIC_0000001510162589__aa56571112724460aaaf0a6e3f69d328b"><strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_en-us_topic_0058967712_b48892289">Default value</strong>: <strong id="EN-US_TOPIC_0000001510162589__b842352706155328">on</strong></p>
</div>
<div class="section" id="EN-US_TOPIC_0000001510162589__s199c0d0827ad412287098d139191a00a"><h4 class="sectiontitle">audit_space_limit</h4><p id="EN-US_TOPIC_0000001510162589__a7726613d3fb54b94ab8bfcbb24f9e146"><strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_en-us_topic_0058967712_b1168798544101111">Parameter description</strong>: Specifies the total disk space occupied by audit files.</p>
<p id="EN-US_TOPIC_0000001510162589__p62888234535"><strong id="EN-US_TOPIC_0000001510162589__b8923521163020">Type</strong>: SIGHUP</p>
<p id="EN-US_TOPIC_0000001510162589__a860225d64b064fc9982a92ab38ca1388"><strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_en-us_topic_0058967712_b84235270695433">Value range</strong>: an integer ranging from <strong id="EN-US_TOPIC_0000001510162589__b84235270616143">1024 KB</strong> to <strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_en-us_topic_0058967712_b84235270693449">1024 GB</strong>. The unit is KB.</p>
<p id="EN-US_TOPIC_0000001510162589__a04e313f9080a4f4da12ece86b1683ba7"><strong id="EN-US_TOPIC_0000001510162589__en-us_topic_0059777744_ad5c25cbbd1714f72808abf2c5c26090c">Default value</strong>: <strong id="EN-US_TOPIC_0000001510162589__b842352706161418">1GB</strong></p>
</div>
<div class="section" id="EN-US_TOPIC_0000001510162589__s1f2f9699c54c4c3f973baa725d94a06a"><h4 class="sectiontitle">audit_object_name_format</h4><p id="EN-US_TOPIC_0000001510162589__a56aa0ba3fa9947e1aff9b9795012ad87"><strong id="EN-US_TOPIC_0000001510162589__b10233211235">Parameter description</strong>: Specifies the format of the object name displayed in the <strong id="EN-US_TOPIC_0000001510162589__b16603171613319">object_name</strong> field of audit logs.</p>
<p id="EN-US_TOPIC_0000001510162589__p49921350132618"><strong id="EN-US_TOPIC_0000001510162589__b14992145052614">Type</strong>: USERSET</p>
<p id="EN-US_TOPIC_0000001510162589__a008d0806c6ff4ac2a8764a60df50d4ef"><strong id="EN-US_TOPIC_0000001510162589__a7268b2d0294e41b8bef43c14418d8899">Value range</strong>: enumerated values</p>
<ul id="EN-US_TOPIC_0000001510162589__uedffbf40c5af4b16ac43e9815aa5578f"><li id="EN-US_TOPIC_0000001510162589__l741d8e67fe4e4720b58904ef7bd7bbcf"><strong id="EN-US_TOPIC_0000001510162589__b2014182419310">single</strong> indicates that the <strong id="EN-US_TOPIC_0000001510162589__b13352130734">object_name</strong> field displays a single object name, which is the name of the target object.</li><li id="EN-US_TOPIC_0000001510162589__l868e7428538f40678bafb4cc11c3f92c"><strong id="EN-US_TOPIC_0000001510162589__b05273352312">all</strong> indicates that the <strong id="EN-US_TOPIC_0000001510162589__b1416854015313">object_name</strong> field displays multiple object names.</li></ul>
<p id="EN-US_TOPIC_0000001510162589__a413426662b5f4da6a91ee5ad03ef3935"><strong id="EN-US_TOPIC_0000001510162589__b1472620464313">Default value</strong>: single</p>
<div class="note" id="EN-US_TOPIC_0000001510162589__n79769e8c392843e2af7c7c420f9bd8ab"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001510162589__a7386f02f7a2e429dbcaa64299718af33">If the default value is set to <strong id="EN-US_TOPIC_0000001510162589__b13261125416316">all</strong>, multiple object names will be displayed for SELECT, DELETE, UPDATE, INSERT, MERGE, CREATE TABLE AS and CREATE VIEW AS.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510162589__section1759171123817"><h4 class="sectiontitle">audit_object_details</h4><p id="EN-US_TOPIC_0000001510162589__p2059101114385"><strong id="EN-US_TOPIC_0000001510162589__b821512395312">Parameter description</strong>: whether to record the <strong id="EN-US_TOPIC_0000001510162589__b18457247636">object_details</strong> field in audit logs. This field indicates the table name, column name, and column type in the audit statement. This parameter is supported only by clusters of version 8.2.1.100 or later.</p>
<p id="EN-US_TOPIC_0000001510162589__p18591101116389"><strong id="EN-US_TOPIC_0000001510162589__b1759275529">Type</strong>: USERSET</p>
<p id="EN-US_TOPIC_0000001510162589__p6591131119389"><strong id="EN-US_TOPIC_0000001510162589__b179674381546">Value range</strong>: Boolean</p>
<ul id="EN-US_TOPIC_0000001510162589__ul165911211193818"><li id="EN-US_TOPIC_0000001510162589__li2591131143817"><strong id="EN-US_TOPIC_0000001510162589__b12731349141">on</strong> indicates that the <strong id="EN-US_TOPIC_0000001510162589__b16791113671">object_details</strong> field is recorded during the audit.</li><li id="EN-US_TOPIC_0000001510162589__li16591211133813"><strong id="EN-US_TOPIC_0000001510162589__b356612251712">off</strong> indicates that the <strong id="EN-US_TOPIC_0000001510162589__b1086523115713">object_details</strong> field is not recorded during the audit.</li></ul>
<p id="EN-US_TOPIC_0000001510162589__p14591191117382"><strong id="EN-US_TOPIC_0000001510162589__b803027354101736">Default value</strong>: <strong id="EN-US_TOPIC_0000001510162589__b640894324101736">off</strong></p>
<div class="note" id="EN-US_TOPIC_0000001510162589__note759131123815"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001510162589__ul157401616102314"><li id="EN-US_TOPIC_0000001510162589__li1274091672318">If this parameter is set to <strong id="EN-US_TOPIC_0000001510162589__b1175613281394">on</strong>, the table name, column name, and column type in the statement will be audited, which may affect the performance. So, exercise caution when setting this parameter to <strong id="EN-US_TOPIC_0000001510162589__b8151419141">on</strong>.</li><li id="EN-US_TOPIC_0000001510162589__li974120161233">If this parameter is set to <strong id="EN-US_TOPIC_0000001510162589__b11241534111417">on</strong>, the <strong id="EN-US_TOPIC_0000001510162589__b259015267170">object_details</strong> field records the following statements: <strong id="EN-US_TOPIC_0000001510162589__b15856194721719">SELECT</strong>, <strong id="EN-US_TOPIC_0000001510162589__b17139145010178">DELETE</strong>, <strong id="EN-US_TOPIC_0000001510162589__b1141665191710">UPDATE</strong>, <strong id="EN-US_TOPIC_0000001510162589__b127741352191719">INSERT</strong>, <strong id="EN-US_TOPIC_0000001510162589__b15959165311178">MERGE</strong>, <strong id="EN-US_TOPIC_0000001510162589__b657218594174">CREATE TABLE AS SELECT</strong>, <strong id="EN-US_TOPIC_0000001510162589__b653814319188">GRANT</strong>, and <strong id="EN-US_TOPIC_0000001510162589__b4100117141812">DECLARE CURSOR</strong>. <strong id="EN-US_TOPIC_0000001510162589__b1815502041816">GRANT</strong> statements that fail to be executed are not recorded.</li></ul>
</div></div>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_04_0937.html">Auditing</a></div>
</div>
</div>