ジャンプ先

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

SQL文の実行計画の取得

get

/database/performance/sql_statements/{sql_id}/plan

指定されたSQL_IDのすべてのGV$SQL_PLANレコードを返します。クライアントは、このサービスを起動するにはSQL管理者ロールが必要です。

リクエスト

パス・パラメータ

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

問合せパラメータ

• limit: integer(int32)
  戻すレコードの最大数。
• q:
  フィルタリングは、全コレクションで見つかった項目のサブセットが含まれている複数ページのリソース全体に対し、リクエストごとの動的フィルタ定義を使用してコレクション・リソースを制限する処理です。フィルタリングは、大規模なコレクションの効率的な走査を可能にします。

  例

  例の選択 FilterCriteriaExample OrderByPropertyExample FilterAndOrderExample

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

先頭に戻る

レスポンス

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

• application/json

200 レスポンス

指定されたSQL文の実行計画。

本文 ()

ルート・スキーマ: PerformanceSQLStatementPlanItem

タイプ: object

1つのSQL文の実行計画について説明します。

ソースの表示

• count: integer
  現在のレスポンス内のレコードの合計数
• hasMore: boolean
  取得するレコードがさらにあるかどうか
• items: array items
• limit: integer
  サーバーによって適用されるレコード数に関する実際のページ・サイズ制限
• links: array links
• offset: integer
  項目リソースの返戻元となる実際の索引

{
    "type":"object",
    "description":"Describes the explain plan for an SQL Statement.",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "id":{
                        "type":"integer",
                        "description":"A number assigned to each step in the execution plan."
                    },
                    "depth":{
                        "type":"integer",
                        "description":"Depth (or level) of the operation in the tree. The root operation (statement) is level 0."
                    },
                    "operation":{
                        "type":"string",
                        "description":"Name of the internal operation performed in this step (for example, TABLE ACCESS)."
                    },
                    "rows":{
                        "type":"string",
                        "description":"The number of rows the optimizer is expecting the operation to produce each time it is called. Also known as E-Rows."
                    },
                    "rowsourcetimes":{
                        "type":"integer",
                        "description":"The number of times the SQL Statement is referenced in GV$ACTIVE_SESSION_HISTORY."
                    }
                }
            }
        },
        "hasMore":{
            "type":"boolean",
            "description":"Indicates if there are more records to be retrieved."
        },
        "limit":{
            "type":"integer",
            "description":"The actual page size limit on number of records applied by the server."
        },
        "offset":{
            "type":"integer",
            "description":"The actual index from which the item resources are returned."
        },
        "count":{
            "type":"integer",
            "description":"Total number of records in the current response."
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/LinkRelation"
            }
        }
    }
}

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

タイプ: array

ソースの表示

• 配列: オブジェクト items

{
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "id":{
                "type":"integer",
                "description":"A number assigned to each step in the execution plan."
            },
            "depth":{
                "type":"integer",
                "description":"Depth (or level) of the operation in the tree. The root operation (statement) is level 0."
            },
            "operation":{
                "type":"string",
                "description":"Name of the internal operation performed in this step (for example, TABLE ACCESS)."
            },
            "rows":{
                "type":"string",
                "description":"The number of rows the optimizer is expecting the operation to produce each time it is called. Also known as E-Rows."
            },
            "rowsourcetimes":{
                "type":"integer",
                "description":"The number of times the SQL Statement is referenced in GV$ACTIVE_SESSION_HISTORY."
            }
        }
    }
}

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

タイプ: array

ソースの表示

• 配列: オブジェクト LinkRelation

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

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

タイプ: object

ソースの表示

• depth: integer
  ツリー内の操作の深さ(レベル)。ルート操作(文)は、レベル0です。
• id: integer
  実行計画の各ステップに割り当てられた番号です。
• operation: string
  このステップで実行される内部操作の名前(たとえば、TABLE ACCESS)
• rows: string
  オプティマイザで、その操作がコールされるたびに生成されると想定されている行の数。E-Rowsとも呼ばれる。
• rowsourcetimes: integer
  そのSQL文がGV$ACTIVE_SESSION_HISTORY内で参照される回数

{
    "type":"object",
    "properties":{
        "id":{
            "type":"integer",
            "description":"A number assigned to each step in the execution plan."
        },
        "depth":{
            "type":"integer",
            "description":"Depth (or level) of the operation in the tree. The root operation (statement) is level 0."
        },
        "operation":{
            "type":"string",
            "description":"Name of the internal operation performed in this step (for example, TABLE ACCESS)."
        },
        "rows":{
            "type":"string",
            "description":"The number of rows the optimizer is expecting the operation to produce each time it is called. Also known as E-Rows."
        },
        "rowsourcetimes":{
            "type":"integer",
            "description":"The number of times the SQL Statement is referenced in GV$ACTIVE_SESSION_HISTORY."
        }
    }
}

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

タイプ: object

ソースの表示

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

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

先頭に戻る