SQL文の履歴統計の取得
get
/database/performance/sql_statements/{sql_id}/history
このサービスには、Oracle Diagnostics Packライセンスが必要です。指定されたSQL_IDのDBA_HIST_SQLSTATおよびDBA_HIST_SNAPSHOTレコードを返します。クライアントは、このサービスを起動するにはSQL管理者ロールが必要です。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- sql_id: string
SQL識別子。
問合せパラメータ
- limit(optional): integer(int32)
戻すレコードの最大数。
- q(optional): string
フィルタリングは、全コレクションで見つかった項目のサブセットが含まれている複数ページのリソース全体に対し、リクエストごとの動的フィルタ定義を使用してコレクション・リソースを制限する処理です。フィルタリングは、大規模なコレクションの効率的な走査を可能にします。
レスポンス
サポートされるメディア・タイプ
- application/json
200 レスポンス
指定されたSQL文の履歴統計。
ルート・スキーマ: PerformanceSQLStatementHistoryItem
タイプ:
object
タイトル:
PerformanceSQLStatementHistoryItem
このオブジェクトは、SQL統計に関する履歴情報を表します。その構造はDBA_HIST_SQLSTATに基づいています。属性のリストは、データベースのバージョンによって異なる場合があります。
ソースの表示
- count (オプション): integer(int32)
現在のレスポンス内のレコードの合計数
- hasMore(optional): boolean
取得するレコードがさらにあるかどうか
- items(optional): array items
- limit(optional): integer(int32)
サーバーによって適用されるレコード数に関する実際のページ・サイズ制限
- links(optional): array links
- offset(optional): integer(int32)
項目リソースの返戻元となる実際の索引
ネストされたスキーマ: Item5
タイプ:
object
タイトル:
ソースの表示
Item5
- action(optional): string
SQL文の初回解析時に実行中であった(DBMS_APPLICATION_INFO.SET_ACTION.をコールして設定した)アクションの名前
- apwait_delta(optional): integer(int32)
アプリケーション待機時間のデルタ値(マイクロ秒)
- apwait_total(optional): integer(int32)
アプリケーション待機時間の累積値(マイクロ秒)
- begin_interval_time(optional): string
スナップショット時間間隔の開始時
- begin_interval_time_utc(optional): string
UTCタイムゾーンにおけるスナップショット時間間隔の開始時刻
- bind_data(optional): string
バインド・データ。
- buffer_gets_delta(optional): integer(int32)
この子カーソルに対するバッファ取得のデルタ数
- buffer_gets_total(optional): integer(int32)
この子カーソルに対するバッファ取得の累積数
- ccwait_delta(optional): integer(int32)
同時実行性待機時間のデルタ値(マイクロ秒)
- ccwait_total(optional): integer(int32)
同時実行性待機時間の累積値(マイクロ秒)
- cell_uncompressed_bytes_delta(optional): integer(int32)
Exadataセルにオフロードされる圧縮解除済バイト数(解凍後のサイズ)のデルタ値
- cell_uncompressed_bytes_total(optional): integer(int32)
Exadataセルにオフロードされる圧縮解除済バイト数(解凍後のサイズ)の累積値
- clwait_delta(optional): integer(int32)
クラスタ待機時間のデルタ値(マイクロ秒)
- clwait_total(optional): integer(int32)
クラスタ待機時間の累積値(マイクロ秒)
- con_dbid(optional): integer(int32)
サンプリングされたセッションのPDBのデータベースID
- con_id(optional): integer(int32)
CON_DBIDで識別されるコンテナのID。
- cpu_time_delta(optional): integer(int32)
このカーソルによって、解析、実行またはフェッチのために使用されたCPU時間(マイクロ秒)のデルタ値
- cpu_time_total(optional): integer(int32)
このカーソルによって、解析、実行またはフェッチのために使用されたCPU時間(マイクロ秒)の累積値
- dbid(optional): integer(int32)
スナップショットのデータベースID
- direct_writes_delta(optional): integer(int32)
direct writesのデルタ値
- direct_writes_total(optional): integer(int32)
direct writesの累積値
- disk_reads_delta(optional): integer(int32)
この子カーソルに対するディスク読取りのデルタ数
- disk_reads_total(optional): integer(int32)
この子カーソルに対するディスク読取りの累積数
- elapsed_time_delta(optional): integer(int32)
このカーソルによって、解析、実行またはフェッチのために使用された経過時間(マイクロ秒)のデルタ値
- elapsed_time_delta_s_per_exec(optional): number(double)
記録されたすべての実行にわたる解析/実行/フェッチの平均経過時間(秒)
- elapsed_time_total(optional): integer(int32)
このカーソルによって、解析、実行またはフェッチのために使用された経過時間(マイクロ秒)の累積値カーソルがパラレル実行を使用する場合、ELAPSED_TIME_TOTALは、問合せコーディネータへの時間にすべてのパラレル問合せスレーブ処理を加えた累積時間です。
- end_interval_time(optional): string
スナップショット時間間隔の終了時(実際にスナップショットが取得された時間)
- end_of_fetch_count_delta(optional): integer(int32)
カーソルがライブラリ・キャッシュに入れられた後で、このカーソルが完全に実行されたデルタ回数。カーソルが正常に実行されなかったか、カーソルがクローズまたは再実行される前にこのカーソルによって生成された先頭の数列のみフェッチされたため、カーソルが部分的に実行された場合、この統計の値は増分されない。
- end_of_fetch_count_total(optional): integer(int32)
カーソルがライブラリ・キャッシュに入れられた後で、このカーソルが完全に実行された回数の累積。カーソルが正常に実行されなかったか、カーソルがクローズまたは再実行される前にこのカーソルによって生成された先頭の数列のみフェッチされたため、カーソルが部分的に実行された場合、この統計の値は増分されない。END_OF_FETCH_COUNT列の値は、EXECUTIONS列の値以下に定義される。
- error_count(optional): integer(int32)
特定のスナップショットの表で発生したエラー数
- executions_delta(optional): integer(int32)
このオブジェクトがライブラリ・キャッシュに入れられた後で行われた実行のデルタ数
- executions_total(optional): integer(int32)
このオブジェクトがライブラリ・キャッシュに入れられた後で行われた実行の累積数
- fetches_delta(optional): integer(int32)
SQL文に関連するフェッチのデルタ数
- fetches_total(optional): integer(int32)
SQL文に関連するフェッチの累積数
- flush_elapsed(optional): string
スナップショットの実行時間
- force_matching_signature(optional): integer(int32)
CURSOR_SHARINGパラメータがFORCEに設定されたときに使用されるシグネチャ
- instance_number(optional): integer(int32)
スナップショットのインスタンス番号
- invalidations_delta(optional): integer(int32)
この子カーソルが無効にされた回数のデルタ値
- invalidations_total(optional): integer(int32)
この子カーソルが無効にされた回数の累積値
- io_interconnect_bytes_delta(optional): integer(int32)
Oracle Databaseとストレージ・システムの間で交換されたI/Oのバイト数のデルタ値
- io_interconnect_bytes_total(optional): integer(int32)
Oracle Databaseとストレージ・システムの間で交換されたI/Oのバイト数の累積値
- io_offload_elig_bytes_delta(optional): integer(int32)
Exadataストレージ・システムによるフィルタリングが可能なI/Oのバイト数のデルタ値
- io_offload_elig_bytes_total(optional): integer(int32)
Exadataストレージ・システムによるフィルタリングが可能なI/Oのバイト数の累積値
- io_offload_return_bytes_delta(optional): integer(int32)
スマート・スキャンのみの場合にExadataセルから戻されるバイト数(他のデータベースI/Oのバイト数は含まない).のデルタ値
- io_offload_return_bytes_total(optional): integer(int32)
スマート・スキャンのみの場合にExadataセルから戻されるバイト数(他のデータベースI/Oのバイト数は含まない).の累積値
- iowait_delta(optional): integer(int32)
ユーザーI/O待機時間のデルタ値(マイクロ秒)
- iowait_total(optional): integer(int32)
ユーザーI/O待機時間の累積値(マイクロ秒)
- javexec_time_delta(optional): integer(int32)
Java実行時間のデルタ値(マイクロ秒)
- javexec_time_total(optional): integer(int32)
Java実行時間の累積値(マイクロ秒)
- loaded_versions(optional): integer(int32)
コンテキスト・ヒープがロードされるかどうか(1 | 0)
- loads_delta(optional): integer(int32)
オブジェクトがロードまたは再ロードされた回数のデルタ値
- loads_total(optional): integer(int32)
オブジェクトがロードまたは再ロードされた回数の累積値
- module(optional): string
SQL文の初回解析時に実行中であった(DBMS_APPLICATION_INFO.SET_MODULE.をコールして設定した)モジュールの名前
- optimized_physical_reads_delta(optional): integer(int32)
監視対象SQLによるデータベース・スマート・フラッシュ・キャッシュまたはExadataスマート・フラッシュ・キャッシュからの物理読取り数のデルタ値
- optimized_physical_reads_total(optional): integer(int32)
監視対象SQLによるデータベース・スマート・フラッシュ・キャッシュまたはExadataスマート・フラッシュ・キャッシュからの物理読取り数の累積値
- optimizer_cost(optional): integer(int32)
オプティマイザによる問合せのコスト
- optimizer_env_hash_value(optional): integer(int32)
オプティマイザ環境のハッシュ値
- optimizer_mode(optional): string
SQL文が実行されるモード
- parse_calls_delta(optional): integer(int32)
この子カーソルに対する解析コールのデルタ数
- parse_calls_total(optional): integer(int32)
この子カーソルに対する解析コールの累積数
- parsing_schema_id(optional): integer(int32)
この子カーソルの作成に使用されたスキーマID
- parsing_schema_name(optional): string
この子カーソルの作成に使用されたスキーマ名
- parsing_user_id(optional): integer(int32)
この子カーソルの作成に使用されたユーザーID
- physical_read_bytes_delta(optional): integer(int32)
監視対象のSQLによってディスクから読み取られたバイト数のデルタ値
- physical_read_bytes_total(optional): integer(int32)
監視対象のSQLによってディスクから読み取られたバイト数の累積値
- physical_read_requests_delta(optional): integer(int32)
監視対象のSQLによって発行された物理読取りI/O要求の数のデルタ値
- physical_read_requests_total(optional): integer(int32)
監視対象のSQLによって発行された物理読取りI/O要求の数の累積値
- physical_write_bytes_delta(optional): integer(int32)
監視対象のSQLによってディスクに書き込まれたバイト数のデルタ値
- physical_write_bytes_total(optional): integer(int32)
監視対象のSQLによってディスクに書き込まれたバイト数の累積値
- physical_write_requests_delta(optional): integer(int32)
監視対象のSQLによって発行された物理書込みI/O要求の数のデルタ値
- physical_write_requests_total(optional): integer(int32)
監視対象のSQLによって発行された物理書込みI/O要求の数の累積値
- plan_hash_value(optional): integer(int32)
カーソルに対するSQLプランの数値表現。PLAN_HASH_VALUEの値を別の値と比較すると、2つのプランが同じかどうかを(2つのプランを行単位で比較するより)容易に識別できる。
- plsexec_time_delta(optional): integer(int32)
PL/SQL実行時間のデルタ値(マイクロ秒)
- plsexec_time_total(optional): integer(int32)
PL/SQL実行時間の累積値(マイクロ秒)
- px_servers_execs_delta(optional): integer(int32)
PXサーバー実行のデルタ値
- px_servers_execs_total(optional): integer(int32)
PXサーバー実行の累積数
- rows_processed_delta(optional): integer(int32)
解析されたSQL文が戻す行数のデルタ値
- rows_processed_total(optional): integer(int32)
解析されたSQL文が戻す行数の累積値
- sharable_mem(optional): integer(int32)
その子カーソルに使用されている共有メモリーのバイト数
- snap_flag(optional): integer(int32)
スナップショットが挿入された条件。
- snap_id(optional): integer(int32)
一意のスナップショットID。
- snap_timezone(optional): string
UTC(協定世界時)タイム・ゾーンからのオフセットとして表現されたスナップショットのタイム・ゾーン
- sorts_delta(optional): integer(int32)
この子カーソルに対して実行されたソートのデルタ数
- sorts_total(optional): integer(int32)
この子カーソルに対して実行されたソートの累積数
- sql_id(optional): string
ライブラリ・キャッシュ内の親カーソルのSQL識別子
- sql_profile(optional): string
適用されたSQLプロファイルの名前
- startup_time(optional): string
インスタンスの起動時間
- sum_executions_delta(optional): integer(int32)
このオブジェクトがライブラリ・キャッシュに入れられた後でこのオブジェクト上で発生したすべての実行の合計数
- version_count(optional): integer(int32)
カーソルに関連付けられた子の数