Copying Data from a Source Table to an OTF Table - Teradata Vantage

Teradata® Open Table Format for Apache Iceberg and Delta Lake User Guide

Deployment
VantageCloud
VantageCore
Edition
VMware
Enterprise
IntelliFlex
Lake
Product
Teradata Vantage
Release Number
20.00
Published
October 2025
ft:locale
en-US
ft:lastEdition
2025-10-25
dita:mapPath
qrj1749167830193.ditamap
dita:ditavalPath
lli1749584660955.ditaval
dita:id
bsr1702324250454

The INSERT INTO..SELECT SQL can be used to copy data from a source table to an OTF table. The source table can be a BFS, OFS, or OTF table. The WHERE clause can be used to copy a subset of the data from the source table to the OTF table.

Syntax

INSERT INTO TABLE <datalake_name>.<OTFdatabase_name>.<OTFtable_name> 
    SELECT * | <column-name>[, ...] 
    FROM [database_name.]<source_table> |
         <datalake_name>.<OTFdatabase_name>.<OTFtable_name>
    [WHERE where_clause];
<datalake_name> ::= !! name of the data lake object
<OTFdatabase_name> ::= !! name of the database in the OTF catalog
<OTFtable_name> ::= !! name of the OTF table
<database_name> ::= !! Teradata identifier
<source_table> ::= !! Teradata table

Example

INSERT INTO datalake_glue.MyDatabase.Tab2
   SELECT * FROM datalake_glue.MyDatabase.Tab1
   WHERE country='France'; 

Usage Considerations

The following are not supported:

  • Non-positional inserts.
  • Writing ORC data files in Iceberg.
  • Writing to a CLOB column.
  • Parameterized SQL for Array Insert for an OTF table.