Skip to main content
The Table Output transformation component lets you write an input dataset out to an existing table in your cloud data warehouse. Table Output will be the last component in your pipeline, as you write the dataset out after all other processing is complete. The target table must already exist, and should have suitable columns to map to the columns in your dataset. The component will validate if the input columns don’t map to suitable output columns (for example, if you map a date column to an integer column), but you may encounter unexpected results when the pipeline runs. You can choose whether the new data will be appended to the existing table (Append option), or whether the existing table rows will be deleted before the new data is written out (Truncate option). This component is equivalent to using the SQL INSERT INTO statement, optionally preceded by a DELETE FROM statement.
There are other components that can write data to a table and may better suit your use case:

Use case

The Table Output component supports two ways of writing data out to a table:
  • Making incremental data loads to an existing table. For example, appending today’s transactions to a sales table.
  • Overwriting existing data with fresh data. For example, replacing a staging table’s data with the latest extracted file.

Properties

Name
string
required
A human-readable name for the component.
Warehouse
drop-down
required
The Snowflake warehouse used to run the queries. The special value [Environment Default] uses the warehouse defined in the environment. Read Overview of Warehouses to learn more.
Database
drop-down
required
The Snowflake database. The special value [Environment Default] uses the database defined in the environment. Read Databases, Tables and Views - Overview to learn more.
Schema
drop-down
required
The Snowflake schema. The special value [Environment Default] uses the schema defined in the environment. Read Database, Schema, and Share DDL to learn more.
Target table
drop-down
required
Select the output table. The available tables depend on the selected environment.
Fix data type mismatches
boolean
required
Select whether to cast types in the event of data type mismatches.
  • Yes: If the source column type does not match the target table type, attempt to CAST the value to the required target type.
  • No: Do not cast types (do not fix data type mismatches).
Column mapping
column editor
required
In each Source column drop-down, select a column in your dataset that you want to write to your existing table. Click the + icon to add another row, or before adding any rows, click Add all to add all input columns to the Source column. If you click Add all, the Target column fields will automatically be completed if there is a column in the selected target table that matches the name of the source column.In each Target column drop-down, select the existing column in the selected target table to populate with the selected Source column data. You can add source columns multiple times to populate different target columns with the same data.
Order by
column editor
  • Column: Select the output column(s) to sort by.
  • Sort Order: Set the corresponding column to be ordered ascending (default) or descending.
Output mode
drop-down
required
  • Append: Adds the records to the end of the table.
  • Truncate: Empty existing rows in the target table before loading the incoming input rows. This operation may use either a TRUNCATE or DELETE FROM query, depending on whether the current flow is in a transaction or not. TRUNCATE is faster, and therefore preferred, but is not transaction-safe and is not used if a transaction is in progress.