SnowConvert AI – Teradata

Spezifische CLI-Argumente

Die folgenden CLI-Argumente gelten speziell für das Ausführen von Migrationen mit SnowConvert AI für Teradata.

--displaceDatabaseAsSchema

This flag must be used with the -s parameter. When used it will maintain Teradata’s database name qualification as Snowflake’s data warehouse, contrary to its default behavior where it becomes a schema on Snowflake code. Let’s look at an example where -s customSchema is included:

SELECT * FROM databaseName.tableName;

-- Additional Params: -s customSchema
SELECT
* FROM
customSchema.tableName;

-- Additional Params: -s customSchema --displaceDatabaseAsSchema
SELECT
* FROM
databaseName.customSchema.tableName;

--CharacterToApproximateNumber <NUMBER>

Ein Ganzzahl-Wert für die Umwandlung von CHARACTER in eine ungefähre Zahl (Standardwert: 10).

--DefaultDateFormat <STRING>

Zeichenfolgenwert für das DATE-Standardformat (Standardwert: "YYYY/MM/DD").

--DefaultTimeFormat <STRING>

Zeichenfolgenwert für das TIME-Standardformat (Standard: "HH:MI:SS.FF6").

--DefaultTimestampFormat <STRING>

Zeichenfolgenwert für das TIMESTAMP-Standardformat (Standard: "YYYY/MM/DD HH:MI:SS.FF6").

--DefaultTimezoneFormat <STRING>

Zeichenfolgenwert für das TIMEZONE-Standardformat (Standardwert: "GMT-5").

-p, --scriptTargetLanguage <TARGET_LANGUAGE>

Der Zeichenfolgenwert gibt die Zielsprache an, in die BTEQ- und MLOAD-Skriptdateien konvertiert werden sollen. Derzeit unterstützte Werte sind SnowScript und Python. Der Standardwert ist Python.

-n, --SessionMode <SESSION_MODE>

SnowConvert AI verarbeitet Teradata-Code in den beiden TERA- und ANSI-Modi. Derzeit beschränkt sich dies auf die standardmäßige Groß-/Kleinschreibungsspezifikation von Zeichendaten und deren Auswirkungen auf Vergleiche.

Der Zeichenfolgenwert gibt den Sitzungsmodus des Eingabecodes an. Die derzeit unterstützten Werte sind TERA und ANSI. Der Standardwert ist auf TERA festgelegt.

Hier können mehr darüber erfahren, wie SnowConvert AI den Code abhängig vom Sitzungsmodus verarbeitet und konvertiert.

--replaceDeleteAllToTruncate

Flag, das angibt, ob DELETE ALL-Anweisungen durch TRUNCATE ersetzt werden müssen oder nicht. Dadurch wird SSC-EWI-TD0037 generiert, wenn die Ersetzung abgeschlossen ist. Beispiel:

create table testTable(
    column1 varchar(30)
);

delete testTable all;

delete from testTable;

CREATE OR REPLACE TABLE testTable (
    column1 varchar(30)
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
;

DELETE FROM testTable;

DELETE FROM 
    testTable;

-- Additional Params: --replaceDeleteAllToTruncate
CREATE OR REPLACE TABLE testTable (
    column1 varchar(30)
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
;

TRUNCATE TABLE testTable;

DELETE FROM 
    testTable;

--generateStoredProcedureTags

Flag, das angibt, ob die SQL-Anweisungen SELECT, INSERT, CREATE, DELETE, UPDATE, DROP, MERGE in gespeicherten Prozeduren im konvertierten Code markiert werden. Dieses Feature dient der einfachen Identifizierung von Anweisungen im migrierten Code. Wenn Sie diese Anweisungen in diese XML-ähnlichen Tags einschließen, können andere Programme sie schnell finden und extrahieren. Der dekorierte Code sieht wie folgt aus:

//<SQL_DELETE
EXEC(DELETE FROM SB_EDP_SANDBOX_LAB.PUBLIC.USER_LIST,[])
//SQL_DELETE!>

--splitPeriodDatatype

Dieses Flag wird verwendet, um anzuzeigen, dass das Tool bei jeder Verwendung des Datentyps PERIOD zwei separate DATETIME-Felder migrieren soll, die die ursprünglichen Werte für Beginn und Ende des Zeitraums enthalten. Jedes Mal, wenn ein Zeitraumfeld oder eine Zeitraumfunktion mit diesem Flag migriert wird, wird SSC-FDM-TD0004 hinzugefügt, um auf diese Änderung hinzuweisen.

CREATE TABLE myTable(
   col1 PERIOD(DATE),
   col2 VARCHAR(50),
   col3 PERIOD(TIMESTAMP)
);

CREATE OR REPLACE TABLE myTable (
   col1 VARCHAR(24) !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!,
   col2 VARCHAR(50),
   col3 VARCHAR(58) !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
;

-- Additional Params: --splitPeriodDatatype
CREATE OR REPLACE TABLE myTable (
   col1_begin DATE,
   col1_end DATE /*** SSC-FDM-TD0004 - PERIOD DATA TYPES ARE HANDLED AS TWO DATA FIELDS ***/,
   col2 VARCHAR(50),
   col3_begin TIMESTAMP,
   col3_end TIMESTAMP /*** SSC-FDM-TD0004 - PERIOD DATA TYPES ARE HANDLED AS TWO DATA FIELDS ***/
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
;

--arrange

Flag, das angibt, ob der Eingabecode vor dem Parsen und der Transformation verarbeitet werden soll.

--RenamingFile

Der Pfad zu einer .json-Datei, die neue Namen für bestimmte Objekte wie Tabellen, Ansichten, Prozeduren, Funktionen und Makros angibt. Dieser Parameter kann nicht mit dem Argument customSchema verwendet werden. Navigieren Sie zu Umbenennungsfeature, um mehr über dieses Argument zu erfahren.

--UseCollateForCaseSpecification

This flag indicates whether to use COLLATE or UPPER to preserve Case Specification functionality, for example, CASESPECIFIC or NOT CASESPECIFIC. By default, it is turned off, meaning that the UPPER function will be used to emulate case insensitivity (NOT CASESPECIFIC). To learn more about how Case Specification is handled by SnowConvert AI check here.