Usage Notes - Analytics Database - Teradata Vantage

SQL External Routine Programming

Deployment
VantageCloud
VantageCore
Edition
Enterprise
IntelliFlex
VMware
Product
Analytics Database
Teradata Vantage
Release Number
17.20
Published
June 2022
Language
English (United States)
Last Update
2023-07-11
dita:mapPath
iiv1628111441820.ditamap
dita:ditavalPath
qkf1628213546010.ditaval
dita:id
B035-1147
lifecycle
latest
Product Category
Teradata Vantageā„¢

Read-only GLOP data can be split into a number of pages, each of which can be overlaid with the current GLOP data in memory. The page to initially map for read-only GLOP data can be specified when the GLOP is added or changed. Read/write or globally modifiable GLOP data can only consist of one page. Remapping page one of such a GLOP will remap the original data contents of the GLOP. Any changed data in the read/write page is thrown away.

All read-only pages are the same size and depend on the GLOP_Length field of the GLOP set row.

The GLOP read/write data must not be locked when this call is made. It places an internal exclusive lock that blocks all read and write locks while a page is being replaced.

Rules to be aware of:

  • You can map the same type of GLOP data in multiple map indexes for read-only GLOP data. That way you can map different pages of the same GLOP data at the same time. This has to be set up that way in the GLOP_Map table. This cannot be done for 'RO', 'US' or 'XR' GLOPs.
  • When reloading page one map for a read write GLOP, an automatic write lock is placed to prevent any external routine from reading or writing the GLOP while the data is being reinitialized with the original contents. If you use this as part of the design, make sure that all external routines are aware that this could happen.
  • Different pages for read-only GLOP data can be mapped by different external routines at the same time.