STL_UTILITYTEXT

擷取在資料庫上執行之非 SELECT SQL 命令的文字。

查詢 STL_UTILITYTEXT 檢視，以擷取已在系統上執行之 SQL 陳述式的下列子集：

• ABORT、BEGIN、COMMIT、END、ROLLBACK

• ANALYZE

• CALL

• 取消

• COMMENT

• CREATE、ALTER、DROP DATABASE

• CREATE、ALTER、DROP USER

• EXPLAIN

• GRANT、REVOKE

• LOCK

• RESET

• SET

• SHOW

• TRUNCATE

另請參閱 STL_DDLTEXT、STL_QUERYTEXT 和 SVL_STATEMENTTEXT。

使用 STARTTIME 和 ENDTIME 資料欄，來了解已在特定時段記錄哪些陳述式。SQL 文字的長區塊會分成數行，一行 200 個字元；SEQUENCE 欄會識別屬於單一陳述式的文字片段。

所有使用者都可看見 STL_UTILITYTEXT。超級使用者可以看見所有資料列；一般使用者只能看見自己的資料。如需詳細資訊，請參閱 系統資料表和檢視中資料的可見性。

此資料表中的部份或所有資料也會在 SYS 監控檢視 SYS_QUERY_HISTORY 中找到。SYS 監視檢視中的資料會格式化為更易於使用和理解。我們建議您使用 SYS 監控檢視進行查詢。

資料表欄

欄名稱	資料類型	描述
userid	integer	產生項目的使用者之 ID。
xid	bigint	交易 ID。
pid	integer	與查詢陳述式相關聯的處理程序 ID。
label	character(320)	用於執行查詢的檔案名稱，或以 SET QUERY_GROUP 命令定義的標籤。如果查詢不是檔案型，或未設定 QUERY_GROUP 參數，則此欄位為空白。
starttime	timestamp	查詢開始的時間，以 UTC 表示。總時間包括佇列和執行。秒小數部分的精確度為 6 位元。例如：2009-06-12 11:29:19.131358。
endtime	timestamp	查詢完成的時間，以 UTC 表示。總時間包括佇列和執行。秒小數部分的精確度為 6 位元。例如：2009-06-12 11:29:19.131358。
sequence	integer	當單一陳述式包含不只 200 個字元時，會將該陳述式的其他資料列記錄下來。序列 0 是第一列，1 是第二列，以此類推。
text	character(200)	SQL 文字，以 200 個字元遞增。此欄位可能包含反斜線 (\\) 和換行符號 (\n) 等特殊字元。

範例查詢

下列查詢會傳回已在 2012 年 1 月 26 日執行之「公用程式」命令的文字。在此案例中，系統已執行部分 SET 命令和 SHOW ALL 命令：

select starttime, sequence, rtrim(text)
from stl_utilitytext
where starttime like '2012-01-26%'
order by starttime, sequence;

starttime          | sequence |              rtrim
---------------------------+-----+----------------------------------
2012-01-26 13:05:52.529235 |   0 | show all;
2012-01-26 13:20:31.660255 |   0 | SET query_group to ''
2012-01-26 13:20:54.956131 |   0 | SET query_group to 'soldunsold.sql'
...

重建儲存的 SQL

若要重建儲存在 STL_UTILITYTEXT text 資料欄中的 SQL，則需執行 SELECT 陳述式以從 text 資料欄的一或多個部分建立 SQL。請先以新的一行取代任意 (\n) 特殊字元，再執行重建的 SQL。下列 SELECT 陳述式顯示的結果會是 query_statement 欄中重建的 SQL 資料列。

SELECT LISTAGG(CASE WHEN LEN(RTRIM(text)) = 0 THEN text ELSE RTRIM(text) END) WITHIN GROUP (ORDER BY sequence) as query_statement 
FROM stl_utilitytext GROUP BY xid order by xid;

例如，下列查詢會將 query_group 設為一個零的字串。該查詢本身的長度超過 200 個字元，且會儲存在 STL_UTILITYTEXT 的多個部分中。

set query_group to '00000000000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000000000000000000000                  000000';

在本範例中，查詢會儲存在 STL_UTILITYTEXT text 資料欄的 2 個部分 (資料列) 中。

select query, sequence, text
from stl_utilitytext where query=pg_last_query_id() order by query desc, sequence limit 10;

         starttime          | sequence |                                                                                                   text                                                                                                   
----------------------------+----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 2019-07-23 22:55:34.926198 |        0 | set query_group to '00000000000000000000000000000000000000000000000000000000000000000000000000000000\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000
 2019-07-23 22:55:34.926198 |        1 |                   000000';

若要重建儲存在 STL_UTILITYTEXT 中的 SQL，請執行下列 SQL。

select LISTAGG(CASE WHEN LEN(RTRIM(text)) = 0 THEN text ELSE RTRIM(text) END, '') within group (order by sequence) AS query_statement 
from stl_utilitytext where query=pg_last_query_id();

若要在用戶端中使用產生的重建 SQL，請以新的一行取代任意 (\n) 特殊字元。

                                                                                                                                      query_statement                                                                                                                                       
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 set query_group to '00000000000000000000000000000000000000000000000000000000000000000000000000000000\n0000000000000000000000000000000000000000000000000000000000000000000000000000000000                  000000';