ジャンプ先

• リクエスト
• レスポンス

監視対象の文に関する情報の取得

get

/database/performance/sql_statements/{sql_id}/monitor/{sql_exec_id},{sql_exec_start}/

このサービスには、Oracle Tuning Packライセンスが必要です。GV$SQL_MONITORビューから監視対象の文の情報を返します。クライアントは、このサービスを起動するにはSQL管理者ロールが必要です。

リクエスト

パス・パラメータ

• sql_exec_id(required): number
  実行識別子。
• sql_exec_start(required): string(date-time)
  実行の開始時刻
• sql_id(required): string
  SQL識別子。

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

200 レスポンス

監視対象のSQL文の説明。

本文 ()

ルート・スキーマ: PerformanceSQLStatementMonitorsItem

タイプ: object

このオブジェクトは、1つのSQL文の単一の実行に関する統計情報を提供します。属性のリストは、データベースのバージョンによって異なる場合があります。

ソースの表示

• action: string
  DBMS_APPLICATION_INFO.SET_ACTIONプロシージャによって設定された、サンプリング時の実行アクションの名前
• application_wait_time: integer
  アプリケーション待機時間(マイクロ秒)。文の実行時に更新される。
• binds_xml: string
  SQLとともに使用されるバインド変数の情報で、名前、位置、値、データ・タイプなど(XML形式で格納される)
• buffer_gets: integer
  バッファ取得操作数。文の実行時に更新される。
• client_identifier: string
  ユーザー・セッションのクライアント識別子
• client_info: string
  ユーザー・セッションのクライアント情報
• cluster_wait_time: integer
  クラスタの待機時間(マイクロ秒)。文の実行時に更新される。
• con_id: integer
  データが関係するコンテナのID。
• con_name: string
  オブジェクトのコンテナ名。非CDBでは、この列の値はNULLです。
• concurrency_wait_time: integer
  同時実行性待機時間(マイクロ秒)。文の実行時に更新される。
• cpu_time: integer
  CPU時間(マイクロ秒)。文の実行時に更新される。
• current_user: integer
  現在のユーザーを識別する一意の番号
• current_username: integer
  現在のユーザーのユーザー名
• dbop_exec_id: integer
  現在の実行に対するデータベース操作実行識別子。タイプがSQLの場合、DBOP_EXEC_IDはNULLとなる。
• dbop_name: string
  データベース操作名。タイプがSQLの場合、DBOP_NAMEはNULLとなる。
• direct_writes: integer
  直接書込み数。文の実行時に更新される。
• disk_reads: integer
  ディスク読取り数。文の実行時に更新される。
• ecid: string
  アプリケーション・サーバーから送信された実行コンテキスト識別子
• elapsed_time: integer
  経過時間(マイクロ秒)。文の実行時に更新される。
• error_facility: string
  SQLが実行に失敗した場合に示されるエラー機構(たとえば、ORA-00932の場合はORA)
• error_message: string
  SQLが実行に失敗した場合に表示される詳細なエラー・メッセージ(エラー番号およびエラー機構に対応している)
• error_number: string
  SQLが実行に失敗した場合に示されるエラー番号(たとえば、ORA-00932の場合は932)
• exact_matching_signature: integer
  正規化されたSQLテキストに対して計算されたシグネチャ。正規化には、空白の削除と非リテラル文字列の大文字化が含まれる。
• fetches: integer
  SQL文に関連するフェッチ数。文の実行時に更新される。
• first_refresh_time: string
  SQL文の監視が開始した時刻。通常は、SQL実行開始時刻の数秒後。
• force_matching_signature: integer
  EXACT_MATCHING_SIGNATUREと同じ。ただし、SQLテキストのリテラルはバインドによって置換される。
• in_dbop_exec_id: integer
  監視されているSQLが、それもまたデータベース操作(DBOP)によって監視されているセッションで実行された場合は、この列にはそのDBOの実行IDを指定する
• in_dbop_name: string
  監視されているSQLが、それもまたデータベース操作(DBOP)によって監視されているセッションで実行された場合は、この列にはそのDBOPの名前を指定する
