---
title: "SYSTEMPSQLATOMICS (Data Dictionary)"
description: "PSQL Atomic Values"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/datadictionary/DataDictionary.Invantive.SYSTEMPSQLATOMICS
original: https://documentation.invantive.eu/en/datamodels/datadictionary/DataDictionary.Invantive.SYSTEMPSQLATOMICS
updated: 2026-11-01T16:08:19Z
license: https://documentation.invantive.eu/en/
---

# 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 | [x] |  | Number of changes which had to wait for the session registry monitor. Zero means the value costs nothing. |
| `CREATED_UTC` | `datetime` | Created (UTC) | [x] |  | 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 | [x] |  | 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 | [x] |  | 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 | [x] |  | 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) | [x] |  | 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:

- [Data Dictionary](/en/release-notes/drivers?driver=data-dictionary)

