Skip to content

16.3.5 Complete Virtual Table Reference

Virtual tables are read-only tables that expose Machbase server operational information. Their names start with V$. Use them to inspect server status or JOIN them with other tables to analyze operational data. INSERT, UPDATE, and DELETE are not supported.

Contents

Session/System

V$PROPERTY


Displays server property settings.

ColumnDescription
NAMEProperty name
VALUEProperty value
TYPEData type
DEFLTDefault value
MINMinimum set value
MAXMaximum set value

V$SESSION


Displays sessions connected to the Machbase server.

ColumnDescription
HOSTNAME (Cluster Only)Name of the HOST which the session is connected.
IDSession identifier
CLOSEDWhether connection is closed
USER_IDUser identifier
LOGIN_TIMEConnection time
CLIENT_TYPEConnected client type
USER_NAMEUser name
CURRENT_DB_IDCurrent logical database identifier for the session
CURRENT_DB_NAMECurrent database name for the session
USER_IPUser IP address
SQL_LOGGINGWhether to write messages to the session trace log.
Logs errors during parsing, validation, and optimization.
Logs DDL execution results.
(Includes both cases above)
SHOW_HIDDEN_COLSWhether hidden columns are shown upon SELECT
FEEDBACK_APPEND_ERRORWhether to fail immediately when an APPEND error is detected
DEFAULT_DATE_FORMATDefault input format upon Datetime input
MAX_QPX_MEMMaximum memory size available when performing query
IDLE_TIMEOUTTerminate the session if the client does nothing for that time after the session connected.
QUERY_TIMEOUTResponse waiting time for query execution
DDL_LOCK_TIMEOUT (Standard Only)Wait for a conflicting DDL lock, in seconds. 0 returns an error immediately.
TRANSACTION_BUSY_TIMEOUT_MSWait for a TRANSACTION write conflict, in milliseconds. -1 waits indefinitely; 0 returns an error immediately.

V$SESMEM


Displays session memory information.

ColumnDescription
SIDSession identifier
IDMemory manager identifier
USAGEUsage size

V$SESSTAT


Displays session statistics.

ColumnDescription
SIDSession identifier
IDStatistical information identifier
VALUEStatistical information value

V$SESTIME


Displays session timing information.

ACCUM_MSEC and MAX_MSEC are DOUBLE values in milliseconds.

ColumnDescription
SIDSession identifier
IDPerformance unit identifier
ACCUM_MSECAccumulated time
MAX_MSECMaximum time per operation

V$SYSMEM


Displays system memory information.

ColumnDescription
IDMemory manager identifier
NAMEMemory manager name
USAGECurrent usage
MAX_USAGE(Recorded) Maximum usage

V$SYSSTAT


Displays system statistics.

ColumnDescription
IDStatistical information identifier
NAMEStatistical information name
VALUEStatistical information value

V$SYSTIME


Displays system timing information.

ACCUM_MSEC, AVG_MSEC, MIN_MSEC, and MAX_MSEC are DOUBLE values in milliseconds.

ColumnDescription
IDPerformance unit identifier
NAMEPerformance unit name
ACCUM_MSECAccumulated time
AVG_MSECAverage time per operation
MIN_MSECMinimum time per operation
MAX_MSECMaximum time per operation
COUNTPerformance frequency

V$STMT


Displays information about queries currently running for users.

ColumnDescription
IDQuery identifier
SESS_IDPerformed query session identifier
STATEQuery status
RECORD_SIZEResulting record size of select statements
QUERYQuery statement

V$VERSION


Displays Machbase version information.

ColumnDescription
BINARY_DB_MAJOR_VERSIONDatabase major version
BINARY_DB_MINOR_VERSIONDatabase minor version
BINARY_META_MAJOR_VERSIONMETA major version
BINARY_META_MINOR_VERSIONMETA minor version
BINARY_CM_MAJOR_VERSIONClient (Communication Level) major version
BINARY_CM_MINOR_VERSIONClient (Communication Level) minor version
BINARY_SIGNATUREVersion name of the database server binary
FILE_DB_MAJOR_VERSIONFile DB major version
FILE_DB_MINOR_VERSIONFile DB minor version
FILE_META_MAJOR_VERSIONFile META major version
FILE_META_MINOR_VERSIONFile META minor version
FILE_CM_MAJOR_VERSIONFile Client (Communication Level) major version
FILE_CM_MINOR_VERSIONFile Client (Communication Level) minor version
FILE_CREATE_TIMEFile creation time
EDITIONMachbase type

