SnowConvert AI - Teradata Conversion Settings

Paramètres de conversion généraux

Paramètres de résultats généraux

Sous-page Paramètres de résultats généraux

  1. Commenter les objets dont les dépendances sont manquantes : Indicateur signalant si l’utilisateur souhaite commenter les nœuds dont les dépendances sont manquantes.

  2. Désactiver la génération de commentaires EWI (erreurs, avertissements et problèmes) : Indicateur signalant si les commentaires EWIs (erreurs, avertissements et problèmes) ne seront pas générés sur le code converti. La valeur par défaut est false.

  3. Générer des balises XML pour les instructions SQL dans les procédures stockées : Indicateur signalant si les instructions SQL SELECT, INSERT, CREATE, DELETE, UPDATE, DROP, MERGE dans les procédures stockées seront balisées dans le code converti. Cette fonction est utilisée pour faciliter l’identification des instructions sur le code migré. Le fait d’entourer ces instructions de ces balises XML permet à d’autres programmes de les trouver et de les extraire rapidement. Le code décoré se présente comme suit :

    //<SQL_DELETE
    EXEC(DELETE FROM SB_EDP_SANDBOX_LAB.PUBLIC.USER_LIST,[])
    //SQL_DELETE!>
    
    Copy
  4. Séparer les définitions et les utilisations du type de données Period en deux champs Data-Time de début et de fin : Cet indicateur sert à signaler que l’outil doit migrer toute utilisation du type de données PERIOD en deux champs DATETIME distincts qui contiendront les valeurs initiales de début et de fin de la période. Chaque fois qu’un champ ou une fonction de période est migré(e) à l’aide de cet indicateur, SSC-EWI-TD0053 seront ajoutés pour vous avertir de ce changement.

    Code d’entrée :

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

    Code de sortie :

    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"}}'
    ;
    
    Copy
  5. Set encoding of the input files: Check General Conversion Settings for more details.

  6. Use COLLATE for Case Specification: This flag indicates whether to use COLLATE or UPPER to preserve Case Specification functionality, e.g. 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.

Note

Pour passer en revue les paramètres qui s’appliquent à l’ensemble des langages pris en charge, consultez l”article suivant.

Paramètres du mode de session

Cette sous-page de paramètres permet d’indiquer le mode de session du code d’entrée.

Sous-page des paramètres du mode de session

SnowConvert AI handles Teradata code in both TERA and ANSI modes. Currently, this is limited to the default case specification of character data and how it affects comparisons. By default, the Session Mode is TERA.

You can learn more about how SnowConvert AI handles and converts code depending on the session mode, check here.

Paramètres des noms d’objet DB

Page des paramètres des noms d'objets DB

  1. Schéma : La valeur de chaîne spécifie le nom du schéma personnalisé à appliquer. S’il n’est pas spécifié, le nom de la base de données d’origine sera utilisé. Exemple : DB1.myCustomSchema.Table1.

  2. Base de données : La valeur de chaîne spécifie le nom de la base de données personnalisée à appliquer. Exemple : MyCustomDB.PUBLIC.Table1.

  3. Par défaut : Aucun des paramètres ci-dessus ne sera utilisé dans les noms d’objet.

Paramètres de préparation du code

Page des paramètres de préparation du code

Description

Prepare my code: Flag to indicate whether the input code should be processed before parsing and transformation. This can be useful to improve the parsing process. By default, it’s set to FALSE.

Splits the input code top-level objects into multiple files. The containing folders would be organized as follows:

└───A new folder named ''[input_folder_name]_Processed''
    └───Top-level object type
        └───Schema name
Copy

Example

Input

├───in
│       DDL_Macros.sql
│       DDL_Procedures.sql
│       DDL_Tables.sql
Copy

Output

Assume that the name of the files is the name of the top-level objects in the input files.


├───in_Processed
    ├───macro
    │   └───MY_DATABASE
    │           MY_FIRST_MACRO.sql
    │           ANOTHER_MACRO.sql
    │
    ├───procedure
    │   └───MY_DATABASE
    │           A_PROCEDURE.sql
    │           ANOTHER_PROCEDURE.sql
    │           YET_ANOTHER_PROCEDURE.sql
    │
    └───table
        └───MY_DATABASE
                MY_TABLE.sql
                ADDITIONAL_TABLE.sql
                THIRD_TABLE.sql
Copy

Inside the « schema name » folder, there should be as many files as top-level objects in the input code. Also, it is possible to have copies of some files when multiple same-type top-level objects have the same name. In this case, the file names will be enumerated in ascending order.

Only files with the « .sql », « .ddl » and « .dml » extensions will be considered for splitting. Other kinds of files like « .bteq » scripts will be copied into the preprocessed folder and will be categorized depending on the script extension but they won’t be modified by the Split Task.

Requirements

To identify top-level objects, a tag must be included in a comment before their declaration. Our Extraction scripts generate these tags.

The tag should follow the next format:

<sc-top_level_object_type>top_level_object_name</sc-top_level_object_type>
Copy

You can follow the next example:

/* <sc-table> MY_DATABASE.MY_TABLE</sc-table> */
CREATE TABLE "MY_DATABASE"."MY_TABLE" (
    "MY_COLUMN" INTEGER
) ;
Copy

Paramètres de conversion du format

Page des paramètres de conversion du format

  1. Échelle par défaut Caractère en nombre : Valeur entière pour la transformation de CHARACTER en nombre approximatif (valeur par défaut : 10).

  2. Format TIMESTAMP par défaut : Valeur de chaîne du format TIMESTAMP (par défaut : « YYYY/MM/DD HH:MI:SS »).

  3. Format DATE par défaut : Valeur de chaîne du format DATE (par défaut : « YYYY/MM/DD »).

  4. TIMEZONE source : Valeur de chaîne du format TIMEZONE (par défaut : « GMT-5 »).

  5. Format TIME par défaut : Valeur de chaîne du format TIME (par défaut : « HH:MI:SS »).

Langue cible pour BTEQ, procédures/macros

Page des paramètres des langues cibles BTEQ

Spécifie la langue cible pour la conversion des fichiers script Bteq et Mload. Les valeurs actuellement prises en charge sont SnowScript et Python. La valeur par défaut est définie sur Python.

Page des paramètres des langues cibles des procédures/macros

Valeur de chaîne spécifiant le langage cible pour la conversion des procédures stockées et des macros. Ceux pris en charge actuellement sont : SnowScript et JavaScript. La valeur par défaut est définie sur SnowScript.

Reset Settings: The reset settings option appears on every page. If you’ve made changes, you can reset SnowConvert AI to its original default settings.