• inst_id: integer
  関連するGV$SQL_MONITORビュー情報の取得元のインスタンス番号
• io_cell_offload_eligible_bytes: integer
  Exadataストレージ・システムによるフィルタリングが可能なI/Oのバイト数
• io_cell_offload_returned_bytes: integer
  Exadataセルによって戻された、フィルタ処理されたバイト数(処理がExadataセルでオフロードされた後に戻されたバイト数)
• io_cell_uncompressed_bytes: integer
  Exadataセルにオフロードされる非圧縮バイト数(解凍後のサイズ)
• io_interconnect_bytes: integer
  Oracle Databaseとストレージ・システムの間で交換されたI/Oのバイト数。
• is_adaptive_plan: string
  統計が適応可能なプランからのものか(Y)そうでないか(N)を示す。
• is_final_plan: string
  統計が最終プランからのものか(Y)そうでないか(N)を示す。
• is_full_sqltext: string
  SQL_TEXT列にすべてのSQLテキストが含まれているかどうか(Y | N)
• java_exec_time: integer
  Java実行時間(マイクロ秒)。文の実行時に更新される。
• key: integer
  GV$SQL_MONITORをGV$SQL_PLAN_MONITORに格納された対応するプラン・レベル監視統計と効率的に結合するための人為的な結合キー
• last_refresh_time: string
  V$SQL_MONITOR内のSQL文の統計が前回更新された時刻。文の実行中は、統計が通常毎秒リフレッシュされる。
• links: array links
• module: string
  DBMS_APPLICATION_INFO.SET_MODULEプロシージャによって設定された、サンプリング時の実行モジュールの名前
• other_xml: string
  XML形式で格納される、SQL実行文に関する追加情報
• physical_read_bytes: integer
  監視対象のSQLによってディスクから読み取られたバイト数。
• physical_read_requests: integer
  監視対象のSQLによって発行された物理読取りI/O要求の数。
• physical_write_bytes: integer
  監視対象のSQLによってディスクに書き込まれたバイト数。
• physical_write_requests: integer
  監視対象のSQLによって発行された物理書込みI/O要求の数。
• plsql_entry_object_id: integer
  スタック上の最上位PL/SQLサブプログラムのオブジェクトID(PL/SQLサブプログラムがスタック上にない場合は、NULL)。
• plsql_entry_subprogram_id: integer
  スタック上の最上位PL/SQLサブプログラムのサブプログラムID(PL/SQLサブプログラムがスタック上にない場合は、NULL)
• plsql_exec_time: integer
  PL/SQL実行時間(マイクロ秒)。文の実行時に更新される。
• plsql_object_id: integer
  現在実行中のPL/SQLサブプログラムのオブジェクトID(SQLの実行中はNULL)
• plsql_subprogram_id: integer
  現在実行中のPL/SQLオブジェクトのサブプログラムID(SQLの実行中はNULL)。
• process_name: string
  その文を実行している(または実行を完了した)プロセスの名前識別子。プロセスがフォアグラウンドの場合はora。それ以外の場合は、バックグラウンド・プロセス名(たとえば、PXサーバーp001の場合はp001)。
• program: string
  監視SQLを発行したオペレーティング・システム・プログラムの名前
• px_is_cross_instance: string
  SQL文が複数のインスタンスにまたがってパラレルに実行されたかどうか(Y | N)
• px_maxdop: integer
  監視対象のSQLのかわりに実行されたプラン操作の最大並列度
• px_maxdop_instances: integer
  最大並列度でアクセスされたデータベース・インスタンスの数
• px_qcinst_id: integer
  パラレル実行コーディネータが実行されているインスタンス識別子。PX_SERVER#がNULLの場合はNULL。
• px_qcsid: integer
  パラレル実行コーディネータのセッション識別子。PX_SERVER#がNULLの場合はNULL。