V$DATABASES


Displays the status of logical active databases and mounted databases. DATABASE_ID is a logical catalog identifier and differs from the physical TABLESPACE_ID.

ColumnDescription
DATABASE_IDLogical database identifier
SOURCE_DATABASE_IDSource database identifier of a mounted backup
NAMEDatabase name or mount alias
KINDACTIVE or MOUNTED
ACCESS_MODEREAD_WRITE or READ_ONLY
CAN_USEWhether the database can be selected with USE
STATELifecycle state
IS_DEFAULTWhether this is the default MACHBASEDB
SELECT database_id, name, kind, access_mode, can_use, state, is_default
  FROM v$databases
 ORDER BY database_id;

V$DATABASE_OPERATIONS


Displays database lifecycle operation status and errors.

ColumnDescription
OPERATION_IDOperation identifier
DATABASE_IDTarget logical database identifier
DATABASE_NAMETarget database name
STATEOperation state
LAST_ERRORFailure cause
CREATED_ATCreation timestamp
UPDATED_ATLast update timestamp
SELECT operation_id, database_name, state, last_error
  FROM v$database_operations
 ORDER BY operation_id DESC;

V$NEO_SESSION


Displays session status for Neo protocol clients.

ColumnDescription
IDSession identifier
USER_IDUser identifier
USER_NAMEUser name
STMT_COUNTStatement count in the session
DISCONN_FLAGDisconnect flag

V$NEO_STMT


Displays statement status for Neo protocol clients.

ColumnDescription
IDStatement identifier
SESS_IDSession identifier
STATEStatement state
QUERYStatement text
APPEND_SUCCESS_CNTAppend success count
APPEND_FAILURE_CNTAppend failure count

PVO Statement Cache

Displays global PVO Statement Cache status, available only in Standard Edition.

V$PVO_CACHE_STAT


Displays overall PVO Statement Cache statistics.

ColumnDescription
CACHE_ENTRY_COUNTNumber of SQL entries stored in cache
CACHE_HANDLE_COUNTTotal cached plans (handles) across SQLs
CACHE_MEMORY_USAGECurrent cache memory usage
CACHE_MAX_MEMORY_SIZEConfigured cache memory limit
CACHE_MAX_PLANS_PER_SQLMaximum plans allowed per SQL
CACHE_MAX_SQL_ENTRIESMaximum SQL entries allowed (0 = unlimited)
CACHE_SHARD_COUNTNumber of cache shards
CACHE_HITCache hit count
CACHE_MISSCache miss count
SINGLEFLIGHT_WAITWait count for concurrent same-SQL build
BUILD_COUNTPlan build attempts
BUILD_FAILPlan build failures
INVALIDATE_COUNTInvalidated plans
EVICT_COUNTEvictions due to limits
FLUSH_COUNTExplicit or internal flush count

V$PVO_CACHE_LIST


Displays details for each SQL statement stored in PVO Statement Cache.

ColumnDescription
TOUCH_TIMELast touch time
USER_IDOwner user identifier
QUERYOriginal SQL text
DEFAULT_DATE_FORMATDate format at execution time
TIMEZONE_OFFSETTimezone offset at execution time
SHOW_HIDDEN_COLSWhether hidden columns are shown
QUERY_PARALLEL_FACTORParallel execution factor
HANDLE_COUNTNumber of cached plans
BUSY_COUNTNumber of handles currently in use
HIT_COUNTCache hit count
BUILD_IN_PROGRESSWhether a build is in progress

Storage

V$STORAGE


Displays storage system internals.

ColumnDescription
DC_TABLE_FILE_SIZETotal capacity of disk column data
DC_INDEX_FILE_SIZETotal capacity of index file data
DC_TABLESPACE_DWFILE_SIZETotal capacity of DWFILE for all column data
DC_KV_TABLE_FILE_SIZETotal data file size of TAGDATA partition tables

V$STORAGE_MOUNT_DATABASES


Displays backup databases mounted with the mount feature.

