WRITE_NOS Returns - Teradata VantageCloud Lake

Lake - Working with SQL

Deployment
VantageCloud
Edition
Lake
Product
Teradata VantageCloud Lake
Release Number
Published
February 2025
ft:locale
en-US
ft:lastEdition
2025-11-21
dita:mapPath
jbe1714339405530.ditamap
dita:ditavalPath
pny1626732985837.ditaval
dita:id
jbe1714339405530

WRITE_NOS writes the database data to external object storage according to the specified options and returns information about the objects written to external object storage. The returned values are a table with the following columns:

NodeId
INTEGER value that identifies the Database Engine 20 node that contains the data written to the external object.
AmpId
INTEGER value that identifies the AMP that contains the data written to the external object.
Sequence
BIGINT value that uniquely identifies the external object to avoid name conflicts in cases where there may otherwise have been multiple objects with the same path and name.
ObjectName
VARCHAR(1024) UNICODE value that is the full object file name in the format:
/connector/endpoint/bucket_or_container/prefix/object_file_name
  • connector
  • endpoint
  • bucket_or_container
  • prefix depends on the value of the NAMING option, discrete or range naming.
  • object_file_name is in the format:
    location_path/[ discrete_naming | range_naming ]/object_node_ID_AMP_ID_sequence.parquet
For example:
/S3/ceph-s3.mycompany.com/test-bucket/2020-06-01/object_33_0_1.parquet
ObjectSize
BIGINT value that is the external object size in bytes.
RecordCount
BIGINT value that indicates the number of Database Engine 20 records in the external object.