---
title: "SYSTEMPREEMPTIVELOADHINTS (Data Dictionary)"
description: "Pre-emptive Load Hints"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/datadictionary/DataDictionary.Invantive.SYSTEMPREEMPTIVELOADHINTS
original: https://documentation.invantive.eu/en/datamodels/datadictionary/DataDictionary.Invantive.SYSTEMPREEMPTIVELOADHINTS
updated: 2026-11-01T16:08:19Z
license: https://documentation.invantive.eu/en/
---

# SYSTEMPREEMPTIVELOADHINTS: Data Dictionary Pre-emptive Load Hints

`read only`

- Catalog: `DataDictionary`
- Schema: `Invantive`
- Label: Pre-emptive Load Hints

The announcements this session received that a table will be needed shortly, with who announced it and whether a candidate was found for it. Live session state rather than a log.

Can only retrieve data.

## Table Columns

The columns of the table `SYSTEMPREEMPTIVELOADHINTS` 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 |
|---|---|---|:---:|---|---|
| `CANDIDATE_ID` | `int64` | Candidate | [ ] |  | Candidate it raised, or empty when nothing matched. |
| `CATALOG_NAME` | `varchar2(240)` | Catalog | [ ] |  | Catalog named in the announcement, or empty for any. |
| `CONTEXT` | `varchar2(240)` | Announced By | [ ] |  | Who announced it. |
| `DATA_CONTAINER_ALIAS` | `varchar2(240)` | Data Container Alias | [ ] |  | Alias of the data container which is to answer, or empty when every data container offering the object is meant. |
| `EXPIRED_DATE_UTC` | `datetime` | Expired Date | [x] |  | Moment at which the announcement has decayed to nothing (UTC). |
| `HONOURED` | `boolean` | Honoured | [x] |  | Whether a candidate was found for it. |
| `LAST_ACTION` | `varchar2(1024)` | Last Action | [ ] |  | What was last done with this announcement, in English: recorded, ignored because loading ahead is switched off, matched against a candidate, work added for a partition, no data container offering the object, a partition the data container does not have, or expired unused. |
| `LAST_ACTION_DATE_UTC` | `datetime` | Last Action Date | [ ] |  | Moment at which that last happened (UTC). |
| `LAST_ACTION_MESSAGE_CODE` | `varchar2(32)` | Last Action Message Code | [ ] |  | Message code of what was last done with this announcement, by which the same event is found in a trace. |
| `MAXIMUM_NUMBER_OF_ROWS` | `int64` | Maximum Number of Rows | [ ] |  | Number of rows which were announced to be read, or empty when the whole table was. |
| `PARTITION_CODE` | `varchar2(240)` | Partition | [ ] |  | Partition announced, or empty for the partitions in scope. |
| `PARTITION_SCOPE` | `varchar2(32)` | Partition Scope | [x] |  | Which partitions were announced: 'One' for the partition named, 'Selected' for the partitions the session has selected, 'All' for every partition of the data container. |
| `RECEIVED_DATE_UTC` | `datetime` | Received Date | [x] |  | Moment the announcement was received (UTC). |
| `SCHEMA_NAME` | `varchar2(240)` | Schema | [ ] |  | Schema named in the announcement, or empty for any. |
| `TABLE_NAME` | `varchar2(240)` | Table | [x] |  | Name of the table announced. |
| `WITHIN_SEC` | `double` | Within | [x] |  | Number of seconds within which it was announced to be needed after receipt. |

## Keys

| Key | Column | Refers to | Kind | Description |
|---|---|---|---|---|
| `SYSTEMPREEMPTIVELOADHINTS_CANDIDATE_ID_SYSTEMPREEMPTIVELOADCANDIDATES_fk` | `CANDIDATE_ID` | [SYSTEMPREEMPTIVELOADCANDIDATES](DataDictionary.Invantive.SYSTEMPREEMPTIVELOADCANDIDATES)`.ID` | Key |  |



## 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)