ColumnDescription
NAMEMounted database name
PATHBackup file location
BACKUP_TBSIDBackup database tablespace identifier
BACKUP_SCNBackup database identifier
MOUNTDBDatabase alias specified when mounting
DB_BEGIN_TIMEBackup database first entry time
DB_END_TIMEBackup database last entry time
BACKUP_BEGIN_TIMEBackup begin time
BACKUP_END_TIMEBackup end time
FLAGProperty flag

V$CACHE


Displays aggregate information about objects that cache results read by the Storage Manager.

ColumnDescription
OBJ_COUNTCurrent number of result set cache objects

V$CACHE_OBJECTS


Displays each object that caches results read from the storage system.

ColumnDescription
OIDObject identifier
REF_COUNTReference count
FLAG(Internal server use flag)

V$STORAGE_DC_TABLESPACES


Displays storage system tablespace information.

ColumnDescription
NAMETablespace name
IDTablespace identifier
FLAGFlag indicating tablespace property
REF_COUNTTablespace reference count
DISK_COUNTTablespace disk count

V$STORAGE_DC_TABLESPACE_DISKS


Displays storage system tablespace information.

ColumnDescription
NAMEDisk name
IDDisk identifier
TABLESPACE_IDDisk tablespace identifier
PATHDisk path
IO_THREAD_COUNTI/O Thread count
IO_JOB_COUNTI/O Job count
VIRTUAL_DISK_COUNTVirtual disk count

V$STORAGE_DC_DWFILES


Displays doublewrite (DW) files managed by the storage system.

ColumnDescription
TBS_IDTablespace identifier
DISK_IDDisk identifier
FILEFile path
TABLE_IDTable identifier
COLUMN_IDColumn identifier
PARTITION_IDPartition identifier
PAGE_IDPage identifier
DISK_OFFSETDisk offset
DISK_IMAGE_SIZEDisk image size
HEAD_CRC32CODE_IMAGEHead CRC32 Code Image
TAIL_CRC32CODE_IMAGETail CRC32 Code Image
CRC32CODE_PAGECRC32 Code Page
HEAD_TIMESTAMP_PAGEHead Timestamp Page
TAIL_TIMESTAMP_PAGETail Timestamp Page

V$STORAGE_DC_PAGECACHE


Displays the page cache managed by the storage system.

ColumnDescription
MAX_MEM_SIZEMaximum memory size of Page Cache
CUR_MEM_SIZECurrent memory size of Page Cache
PAGE_CNTNumber of cached pages
CHECK_TIMECheck time

V$STORAGE_DC_PAGECACHE_LRU_LST


Displays the LRU list of the page cache managed by the storage system.

ColumnDescription
SIZEPage size
REF_CNTReference count
PARTITION_IDPartition identifier
OFFSETPage Cache Offset
OBJECT_IDObject identifier
LEVELPartition level

V$STORAGE_USAGE


Displays storage usage.

ColumnDescription
TOTAL_SPACETotal storage capacity where the $MACHBASE_HOME/dbs directory is located
USED_SPACETotal storage usage where the $MACHBASE_HOME/dbs directory is located
USED_RATIOPercentage of usage(%)
RATIO_CAPStorage usage limit. Data input/index construction stops when USED_RATIO reaches this limit.

V$STORAGE_TABLES


Displays table details.

ColumnDescription
IDTable ID
TYPETable type
Persistent: LOG and TAG tables
Volatile: Volatile tables
Key-Value: Auxiliary tables of TAG tables
STATUSCurrent Status
- Creating…: Creating table by CREATE TABLE query
- Normal: normal
- Predrop: DROP TABLE query accepted
- Dropping…: DROP TABLE query processing
- Dropped: DROP TABLE query completed
- Mounted: The backed up database loaded with the MOUNT query
STORAGE_USAGECapacity occupied by the table in storage

Log Table

V$STORAGE_DC_TABLES


Displays Log table internals.

ColumnDescription
IDTable identifier
TABLESPACE_IDTablespace identifier
CREATE_SCNSystem Change Number at time of creation
UPDATE_SCNSystem Change Number at time of most recent update
DDL_REF_COUNTNumber of sessions referencing table in DDL syntax execution
BEGIN_RIDMinimum table RID
END_RIDLast row ID of table + 1
BEGIN_META_RIDID at start of recording meta information
END_META_RIDID at end of recording meta information
END_SYNC_RIDLast row ID recorded on disk + 1
FLAGFlag indicating table property
COLUMN_COUNTTable column count
INDEX_COUNTTable index count
INDEX_MIN_END_RIDLast RID recorded in index + 1
LAST_ARRIVAL_TIMELast recorded _arrival_time value
LAST_CHECKPOINT_TIMELast checkpoint time
TYPETable type

