Argument Types and Rules - Teradata Vantage NewSQL Engine - 16.20

Teradata Vantageā„¢ XML Data Type

prodname
Teradata Database
Teradata Vantage NewSQL Engine
vrm_release
16.20
category
Programming Reference
featnum
B035-1140-162K

XSLT_SHRED_BATCH takes the following input arguments and returns a result code.

Parameter Name Parameter Type Data Type Description
queryString IN VARCHAR(20000)

CHARACTER SET UNICODE

The SQL query string that is evaluated and returns a result set with two columns: an ID column and a column with the XML documents to be shredded.

An error is reported if this parameter is NULL.

xsltMapping IN XML An XSLT stylesheet provides the mapping from the XML elements to be shredded to the target table columns.
externalContext IN VARCHAR(512)

CHARACTER SET UNICODE

A comma separated list of name=value pairs that parameterize the shredding operation. These values override configuration parameters, such as defaultDatabase, that are specified in the stylesheet mapping.
resultCode OUT INTEGER A return code where:
  • 0 = success
  • 1 = failure

The externalContext parameter specifies configuration values used to override equivalent parameters specified in the XSLT stylesheet mapping. This must be a comma separated list of name=value pairs and the names must match one of the configuration parameters in the XSLT stylesheet.

Currently four parameter values can be set through the externalContext:
  • defaultDatabase
  • defaultEncoding
  • rootElement
  • errorTable

For explanations of the defaultDatabase, defaultEncoding, and rootElement options, see the description of the corresponding elements in the discussion of Adding Schema Annotations.

The errorTable option allows you to specify the fully qualified name of a table to which error information will be written if any of the documents fails shredding. Specifying this option activates a more permissive form of shredding in which failure of any individual document during shredding does not result in the abortion of the entire shredding procedure. Instead, the remaining valid documents in the batch are shredded, and the error information for the documents that failed shredding is written to an error table.