Introduction

Mobilize.Net Forums Blog Documentation Home
Search…
Introduction
Welcome to Mobilize.Net SnowConvert for Teradata. Let us be your guide on the road to a successful migration.
What is SnowConvert for Teradata?
SnowConvert is a software that understands Teradata SQL, BTEQ, and other Teradata-specific scripts (such as Fastload, Multiload, TPump, and TPT files) and converts this source code into functionally equivalent Snowflake code. 
Conversion Types
Specifically, SnowConvert for Teradata performs the following conversions:
Teradata SQL to Snowflake SQL
SnowConvert understands the Teradata source code and converts the Data Definition Language (DDL), Data Manipulation Language (DML), and functions in the source code to the corresponding SQL in the target: Snowflake. SnowConvert can migrate the source code in any of these three extensions .sql, .dml, ddl
Teradata Stored Procedures to JavaScript Embedded in Snowflake SQL
SnowConvert takes Teradata stored procedures (usually written in SQL) and converts them to JavaScript embedded into Snowflake SQL. Teradata's CREATE PROCEDURE and REPLACE PROCEDURE language is replaced by Snowflake's CREATE OR REPLACE PROCEDURE language. JavaScript is called as a scripting language, and all of the inner statements are converted to JavaScript.
Teradata BTEQ, Fastload, Multiload, and TPT to Python
Basic Teradata Query (BTEQ) is Teradata's proprietary scripting language. All BTEQ script files will be converted to Python scripts. A helper class will be called from the converted scripts to create the functional equivalence between the source and the target. More information about the Python Helpers can be found on our Translation Reference page. BTEQ can be batch run from outside the Snowflake environment. Learn more about how you can connect Python scripts directly to Snowflake. 
BTEQ files are also the foundation for multiple other proprietary data types that Teradata has created:
Fastload
Multiload
TPUMP
Each one of these file types are extensions of BTEQ. SnowConvert translates each one of these file types to Python.
Each of these conversions are optimized to give you the most functionally equivalent output ready for use in Snowflake. For more information on the power of the kind of conversion SnowConvert can provide, you can learn more about our tool by visiting our complete SQL reference guide.
SnowConvert Terminology
Before we get lost in the magic of these code conversions, here are a few terms/definitions so you know what we mean when we start dropping them all over the documentation:
SQL (Structured Query Language): the standard language for storing, manipulating, and retrieving data in most modern database architectures.
BTEQ (Batch Teradata Query): BTEQ was the first utility and query tool for Teradata.
TPT (Teradata Parallel Transporter): TPT is a new generation utility tool that aims to create a one-stop tool for all the activities related to loading and exporting data from/to Teradata databases.
SnowConvert: the software that converts securely and automatically your Teradata files to the Snowflake cloud data platform. 
Conversion rule or transformation rule: rules that allow SnowConvert to convert from a portion of source code to the expected target code.  
Parse: parse or parsing is an initial process done by SnowConvert to understand the source code and build up an internal data structure to process the conversion rules. 
On the next few pages, you'll learn more about the kind of conversions that SnowConvert for Teradata is capable of. If you're ready to get started, visit the Getting Started page in this documentation. If you're interested in getting more information about SnowConvert in general, visit our SnowConvert for Teradata information page.
Translation Sample
Teradata SQL Statement
1
-- CREATE TABLE DDL
2
CREATE SET TABLE TABLE1
3
    NO BEFORE JOURNAL,
4
    NO AFTER JOURNAL,
5
    CHECKSUM = DEFAULT,
6
    DEFAULT MERGEBLOCKRATIO
7
(
8
    COL1 VARCHAR(15) CHARACTER SET LATIN NOT CASESPECIFIC,
9
    Col2 BYTEINT CHECK ( CurrentFlag  IN (0 ,1 ) ) NOT NULL,
10
    COL3 DATE FORMAT 'yyyy-mm-dd',
11
    COL4 BLOB(2097088000),
12
    COL5 BYTEINT,
13
    COL7 INTEGER NOT NULL COMPRESS (1 ,2 ,3 ,4),
14
    COL8 INTERVAL HOUR(2) TO MINUTE
15
);
16
​
17
-- REPLACE VIEW DDL
18
REPLACE VIEW VIEW1 AS
19
SELECT * FROM TABLE1
20
UNION ALL
21
SELECT MAX(COL1) FROM TABLE1;
Copied!
The Converted Snowflake SQL Code:
1
-- Snowflake converted SQL
2
CREATE TABLE PUBLIC. TABLE1
3
(
4
    COL1 VARCHAR(15) COLLATE 'en-ci',
5
    Col2 BYTEINT NOT NULL,
6
    COL3 DATE,
7
    COL4 BINARY /**** WARNING: Column converted from BLOB data type ****/,
8
    COL5 BYTEINT,
9
    COL7 INTEGER NOT NULL,
10
    COL8 VARCHAR (20) COMMENT 'INTERVAL HOUR(2) TO MINUTE' /**** WARNING: INTERVAL DATA TYPE "INTERVAL HOUR(2) TO MINUTE" CONVERTED TO VARCHAR ****/
11
) ;
12
​
13
CREATE OR REPLACE VIEW PUBLIC. VIEW1
14
AS
15
    SELECT * FROM PUBLIC. TABLE1
16
    UNION ALL
17
    SELECT MAX(COL1) FROM PUBLIC. TABLE1 ;
Copied!
In this converted SQL you will notice that we are converting many things such as:
Adding PUBLIC Schema by default for all the Table and view names if the user doesn't specify one (see how to specify a Schema).
CREATE SET TABLE to CREATE TABLE
REPLACE VIEW to CREATE OR REPLACE VIEW
Data Types: BLOB to BINARY and INTERVAL to VARCHAR
Data Type Attributes: NOT CASESPECIFIC to COLLATE
Removing pieces of the Teradata SQL that are not necessary in Snowflake due to Snowflake's architecture such as NO BEFORE JOURNAL, NO AFTER JOURNAL, CHECKSUM, COMPRESS, and DEFAULT MERGEBLOCKRATIO.
Mobilize.Net SnowConvert Documentation
Next - For Teradata
Getting Started
Last modified 25d ago
Copy link
Contents
What is SnowConvert for Teradata?
Conversion Types
Teradata SQL to Snowflake SQL
Teradata Stored Procedures to JavaScript Embedded in Snowflake SQL
Teradata BTEQ, Fastload, Multiload, and TPT to Python
SnowConvert Terminology
Translation Sample