Override Session Properties | Spark SQL Initiator Connector | Teradata Fabric - Overriding Session Properties (Spark SQL) - Teradata Fabric

Teradata® Fabric - Installation and User Guide - 3.11

Product
Teradata Fabric
Release Number
3.11
Published
August 2026
ft:locale
en-US
ft:lastEdition
2026-08-15
dita:mapPath
svw1780362788070.ditamap
dita:ditavalPath
ezw1784752870623.ditaval
dita:id
lxg1591800469257
Designating a Spark SQL connector property as overridable in the Teradata Fabric portlet allows you to override configured Spark SQL connector properties when running queries during an individual processing session.

For the Spark SQL initiator session, setSessionOverride() is used at the Foreign Server level to override configured Spark SQL connector properties. The session override applies to all non-native tables that belong to the Foreign Server.

  1. Under Fabric Configuration, select Fabrics.
  2. Select the fabric.
  3. Perform one of the following:
    Option Description
    To override a Spark SQL connector property in the Connectors tab
    1. Select the Connectors tab.
    2. Select "" next to the connector that has a property to override.
    3. Select Edit.
    4. Select "" next to Connector Software.
    5. Find the Spark SQL connector property to override and select the Overridable check box.
    6. Select OK.
    7. Select Save..
    To override a Spark SQL connector property in the Links tab
    1. Select the Links tab.
    2. Select "" next to the link that has a property to override.
    3. Select Edit.
    4. Select "" next to Initiating Connector or Target Connector.
    5. Find the Spark SQL link property to override and select the Overridable check box.
    6. Select OK.
    7. Select Save..
  4. [Optional] To override the Spark SQL connector property during a Spark SQL session for Foreign Server s1, use the syntax in the following example where the numExecutors and hadoopProperties connector properties are overridden.
    s1.setSessionOverride("linkBufferSize=100000, numExecutors=4, hadoopProperties=name1:value1 | name2:value2")
    When overriding hadoopProperties, you must use the pipe (|) symbol to split Hadoop properties and a colon (:) to split name value pairs, as shown in these examples.
  5. [Optional] To clear Spark SQL connector property overrides without closing a Spark SQL session for Foreign Server S1, use the syntax in the following example:
    s1.setSessionOverride("")