ジャンプ先

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

SQL文の統計の取得

get

/database/performance/sql_statements/{sql_id}/

このサービスには、Oracle Tuning Packライセンスが必要です。指定されたSQL文識別子のGV$SQL_MONITORタイミング・データを使用して、GV$SQLからデータを返します。クライアントは、このサービスを起動するにはSQL管理者ロールが必要です。

リクエスト

パス・パラメータ

• sql_id(required): string
  SQL識別子。

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

先頭に戻る

レスポンス

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

• application/json

200 レスポンス

SQL文の統計。

本文 ()

ルート・スキーマ: PerformanceSQLStatementsItem

タイプ: object

このオブジェクトは、1つのSQL文について説明します。属性のリストは、データベースのバージョンによって異なる場合があります。

ソースの表示

• con_id: integer
  データが関係するコンテナのID。
• cpu_time: number
  CPU時間の総計。文の実行時に更新される。
• duration: integer
  SQL文を実行していた時間の長さ。GV$SQL_MONITORからのSQL_EXEC_STARTおよびLAST_REFRESH_TIMEに基づいて計算される。
• elapsed_time: integer
  経過時間(マイクロ秒)。文の実行時に更新される。
• end_time: string
  ステータスがDONE (ALL ROWS)の場合、これはGV$SQL_MONITORからのLAST_REFRESH_TIME値
• instance_dop: string
  監視対象のSQL文が実行されている(または実行された)論理パラレル実行サーバー・プロセスの数と比較した、そのSQL文が実行されたインスタンスの数
• io_time: number
  ユーザーI/O待機時間の総計。文の実行時に更新される。
• links: array links
• session_id: integer
  監視されているSQL文を実行している(または実行した)セッション識別子。
• session_serial: integer
  監視対象の文を実行しているセッション・シリアル番号
• sql_exec_id: integer
  SQL実行識別子。SQL_IDがNULLの場合、またはSQL実行がまだ開始されていない場合はNULL。
• sql_exec_start: string
  実行の開始時刻GV$SQL_MONITOR内の単一レコードを識別するための実行キーの部分。
• sql_fulltext: string
  カレント・カーソルのSQLテキストのすべての文字
• sql_id: string
  文のSQL識別子
• start_time: string
  実行の開始時刻
• status: string
  SQL実行ステータス。

{
    "type":"object",
    "description":"This object describes an SQL statement. The list of attributes may vary depending on database version.",
    "properties":{
        "elapsed_time":{
            "type":"integer",
            "description":"Elapsed time (in microseconds); updated as the statement executes."
        },
        "sql_exec_id":{
            "type":"integer",
            "description":"SQL execution identifier; NULL if SQL_ID is NULL or if the execution of that SQL has not yet started."
        },
        "status":{
            "type":"string",
            "description":"SQL execution status."
        },
        "duration":{
            "type":"integer",
            "description":"Indicates the length of time the SQL statement has been running for. Calculated based on SQL_EXEC_START and LAST_REFRESH_TIME from GV$SQL_MONITOR."
        },
        "sql_id":{
            "type":"string",
            "description":"SQL identifier of the statement."
        },
        "session_id":{
            "type":"integer",
            "description":"Session identifier executing (or having executed) the SQL statement being monitored."
        },
        "session_serial":{
            "type":"integer",
            "description":"Session serial number executing the statement being monitored."
        },
        "instance_dop":{
            "type":"string",
            "description":"Distinct number of instances that the SQL statement executed compared with the logical parallel execution server process number executing (or having executed) the statement being monitored."
        },
        "cpu_time":{
            "type":"number",
            "description":"Sum of total CPU time; updated as the statement executes."
        },
        "io_time":{
            "type":"number",
            "description":"Sum of total User I/O Wait Time; updated as the statement executes"
        },
        "start_time":{
            "type":"string",
            "description":"Time when the execution started"
        },
        "sql_exec_start":{
            "type":"string",
            "description":"Time when the execution started. Part of the execution key for identifying a single record in GV$SQL_MONITOR."
        },
        "end_time":{
            "type":"string",
            "description":"When the status is 'DONE (ALL ROWS)' this is the LAST_REFRESH_TIME value from GV$SQL_MONITOR."
        },
        "sql_fulltext":{
            "type":"string",
            "description":"All characters of the SQL text for the current cursor."
        },
        "con_id":{
            "type":"integer",
            "description":"The ID of the container to which the data pertains."
        },
        "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"
    ]
}

先頭に戻る