GV$OB_SQL_AUDIT

2024-07-18 01:57:31  Updated

Purpose

The GV$OB_SQL_AUDIT view displays the statistics about each SQL request on all OBServer nodes, such as the source and execution status. This view is tenant-specific, and only the sys tenant can query this view in other tenants.

Note

This view is introduced since OceanBase Database V4.0.0.

Columns

Column Type Nullable? Description
SVR_IP varchar(46) NO The IP address of the server.
SVR_PORT bigint(20) NO The port number of the server.
REQUEST_ID bigint(20) NO The ID of the request.
SQL_EXEC_ID bigint(20) NO The ID of the current execution.
TRACE_ID varchar(128) NO The trace ID of the statement.
SID bigint(20) unsigned NO The ID of the session connection.
CLIENT_IP varchar(46) NO
  • When the client is connected to the OBServer node by using OceanBase Database Proxy (ODP), this column indicates the IP address of the ODP instance that forwarded the request.
  • When the client is directly connected to the OBServer node, this column indicates the IP address of the client that sent the request.
  • CLIENT_PORT bigint(20) NO The port number of the client that sent the request.
    TENANT_ID bigint(20) NO The ID of the tenant that sent the request.
    TENANT_NAME varchar(64) NO The name of the tenant that sent the request.
    EFFECTIVE_TENANT_ID bigint(20) NO The ID of the tenant.
    USER_ID bigint(20) NO The ID of the user that sent the request.
    USER_NAME varchar(64) NO The name of the user that sent the request.
    USER_GROUP bigint(20) YES The ID of the resource group to which the user belongs.
    USER_CLIENT_IP varchar(46) NO The IP address of the client that sent the request.
    DB_ID bigint(20) unsigned NO The ID of the database.
    DB_NAME varchar(128) NO The name of the database.
    SQL_ID varchar(32) NO The ID of the SQL statement.
    QUERY_SQL longtext NO The actual SQL statement.
    PLAN_ID bigint(20) NO The ID of the execution plan.
    AFFECTED_ROWS bigint(20) NO The number of rows affected.
    RETURN_ROWS bigint(20) NO The number of rows returned.
    PARTITION_CNT bigint(20) NO The number of partitions scanned by the request.
    RET_CODE bigint(20) NO The return code of the execution. Valid values:
  • 0: indicates that the statement is successfully executed without errors.
  • Other return codes: indicate that OceanBase Database has encountered an error. For more information about the error codes, see Error codes
  • QC_ID bigint(20) unsigned NO The ID of the scheduler in the parallel execution scenario.
    DFO_ID bigint(20) NO The ID of the sub-plan being executed in the parallel execution scenario.
    SQC_ID bigint(20) NO The ID of the local coordinator in the parallel execution scenario.
    WORKER_ID bigint(20) NO The ID of the worker thread in the parallel execution scenario.
    EVENT varchar(64) NO The name of the wait event with the longest wait time.
    P1TEXT varchar(64) NO The first parameter of the wait event.
    P1 bigint(20) unsigned NO The value of the first parameter of the wait event.
    P2TEXT varchar(64) NO The second parameter of the wait event.
    P2 bigint(20) unsigned NO The value of the second parameter of the wait event.
    P3TEXT varchar(64) NO The third parameter of the wait event.
    P3 bigint(20) unsigned NO The value of the third parameter of the wait event.
    LEVEL bigint(20) NO The level of the wait event.
    WAIT_CLASS_ID bigint(20) NO The ID of the class to which the wait event belongs.
    WAIT_CLASS# bigint(20) NO The subscript of the class to which the wait event belongs.
    WAIT_CLASS varchar(64) NO The name of the class to which the wait event belongs.
    STATE varchar(19) NO The status of the wait event.
    WAIT_TIME_MICRO bigint(20) NO The wait time of the wait event in microseconds.
    TOTAL_WAIT_TIME_MICRO bigint(20) NO The total wait time in microseconds during execution.
    TOTAL_WAITS bigint(20) NO The total number of waits during the execution.
    RPC_COUNT bigint(20) NO The number of remote procedure calls (RPCs) sent.
    PLAN_TYPE bigint(20) NO The type of the execution plan. Valid values:
  • local
  • remote
  • distribute
  • IS_INNER_SQL tinyint(4) NO Indicates whether the request is an internal SQL request.
    IS_EXECUTOR_RPC tinyint(4) NO Indicates whether the current request is an RPC request.
    IS_HIT_PLAN tinyint(4) NO Indicates whether the plan cache is hit.
    REQUEST_TIME bigint(20) NO The time when the execution started, in microseconds.
    ELAPSED_TIME bigint(20) NO The amount of time elapsed from when the request was received to when the execution of the request ended, in microseconds.
    NET_TIME bigint(20) NO The amount of time elapsed from when the RPC request was sent to when the request was received, in microseconds.
    NET_WAIT_TIME bigint(20) NO The amount of time elapsed from when the request was received to when it entered the queue, in microseconds.
    QUEUE_TIME bigint(20) NO The time that the request waited in the queue, in microseconds.
    DECODE_TIME bigint(20) NO The time spent on decoding the request after it left the queue, in microseconds.
    GET_PLAN_TIME bigint(20) NO The amount of time elapsed from when the processing started to when the plan was obtained, in microseconds.
    EXECUTE_TIME bigint(20) NO The time consumed for plan execution, in microseconds.
    APPLICATION_WAIT_TIME bigint(20) unsigned NO The total amount of time spent on waiting for events of the Application class, in microseconds.
    CONCURRENCY_WAIT_TIME bigint(20) unsigned NO The total amount of time spent on waiting for events of the Concurrency class, in microseconds.
    USER_IO_WAIT_TIME bigint(20) unsigned NO The total amount of time spent on waiting for events of the user_io class, in microseconds.
    SCHEDULE_TIME bigint(20) unsigned NO The total amount of time spent on waiting for events of the Schedule class, in microseconds.
    ROW_CACHE_HIT bigint(20) NO The number of row cache hits.
    BLOOM_FILTER_CACHE_HIT bigint(20) NO The number of Bloom filter cache hits.
    BLOCK_CACHE_HIT bigint(20) NO The number of block cache hits.
    DISK_READS bigint(20) NO The number of physical reads.
    RETRY_CNT bigint(20) NO The number of retries.
    TABLE_SCAN tinyint(4) NO Indicates whether the request contains a full table scan.
    CONSISTENCY_LEVEL bigint(20) NO The consistency level.
    MEMSTORE_READ_ROW_COUNT bigint(20) NO The number of rows read in the MemStore.
    SSSTORE_READ_ROW_COUNT bigint(20) NO The number of rows consecutively read in the SSStore.
    DATA_BLOCK_READ_CNT bigint(20) NO The number of data microblocks accessed.
    DATA_BLOCK_CACHE_HIT bigint(20) NO The number of data microblock cache hits.
    INDEX_BLOCK_READ_CNT bigint(20) NO The number of intermediate-layer microblocks accessed.
    INDEX_BLOCK_CACHE_HIT bigint(20) NO The number of intermediate-layer microblock cache hits.
    BLOCKSCAN_BLOCK_CNT bigint(20) NO The number of data microblocks scanned during a unilateral scan.
    BLOCKSCAN_ROW_CNT bigint(20) NO The number of data rows scanned during a unilateral scan.
    PUSHDOWN_STORAGE_FILTER_ROW_CNT bigint(20) NO The number of rows that remain after the filter condition is pushed down to and applied in the storage layer.
    REQUEST_MEMORY_USED bigint(20) NO The memory consumed by the request.
    EXPECTED_WORKER_COUNT bigint(20) NO The number of worker threads expected by the request.
    USED_WORKER_COUNT bigint(20) NO The number of worker threads used by the request.
    SCHED_INFO varchar(16384) YES The scheduling information about the request.
    FUSE_ROW_CACHE_HIT bigint(20) NO At present, this column is not supported and is NULL by default.
    PS_CLIENT_STMT_ID bigint(20) NUMBER(38) This field is used to record the client Prepare ID corresponding to the request.
    • -1: Indicates that the current SQL statement did not use the PS protocol. That is, the statement is executed directly without going through the preparation steps.
    • Values other than -1: Indicates that the current SQL statement used the PS protocol, and this value is the unique identifier returned by the client for the prepared statement. This value is used to reference the previously prepared SQL statement in subsequent operations.
    PS_INNER_STMT_ID bigint(20) NUMBER(38) This field is used to record the inner (database internal) Prepare ID corresponding to the request.
    • -1: Indicates that the current SQL statement did not use the Prepare Statement (PS) protocol. That is, the statement is executed directly without going through the preparation steps.
    • Values other than -1: Indicates that the current SQL statement used the Prepare Statement (PS) protocol, and this value is the unique identifier returned by the client for the prepared statement. This value is used to reference the previously prepared SQL statement in subsequent operations.
    TX_ID bigint(20) NO The ID of the transaction corresponding to the request.
    SNAPSHOT_VERSION bigint(20) NO The snapshot version used by the SQL statement.
    REQUEST_TYPE bigint(20) NO The type of the request. Valid values:
  • 0: indicates an invalid request.
  • 1: indicates an internal request.
  • 2: indicates a local request whose execution plan is a local plan.
  • 3: indicates a remote request.
  • 4: indicates a distributed request.
  • 5: indicates an SQL PREPARE request.
  • 6: indicates an SQL Execute Stmt request.
  • IS_BATCHED_MULTI_STMT tinyint(4) NO Indicates whether optimization has been performed for batch execution of multiple statements.
    OB_TRACE_INFO varchar(4096) NO The trace information configured by the user.
    PLAN_HASH bigint(20) unsigned NO The hash value of the execution plan.
    LOCK_FOR_READ_TIME bigint(20) NO The time in microseconds spent on waiting for locked data to be unlocked before it can be read.
    PARAMS_VALUE longtext NO The PS-bound parameter value.
    RULE_NAME varchar(256) NO The name of the rule.
    PARTITION_HIT tinyint(4) NO
    • If a DAS execution plan is obtained and a local partition is hit, the value is 1. If no local partition is hit, the value is 0.
    • If no DAS execution plan is obtained, the value is 1.
    TX_INTERNAL_ROUTING bigint(20) NO Indicates whether the SQL statement is internally routed. Valid values
    • 0: The SQL statement is directly executed on the current node without being routed to another node.
    • 1: The SQL statement is routed from the current node to another node for execution.
    TX_STATE_VERSION bigint(20) unsigned NO The transaction status version of the SQL statement.
    FLT_TRACE_ID varchar(1024) NO The trace ID of this record in end-to-end diagnostics. If this column is left empty, the record is not monitored in end-to-end diagnostics. The value is a universally unique identifier (UUID), which is different from a trace. The format is similar to 000600d6-a5de-038c-6c80-df07e4e79149.

    Note

    This column is introduced since OceanBase Database V4.2.1.

    Contact Us