QUERY_HISTORY , QUERY_HISTORY_BY_*¶

Syntax¶

QUERY_HISTORY(
      [ END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_SESSION(
      [ SESSION_ID => <constant_expr> ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_USER(
      [ USER_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_WAREHOUSE(
      [ WAREHOUSE_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

Argumente¶

Alle Argumente sind optional.

END_TIME_RANGE_START => constant_expr, . END_TIME_RANGE_END => constant_expr

Zeitbereich (im Format TIMESTAMP_LTZ) innerhalb der letzten 7 Tage, in der die Abfrage fertig ausgeführt wurde:

• Wenn END_TIME_RANGE_END nicht angegeben ist, gibt die Funktion alle Abfragen zurück, auch jene, die noch ausgeführt werden.

• Wenn END_TIME_RANGE_END den Wert CURRENT_TIMESTAMP aufweist, gibt die Funktion nur jene Abfragen zurück, die abgeschlossen wurden.

Wenn der Zeitbereich nicht in den letzten 7 Tagen liegt, wird ein Fehler zurückgegeben.

Bemerkung

Wenn keine Start- oder Endzeiten angegeben sind, werden die letzten Abfragen bis zum angegebenen Limit zurückgegeben.

SESSION_ID => constant_expr

Gilt nur für QUERY_HISTORY_BY_SESSION

Der numerische Bezeichner für eine Sitzung oder CURRENT_SESSION. Es werden nur Abfragen aus der angegebenen Sitzung zurückgegeben.

Standard: CURRENT_SESSION

USER_NAME => 'string'

Gilt nur für QUERY_HISTORY_BY_USER

Eine Zeichenfolge, die den Anmeldenamen eines Benutzers oder CURRENT_USER angibt. Es werden nur Abfragen zurückgegeben, die vom angegebenen Benutzer ausgeführt wurden. Beachten Sie, dass der Anmeldename in einfache Anführungszeichen gesetzt werden muss. Wenn der Anmeldename Leerzeichen, gemischte Groß- und Kleinbuchstaben oder Sonderzeichen enthält, muss der Name innerhalb der einfachen Anführungszeichen in doppelte Anführungszeichen gesetzt werden (z. B. '"User 1"' vs. 'user1').

Standard: CURRENT_USER

WAREHOUSE_NAME => 'string'

Gilt nur für QUERY_HISTORY_BY_WAREHOUSE

Eine Zeichenfolge, die einen Warehouse-Namen angibt, oder CURRENT_WAREHOUSE. Es werden nur von diesem Warehouse ausgeführte Abfragen zurückgegeben. Beachten Sie, dass der Warehouse-Name in einfache Anführungszeichen gesetzt werden muss. Wenn der Warehouse-Name Leerzeichen, Groß- und Kleinbuchstaben oder Sonderzeichen enthält, muss der Name außerdem innerhalb der einfachen Anführungszeichen in doppelte Anführungszeichen gesetzt werden (z. B. '"My Warehouse"' vs. 'mywarehouse').

Standard: CURRENT_WAREHOUSE

RESULT_LIMIT => num

Eine Zahl, die die maximale Anzahl der von der Funktion zurückgegebenen Zeilen angibt:

Wenn die Anzahl der übereinstimmenden Zeilen größer als dieser Grenzwert ist, werden die Abfragen mit der jüngsten Endzeit (oder Abfragen, die noch ausgeführt werden) zurückgegeben – bis zum angegebenen Grenzwert.

Bereich: 1 bis 10000

Standard: 100.

Nutzungshinweise¶

• Gibt Abfragen zurück, die vom aktuellen Benutzer ausgeführt werden. Gibt auch Abfragen zurück, die von einem beliebigen Benutzer ausgeführt wurden, wenn die ausführende Rolle oder eine höhere Rolle in einer Hierarchie die Berechtigung MONITOR oder OPERATE für die Warehouses, in denen die Abfragen ausgeführt wurden. Weitere Informationen dazu finden Sie unter Berechtigungen von virtuellen Warehouses.

• Beim Aufrufen einer Tabellenfunktion des Information Schema muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder der Funktionsname muss vollqualifiziert sein. Weitere Details dazu finden Sie unter Snowflake Information Schema.

• Die Werte für die Spalten EXTERNAL_FUNCTION_TOTAL_INVOCATIONS, EXTERNAL_FUNCTION_TOTAL_SENT_ROWS, EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS, EXTERNAL_FUNCTION_TOTAL_SENT_BYTES und EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES werden von vielen Faktoren beeinflusst, darunter:

  • Anzahl der externen Funktionen in der Anweisung SQL.

  • Anzahl der Zeilen pro Batch, die an jeden Remotedienst gesendet werden.

  • Anzahl der Wiederholungen aufgrund vorübergehender Fehler (z. B. weil eine Antwort nicht innerhalb der erwarteten Zeit empfangen wurde).

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Die Spalte QUERY_TYPE kann folgende Werte enthalten:

• CREATE_USER

• CREATE_ROLE

• CREATE_NETWORK_POLICY

• ALTER_ROLE

• ALTER_NETWORK_POLICY

• ALTER_ACCOUNT

• DROP_SEQUENCE

• DROP_USER

• DROP_ROLE

• DROP_NETWORK_POLICY

• RENAME_NETWORK_POLICY

• REVOKE

Beispiele¶

Abrufen der maximal 100 letzten Abfragen, die in der aktuellen Sitzung ausgeführt wurden:

select *
from table(information_schema.query_history_by_session())
order by start_time;

Copy

Abrufen der maximal 100 letzten Abfragen, die vom aktuellen Benutzer ausgeführt wurden (oder von einem beliebigen Benutzer für eine Warehouse ausgeführt werden, bei dem der aktuelle Benutzer über die Berechtigung MONITOR verfügt):

select *
from table(information_schema.query_history())
order by start_time;

Copy

Abrufen der maximal 100 letzten Abfragen, die in der vergangenen Stunde vom aktuellen Benutzer ausgeführt wurden (oder von einem beliebigen Benutzer für ein Warehouse ausgeführt werden, bei dem der aktuelle Benutzer über die Berechtigung MONITOR verfügt):

select *
from table(information_schema.query_history(dateadd('hours',-1,current_timestamp()),current_timestamp()))
order by start_time;

Copy

Abrufen aller Abfragen, die die aktuelle Benutzer ausgeführt hat (oder von einem beliebigen Benutzer für ein Warehouse ausgeführt wurden, bei dem der aktuelle Benutzer über die Berechtigung MONITOR verfügt) innerhalb eines bestimmten 30-Minuten-Zeitblocks in den letzten 7 Tagen:

select *
  from table(information_schema.query_history(
    END_TIME_RANGE_START=>to_timestamp_ltz('2017-12-4 12:00:00.000 -0700'),
    END_TIME_RANGE_END=>to_timestamp_ltz('2017-12-4 12:30:00.000 -0700')));

Copy