V$STORAGE_DC_TABLES_STAT


Displays Log table internals.

ColumnDescription
TABLESPACE_IDTablespace identifier
TABLE_IDTable identifier
COUNTRecord count
COLUMN_IDColumn identifier

V$STORAGE_DC_TABLE_COLUMNS


Displays Log table column information.

ColumnDescription
TABLE_IDTable identifier
TABLESPACE_IDTablespace identifier
IDColumn identifier
FLAGProperty flag
SIZEColumn data size
PARTITION_VALUE_COUNTMaximum number of data stored in partition
PAGE_VALUE_COUNTMaximum number of data stored in page
CACHE_VALUE_COUNTMaximum number of cache values
MINMAX_CACHE_SIZEMaximum size of MIN / MAX cache for column partitions
CUR_APPEND_PARTITION_IDCurrent partition in progress of input identifier
CUR_CACHE_PARTITION_COUNTNumber of partitions that have read data in current cache
CUR_MINMAX_CACHE_SIZECurrent Min / MAX cache size
END_RID_FOR_DEFAULT_VALUEColumn values with RIDs below this value use the default value
DISK_FILE_SIZETotal size of column partition data file for that column
MEMORY_TOTAL_SIZEMemory size used by table
MEMORY_ALLOC_SIZEMemory size allocated by table

V$STORAGE_DC_TABLE_COLUMN_PARTS


Displays Log table column partition information.

ColumnDescription
TABLE_IDTable identifier
TABLESPACE_IDTablespace identifier
COLUMN_IDColumn identifier
IDPartition identifier
FLAGFlag indicating column property
BEGIN_RIDFirst RID stored in partition
END_RIDLast RID stored in partition
END_SYNC_RIDLast RID SYNC ended.

Data with a RID greater than the starting RID and less than the last SYNC RID is recorded in the partition file.
MIN_TIMEFirst time data was entered into column partition
MAX_TIMELast time data was entered into column partition
MAX_VALUE_COUNT_PER_PARTITIONMaximum partition data count
MAX_VALUE_COUNT_PER_PAGEMaximum page data count
MAX_PAGE_COUNTMaximum partition page count
PAGE_SIZEPage size stored in column partition
PAGE_COUNTPage count created in current column partition
COMPRESS_RATIOColumn partition compression ratio. If it is 0, data compression has not been performed yet.
DISK_FILENAMEPartition file name
EXTERNAL_PART_SIZEA large amount of data is written to the external partition file, indicating the size of the file
MIN_VALUEMinimum column partition value
MAX_VALUEMaximum column partition value

V$STORAGE_DC_TABLE_INDEXES


Displays indexes created on Log tables.

ColumnDescription
TABLE_IDTable identifier
TABLESPACE_IDTablespace identifier
IDIndex identifier
FLAGFlag indicating index property
TABLE_BEGIN_RIDFirst RID entered into table
TABLE_END_RIDLast table RID
BEGIN_RIDFirst index RID
END_RIDLast index RID
END_SYNC_RIDLast recorded RID in file + 1
COLUMN_COUNTIndex column count
BEGIN_PART_IDIndex first partition identifier
END_PART_IDIndex last partition identifier
FLUSH_REQUEST_COUNTNumber of index partitions requested to reflect on disk
MAX_KEY_SIZEMaximum key size
INDEX_TYPEIndex type
DISK_FILE_SIZETotal size of index partition file for that index
LAST_CHECKPOINT_TIMELast checkpoint time

LSM(Log Structured Merge) Index

V$STORAGE_DC_LSMINDEX_LEVEL_PARTS


Displays LSM index partition information.

