openapi: 3.2.0 info: description: '
Provides the Oracle REST Data Services (ORDS) users the ability to perform Oracle Database management and monitoring operations through a user-friendly REST API. Depending on the database version and configuration, ORDS database APIs provide services such as manage pluggable databases, export data, and review database performance.
To install and configure Oracle REST Data Services refer to the Oracle® REST Data Services Installation and Configuration Guide.
An OpenAPI V3 document that describes the available ORDS database API services can be retrieved from a running ORDS instance. The API document can be imported into compatible development tools and invoked from there. The URL to retrieve the API document depends on the your configuration.
The pattern for the API document URL is:
https://<server>/<context root>/<my database>/<my schema>/_/db-api/stable/<service path>
Where, the <my database> and <my schema> variables can be optional, depending on the ORDS configuration and the service invoked.'
version: 2026.03.26
title: Oracle REST Data Services Performance API
contact:
name: Oracle REST Data Services
url: https://www.oracle.com/database/technologies/appdev/rest.html
x-summary: Provides the Oracle REST Data Services (ORDS) users the ability to perform Oracle Database management and monitoring operations through a user-friendly REST API.
tags:
- name: Performance
description: Services related to the runtime performance of the Oracle database instance.
paths:
/database/performance/active_sessions_history/:
get:
tags:
- Performance
summary: Get all sampled session activity in the database
description: Oracle Diagnostics Pack licence is required for this service. Returns all records from GV$ACTIVE_SESSION_HISTORY. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Description of sampled session activity in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceActionSessionHistories'
x-internal-id: database-performance-active_sessions_history--get
x-filename-id: database-performance-active_sessions_history-get
/database/performance/active_sessions_history/{sample_id},{session_id}:
get:
tags:
- Performance
summary: Get a specified sampled session activity in the database
description: Oracle Diagnostics Pack licence is required for this service. Returns specified records from GV$ACTIVE_SESSION_HISTORY. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sample_id
in: path
description: ID of the sample.
required: true
schema:
type: number
- name: session_id
in: path
description: Session identifier for the sampled session.
required: true
schema:
type: number
responses:
'200':
description: Active session history record.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceActionSessionHistoriesItem'
x-internal-id: database-performance-active_sessions_history-{sample_id},{session_id}-get
x-filename-id: database-performance-active_sessions_history-sample_id-session_id-get
/database/performance/active_sessions_history_waits/:
get:
tags:
- Performance
summary: Get the last 10 wait events for each active session
description: Return records from GV$SESSION_WAIT_HISTORY. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Description of session wait history.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceActionSessionHistoryWaits'
x-internal-id: database-performance-active_sessions_history_waits--get
x-filename-id: database-performance-active_sessions_history_waits-get
/database/performance/active_sessions_history_waits/{sid},{seq_number}/:
get:
tags:
- Performance
summary: Get the specified wait event for specific active session
description: Return data from GV$SESSION_WAIT_HISTORY for the specified Session Identifier and Event Sequence Number. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session Identifier.
required: true
schema:
type: number
- name: seq_number
in: path
description: Sequence number of wait event; 1 is the most recent.
required: true
schema:
type: number
responses:
'200':
description: The session wait history for a particular session and event.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceActionSessionHistoryWaitsItem'
x-internal-id: database-performance-active_sessions_history_waits-{sid},{seq_number}--get
x-filename-id: database-performance-active_sessions_history_waits-sid-seq_number-get
/database/performance/active_sessions_history_waits/{sid},{seq_number}/active_sql:
get:
tags:
- Performance
summary: Get SQL statistics for a specific session
description: Return records from GV$SQLAREA for a given session with current waits on GV$SESSION_WAIT_HISTORY. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session Identifier.
required: true
schema:
type: number
- name: seq_number
in: path
description: Sequence number of wait event; 1 is the most recent.
required: true
schema:
type: number
responses:
'200':
description: Stastics on the SQL statements currently executing for specific session.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceActionSessionHistoryWaitsActiveSQLItem'
x-internal-id: database-performance-active_sessions_history_waits-{sid},{seq_number}-active_sql-get
x-filename-id: database-performance-active_sessions_history_waits-sid-seq_number-active_sql-get
/database/performance/sql_statements/:
get:
tags:
- Performance
summary: Get statistics for all SQL statements
description: Oracle Tuning Pack licence is required for this service. Returns data from GV$SQL with GV$SQL_MONITOR timing data. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Description of all SQL statements in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatements'
x-internal-id: database-performance-sql_statements--get
x-filename-id: database-performance-sql_statements-get
/database/performance/sql_statements/{sql_id}/:
get:
tags:
- Performance
summary: Get statistics for a SQL statement
description: Oracle Tuning Pack licence is required for this service. Returns data from GV$SQL with GV$SQL_MONITOR timing data for the specified SQL statement identifier. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
responses:
'200':
description: Statistic for a SQL statement.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementsItem'
x-internal-id: database-performance-sql_statements-{sql_id}--get
x-filename-id: database-performance-sql_statements-sql_id-get
/database/performance/sql_statements/{sql_id}/monitor/:
get:
tags:
- Performance
summary: Get monitoring statistics for a SQL Statement
description: Oracle Tuning Pack licence is required for this service. Returns all GV$SQL_MONITOR records for a specified SQL_ID. GV$SQL_MONITOR will contain statistics only for SQL statements whose execution have been (or are being) monitored by Oracle. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Description of all monitored SQL statements in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementMonitors'
x-internal-id: database-performance-sql_statements-{sql_id}-monitor--get
x-filename-id: database-performance-sql_statements-sql_id-monitor-get
/database/performance/sql_statements/{sql_id}/monitor/{sql_exec_id},{sql_exec_start}/:
get:
tags:
- Performance
summary: Get information on a monitored statement
description: Oracle Tuning Pack licence is required for this service. Returns information on a monitored statement from GV$SQL_MONITOR view. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
- name: sql_exec_id
in: path
description: Execution identifier.
required: true
schema:
type: number
- name: sql_exec_start
in: path
description: Time when the execution started.
required: true
schema:
type: string
format: date-time
responses:
'200':
description: Description of a monitored SQL statement.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementMonitorsItem'
x-internal-id: database-performance-sql_statements-{sql_id}-monitor-{sql_exec_id},{sql_exec_start}--get
x-filename-id: database-performance-sql_statements-sql_id-monitor-sql_exec_id-sql_exec_start-get
/database/performance/sql_statements/{sql_id}/monitor/{sql_exec_id},{sql_exec_start}/parallelism:
get:
tags:
- Performance
summary: Get parallel execution information for specific statement execution
description: Oracle Tuning Pack licence is required for this service. Returns information on a monitored statement that is executed in parallel. Using GV$SQL_MONITOR view, the information includes the Parallel Coordinator and the instance(s) where it was executed. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
- name: sql_exec_id
in: path
description: Execution identifier.
required: true
schema:
type: number
- name: sql_exec_start
in: path
description: Time when the execution started.
required: true
schema:
type: string
format: date-time
responses:
'200':
description: Returns information on a monitored statement. The structure of the data may vary depending on the database used.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementMonitorParallelism'
x-internal-id: database-performance-sql_statements-{sql_id}-monitor-{sql_exec_id},{sql_exec_start}-parallelism-get
x-filename-id: database-performance-sql_statements-sql_id-monitor-sql_exec_id-sql_exec_start-parallelism-get
/database/performance/sql_statements/{sql_id}/plan:
get:
tags:
- Performance
summary: Get execution plan for an SQL Statement
description: Returns all GV$SQL_PLAN records for a specified SQL_ID. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Execution plan for the specified SQL statement.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementPlanItem'
x-internal-id: database-performance-sql_statements-{sql_id}-plan-get
x-filename-id: database-performance-sql_statements-sql_id-plan-get
/database/performance/sql_statements/{sql_id}/history:
get:
tags:
- Performance
summary: Get historical statistics for a SQL statement
description: Oracle Diagnostics Pack licence is required for this service. Returns DBA_HIST_SQLSTAT and DBA_HIST_SNAPSHOT records for a specified SQL_ID. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Historical statistics for the specified SQL statement.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementHistoryItem'
x-internal-id: database-performance-sql_statements-{sql_id}-history-get
x-filename-id: database-performance-sql_statements-sql_id-history-get
/database/performance/sql_statements/{sql_id}/text:
get:
tags:
- Performance
summary: Get SQL statement
description: Returns records from GV$SQL for specified SQL_ID. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sql_id
in: path
description: SQL identifier.
required: true
schema:
type: string
responses:
'200':
description: The text of a specific SQL statement.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceSQLStatementTextItem'
x-internal-id: database-performance-sql_statements-{sql_id}-text-get
x-filename-id: database-performance-sql_statements-sql_id-text-get
/database/performance/top_sql_statements/:
get:
tags:
- Performance
summary: Get all SQL statements ordered by CPU time descending
description: Returns records from GV$SQL ordered by CPU time descending, SQL Text ascending. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Description of the SQL statements in the database ordered to show the top SQL statements first.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceTopSQLStatements'
x-internal-id: database-performance-top_sql_statements--get
x-filename-id: database-performance-top_sql_statements-get
/database/performance/top_sql_statements/maximums:
get:
tags:
- Performance
summary: Get SQL statistics maximum values
description: Returns maximum values for cpu time, elapsed time, disk reads, buffer gets and executions from GV$SQL. A client requires SQL Administrator role to invoke this service.
responses:
'200':
description: Maximum values for SQL statement performance statistics recorded in GV$SQL.
content:
application/json:
schema:
$ref: '#/components/schemas/PerformanceTopSQLStatementsMaximumsItem'
x-internal-id: database-performance-top_sql_statements-maximums-get
x-filename-id: database-performance-top_sql_statements-maximums-get
components:
schemas:
PerformanceActionSessionHistoryWaitsActiveSQLItem:
type: object
description: Describes statistics on an SQL statement that is in memory, parsed and ready for execution but waiting on an event. The list of attributes may vary depending on database version.
properties:
username:
type: string
description: Name of the user that is associated with the session that is waiting.
inst_id:
type: integer
description: Instance number from which the associated V$ view information was obtained.
sql_text:
type: string
description: First thousand characters of the SQL text for the current cursor.
sql_fulltext:
type: string
description: All characters of the SQL text for the current cursor.
sql_id:
type: string
description: SQL identifier of the parent cursor in the library cache.
sharable_mem:
type: integer
description: Amount of shared memory used by a cursor. If multiple child cursors exist, then the sum of all shared memory used by all child cursors.
persistent_mem:
type: integer
description: Fixed amount of memory used for the lifetime of an open cursor. If multiple child cursors exist, then the fixed sum of memory used for the lifetime of all the child cursors.
runtime_mem:
type: integer
description: Fixed amount of memory required during execution of a cursor. If multiple child cursors exist, then the fixed sum of all memory required during execution of all the child cursors.
sorts:
type: integer
description: Sum of the number of sorts that were done for all the child cursors.
version_count:
type: integer
description: Number of child cursors that are present in the cache under this parent.
loaded_versions:
type: integer
description: Number of child cursors that are present in the cache and have their context heap loaded.
open_versions:
type: integer
description: Number of child cursors that are currently open under this current parent.
users_opening:
type: integer
description: Number of users that have any of the child cursors open.
fetches:
type: integer
description: Number of fetches associated with the SQL statement.
executions:
type: integer
description: Total number of executions, totalled over all the child cursors.
px_servers_executions:
type: integer
description: Total number of executions performed by parallel execution servers (0 when the statement has never been executed in parallel).
end_of_fetch_count:
type: integer
description: Number of times this cursor was fully executed since the cursor was brought into the library cache. The value of this statistic is not incremented when the cursor is partially executed, either because it failed during the execution or because only the first few rows produced by this cursor are fetched before the cursor is closed or re-executed. By definition, the value of the END_OF_FETCH_COUNT column should be less or equal to the value of the EXECUTIONS column.
users_executing:
type: integer
description: Total number of users executing the statement over all child cursors.
loads:
type: integer
description: Number of times the object was loaded or reloaded.
first_load_time:
type: string
description: Timestamp of the parent creation time.
invalidations:
type: integer
description: Total number of invalidations over all the child cursors.
parse_calls:
type: integer
description: Sum of all parse calls to all the child cursors under this parent.
disk_reads:
type: integer
description: Sum of the number of disk reads over all child cursors.
direct_writes:
type: integer
description: Sum of the number of direct writes over all child cursors.
direct_reads:
type: integer
description: Sum of the number of direct reads over all child cursors.
buffer_gets:
type: integer
description: Sum of buffer gets over all child cursors.
application_wait_time:
type: integer
description: Application wait time (in microseconds).
concurrency_wait_time:
type: integer
description: Concurrency wait time (in microseconds).
cluster_wait_time:
type: integer
description: Cluster wait time (in microseconds).
user_io_wait_time:
type: integer
description: User I/O Wait Time (in microseconds).
plsql_exec_time:
type: integer
description: PL/SQL execution time (in microseconds).
java_exec_time:
type: integer
description: Java execution time (in microseconds).
rows_processed:
type: integer
description: Total number of rows processed on behalf of this SQL statement.
command_type:
type: integer
description: Oracle command type definition.
optimizer_mode:
type: string
description: Mode under which the SQL statement was executed.
optimizer_cost:
type: integer
description: Cost of this query given by the optimizer.
optimizer_env:
type: string
description: Optimizer environment.
optimizer_env_hash_value:
type: integer
description: Hash value for the optimizer environment.
parsing_user_id:
type: integer
description: User ID of the user that has parsed the very first cursor under this parent.
parsing_schema_id:
type: integer
description: Schema ID that was used to parse this child cursor.
parsing_schema_name:
type: string
description: Schema name that was used to parse this child cursor.
kept_versions:
type: integer
description: Number of child cursors that have been marked to be kept using the DBMS_SHARED_POOL package.
address:
type: string
description: Address of the handle to the parent for this cursor.
hash_value:
type: integer
description: Hash value of the parent statement in the library cache.
old_hash_value:
type: integer
description: Old SQL hash value.
plan_hash_value:
type: integer
description: Numeric representation of the current SQL plan for this cursor. Comparing one PLAN_HASH_VALUE to another easily identifies whether or not two plans are the same (rather than comparing the two plans line by line).
full_plan_hash_value:
type: integer
description: Numeric representation of the complete SQL plan for this cursor. Comparing one 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 FULL_PLAN_HASH_VALUE cannot be compared across databases releases. It is not backward compatible.
module:
type: string
description: Contains the name of the module that was executing when the SQL statement was first parsed as set by calling DBMS_APPLICATION_INFO.SET_MODULE
module_hash:
type: integer
description: Hash value of the module that is named in the MODULE column.
action:
type: string
description: Contains the name of the action that was executing when the SQL statement was first parsed as set by calling DBMS_APPLICATION_INFO.SET_ACTION.
action_hash:
type: integer
description: Hash value of the action that is named in the ACTION column.
serializable_aborts:
type: integer
description: Number of times the transaction failed to serialize, producing ORA-08177 errors, totalled over all the child cursors.
outline_category:
type: string
description: If an outline was applied during construction of the cursor, then this column displays the category of that outline. Otherwise the column is left blank.
cpu_time:
type: integer
description: CPU time (in microseconds) used by this cursor for parsing, executing, and fetching.
elapsed_time:
type: integer
description: Elapsed time (in microseconds) used by this cursor for parsing, executing, and fetching. If the cursor uses parallel execution, then ELAPSED_TIME is the cumulative time for the query coordinator, plus all parallel query slave processes.
outline_sid:
type: string
description: Outline session identifier.
last_active_child_address:
type: string
description: Address (identifier) of the child cursor that was the last to be active in the group (that is, the child cursor on behalf of which statistics in GV$SQL were updated).
remote:
type: string
description: Indicates whether the cursor is remote mapped (Y) or not (N).
object_status:
type: string
description: Status of the cursor.
literal_hash_value:
type: integer
description: Hash value of the literals which are replaced with system-generated bind variables and are to be matched, when CURSOR_SHARING is used. This is not the hash value for the SQL statement. If CURSOR_SHARING is not used, then the value is 0.
last_load_time:
type: string
description: Time at which the query plan was loaded into the library cache.
is_obsolete:
type: string
description: Indicates whether the cursor has become obsolete (Y) or not (N). This can happen if the number of child cursors is too large.
is_bind_sensitive:
type: string
description: Indicates whether the cursor is bind sensitive (Y) or not (N). A query is considered bind-sensitive if the optimizer peeked at one of its bind variable values when computing predicate selectivities and where a change in a bind variable value may cause the optimizer to generate a different plan.
is_bind_aware:
type: string
description: Indicates whether the cursor is bind aware (Y) or not (N). A query is considered bind-aware if it has been marked to use extended cursor sharing. The query would already have been marked as bind-sensitive.
child_latch:
type: integer
description: Child latch number that is protecting the cursor. This column is obsolete and maintained for backward compatibility.
sql_profile:
type: string
description: SQL profile used for this statement, if any.
sql_patch:
type: string
description: SQL patch used for this statement, if any.
sql_plan_baseline:
type: string
description: SQL plan baseline used for this statement, if any.
program_id:
type: integer
description: Program identifier.
program_line#:
type: integer
description: Program line number.
exact_matching_signature:
type: integer
description: Signature used when the CURSOR_SHARING parameter is set to EXACT.
force_matching_signature:
type: integer
description: Signature used when the CURSOR_SHARING parameter is set to FORCE.
last_active_time:
type: string
description: Time at which the query plan was last active.
bind_data:
type: string
description: Bind data.
typecheck_mem:
type: integer
description: Typecheck memory.
io_cell_offload_eligible_bytes:
type: integer
description: Number of I/O bytes which can be filtered by the Exadata storage system.
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.
optimized_phy_read_requests:
type: integer
description: Number of physical read I/O requests from Database Smart Flash Cache issued by the monitored SQL.
locked_total:
type: integer
description: Total number of times the child cursor has been locked.
pinned_total:
type: integer
description: Total number of times the child cursor has been pinned.
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_returned_bytes:
type: integer
description: Number of bytes that are returned by Exadata cell through the regular I/O path.
con_id:
type: integer
description: The ID of the container to which the data pertains.
is_reoptimizable:
type: string
description: This columns shows whether the next execution matching this child cursor will trigger a reoptimization.
is_resolved_adaptive_plan:
type: string
description: This column shows whether all of the adaptive parts of a plan have been resolved to the final plan.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
PerformanceSQLStatementMonitors:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/PerformanceSQLStatementMonitorsItem'
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'
PerformanceSQLStatementMonitorsItem:
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'
PerformanceSQLStatementTextItem:
type: object
description: Describes the SQL Statement.
properties:
sql_text:
type: string
description: First thousand characters of the SQL text for the current cursor.
sql_fulltext:
type: string
description: Full text for the SQL statement.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
PerformanceActionSessionHistoryWaitsItem:
type: object
description: Describes a wait event for a session. Data corresponds to a record from GV$SESSION_WAIT_HISTORY. The list of attributes may vary depending on database version.
properties:
username:
type: string
description: Name of the user that is associated with the session.
inst_id:
type: integer
description: Instance number from which the associated V$ view information was obtained.
sid:
type: integer
description: Session identifier.
seq#:
type: integer
description: Sequence of wait events; 1 is the most recent.
event#:
type: integer
description: Event number.
event:
type: string
description: Resource or event for which the session is waiting.
p1text:
type: string
description: Description of the first wait event parameter.
p1:
type: integer
description: First wait event parameter (in decimal).
p2text:
type: string
description: Description of the second wait event parameter.
p2:
type: integer
description: Second wait event parameter (in decimal).
p3text:
type: string
description: Description of the third wait event parameter.
p3:
type: integer
description: Third wait event parameter (in decimal).
wait_time:
type: integer
description: Amount of time waited (in hundredths of a second).
wait_time_micro:
type: integer
description: Amount of time waited (in microseconds).
time_since_last_wait_micro:
type: integer
description: Time elapsed (in microseconds) since the end of the previous wait in the wait history.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
SQLStatement:
type: object
description: Corresponding to a record on GV$SQL, this object describes 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 view information was obtained.
sql_text:
type: string
description: First thousand characters of the SQL text for the current cursor.
sql_fulltext:
type: string
description: Full text for the SQL statement exposed as a CLOB column. The full text of a SQL statement can be retrieved using this column instead of joining with the V$SQLTEXT dynamic performance view.
sql_id:
type: string
description: SQL identifier of the parent cursor in the library cache.
sharable_mem:
type: integer
description: Amount of shared memory used by the child cursor (in bytes).
persistent_mem:
type: integer
description: Fixed amount of memory used for the lifetime of the child cursor (in bytes).
runtime_mem:
type: integer
description: Fixed amount of memory required during the execution of the child cursor.
sorts:
type: integer
description: Number of sorts that were done for the child cursor.
loaded_versions:
type: integer
description: Indicates whether the context heap is loaded (1) or not (0).
open_versions:
type: integer
description: Indicates whether the child cursor is locked (1) or not (0).
users_opening:
type: integer
description: Number of users that have any of the child cursors open.
fetches:
type: integer
description: Number of fetches associated with the SQL statement.
executions:
type: integer
description: Number of executions that took place on this object since it was brought into the library cache.
px_servers_executions:
type: integer
description: Total number of executions performed by parallel execution servers (0 when the statement has never been executed in parallel).
end_of_fetch_count:
type: integer
description: Number of times this cursor was fully executed since the cursor was brought into the library cache. The value of this statistic is not incremented when the cursor is partially executed, either because it failed during the execution or because only the first few rows produced by this cursor are fetched before the cursor is closed or re-executed. By definition, the value of the END_OF_FETCH_COUNT column should be less or equal to the value of the EXECUTIONS column.
users_executing:
type: integer
description: Number of users executing the statement.
loads:
type: integer
description: Number of times the object was either loaded or reloaded.
first_load_time:
type: string
description: Timestamp of the parent creation time.
invalidations:
type: integer
description: Number of times this child cursor has been invalidated.
parse_calls:
type: integer
description: Number of parse calls for this child cursor.
disk_reads:
type: integer
description: Number of disk reads for this child cursor.
direct_writes:
type: integer
description: Number of direct writes for this child cursor.
direct_reads:
type: integer
description: Number of direct reads for this child cursor.
buffer_gets:
type: integer
description: Number of buffer gets for this child cursor.
application_wait_time:
type: integer
description: Application wait time (in microseconds).
concurrency_wait_time:
type: integer
description: Concurrency wait time (in microseconds).
cluster_wait_time:
type: integer
description: Cluster wait time (in microseconds).
user_io_wait_time:
type: integer
description: User I/O Wait Time (in microseconds).
plsql_exec_time:
type: integer
description: PL/SQL execution time (in microseconds).
java_exec_time:
type: integer
description: Java execution time (in microseconds).
rows_processed:
type: integer
description: Total number of rows the parsed SQL statement returns.
command_type:
type: integer
description: Oracle command type definition.
optimizer_mode:
type: string
description: Mode under which the SQL statement was executed.
optimizer_cost:
type: integer
description: Cost of this query given by the optimizer.
optimizer_env:
type: string
description: Optimizer environment.
optimizer_env_hash_value:
type: integer
description: Hash value for the optimizer environment.
parsing_user_id:
type: integer
description: User ID of the user who originally built this child cursor.
parsing_schema_id:
type: integer
description: Schema ID that was used to originally build this child cursor.
parsing_schema_name:
type: string
description: Schema name that was used to originally build this child cursor.
kept_versions:
type: integer
description: Indicates whether this child cursor has been marked to be kept pinned in the cache using the DBMS_SHARED_POOL package.
address:
type: string
description: Address of the handle to the parent for this cursor.
type_chk_heap:
type: string
description: Descriptor of the type check heap for this child cursor.
hash_value:
type: integer
description: Hash value of the parent statement in the library cache.
old_hash_value:
type: integer
description: Old SQL hash value.
plan_hash_value:
type: integer
description: Numeric representation of the current SQL plan for this cursor. Comparing one PLAN_HASH_VALUE to another easily identifies whether or not two plans are the same (rather than comparing the two plans line by line).
full_plan_hash_value:
type: integer
description: Numeric representation of the complete SQL plan for this cursor. Comparing one 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 FULL_PLAN_HASH_VALUE cannot be compared across databases releases. It is not backward compatible.
child_number:
type: integer
description: Number of this child cursor.
service:
type: string
description: Service name.
service_hash:
type: integer
description: Hash value for the name listed in the SERVICE column.
module:
type: string
description: Contains the name of the module that was executing when the SQL statement was first parsed, which is set by calling DBMS_APPLICATION_INFO.SET_MODULE.
module_hash:
type: integer
description: Hash value of the module listed in the MODULE column.
action:
type: string
description: Contains the name of the action that was executing when the SQL statement was first parsed, which is set by calling DBMS_APPLICATION_INFO.SET_ACTION.
action_hash:
type: integer
description: Hash value of the action listed in the ACTION column.
serializable_aborts:
type: integer
description: Number of times the transaction failed to serialize, producing ORA-08177 errors, per cursor.
outline_category:
type: string
description: If an outline was applied during construction of the cursor, then this column displays the category of that outline. Otherwise the column is left blank.
cpu_time:
type: integer
description: CPU time (in microseconds) used by this cursor for parsing, executing, and fetching.
elapsed_time:
type: integer
description: Elapsed time (in microseconds) used by this cursor for parsing, executing, and fetching. If the cursor uses parallel execution, then ELAPSED_TIME is the cumulative time for the query coordinator, plus all parallel query slave processes.
outline_sid:
type: integer
description: Outline session identifier.
child_address:
type: string
description: Address of the child cursor.
sqltype:
type: integer
description: Denotes the version of the SQL language used for this statement.
remote:
type: string
description: Indicates whether the cursor is remote mapped (Y) or not (N).
object_status:
type: string
description: Status of the cursor.
literal_hash_value:
type: integer
description: Hash value of the literals which are replaced with system-generated bind variables and are to be matched, when CURSOR_SHARING is used. This is not the hash value for the SQL statement. If CURSOR_SHARING is not used, then the value is 0.
last_load_time:
type: string
description: Time at which the query plan was loaded into the library cache.
is_obsolete:
type: string
description: Indicates whether the cursor has become obsolete (Y) or not (N). This can happen if the number of child cursors is too large.
is_bind_sensitive:
type: string
description: Indicates whether the cursor is bind sensitive (Y) or not (N). A query is considered bind-sensitive if the optimizer peeked at one of its bind variable values when computing predicate selectivities and where a change in a bind variable value may cause the optimizer to generate a different plan.
is_bind_aware:
type: string
description: Indicates whether the cursor is bind aware (Y) or not (N). A query is considered bind-aware if it has been marked to use extended cursor sharing. The query would already have been marked as bind-sensitive.
is_shareable:
type: string
description: Indicates whether the cursor can be shared (Y) or not (N).
child_latch:
type: integer
description: Child latch number that is protecting the cursor. This column is obsolete and maintained for backward compatibility.
sql_profile:
type: string
description: SQL profile used for this statement, if any.
sql_patch:
type: string
description: SQL patch used for this statement, if any.
sql_plan_baseline:
type: string
description: SQL plan baseline used for this statement, if any.
program_id:
type: integer
description: Program identifier.
program_line#:
type: integer
description: Program line number.
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: Signature used when the CURSOR_SHARING parameter is set to FORCE.
last_active_time:
type: string
description: TIme at which the query plan was last active.
bind_data:
type: string
description: Bind data.
typecheck_mem:
type: integer
description: Typecheck memory.
io_cell_offload_eligible_bytes:
type: integer
description: Number of I/O bytes which can be filtered by the Exadata storage system.
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.
optimized_phy_read_requests:
type: integer
description: Number of physical read I/O requests from Database Smart Flash Cache issued by the monitored SQL.
locked_total:
type: integer
description: Total number of times the child cursor has been locked.
pinned_total:
type: integer
description: Total number of times the child cursor has been pinned.
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_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).
con_id:
type: integer
description: The ID of the container to which the data pertains.
is_reoptimizable:
type: string
description: This columns shows whether the next execution matching this child cursor will trigger a reoptimization.
is_resolved_adaptive_plan:
type: string
description: This column shows whether all of the adaptive parts of a plan have been resolved to the final plan. Once the plan is resolved, the plan hash value and the plan displayed by DBMS_XPLAN will not change through the end of execution.
im_scans:
type: integer
description: Number of In-Memory Column Store (IM column store) segment scans.
im_scan_bytes_uncompressed:
type: integer
description: Uncompressed size of data scanned from the IM column store.
im_scan_bytes_inmemory:
type: integer
description: In-memory size of data scanned from the IM column store.
ddl_no_invalidate:
type: string
description: Indicates if a DDL statement updated a dependent object and did not invalidate this cursor.
is_rolling_invalid:
type: string
description: Indicates if this cursor is rolling validated.
is_rolling_refresh_invalid:
type: string
description: Indicates if this cursor is rolling validated and requires execution time refresh.
result_cache:
type: string
description: Indicates whether the function is result???cached (YES) or not (NO).
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
PerformanceSQLStatementMonitorParallelism:
type: object
description: Describes the parallel execution of an SQL Statement. Using GV$SQL_MONITOR view, the information includes the Parallel Coordinator and the instance(s) where it was executed.
properties:
items:
type: array
items:
type: object
properties:
node_id:
type: integer
description: Used as a distinguishing value in the Parallelism metadata. The value may be an Instance Number to represent the execution on an instance, 10000 when a Parallel Coordinator or some other value derived from the SERVER_GROUP data.
parent_node_id:
type: number
description: The value may be an Instance Number to represent the execution of Parallel Coordinator or Server Group on an instance. May be NULL.
name:
type: string
description: Name of either the Instance, Parallel Coordinator, Parallel Group, Parallel Set or Parallel Server that corresponds to the GV$SQL_MONITOR record.
inst_id:
type: number
description: The Instance Number from the GV$SQL_MONITOR record.
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.
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).
db_time:
type: number
description: The greater of either ELAPSED_TIME or a total of the following CPU_TIME + QUEUING_TIME + APPLICATION_WAIT_TIME + CONCURRENCY_WAIT_TIME + CLUSTER_WAIT_TIME + USER_IO_WAIT_TIME + PLSQL_EXEC_TIME + JAVA_EXEC_TIME.
db_time_prop:
type: number
description: The proportional time spent for this GV$SQL_MONITOR record compared to other execution records for the same SQL Statement.
db_time_max:
type: number
description: The maximum time spent for an execution of the SQL Statement.
cpu_time:
type: integer
description: CPU time (in microseconds) used by this cursor for parsing, executing, and fetching.
queuing_time:
type: integer
description: Duration of time (in microseconds) spent by SQL in the statement queue.
application_wait_time:
type: number
description: Application wait time (in microseconds); updated as the statement executes.
concurrency_wait_time:
type: number
description: Concurrency wait time (in microseconds); updated as the statement executes.
cluster_wait_time:
type: number
description: Cluster wait time (in microseconds); updated as the statement executes.
user_io_wait_time:
type: number
description: User I/O Wait Time (in microseconds); updated as the statement executes.
plsql_exec_time:
type: number
description: PL/SQL execution time (in microseconds); updated as the statement executes.
java_exec_time:
type: number
description: Java execution time (in microseconds); updated as the statement executes.
other_wait_time:
type: number
description: The greater of either zero or a total of the following CPU_TIME - QUEUING_TIME - APPLICATION_WAIT_TIME - CONCURRENCY_WAIT_TIME - CLUSTER_WAIT_TIME - USER_IO_WAIT_TIME - PLSQL_EXEC_TIME - JAVA_EXEC_TIME.
io_requests:
type: number
description: Total of number of physical read and write I/O requests issued by the monitored SQL.
io_requests_prop:
type: number
description: The proportional number of physical read and write I/O requests issued by the monitored SQL compared to other execution records for the same SQL Statement.
io_requests_max:
type: number
description: The maximum number of physical read and write I/O requests issued by a monitored SQL execution for the same SQL Statement.
io_bytes:
type: number
description: Total of number of bytes read from disks and bytes written to disks by the monitored SQL.
io_bytes_prop:
type: number
description: The proportional number of bytes read from disks and bytes written to disks by the monitored SQL compared to other execution records for the same SQL Statement.
io_bytes_max:
type: number
description: The maximum number of bytes read from disks and bytes written to disks by a monitored SQL execution for the same SQL Statement.
buffer_gets:
type: number
description: Number of buffer get operations; updated as the statement executes.
buffer_gets_prop:
type: number
description: The proportional number of buffer get operations compared to other execution records for the same SQL Statement.
buffer_gets_max:
type: number
description: The maximum number of buffer get operations by a monitored SQL execution for the same SQL Statement.
dop_downgrade:
type: string
description: Percentage of actual number of parallel execution servers allocated to execute the query compared to the total number of parallel execution servers requested to execute the query.
servers_requested:
type: number
description: Total number of parallel execution servers requested to execute the monitored SQL.
servers_allocated:
type: number
description: Actual number of parallel execution servers allocated to execute the query.
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'
PerformanceActionSessionHistoryWaits:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/PerformanceActionSessionHistoryWaitsItem'
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'
PerformanceSQLStatementHistoryItem:
type: object
description: This object represents historical information about SQL statistics. The structure is based on DBA_HIST_SQLSTAT. The list of attributes may vary depending on database version.
properties:
items:
type: array
items:
type: object
properties:
begin_interval_time_utc:
type: string
description: Time at the beginning of the snapshot interval in UTC timezone.
startup_time:
type: string
description: Startup time of the instance.
begin_interval_time:
type: string
description: Time at the beginning of the snapshot interval.
end_interval_time:
type: string
description: Time at the end of the snapshot interval; the actual time the snapshot was taken.
flush_elapsed:
type: string
description: Amount of time to perform the snapshot.
error_count:
type: integer
description: Number of errors occurring in the tables for the particular snapshot.
snap_flag:
type: integer
description: Condition under which the snapshot was inserted.
snap_timezone:
type: string
description: Snapshot time zone expressed as offset from UTC (Coordinated Universal Time) time zone.
sql_id:
type: string
description: SQL identifier of the parent cursor in the library cache.
snap_id:
type: integer
description: Unique snapshot ID.
dbid:
type: integer
description: Database ID for the snapshot.
instance_number:
type: integer
description: Instance number for the snapshot.
plan_hash_value:
type: integer
description: Numerical representation of the SQL plan for the cursor. Comparing one PLAN_HASH_VALUE to another easily identifies whether or not two plans are the same (rather than comparing the two plans line by line).
optimizer_cost:
type: integer
description: Cost of the query given by the optimizer.
optimizer_mode:
type: string
description: Mode under which the SQL statement is executed.
optimizer_env_hash_value:
type: integer
description: Hash Value for the optimizer environment.
sharable_mem:
type: integer
description: Amount of shared memory used by the child cursor (in bytes).
loaded_versions:
type: integer
description: Indicates whether the context heap is loaded (1) or not (0).
version_count:
type: integer
description: Number of children associated with the cursor.
module:
type: string
description: Contains the name of the module that was executing at the time that the SQL statement was first parsed, which is set by calling DBMS_APPLICATION_INFO.SET_MODULE.
action:
type: string
description: Contains the name of the action that was executing at the time that the SQL statement was first parsed, which is set by calling DBMS_APPLICATION_INFO.SET_ACTION.
sql_profile:
type: string
description: Name of the applied SQL Profile.
force_matching_signature:
type: integer
description: The signature used when the CURSOR_SHARING parameter is set to FORCE.
parsing_schema_id:
type: integer
description: Schema ID that was used to originally build the child cursor.
parsing_schema_name:
type: string
description: Schema name that was used to originally build the child cursor.
parsing_user_id:
type: integer
description: User ID that was used to originally build the child cursor.
fetches_total:
type: integer
description: Cumulative number of fetches associated with the SQL statement.
fetches_delta:
type: integer
description: Delta number of fetches associated with the SQL statement.
end_of_fetch_count_total:
type: integer
description: Cumulative number of times this cursor was fully executed since the cursor was brought into the library cache. The value of this statistic is not incremented when the cursor is partially executed, either because it failed during the execution or because only the first few rows produced by this cursor are fetched before the cursor is closed or re-executed. By definition, the value of the END_OF_FETCH_COUNT column should be less or equal to the value of the EXECUTIONS column.
end_of_fetch_count_delta:
type: integer
description: Delta number of times this cursor was fully executed since the cursor was brought into the library cache. The value of this statistic is not incremented when the cursor is partially executed, either because it failed during the execution or because only the first few rows produced by this cursor are fetched before the cursor is closed or re-executed.
sorts_total:
type: integer
description: Cumulative number of sorts that were done for this child cursor.
sorts_delta:
type: integer
description: Delta number of sorts that were done for this child cursor.
executions_total:
type: integer
description: Cumulative number of executions that took place on this object since it was brought into the library cache.
executions_delta:
type: integer
description: Delta number of executions that took place on this object since it was brought into the library cache.
px_servers_execs_total:
type: integer
description: Cumulative number of PX server executions.
px_servers_execs_delta:
type: integer
description: Delta number of PX server executions.
loads_total:
type: integer
description: Cumulative number of times the object was either loaded or reloaded.
loads_delta:
type: integer
description: Delta number of times the object was either loaded or reloaded.
invalidations_total:
type: integer
description: Cumulative number of times this child cursor has been invalidated.
invalidations_delta:
type: integer
description: Delta number of times this child cursor has been invalidated.
parse_calls_total:
type: integer
description: Cumulative number of parse calls for this child cursor.
parse_calls_delta:
type: integer
description: Delta number of parse calls for this child cursor.
disk_reads_total:
type: integer
description: Cumulative number of disk reads for this child cursor.
disk_reads_delta:
type: integer
description: Delta number of disk reads for this child cursor.
buffer_gets_total:
type: integer
description: Cumulative number of buffer gets for this child cursor.
buffer_gets_delta:
type: integer
description: Delta number of buffer gets for this child cursor.
rows_processed_total:
type: integer
description: Cumulative number of rows the parsed SQL statement returns.
rows_processed_delta:
type: integer
description: Delta number of rows the parsed SQL statement returns.
cpu_time_total:
type: integer
description: Cumulative value of CPU time (in microseconds) used by this cursor for parsing/executing/fetching.
cpu_time_delta:
type: integer
description: Delta value of CPU time (in microseconds) used by this cursor for parsing/executing/fetching.
elapsed_time_total:
type: integer
description: Cumulative value of elapsed time (in microseconds) used by this cursor for parsing/executing/fetching. If the cursor uses parallel execution, then ELAPSED_TIME_TOTAL is the cumulative time for the query coordinator, plus all parallel query slave processes.
elapsed_time_delta:
type: integer
description: Delta value of elapsed time (in microseconds) used by this cursor for parsing/executing/fetching.
iowait_total:
type: integer
description: Cumulative value of user I/O wait time (in microseconds).
iowait_delta:
type: integer
description: Delta value of user I/O wait time (in microseconds).
clwait_total:
type: integer
description: Cumulative value of cluster wait time (in microseconds).
clwait_delta:
type: integer
description: Delta value of cluster wait time (in microseconds).
apwait_total:
type: integer
description: Cumulative value of application wait time (in microseconds).
apwait_delta:
type: integer
description: Delta value of application wait time (in microseconds).
ccwait_total:
type: integer
description: Cumulative value of concurrency wait time (in microseconds).
ccwait_delta:
type: integer
description: Delta value of concurrency wait time (in microseconds).
direct_writes_total:
type: integer
description: Cumulative value of direct writes.
direct_writes_delta:
type: integer
description: Delta value of direct writes.
plsexec_time_total:
type: integer
description: Cumulative value of PL/SQL Execution Time (in microseconds).
plsexec_time_delta:
type: integer
description: Delta value of PL/SQL Execution Time (in microseconds).
javexec_time_total:
type: integer
description: Cumulative value of Java Execution Time (in microseconds).
javexec_time_delta:
type: integer
description: Delta value of Java Execution Time (in microseconds).
io_offload_elig_bytes_total:
type: integer
description: Cumulative value of number of I/O bytes which can be filtered by the Exadata storage system.
io_offload_elig_bytes_delta:
type: integer
description: Delta value of number of I/O bytes which can be filtered by the Exadata storage system.
io_interconnect_bytes_total:
type: integer
description: Cumulative value of number of I/O bytes exchanged between Oracle Database and the storage system.
io_interconnect_bytes_delta:
type: integer
description: Delta value of number of I/O bytes exchanged between Oracle Database and the storage system.
physical_read_requests_total:
type: integer
description: Cumulative value of number of physical read I/O requests issued by the monitored SQL.
physical_read_requests_delta:
type: integer
description: Delta value of number of physical read I/O requests issued by the monitored SQL.
physical_read_bytes_total:
type: integer
description: Cumulative value of number of bytes read from disks by the monitored SQL.
physical_read_bytes_delta:
type: integer
description: Delta value of number of bytes read from disks by the monitored SQL.
physical_write_requests_total:
type: integer
description: Cumulative value of number of physical write I/O requests issued by the monitored SQL.
physical_write_requests_delta:
type: integer
description: Delta value of number of physical write I/O requests issued by the monitored SQL.
physical_write_bytes_total:
type: integer
description: Cumulative value of number of bytes written to disks by the monitored SQL.
physical_write_bytes_delta:
type: integer
description: Delta value of number of bytes written to disks by the monitored SQL.
optimized_physical_reads_total:
type: integer
description: Cumulative value of number of physical reads from the Database Smart Flash Cache or the Exadata Smart Flash Cache by the monitored SQL.
optimized_physical_reads_delta:
type: integer
description: Delta value of number of physical reads from the Database Smart Flash Cache or the Exadata Smart Flash Cache by the monitored SQL.
cell_uncompressed_bytes_total:
type: integer
description: Cumulative value of number of uncompressed bytes (that is, size after decompression) that are offloaded to the Exadata cells.
cell_uncompressed_bytes_delta:
type: integer
description: Delta value of number of uncompressed bytes (that is, size after decompression) that are offloaded to the Exadata cells.
io_offload_return_bytes_total:
type: integer
description: Cumulative value of number of bytes that are returned by the Exadata cell for smart scan only (that is, not including bytes for other database I/O).
io_offload_return_bytes_delta:
type: integer
description: Delta value of number of bytes that are returned by the Exadata cell for smart scan only (that is, not including bytes for other database I/O).
bind_data:
type: string
description: Bind data.
con_dbid:
type: integer
description: The database ID of the PDB for the sampled session.
con_id:
type: integer
description: The ID of the container that CON_DBID identifies.
elapsed_time_delta_s_per_exec:
type: number
description: Average elapsed time (in seconds) for parsing/executing/fetching across all recorded executions.
sum_executions_delta:
type: integer
description: Total of all executions that took place on this object since it was brought into the library cache.
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'
PerformanceTopSQLStatements:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/SQLStatement'
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'
PerformanceSQLStatementPlanItem:
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'
PerformanceActionSessionHistoriesItem:
type: object
description: This object represents a sampled session activity in the database from GV$ACTIVE_SESSION_HISTORY. It contains snapshots of active database sessions taken once a second. A database session is considered active if it was on the CPU or was waiting for an event that didn't belong to the Idle wait class. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Instance number from which the associated GV$ACTIVE_SESSION_HISTORY view information was obtained.
sample_id:
type: integer
description: ID of the sample.
sample_time:
type: string
description: Time at which the sample was taken.
is_awr_sample:
type: string
description: Indicates whether this sample has been flushed or will be flushed to the Automatic Workload Repository (DBA_HIST_ACTIVE_SESS_HISTORY) (Y) or not (N).
session_id:
type: integer
description: Session identifier; maps to GV$SESSION.SID.
session_serial#:
type: integer
description: Session serial number (used to uniquely identify a session's objects); maps to GV$SESSION.SERIAL#.
session_type:
type: string
description: Session type.
user_id:
type: integer
description: Oracle user identifier; maps to GV$SESSION.USER#.
sql_id:
type: string
description: SQL identifier of the SQL statement that the session was executing at the time of sampling.
is_sqlid_current:
type: string
description: Indicates whether the SQL identifier in the SQL_ID column is being executed (Y) or not (N).
sql_child_number:
type: integer
description: Child number of the SQL statement that the session was executing at the time of sampling.
sql_opcode:
type: integer
description: Indicates what phase of operation the SQL statement was in.
force_matching_signature:
type: integer
description: Signature used when the CURSOR_SHARING parameter is set to FORCE.
top_level_sql_id:
type: string
description: SQL identifier of the top level SQL statement.
top_level_sql_opcode:
type: integer
description: Indicates what phase of operation the top level SQL statement was in.
sql_opname:
type: string
description: SQL command name.
sql_adaptive_plan_resolved:
type: integer
description: Indicates whether the SQL plan of the sampled database session is a resolved adaptive plan or not.
sql_full_plan_hash_value:
type: integer
description: Numerical representation of the complete SQL plan for the cursor being executed by this session.
sql_plan_hash_value:
type: integer
description: Numeric representation of the SQL plan for the cursor. This information might not be available for all session samples.
sql_plan_line_id:
type: integer
description: SQL plan line ID.
sql_plan_operation:
type: string
description: Plan operation name.
sql_plan_options:
type: string
description: Plan operation options.
sql_exec_id:
type: integer
description: SQL execution identifier.
sql_exec_start:
type: string
description: Time when the execution of the SQL started.
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. Maps to DBA_OBJECTS.OBJECT_ID.
plsql_entry_subprogram_id:
type: integer
description: Subprogram ID of the top-most PL/SQL subprogram on the stack. Maps to DBA_OBJECTS.DATA_OBJECT_ID.
plsql_object_id:
type: integer
description: Object ID of the currently executing PL/SQL subprogram.
plsql_subprogram_id:
type: integer
description: Subprogram ID of the currently executing PL/SQL object.
qc_instance_id:
type: integer
description: Query coordinator instance ID. This information is only available if the sampled session is a parallel query slave. For all other sessions, the value is 0.
qc_session_id:
type: integer
description: Query coordinator session ID. This information is only available if the sampled session is a parallel query slave. For all other sessions, the value is 0.
qc_session_serial#:
type: integer
description: Query coordinator session serial number. This information is only available if the sampled session is a parallel query slave. For all other sessions, the value is 0.
event:
type: string
description: If SESSION_STATE = WAITING, then the event for which the session was waiting for at the time of sampling. If SESSION_STATE = ON CPU, then this column is NULL.
event_id:
type: integer
description: Identifier of the resource or event for which the session is waiting or for which the session last waited. Interpretation is similar to that of the EVENT column.
event#:
type: integer
description: Number of the resource or event for which the session is waiting or for which the session last waited. Interpretation is similar to that of the EVENT column.
seq#:
type: integer
description: Sequence number that uniquely identifies the wait (incremented for each wait).
p1text:
type: string
description: Description of the first wait event parameter.
p1:
type: integer
description: First wait event parameter (in decimal).
p2text:
type: string
description: Description of the second wait event parameter.
p2:
type: integer
description: Second wait event parameter (in decimal).
p3text:
type: string
description: Description of the third wait event parameter.
p3:
type: integer
description: Third wait event parameter (in decimal).
wait_class:
type: string
description: Wait class name of the event for which the session was waiting at the time of sampling.
wait_class_id:
type: integer
description: Wait class identifier of the event for which the session was waiting at the time of sampling.
wait_time:
type: integer
description: Total wait time for the event for which the session last waited if the session was on the CPU when sampled; 0 if the session was waiting at the time of sampling.
session_state:
type: string
description: Session state.
time_waited:
type: integer
description: If SESSION_STATE = WAITING, then the time that the session actually spent waiting for that event (in microseconds). This column is set for waits that were in progress at the time the sample was taken. If a wait event lasted for more than a second and was caught waiting in more than one session sample row, then the actual time spent waiting for that wait event will be populated in the last of those session sample rows. At any given time, this information will not be available for the latest session sample.
blocking_session_status:
type: string
description: Status of the blocking session.
blocking_session:
type: integer
description: Session identifier of the blocking session. Populated only if the blocker is on the same instance and the session was waiting for enqueues or a 'buffer busy' wait.
blocking_session_serial#:
type: integer
description: Serial number of the blocking session.
blocking_inst_id:
type: integer
description: Instance number of the blocker shown in BLOCKING_SESSION.
blocking_hangchain_info:
type: string
description: Indicates whether the information about BLOCKING_SESSION comes from the hang chain (Y) or not (N).
current_obj#:
type: integer
description: Object ID of the object that the session is referencing. This information is only available if the session was waiting for application, cluster, concurrency, and user I/O wait events.
current_file#:
type: integer
description: File number of the file containing the block that the session is referencing. This information is only available if the session was waiting for cluster, concurrency, and user I/O wait events.
current_block#:
type: integer
description: ID of the block that the session is referencing. This information is only available if the session was waiting for cluster, concurrency, and user I/O wait events.
current_row#:
type: integer
description: Row identifier that the session is referencing. This information is only available if the session was waiting for cluster, concurrency, and user I/O wait events.
top_level_call#:
type: integer
description: Oracle top level call number.
top_level_call_name:
type: string
description: Oracle top level call name.
consumer_group_id:
type: integer
description: Consumer group ID.
xid:
type: string
description: Transaction ID that the session was working on at the time of sampling.
remote_instance#:
type: integer
description: Remote instance identifier that will serve the block that this session is waiting for. This information is only available if the session was waiting for cluster events.
time_model:
type: integer
description: Time model information.
in_connection_mgmt:
type: string
description: Indicates whether the session was doing connection management at the time of sampling (Y) or not (N).
in_parse:
type: string
description: Indicates whether the session was parsing at the time of sampling (Y) or not (N).
in_hard_parse:
type: string
description: Indicates whether the session was hard parsing at the time of sampling (Y) or not (N).
in_sql_execution:
type: string
description: Indicates whether the session was executing SQL statements at the time of sampling (Y) or not (N).
in_plsql_execution:
type: string
description: Indicates whether the session was executing PL/SQL at the time of sampling (Y) or not (N).
in_plsql_rpc:
type: string
description: Indicates whether the session was executing inbound PL/SQL RPC calls at the time of sampling (Y) or not (N).
in_plsql_compilation:
type: string
description: Indicates whether the session was compiling PL/SQL at the time of sampling (Y) or not (N).
in_java_execution:
type: string
description: Indicates whether the session was executing Java at the time of sampling (Y) or not (N).
in_bind:
type: string
description: Indicates whether the session was doing bind operations at the time of sampling (Y) or not (N).
in_cursor_close:
type: string
description: Indicates whether the session was closing a cursor at the time of sampling (Y) or not (N).
in_sequence_load:
type: string
description: Indicates whether the session is loading in sequence (in sequence load code) (Y) or not (N).
in_inmemory_query:
type: string
description: Indicates whether the session was querying the In-Memory Column Store (IM column store) at the time of sampling (Y) or not (N).
in_inmemory_populate:
type: string
description: Indicates whether the session was populating the IM column store at the time of sampling (Y) or not (N).
in_inmemory_prepopulate:
type: string
description: Indicates whether the session was prepopulating the IM column store at the time of sampling (Y) or not (N).
in_inmemory_repopulate:
type: string
description: Indicates whether the session was repopulating the IM column store at the time of sampling (Y) or not (N).
in_inmemory_trepopulate:
type: string
description: Indicates whether the session was trickle repopulating the IM column store at the time of sampling (Y) or not (N).
in_tablespace_encryption:
type: string
description: Indicates whether encryption or decryption of a tablespace occurred at the time of sampling (Y) or not (N).
capture_overhead:
type: string
description: Indicates whether the session is executing capture code (Y) or not (N).
replay_overhead:
type: string
description: Indicates whether the session is executing replay code (Y) or not (N).
is_captured:
type: string
description: Indicates whether the session is being captured (Y) or not (N).
is_replayed:
type: string
description: Indicates whether the session is being replayed (Y) or not (N).
is_replay_sync_token_holder:
type: string
description: Indicates whether the session is holding a synchronization token (Y) or not (N) during workload replay.
service_hash:
type: integer
description: Hash that identifies the Service.
program:
type: string
description: Name of the operating system program.
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 module when sampled, as set by the DBMS_APPLICATION_INFO.SET_ACTION procedure.
client_id:
type: string
description: Client identifier of the session.
machine:
type: string
description: Client's operating system machine name.
port:
type: integer
description: Client port number.
ecid:
type: string
description: Execution context identifier (sent by Application Server).
dbreplay_file_id:
type: integer
description: If the session is being captured or replayed, then DBREPLAY_FILE_ID is the file ID for the workload capture or workload replay; otherwise it is NULL.
dbreplay_call_counter:
type: integer
description: If the session is being captured or replayed, then DBREPLAY_CALL_COUNTER is the call counter of the user call that is being captured or replayed; otherwise it is NULL.
tm_delta_time:
type: integer
description: Time interval (in microseconds) over which TM_DELTA_CPU_TIME and TM_DELTA_DB_TIME are accumulated.
tm_delta_cpu_time:
type: integer
description: Amount of time this session spent on CPU over the last TM_DELTA_TIME microseconds.
tm_delta_db_time:
type: integer
description: Amount of time spent by this session in database calls over the last TM_DELTA_TIME microseconds.
delta_time:
type: integer
description: Time interval (in microseconds) since the last time this session was sampled or created, over which the next five statistics are accumulated.
delta_read_io_requests:
type: integer
description: Number of read I/O requests made by this session over the last DELTA_TIME microseconds.
delta_write_io_requests:
type: integer
description: Number of write I/O requests made by this session over the last DELTA_TIME microseconds.
delta_read_io_bytes:
type: integer
description: Number of I/O bytes read by this session over the last DELTA_TIME microseconds.
delta_write_io_bytes:
type: integer
description: Number of I/O bytes written by this session over the last DELTA_TIME microseconds.
delta_interconnect_io_bytes:
type: integer
description: Number of I/O bytes sent over the I/O interconnect over the last DELTA_TIME microseconds.
delta_read_mem_bytes:
type: integer
description: Number of read bytes through the buffer cache.
pga_allocated:
type: integer
description: Amount of PGA memory (in bytes) consumed by this session at the time this sample was taken.
temp_space_allocated:
type: integer
description: Amount of TEMP memory (in bytes) consumed by this session at the time this sample was taken.
con_id:
type: integer
description: The ID of the container to which the data pertains.
dbop_name:
type: string
description: Database operation name. If the type is SQL, the DBOP_NAME will be NULL.
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.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
PerformanceSQLStatements:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/PerformanceSQLStatementsItem'
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'
PerformanceSQLStatementsItem:
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'
LinkRelation:
type: object
properties:
rel:
type: string
href:
type: string
required:
- rel
- href
PerformanceTopSQLStatementsMaximumsItem:
type: object
description: Describes the maximum values on GV$SQL view.
properties:
max_cpu_time:
type: integer
description: Maximum CPU time (in microseconds) used by an SQL Statement for parsing, executing, and fetching.
max_elapsed_time:
type: integer
description: Maximum elapsed time (in microseconds) used by an SQL Statement for parsing, executing, and fetching.
max_disk_reads:
type: integer
description: Maximum number of disk reads by an SQL Statement.
max_buffer_gets:
type: integer
description: Maximum number of buffer gets by an SQL Statement.
max_executions:
type: integer
description: Maximum number of executions that took place for an SQL Statement since it was brought into the library cache.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
Filter:
type: object
description: See Oracle REST Data Services production documentation 'Filtering in Queries' section.
externalDocs:
url: https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/
anyOf:
- type: object
description: Any key / value pair for specifying a Filter Criteria.
- type: object
properties:
$orderby:
description: Specify which properties to order the result set by.
type: object
$asof:
description: Specify a time related query parameter to limit the results. Parameter value can be a System Change Number or a Date.
type: object
PerformanceActionSessionHistories:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/PerformanceActionSessionHistoriesItem'
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'
examples:
FilterCriteria:
summary: Implicit EQUALS operator for a number. Supports String and Dates too.
value:
SALARY: 1000
OrderByProperty:
summary: Order by with literals.
value:
$orderby:
SALARY: ASC
ENAME: DESC
FilterAndOrder:
summary: Filter criteria supports a wide range of operators. In this example LIKE operator ($like) is used. See Oracle REST Data Services production documentation 'Filtering in Queries' section for further information on the operators available.
value:
ENAME:
$like: AX%
$orderby:
ENAME: ASC
parameters:
Filter:
name: q
in: query
description: 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.
required: false
schema:
$ref: '#/components/schemas/Filter'
examples:
FilterCriteriaExample:
$ref: '#/components/examples/FilterCriteria'
OrderByPropertyExample:
$ref: '#/components/examples/OrderByProperty'
FilterAndOrderExample:
$ref: '#/components/examples/FilterAndOrder'
Limit:
name: limit
in: query
description: The maximum number of records to return.
required: false
schema:
type: integer
format: int32
securitySchemes:
BasicAuth:
type: http
scheme: basic
BearerAuth:
type: http
scheme: bearer
OAuth2:
type: oauth2
flows:
implicit:
authorizationUrl: /oauth/auth
scopes: {}
authorizationCode:
authorizationUrl: /oauth/auth
tokenUrl: /oauth/token
scopes: {}
clientCredentials:
tokenUrl: /oauth/token
scopes: {}
externalDocs:
description: Oracle REST Data Services product documentation.
url: https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/