Jump to

• Request
• Response

Get all session waits

get

/database/monitoring/session_waits/

Returns all records from GV$SESSION_WAIT.

Request

Query Parameters

• limit: integer(int32)
  The maximum number of records to return.
• q:
  Filtering is the process of limiting a collection resource by using a per-request dynamic filter definition across multiple page resources, where each page contains a subset of items found in the complete collection. Filtering enables efficient traversal of large collections.

  Examples

  Select an example FilterCriteriaExample OrderByPropertyExample FilterAndOrderExample

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

All session wait records from GV$SESSION_WAIT. A client requires SQL Administrator role to invoke this service.

Body ()

Root Schema : MonitoringSessionWaits

Type: object

Show Source

• count: integer
  Total number of records in the current response.
• hasMore: boolean
  Indicates if there are more records to be retrieved.
• items: array items
• limit: integer
  The actual page size limit on number of records applied by the server.
• links: array links
• offset: integer
  The actual index from which the item resources are returned.

{
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/MonitoringSessionWaitsItem"
            }
        },
        "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"
            }
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: object MonitoringSessionWaitsItem
  This object represents a record from GV$SESSION_WAIT view. GV$SESSION_WAIT displays the current or last wait for each session. The list of attributes may vary depending on database version.

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

Nested Schema : links

Type: array

Show Source

• Array of: object LinkRelation

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

Nested Schema : MonitoringSessionWaitsItem

Type: object

This object represents a record from GV$SESSION_WAIT view. GV$SESSION_WAIT displays the current or last wait for each session. The list of attributes may vary depending on database version.

Show Source

• con_id: integer
  The ID of the container to which the data pertains.
• event: string
  If the session is currently waiting, then the resource or event for which the session is waiting. If the session is not in a wait, then the resource or event for which the session most recently waited.
• inst_id: integer
  Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
• links: array links
• p1: integer
  First wait event parameter (in decimal).
• p1raw: string
  First wait event parameter (in hexadecimal).
• p1text: string
  Description of the first wait event parameter.
• p2: integer
  Second wait event parameter (in decimal).
• p2raw: string
  Second wait event parameter (in hexadecimal).
• p2text: string
  Description of the second wait event parameter.
• p3: integer
  Third wait event parameter (in decimal).
• p3raw: string
  Third wait event parameter (in hexadecimal).
• p3text: string
  Description of the third wait event parameter.
• seconds_in_wait: integer
  If the session is currently waiting, then the value is the amount of time waited for the current wait. If the session is not in a wait, then the value is the amount of time since the start of the last wait.
• seq#: integer
  A number that uniquely identifies the current or last wait (incremented for each wait).
• sid: integer
  Session identifier.
• state: string
  Wait state.
• time_remaining_micro: integer
  Amount of time remaining remaining before a timeout. This field may indicate that a timeout has occurred, or that no timeout will occur.
• time_since_last_wait_micro: integer
  Time elapsed since the end of the last wait (in microseconds). If the session is currently in a wait, then the value is 0.
• wait_class: string
  Name of the class of the wait event.
• wait_class#: integer
  Number of the class of the wait event.
• wait_class_id: integer
  Identifier of the class of the wait event.
• wait_time: integer
  If the session is currently waiting, then the value is 0. If the session is not in a wait, then the value indicates the duration of the last wait.
• wait_time_micro: integer
  Amount of time waited (in microseconds). If the session is currently waiting, then the value is the time spent in the current wait. If the session is currently not in a wait, then the value is the amount of time waited in the last wait.

{
    "type":"object",
    "description":"This object represents a record from GV$SESSION_WAIT view. GV$SESSION_WAIT displays the current or last wait for each session. The list of attributes may vary depending on database version.",
    "properties":{
        "inst_id":{
            "type":"integer",
            "description":"Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1."
        },
        "sid":{
            "type":"integer",
            "description":"Session identifier."
        },
        "seq#":{
            "type":"integer",
            "description":"A number that uniquely identifies the current or last wait (incremented for each wait)."
        },
        "event":{
            "type":"string",
            "description":"If the session is currently waiting, then the resource or event for which the session is waiting. If the session is not in a wait, then the resource or event for which the session most recently waited."
        },
        "p1text":{
            "type":"string",
            "description":"Description of the first wait event parameter."
        },
        "p1":{
            "type":"integer",
            "description":"First wait event parameter (in decimal)."
        },
        "p1raw":{
            "type":"string",
            "description":"First wait event parameter (in hexadecimal)."
        },
        "p2text":{
            "type":"string",
            "description":"Description of the second wait event parameter."
        },
        "p2":{
            "type":"integer",
            "description":"Second wait event parameter (in decimal)."
        },
        "p2raw":{
            "type":"string",
            "description":"Second wait event parameter (in hexadecimal)."
        },
        "p3text":{
            "type":"string",
            "description":"Description of the third wait event parameter."
        },
        "p3":{
            "type":"integer",
            "description":"Third wait event parameter (in decimal)."
        },
        "p3raw":{
            "type":"string",
            "description":"Third wait event parameter (in hexadecimal)."
        },
        "wait_class_id":{
            "type":"integer",
            "description":"Identifier of the class of the wait event."
        },
        "wait_class#":{
            "type":"integer",
            "description":"Number of the class of the wait event."
        },
        "wait_class":{
            "type":"string",
            "description":"Name of the class of the wait event."
        },
        "wait_time":{
            "type":"integer",
            "description":"If the session is currently waiting, then the value is 0. If the session is not in a wait, then the value indicates the duration of the last wait."
        },
        "seconds_in_wait":{
            "type":"integer",
            "description":"If the session is currently waiting, then the value is the amount of time waited for the current wait. If the session is not in a wait, then the value is the amount of time since the start of the last wait."
        },
        "state":{
            "type":"string",
            "description":"Wait state."
        },
        "wait_time_micro":{
            "type":"integer",
            "description":"Amount of time waited (in microseconds). If the session is currently waiting, then the value is the time spent in the current wait. If the session is currently not in a wait, then the value is the amount of time waited in the last wait."
        },
        "time_remaining_micro":{
            "type":"integer",
            "description":"Amount of time remaining remaining before a timeout. This field may indicate that a timeout has occurred, or that no timeout will occur."
        },
        "time_since_last_wait_micro":{
            "type":"integer",
            "description":"Time elapsed since the end of the last wait (in microseconds). If the session is currently in a wait, then the value is 0."
        },
        "con_id":{
            "type":"integer",
            "description":"The ID of the container to which the data pertains."
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/LinkRelation"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object LinkRelation

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

Nested Schema : LinkRelation

Type: object

Show Source

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

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

Back to Top