• px_server#: integer
  監視対象の文を実行している(または実行を完了した)論理パラレル実行サーバーのプロセス番号。この監視エントリが実行サーバーに関連付けられていない場合はNULL。これは、パラレル・サーバー・セット内の論理番号(V$PX_SESSIONのSERVER#を参照)。
• px_server_group: integer
  PX_SERVER#が属する論理パラレル実行サーバーのグループ番号(V$PX_SESSIONのSERVER_GROUPを参照)。この監視エントリがパラレル実行サーバーに関連付けられていない場合はNULL。SQL文に1つ以上のパラレル副問合せが含まれない場合、この値は通常1。
• px_server_set: integer
  PX_SERVER#が属するパラレル実行サーバーの論理セットの番号で、1または2(V$PX_SESSIONのSERVER_SETを参照)。この監視エントリがパラレル実行サーバーに関連付けられていない場合はNULL。
• px_servers_allocated: integer
  問合せを実行するために割り当てられたパラレル実行サーバーの実際の数
• px_servers_requested: integer
  監視対象のSQLの実行を要求されたパラレル実行サーバーの合計数
• queuing_time: integer
  文のキューでSQLが費した時間(マイクロ秒)
• refresh_count: integer
  V$SQL_MONITOR統計がリフレッシュされた回数(通常、SQL文実行中の1秒に1回)
• report_id: integer
  この監視エンティティについて自動ワークロード・リポジトリ(AWR)に保管されたXMLレポートの固有ID
• rm_consumer_group: string
  このSQL操作の現在のコンシューマ・グループ
• rm_last_action: string
  このSQL操作に対してリソース・マネージャによって実行された最新のアクション。
• rm_last_action_reason: string
  このSQL操作に対してリソース・マネージャによって実行された最新のアクションの理由。
• rm_last_action_time: string
  このSQL操作に対してリソース・マネージャによって実行された最新のアクションの時間。
• service_name: string
  ユーザー・セッションのサービス名
• session_serial#: integer
  監視対象の文を実行しているセッション・シリアル番号
• sid: integer
  監視されているSQL文を実行している(または実行した)セッション識別子。
• sql_child_address: string
  子カーソルのアドレス(SQL_IDとともに使用してGV$SQLと結合できる)
• sql_exec_id: integer
  実行識別子。3つの列SQL_ID、SQL_EXEC_STARTおよびSQL_EXEC_IDは、ともに同じ実行キーを表す。この実行キーは、SQL文の1回の実行を一意に識別するために使用される。
• sql_exec_start: string
  実行の開始時刻
• sql_full_plan_hash_value: integer
  このカーソルに対する完全なSQLプランの数値表現。あるSQL_FULL_PLAN_HASH_VALUEの値を別の値と比較すると、2つのプランが同じかどうかを(2つのプランを行単位で比較するより)容易に識別できる。SQL_FULL_PLAN_HASH_VALUEは、複数のデータベース・リリースにまたがって比較することはできないので注意。下位互換性はない。
• sql_id: string
  監視されている文のSQL識別子。
• sql_plan_hash_value: integer
  SQLプランのハッシュ値
• sql_text: string
  監視対象のSQLテキストの最初の2000文字(最大)
• status: string
  SQL実行ステータス。
• user#: integer
  監視対象のSQLを発行したデータベース・ユーザーのユーザーID
• user_io_wait_time: integer
  ユーザーI/O待機時間(マイクロ秒)。文の実行時に更新される。
• username: string
  監視対象のSQLを発行したデータベース・ユーザーのユーザー名

{
    "type":"object",
    "description":"This object provides statistics for a single execution of an SQL statement. The list of attributes may vary depending on database version.",
    "properties":{
        "inst_id":{
            "type":"integer",
            "description":"Instance number from which the associated GV$SQL_MONITOR view information was obtained."
        },
        "key":{
            "type":"integer",
            "description":"Artificial join key to efficiently join GV$SQL_MONITOR with its corresponding plan level monitoring statistics stored in GV$SQL_PLAN_MONITOR."
        },
        "report_id":{
            "type":"integer",
            "description":"Unique ID of the XML report stored in Automatic Workload Repository (AWR) for this monitored entity."
        },
        "status":{
            "type":"string",
            "description":"SQL execution status."
        },
        "user#":{
            "type":"integer",
            "description":"User ID of the database user who issued the SQL being monitored."
        },
        "username":{
            "type":"string",
            "description":"User name of the database user who issued the SQL being monitored."
        },
        "module":{
            "type":"string",
            "description":"Name of the executing module when sampled, as set by the DBMS_APPLICATION_INFO.SET_MODULE procedure."
        },
        "action":{
            "type":"string",
            "description":"Name of the executing action when sampled, as set by the DBMS_APPLICATION_INFO.SET_ACTION procedure."
        },
        "service_name":{
            "type":"string",
            "description":"Service name of the user session."
        },
        "client_identifier":{
            "type":"string",
            "description":"Client identifier from the user session."
        },
        "client_info":{
            "type":"string",
            "description":"Client information for the user session."
        },
        "program":{
            "type":"string",
            "description":"Name of the operating system program that issued the monitored SQL."
        },
        "plsql_entry_object_id":{
            "type":"integer",
            "description":"Object ID of the top-most PL/SQL subprogram on the stack; NULL if there is no PL/SQL subprogram on the stack."
        },
        "plsql_entry_subprogram_id":{
            "type":"integer",
            "description":"Subprogram ID of the top-most PL/SQL subprogram on the stack; NULL if there is no PL/SQL subprogram on the stack."
        },
        "plsql_object_id":{
            "type":"integer",
            "description":"Object ID of the currently executing PL/SQL subprogram; NULL if executing SQL."
        },
        "plsql_subprogram_id":{
            "type":"integer",
            "description":"Subprogram ID of the currently executing PL/SQL object; NULL if executing SQL."
        },
        "first_refresh_time":{
            "type":"string",
            "description":"Time when monitoring of the SQL statement started, generally a few seconds after execution start time."
        },
        "last_refresh_time":{
            "type":"string",
            "description":"Time when statistics in V$SQL_MONITOR were last updated for the SQL statement. Statistics are generally refreshed every second when the statement executes."
        },
        "refresh_count":{
            "type":"integer",
            "description":"Number of times V$SQL_MONITOR statistics have been refreshed (generally once every second when the SQL statement executes)."
        },
        "dbop_exec_id":{
            "type":"integer",
            "description":"Database operation execution identifier for the current execution. If the type is SQL, the DBOP_EXEC_ID will be NULL."
        },
        "dbop_name":{
            "type":"string",
            "description":"Database operation name. If the type is SQL, the DBOP_NAME will be NULL."
        },
        "sid":{
            "type":"integer",
            "description":"Session identifier executing (or having executed) the SQL statement being monitored."
        },
        "process_name":{
            "type":"string",
            "description":"Process name identifier executing (or having executed)the statement; ora if the process is foreground, else the background process name (for example, p001 for PX server p001)."
        },
        "sql_id":{
            "type":"string",
            "description":"SQL identifier of the statement being monitored."
        },
        "sql_text":{
            "type":"string",
            "description":"Up to the first 2000 characters of the text of the SQL being monitored."
        },
        "is_full_sqltext":{
            "type":"string",
            "description":"Indicates whether the SQL_TEXT column has the entire SQL text (Y) or not (N)."
        },
        "sql_exec_start":{
            "type":"string",
            "description":"Time when the execution started."
        },
        "sql_exec_id":{
            "type":"integer",
            "description":"Execution identifier. Together, the three columns SQL_ID, SQL_EXEC_START, and SQL_EXEC_ID represent the execution key. The execution key is used to uniquely identify one execution of the SQL statement."
        },
        "sql_plan_hash_value":{
            "type":"integer",
            "description":"SQL plan hash value."
        },
        "sql_full_plan_hash_value":{
            "type":"integer",
            "description":"Numeric representation of the complete SQL plan for this cursor. Comparing one SQL_FULL_PLAN_HASH_VALUE to another easily identifies whether or not two plans are the same (rather than comparing the two plans line by line). Note that the SQL_FULL_PLAN_HASH_VALUE cannot be compared across databases releases. It is not backward compatible."
        },
        "exact_matching_signature":{
            "type":"integer",
            "description":"Signature calculated on the normalized SQL text. The normalization includes the removal of white space and the uppercasing of all non-literal strings."
        },
        "force_matching_signature":{
            "type":"integer",
            "description":"Same as EXACT_MATCHING_SIGNATURE but literals in the SQL text are replaced by binds."
        },
        "sql_child_address":{
            "type":"string",
            "description":"Address of the child cursor (can be used with SQL_ID to join with GV$SQL)."
        },
        "session_serial#":{
            "type":"integer",
            "description":"Session serial number executing the statement being monitored."
        },
        "px_is_cross_instance":{
            "type":"string",
            "description":"Indicates whether the SQL statement ran parallel across multiple instances (Y) or not (N)."
        },
        "px_maxdop":{
            "type":"integer",
            "description":"Maximum degree of parallelism for any plan operation executed on behalf of the monitored SQL."
        },
        "px_maxdop_instances":{
            "type":"integer",
            "description":"Number of database instances touched at the maximum degree of parallelism."
        },
        "px_servers_requested":{
            "type":"integer",
            "description":"Total number of parallel execution servers requested to execute the monitored SQL."
        },
        "px_servers_allocated":{
            "type":"integer",
            "description":"Actual number of parallel execution servers allocated to execute the query"
        },
        "px_server#":{
            "type":"integer",
            "description":"Logical parallel execution server process number executing (or having executed) the statement being monitored; NULL if this monitoring entry is not associated with an execution server. This is a logical number within the parallel server set (see SERVER# in V$PX_SESSION)."
        },
        "px_server_group":{
            "type":"integer",
            "description":"Logical parallel execution server group number to which PX_SERVER# belongs (see SERVER_GROUP in V$PX_SESSION); NULL if this monitoring entry is not associated with a parallel execution server. This value is generally 1 unless the SQL statement has one or more parallel sub-queries."
        },
        "px_server_set":{
            "type":"integer",
            "description":"Number (1 or 2) of the logical set of parallel execution servers to which PX_SERVER# belongs (see SERVER_SET in V$PX_SESSION); NULL if this monitoring entry is not associated with a parallel execution server."
        },
        "px_qcinst_id":{
            "type":"integer",
            "description":"Instance identifier where the parallel execution coordinator runs; NULL if PX_SERVER# is NULL."
        },
        "px_qcsid":{
            "type":"integer",
            "description":"Session identifier for the parallel execution coordinator; NULL if PX_SERVER# is NULL."
        },
        "error_number":{
            "type":"string",
            "description":"Error number encountered in case a SQL fails to execute successfully (for example, 932 in case of ORA-00932)."
        },
        "error_facility":{
            "type":"string",
            "description":"Error facility in case a SQL fails to execute successfully (for example, ORA in case of ORA-00932)."
        },
        "error_message":{
            "type":"string",
            "description":"Detailed error message displayed corresponding to the error number and error facility when a SQL fails to execute successfully."
        },
        "binds_xml":{
            "type":"string",
            "description":"Information about bind variables used with the SQL, such as name, position, value, data type, and so on (stored in XML format)."
        },
        "other_xml":{
            "type":"string",
            "description":"Additional information about SQL execution stored in XML format."
        },
        "elapsed_time":{
            "type":"integer",
            "description":"Elapsed time (in microseconds); updated as the statement executes."
        },
        "queuing_time":{
            "type":"integer",
            "description":"Duration of time (in microseconds) spent by SQL in the statement queue."
        },
        "cpu_time":{
            "type":"integer",
            "description":"CPU time (in microseconds); updated as the statement executes."
        },
        "fetches":{
            "type":"integer",
            "description":"Number of fetches associated with the SQL statement; updated as the statement executes."
        },
        "buffer_gets":{
            "type":"integer",
            "description":"Number of buffer get operations; updated as the statement executes."
        },
        "disk_reads":{
            "type":"integer",
            "description":"Number of disk reads; updated as the statement executes."
        },
        "direct_writes":{
            "type":"integer",
            "description":"Number of direct writes; updated as the statement executes."
        },
        "io_interconnect_bytes":{
            "type":"integer",
            "description":"Number of I/O bytes exchanged between Oracle Database and the storage system."
        },
        "physical_read_requests":{
            "type":"integer",
            "description":"Number of physical read I/O requests issued by the monitored SQL."
        },
        "physical_read_bytes":{
            "type":"integer",
            "description":"Number of bytes read from disks by the monitored SQL."
        },
        "physical_write_requests":{
            "type":"integer",
            "description":"Number of physical write I/O requests issued by the monitored SQL."
        },
        "physical_write_bytes":{
            "type":"integer",
            "description":"Number of bytes written to disks by the monitored SQL."
        },
        "application_wait_time":{
            "type":"integer",
            "description":"Application wait time (in microseconds); updated as the statement executes."
        },
        "concurrency_wait_time":{
            "type":"integer",
            "description":"Concurrency wait time (in microseconds); updated as the statement executes."
        },
        "cluster_wait_time":{
            "type":"integer",
            "description":"Cluster wait time (in microseconds); updated as the statement executes."
        },
        "user_io_wait_time":{
            "type":"integer",
            "description":"User I/O Wait Time (in microseconds); updated as the statement executes."
        },
        "plsql_exec_time":{
            "type":"integer",
            "description":"PL/SQL execution time (in microseconds); updated as the statement executes."
        },
        "java_exec_time":{
            "type":"integer",
            "description":"Java execution time (in microseconds); updated as the statement executes."
        },
        "rm_last_action":{
            "type":"string",
            "description":"The most recent action that was taken on this SQL operation by Resource Manager."
        },
        "rm_last_action_reason":{
            "type":"string",
            "description":"The reason for the most recent action that was taken on this SQL operation by Resource Manager."
        },
        "rm_last_action_time":{
            "type":"string",
            "description":"The time of the most recent action that was taken on this SQL operation by Resource Manager."
        },
        "rm_consumer_group":{
            "type":"string",
            "description":"The current consumer group for this SQL operation."
        },
        "con_id":{
            "type":"integer",
            "description":"The ID of the container to which the data pertains."
        },
        "con_name":{
            "type":"string",
            "description":"Container name of the object. The value of this column is NULL in non-CDBs."
        },
        "ecid":{
            "type":"string",
            "description":"Execution context identifier (sent by Application Server)."
        },
        "is_adaptive_plan":{
            "type":"string",
            "description":"Indicates whether the statistics are from an adaptive plan (Y) or not (N)."
        },
        "is_final_plan":{
            "type":"string",
            "description":"Indicates whether the statistics are from the final plan (Y) or not (N)."
        },
        "in_dbop_name":{
            "type":"string",
            "description":"If the SQL that is monitored was executed by a session that was also monitored by a database operation (DBOP), then this column specifies the name of that DBOP."
        },
        "in_dbop_exec_id":{
            "type":"integer",
            "description":"If the SQL that is monitored was executed by a session that was also monitored by a database operation (DBOP), then this column specifies the execution ID of that DBO."
        },
        "io_cell_uncompressed_bytes":{
            "type":"integer",
            "description":"Number of uncompressed bytes (that is, size after decompression) that are offloaded to the Exadata cells."
        },
        "io_cell_offload_eligible_bytes":{
            "type":"integer",
            "description":"Number of I/O bytes which can be filtered by the Exadata storage system."
        },
        "io_cell_offload_returned_bytes":{
            "type":"integer",
            "description":"Number of filtered bytes returned by Exadata cells (that is, the number of bytes returned after  processing has been offloaded on the Exadata cells)."
        },
        "current_user":{
            "type":"integer",
            "description":"Unique number identifying the current user."
        },
        "current_username":{
            "type":"integer",
            "description":"Username for the current user."
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/LinkRelation"
            }
        }
    }
}

ネストされたスキーマ: links

タイプ: array

ソースの表示

• 配列: オブジェクト LinkRelation

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/LinkRelation"
    }
}

ネストされたスキーマ: LinkRelation

タイプ: object

ソースの表示

• href(required): string
• rel(required): string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "required":[
        "rel",
        "href"
    ]
}

先頭に戻る