

 Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im [Blog-Posting](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# STL\$1UTILITYTEXT
<a name="r_STL_UTILITYTEXT"></a>

Erfasst den Text von auf der Datenbank ausgeführten Nicht-SELECT SQL-befehlen.

Fragen Sie die Ansicht STL\$1UTILITYTEXT ab, um die folgende Teilmenge von SQL-Anweisungen zu erfassen, die auf dem System ausgeführt wurden:
+ ABORT, BEGIN, COMMIT, END, ROLLBACK
+ ANALYZE
+ CALL
+ CANCEL
+ COMMENT
+ CREATE, ALTER, DROP DATABASE
+ CREATE, ALTER, DROP USER
+ EXPLAIN
+ GRANT, REVOKE
+ LOCK
+ RESET
+ SET
+ ZEIGEN
+ TRUNCATE

Vgl. auch [STL\$1DDLTEXT](r_STL_DDLTEXT.md), [STL\$1QUERYTEXT](r_STL_QUERYTEXT.md) und [SVL\$1STATEMENTTEXT](r_SVL_STATEMENTTEXT.md).

Verwenden Sie die Spalten STARTTIME und ENDTIME, um zu erfahren, welche Anweisungen während eines bestimmten Zeitraums protokolliert wurden. Lange SQL-Textblöcke werden in 200 Zeichen lange Zeilen umgebrochen; die Spalte SEQUENCE identifiziert Textfragmente, die zu einer einzelnen Anweisung gehören.

Die Systemtabelle STL\$1UTILITYTEXT unterstützt sowohl MANUAL- als auch AUTO REFRESH-Operationen von materialisierten Ansichten. Suchen Sie nach der Spalte `label`, um AUTO REFRESH in materialisierten Ansichten zu identifizieren. Alle AUTO REFRESH-Abfragen haben eine Bezeichnung mit dem Wert `maintenance`.

STL\$1UTILITYTEXT ist für alle Benutzer sichtbar. Superuser können alle Zeilen sehen; reguläre Benutzer können nur ihre eigenen Daten sehen. Weitere Informationen finden Sie unter [Sichtbarkeit der Daten in Systemtabellen und Ansichten](cm_chap_system-tables.md#c_visibility-of-data).

Einige oder alle Daten in dieser Tabelle sind auch in der SYS-Überwachungsansicht [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) zu finden. Die Daten in der SYS-Überwachungsansicht sind so formatiert, dass sie leichter verwendbar und besser verständlich sind. Wir empfehlen Ihnen, für Ihre Abfragen die SYS-Überwachungsansicht zu verwenden.

## Tabellenspalten
<a name="r_STL_UTILITYTEXT-table-columns"></a>

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/redshift/latest/dg/r_STL_UTILITYTEXT.html)

## Beispielabfragen
<a name="r_STL_UTILITYTEXT-sample-queries"></a>

Die folgende Abfrage gibt den Text für „Utility“-Befehle aus, die am 26. Januar 2012 ausgeführt wurden. In diesem Fall wurden einige SET-befehle und ein SHOW ALL-Befehl ausgeführt: 

```
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'
...
```

### Wiederherstellen von gespeichertem SQL
<a name="r_STL_UTILITYTEXT-reconstruct-sql"></a>

Um das in der Spalte `text` von STL\$1UTILITYTEXT gespeicherte SQL wiederherzustellen, führen Sie eine SELECT-Anweisung aus, um SQL von mindestens einem Teil der Spalte `text` zu erstellen. Bevor Sie das wiederhergestellte SQL ausführen, ersetzen Sie alle Sonderzeichen (`\n`) durch einen Zeilenumbruch. Das Ergebnis der folgenden SELECT-Anweisung besteht aus Zeilen von wiederhergestelltem SQL im Feld `query_statement`.

```
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;
```

Die folgende Abfrage setzt beispielsweise die query\$1group auf eine Zeichenfolge von Nullen. Die Abfrage selbst ist länger als 200 Zeichen und wird in mehreren Teilen in STL\$1UTILITYTEXT gespeichert.

```
set query_group to '00000000000000000000000000000000000000000000000000000000000000000000000000000000
0000000000000000000000000000000000000000000000000000000000000000000000000000000000                  000000';
```

In diesem Beispiel wird die Abfrage in 2 Teilen (Zeilen) in der Spalte `text` von STL\$1UTILITYTEXT gespeichert.

```
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';
```

Um das in STL\$1UTILITYTEXT gespeicherte SQL wiederherzustellen, führen Sie den folgenden SQL-Code aus. 

```
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();
```

Um das resultierende wiederhergestellte SQL in Ihrem Client zu verwenden, ersetzen Sie alle Sonderzeichen (`\n`) durch einen Zeilenumbruch. 

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