ColumnDescription
TABLE IDIndex table identifier
TABLESPACE_IDTablespace identifier
INDEX_IDIndex identifier
LEVELIndex partition LSM level
PARTITION_IDPartition identifier
BEGIN_RIDFirst RID entered into partition
END_RIDLast RID entered into partition + 1
KEY_VALUE_COUNTKey value count entered into partition
KEY_VALUE_TABLE_SIZESize of page storing key value
KEY_VALUE_TABLE_PAGE_COUNTNumber of pages storing key value
MIN_KEY_VALUEMinimum key value
MAX_KEY_VALUEMaximum key value
BITMAP_TABLE_SIZETotal size of page storing bitmap value
BITMAP_TABLE_PAGE_COUNTNumber of pages storing bitmap value
META_SIZETotal size of page storing meta information
META_PAGE_COUNTNumber of pages storing meta information
TOTAL_BUILD_MSECTotal time to complete partition
KEYVAL_BUILD_MSECTotal time to complete partition for KeyValue Mode
BITMAP_BUILD_MSECTotal time to complete partition for Bitmap Mode

V$STORAGE_DC_LSMINDEX_LEVEL_PARTS_CACHE


Displays LSM index partition cache information.

ColumnDescription
BEGIN_RIDFirst RID entered into partition
BITMAP_TABLE_PAGE_COUNTNumber of pages storing bitmap value
BITMAP_TABLE_SIZETotal size of page storing bitmap value
END_RIDLast RID entered into partition + 1
INDEX_IDIndex identifier
KEY_VALUE_COUNTNumber of key values entered into partition
KEY_VALUE_TABLE_PAGE_COUNTNumber of pages storing key value
KEY_VALUE_TABLE_SIZESize of page storing key value
LEVELIndex partition LSM level
MEMORY_SIZEMemory usage
MEMORY_SIZE_RBTREERedblack Tree memory usage
META_PAGE_COUNTNumber of pages storing meta information
META_SIZETotal size of page storing meta information
PARTITION_IDPartition identifier
TABLE_IDIndex Table identifier
TABLESPACE_IDTablespace identifier

V$STORAGE_DC_LSMINDEX_LEVELS


Displays LSM index level information.

ColumnDescription
TABLE_IDTable identifier
TABLESPACE_IDTablespace identifier
INDEX_IDIndex identifier
LEVELLevel
BEGIN_RIDFirst partition RID
END_RIDLast partition RID + 1
META_BEGIN_RIDRID at start time of recording meta information
META_END_RIDRID at end time of recording meta information
DELETE_END_RIDMaximum deleted RID + 1

V$STORAGE_DC_LSMINDEX_FILES


Displays files that make up LSM indexes.

ColumnDescription
TABLE_IDTable identifier
TABLESPACE_IDTablespace identifier
INDEX_IDIndex identifier
LEVELIndex partition LSM level
PARTITION_IDPartition identifier
BEGIN_RIDPartition first RID
END_RIDPartition last RID + 1
PATHIndex file location

V$STORAGE_DC_LSMINDEX_AGER_JOBS


Displays job status for the ager responsible for LSM index deletion.

ColumnDescription
TABLE_IDTable identifier
INDEX_IDIndex identifier
LEVELIndex partition LSM level
BEGIN_RIDFirst partition RID
END_RIDLast partition RID + 1
STATEIndex Ager working status

Volatile Table

V$STORAGE_DC_VOLATILE_TABLE


Displays Volatile table information.

ColumnDescription
MAX_MEM_SIZEMaximum Volatile Tablespace size
CUR_MEM_SIZECurrent Volatile Tablespace size

Tag Table

V$STORAGE_TAG_TABLES


Displays partition tables of Tagdata tables.

