invantive documentation
Invantive Support ForumsLog In / Sign Up

SYSTEMPSQLATOMICS: Data Dictionary PSQL Atomic Values

read only

  • Catalog: DataDictionary
  • Schema: Invantive
  • Label: PSQL Atomic Values

Named atomic values of the session (dbms_atomic), with their kind, size and contention statistics. Live session state rather than a log: the values are gone when the session ends, so a script wanting an audit trail past its session writes one itself. The accumulated text and the elements of a list are deliberately not shown; they are readable from the script through get_text and elements_text.

Can only retrieve data.

Table Columns

The columns of the table SYSTEMPSQLATOMICS are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

Name Data Type Label Required Marks Documentation
CONTENDED_COUNT int64 Contended Count Number of changes which had to wait for the session registry monitor. Zero means the value costs nothing.
CREATED_UTC datetime Created (UTC) Moment the name came into being.
ELEMENT_COUNT int64 Element Count Number of elements in a list, or number of appends to a text. Empty for the NUMBER kind.
KIND varchar2 Kind Kind of the value, fixed when the name was created: NUMBER, TEXT or LIST OF TEXT.
LAST_MODIFIED_BY_INSTANCE varchar2 Last Modified By Description of the worker frame which last changed the value: a parallel branch, a parallel loop worker or the main frame.
LAST_MODIFIED_UTC datetime Last Modified (UTC) Moment the value was last changed.
NAME varchar2 Name Name of the atomic value (dbms_atomic).
NUMBER_VALUE numeric Value Current value, for the NUMBER kind. Empty for the other kinds.
OPERATION_COUNT int64 Operation Count Number of times the value was changed. Reads are not counted, so selecting this view does not change what it reports.
TOTAL_LENGTH int64 Total Length Number of characters accumulated. Reported instead of the content itself: a value built by a script can hold anything the script could compute, so the content is readable only from the script, through get_text and elements_text.
WAIT_DURATION_MS double Wait Duration (ms) Total time changes of this value spent waiting for the session registry monitor. The count says how often the value was contended; this says what it cost. One monitor guards the whole session, so this is the wait experienced by operations on this name rather than necessarily the wait caused by them.

Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver: