QUERY_HISTORY , QUERY_HISTORY_BY_*¶

構文¶

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> ] )

引数¶

すべての引数はオプションです。

END_TIME_RANGE_START => constant_expr、 . END_TIME_RANGE_END => constant_expr

クエリの実行が完了した過去7日以内の時間範囲（TIMESTAMP_LTZ 形式）：

• END_TIME_RANGE_END が指定されていない場合、関数はまだ実行中のクエリを含むすべてのクエリを返します。

• END_TIME_RANGE_END が CURRENT_TIMESTAMP の場合、関数は完了したクエリのみを返します。

時間範囲が過去7日以内に収まらない場合、エラーが返されます。

注釈

開始時刻または終了時刻が指定されていない場合、指定された制限までの最新のクエリが返されます。

SESSION_ID => constant_expr

QUERY_HISTORY_BY_SESSION にのみ適用

セッションの数値識別子または CURRENT_SESSION です。指定されたセッションからのクエリのみが返されます。

デフォルト: CURRENT_SESSION

USER_NAME => 'string'

QUERY_HISTORY_BY_USER にのみ適用

ユーザーログイン名または CURRENT_USER を指定する文字列です。指定したユーザーが実行したクエリのみが返されます。ログイン名は一重引用符で囲む必要があります。また、ログイン名にスペース、大文字と小文字の混在、または特殊文字がある場合、名前は二重引用符を一重引用符内で囲む必要があります（例： '"User 1"' と 'user1'）。

デフォルト: CURRENT_USER

WAREHOUSE_NAME => 'string'

QUERY_HISTORY_BY_WAREHOUSE にのみ適用

ウェアハウス名または CURRENT_WAREHOUSE を指定する文字列です。そのウェアハウスによって実行されたクエリのみが返されます。ウェアハウス名は一重引用符で囲む必要があります。また、ウェアハウス名にスペース、大文字と小文字の混在、または特殊文字がある場合、名前は二重引用符を一重引用符内で囲む必要があります（例： '"My Warehouse"' と 'mywarehouse'）。

デフォルト: CURRENT_WAREHOUSE

RESULT_LIMIT => num

関数によって返される行の最大数を指定する数値です。

一致する行の数がこの制限よりも大きい場合、指定された制限まで、最新の終了時刻（またはまだ実行中のもの）のクエリが返されます。

範囲： 1 ～ 10000

デフォルト： 100

使用上の注意¶

• 現在のユーザーが実行したクエリを返します。また、実行ロールまたは階層内の上位ロールが、クエリが実行されたウェアハウスに対する MONITOR または OPERATE 権限を持っている場合に、任意のユーザーによって実行されたクエリを返します。詳細については、 仮想ウェアハウス権限 をご参照ください。

• Information Schemaテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマ または 完全修飾された関数名が必要です。詳細については、 Snowflake Information Schema をご参照ください。

• 列 EXTERNAL_FUNCTION_TOTAL_INVOCATIONS、 EXTERNAL_FUNCTION_TOTAL_SENT_ROWS、 EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS、 EXTERNAL_FUNCTION_TOTAL_SENT_BYTES、および EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES の値は、多くの要因の影響を受けます。要因には次のようなものがあります。

  • SQL ステートメント内の外部関数の数。

  • 各リモートサービスに送信されたバッチあたりの行数。

  • 一時的なエラーによる再試行の数（例：予期した時間内に応答が受信されなかった）。

出力¶

この関数は、次の列を返します。

QUERY_TYPE 列の潜在的な値は次のとおりです。

• 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

例¶

現在のセッションで実行された最後の100クエリまで取得します。

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

Copy

現在のユーザー（または現在のユーザーが MONITOR 権限を持つウェアハウスの任意のユーザー）によって実行された最後の100クエリまで取得します。

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

Copy

過去1時間に現在のユーザー（または、現在のユーザーが MONITOR 権限を持つウェアハウスの任意のユーザー）によって実行された最後の100クエリまで取得します。

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

Copy

過去7日以内の指定された30分ブロック内に、現在のユーザー（または現在のユーザーが MONITOR 権限を持つ任意のウェアハウスのユーザー）によって実行されたすべてのクエリを取得します。

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