ColumnDescription
IDTable identifier
TABLE_BEGIN_RIDTable start RID
TABLE_END_RIDTable end RID
WRITE_END_RIDLast RID which is written to data file.
EXT_ROW_COUNTNumber of entries to external partitions in VARCHAR records
EXT_WRITE_COUNTNumber of entries to data files in VARCHAR records
DISK_INDEX_END_RIDIndex end RID stored in storage
MEMORY_INDEX_END_RIDTable end RID in memory index
DELETE_MIN_DATEMinimum time of deleted data by execute DELETE BETWEEN query
DELETE_MAX_DATEMaximum time of deleted data by execute DELETE BETWEEN/BEFORE query
INDEX_STATECurrent Index Build State
- IDLE: Build Complete, waiting
- PROGRESS: Build in progress
- IOWAIT: Waiting for I/O operation in storage
- PENDING: Waiting for table read lock
- SHUTDOWN: Stopped. DELETE operation or DROP operation in progress.
- ABNORMAL: Abnormal end
DELETE_STATECurrent DELETE operation state. There is no IDLE state because this runs only when a DELETE command is received.
PROGRESS: Deletion in progress
IOWAIT: Waiting for storage I/O
PENDING: Waiting for a table read/write lock
SHUTDOWN: Stopped; no DELETE operation is running
ABNORMAL: Abnormal termination
SAVE_STATECurrent Table Save operation state.
- IDLE: Save Complete, waiting
- PROGRESS: Save in progress
- IOWAIT: Waiting for I/O operation in storage
- PENDING: Waiting for table read lock
- SHUTDOWN: Stopped. DELETE operation or DROP operation in progress.
- ABNORMAL: Abnormal end
VINDEX_STATECurrent VARCHAR Index Build State
- IDLE: Build Complete, waiting
- PROGRESS: Build in progress
- IOWAIT: Waiting for I/O operation in storage
- PENDING: Waiting for table read lock
- SHUTDOWN: Stopped. DELETE operation or DROP operation in progress.
- ABNORMAL: Abnormal end

V$STORAGE_TAG_CACHE


Displays the cache used by Tagdata partition tables.

ColumnDescription
POOL_IDCache pool identifier
CATEGORYType of object in cache
USED_MEMORYSize of memory in use
BLOCK_COUNTData cache count
CACHE_HITData cache hit count
CACHE_MISSData cache miss count
FLUSHOUTPages flushed out because of data cache conflicts
COLD_READData pages read directly from storage
MEMORY_WAITTimes data memory waited because of cache conflicts
IO_WAITData read operation wait count

V$STORAGE_TAG_CACHE_BASE


Displays aggregate tag cache pool information.

ColumnDescription
POOL_IDCache pool identifier
TOTAL_CACHE_MEMORYTotal cache memory
TOTAL_OBJECT_COUNTTotal cached object count
TOTAL_LRU_LOOP_COUNTTotal LRU loop count

V$STORAGE_TAG_CACHE_OBJECTS


Displays details for each cache block used by Tagdata partition tables.

ColumnDescription
CATEGORYObject classification being cached
LATEST_HITLast access timestamp
STATUSCache status
- None: Memory allocation done
- Resides: Already stored in cache
- Loading: Loading table data from storage
- ERROR!: Error appears while loading data
WAIT_COUNTThe number of waiting times because the cache could not be read in the Loading state
REF_COUNTNumber of sessions currently referencing the cache block
HIT_COUNTNumber of times a cache block was referenced
TABLE_IDTable Identifier
FILE_IDFile Identifier
PART_IDPartition identifier inside the datafile
SAVE_SCNSCN of table save
VSAVE_SCNSCN of table save
DELETE_SCNSCN of delete operation
OFFSETDatafile offset
DATA_SIZEData size before compression, or 0

V$STORAGE_TAG_TABLE_FILES


Displays files of Tagdata partition tables.

ColumnDescription
TABLE_IDTable identifier
FILE_IDFile identifier
STATEIndex status
- COMPLETE: Data stored, index build complete
- INDEXING: Index build in progress
- FILLED: Data is full, waiting for Index build
- PARTIAL: Data not yet full, waiting for Index build
REF_COUNTNumber of sessions currently referencing the file
ROW_COUNTNumber of records stored in the file, including those that were deleted
DEL_COUNTNumber of records deleted from the file
MIN_DATEMinimum datetime value of this data file.
MAX_DATEMaximum datetime value of this data file.

V$STORAGE_TAG_INDEX


Displays indexes created on Tagdata tables.

ColumnDescription
TABLE_IDTable identifier
INDEX_IDIndex identifier (if INDEX_ID is 4294967295 it is a default index that is created automatically when the tag table is created.)
INDEX_STATECurrent index build state
- IDLE: Build Complete, waiting
- INDEXING: Build in progress
- STORAGE FULL: Stopped because of disk full
DISK_INDEX_END_RIDIndex end RID stored in storage
MEMORY_INDEX_END_RIDEnd RID of the index most recently applied to memory
TABLE_END_RIDTable end RID

Tag Rollup

V$ROLLUP


Displays rollup information for Tagdata tables.

ColumnDescription
DATABASE_IDLogical database identifier
IDRollup job ID
ROLLUP_TABLEName of the rollup table
SOURCE_TABLESource table name (TAG/ROLLUP)
COLUMN_NAMETarget value column aggregated by this rollup
ROOT_TABLERoot source tag table name
USER_IDOwner user ID
INTERVAL_TIMEData aggregation interval in milliseconds
WAKEUP_INTERVALRollup job execution interval in milliseconds
LAST_WAKEUP_TIMELast time the rollup thread woke up
NEXT_WAKEUP_TIMENext scheduled wakeup time
ENABLEDWhether the rollup is enabled (1/0)
END_RIDSource table end RID processed by this rollup
LAST_ELAPSED_MSECElapsed time of the last rollup run (msec)
EXT_TYPEEXTENSION flag
PREDICATEFilter predicate for conditional rollups (NULL if none)
RUN_STATECurrent worker state: I=INIT, S=SLEEPING, R=RUNNING

License

V$LICENSE_INFO


Displays license information.

ColumnDescription
IDLicense ID
ISSUE_DATEIssue date
TYPELicense type
CUSTOMERCustomer name
PROJECTProject name
COUNTRY_CODECountry code
INSTALL_DATEInstallation date
VIOLATE_STATUSLicense violation status
VIOLATE_MSGLicense violation message

V$LICENSE_STATUS is not exposed by Standard 8.5.4 servers. Use V$LICENSE_INFO for license fields available in Standard Edition.

Mutex

V$MUTEX


Displays current mutex status.

WAIT_MSEC, WAIT_AVG_MSEC, HELD_MSEC, and HELD_AVG_MSEC are DOUBLE values in milliseconds.

ColumnDescriptionNotes
OBJECTAddress of the mutex object
NAMEThe name given when creating the mutex
TYPEMutex type- Mutex: pmuMutex
- RW Mutex: pmuRWMutex
OWNERID of the thread that acquired the mutex- Mutex: 0 if no thread acquired the mutex.
- RW Mutex w/ Read-Lock: 0
- RW Mutex w/ Write-Lock: ID of the thread that acquired the write lock.
LOCK_COUNTNumber of threads that acquired the mutex- RW Mutex can be 2 or more.
PEND_COUNTNumber of threads waiting to acquire a mutex- Collect only when TRACE_MUTEX_WAIT_STATUS=1
TRY_COUNTNumber of attempts to acquire the mutex- Collect only when TRACE_MUTEX_WAIT_STATUS=1
CONFLICT_COUNTNumber of failed to acquire mutex- Collect only when TRACE_MUTEX_WAIT_STATUS=1
WAIT_MSECTotal time waiting to acquire the mutexCollected only when TRACE_MUTEX_WAIT_STATUS=1
Not recorded for RW mutexes
WAIT_AVG_MSECAverage time from an acquisition attempt to successCollected only when TRACE_MUTEX_WAIT_STATUS=1
Not recorded for RW mutexes
HELD_MSECTotal time from acquisition to releaseCollected only when TRACE_MUTEX_WAIT_STATUS=1
Not recorded for RW mutexes
HELD_AVG_MSECAverage time from acquisition to releaseCollected only when TRACE_MUTEX_WAIT_STATUS=1
Not recorded for RW mutexes

V$MUTEX_WAIT_STAT


Displays call stacks currently waiting for mutexes.

ColumnDescriptionNotes
THREAD_IDID of the thread waiting to acquire the mutex
OBJECTAddress of the mutex being acquired- Same as OBJECT in V$MUTEX
DEPTHCall stack depthCollected only when TRACE_MUTEX_WAIT_STACK=1
SYMBOLSymbol of the function that requested mutex acquisitionCollected only when TRACE_MUTEX_WAIT_STACK=1

Cluster

The following virtual tables are exclusive to Cluster Edition and are not exposed on Standard servers. Before using them, check V$TABLES to confirm availability in the running edition.

V$NODE_STATUS


Displays the status of a cluster node. Returns one row.

ColumnDescription
NODETYPENode type. There are two types that can be viewed by queries.
- Broker
- Warehouse
STATENode status

V$DDL_INFO


Displays DDL operations executed in the cluster.

ColumnDescription
SEQUENCENUMBERDDL sequence number
TIMEDDL execution time
VALUEDDL query result value (Internal server use)
CLIENTClient name
BROKERLead Broker Node name
USERUser name
SQLDDL query value

V$REPLICATION


Displays replication operation information.

ColumnDescription
HOSTNAMEReplication Node Hostname
MODE(Internal server use)
STATENode status
ADDRReplication Manager address
PORT_NOReplication Manager port number
MAX_SENDER_COUNTMaximum number of Senders that can be created
RUN_SENDER_COUNTMaximum number of active Senders

V$REPL_SENDER


Displays sender information during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
IDSender identifier
STATUSSender operational status
PAYLOAD_RECV_COUNTNumber of payloads received from sender
PAYLOAD_RECV_BYTESTotal payload size received from Sender
QUEUE_REMAIN_COUNTNumber of buffers remaining in the Receive Queue
NET_SEND_COUNTNet send count
NET_SEND_SIZENet send size
NET_RECV_COUNTNet receive count
NET_RECV_SIZENet receive size

V$REPL_SENDER_META


Displays sender metadata during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
SENDER_IDSender identifier
TABLE_IDTarget table identifier
TABLE_TYPETarget table type
BEGIN_RIDTarget record start RID
END_RIDTarget record end RID

V$REPL_RECEIVER


Displays receiver information during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
STATUSReceiver operational status
PAYLOAD_RECV_COUNTNumber of payloads received from sender
PAYLOAD_RECV_BYTESTotal payload size received from Sender
QUEUE_REMAIN_COUNTNumber of buffers remaining in the Receive Queue
NET_SEND_COUNTNet send count
NET_SEND_SIZENet send size
NET_RECV_COUNTNet receive count
NET_RECV_SIZENet receive size

V$REPL_RECEIVER_META


Displays receiver metadata during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
TABLE_IDTarget table identifier
TABLE_TYPETarget table type
BEGIN_RIDTarget record start RID
END_RIDTarget record end RID

V$REPL_READER


Displays reader information during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
SENDER_IDSender identifier
IDReader identifier
STATUSReader operation status
FETCH_COUNTFETCH count

V$REPL_READER_META


Displays reader metadata during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
SENDER_IDSender identifier
IDReader identifier
TABLE_IDTarget table identifier
TABLE_TYPETarget table type
BEGIN_RIDTarget record start RID
END_RIDTarget record end RID

V$REPL_WRITER


Displays writer information during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
IDWriter identifier
STATUSWriter operational status
APPEND_COUNTAPPEND count

V$REPL_WRITER_META


Displays writer metadata during replication.

ColumnDescription
HOSTNAMEReplication Node Hostname
IDWriter identifier
TABLE_IDTarget table identifier
TABLE_TYPETarget table type
BEGIN_RIDTarget record start RID
END_RIDTarget record end RID

Others

V$TABLES


Lists all virtual tables with names starting with V$.

ColumnDescription
NAMETable name
TYPETable type
DATABASE_IDDatabase identifier
IDTable identifier
USER_IDUser who created table
COLCOUNTColumn count

V$COLUMNS


Displays virtual table column information.

ColumnDescription
NAMEColumn name
TYPEColumn data type
DATABASE_IDDatabase identifier
IDColumn identifier
LENGTHColumn size
TABLE_IDTable identifier
FLAGPrivate data
PART_PAGE_COUNTUnused
PAGE_VALUE_COUNTUnused
MINMAX_CACHE_SIZEUnused
MAX_CACHE_PART_COUNTUnused

V$RETENTION_JOB


Displays tables with a RETENTION POLICY applied.

ColumnDescription
USER_NAMEUser name
TABLE_NAMEapplied table name
POLICY_NAMEapplied policy name
STATERETENTION state (RUNNING/WAITING/STOPPED)
LAST_DELETED_TIMEmost recently deleted time

V$USER_AUTH_KEYS


Displays public keys registered for challenge authentication.

ColumnDescription
KEY_IDKey identifier
USER_IDUser identifier
USER_NAMEUser name
KEY_ALGOKey algorithm
KEY_PARAMKey parameter
PUBKEYPublic key text
ACTIVATEDWhether the key is active
VALID_AFTERStart date of key validity
VALID_BEFOREEnd date of key validity
COMMENTKey comment
Last updated on