SnowConvert AI - Teradata - MLOAD¶

Références de traduction pour convertir des fichiers Teradata MLOAD en Python

Teradata MultiLoad est un utilitaire piloté par des commandes qui permet d’effectuer une maintenance rapide et en grande quantité sur plusieurs tables et vues de la base de données Teradata.

Afin de simuler la fonctionnalité MultiLoad pour Teradata dans Snowflake, les fichiers et les commandes MultiLoad sont transformés en code Python, de manière similaire aux transformations effectuées pour les scripts BTEQ et FastLoad. Le code généré utilise le projet Snowflake Python appelé snowconvert.helpers qui contient les fonctions requises pour simuler les instructions de MultiLoad dans Snowflake.

Traduction des commandes MultiLoad¶

La plupart des commandes MultiLoad sont considérées comme non pertinentes dans Snowflake, ces commandes sont donc commentées. Vous trouverez ci-dessous la liste récapitulative des commandes MultiLoad et leur statut de transformation dans Snowflake :

Commands	Transformation Status	Note
ACCEPT	Commented
BEGIN MLOAD	Transformed	The node is commented out since the transformation occurs in other related statements instead.
BEGIN DELETE MLOAD	Commented
DATEFORM	Commented
DELETE	Partially transformed	Check known issues.
DISPLAY	Commented
DML LABEL	Transformed
END MLOAD	Transformed	Commented out since is not necessary for the transformation of the BEGIN MLOAD.
EOC	Commented
FIELD	Transformed
FILLER	Transformed	This command needs to be with a FIELD and LAYOUT command to be converted.
IF, ELSE, and ENDIF	Commented
IMPORT	Transformed
INSERT	Transformed	This is taken as a Teradata Statement, so it doesn't appear in this chapter.
LAYOUT	Transformed	This command needs to be with a FIELD and FILLER command to be converted.
LOGDATA	Commented
LOGMECH	Commented
LOGOFF	Commented
LOGON	Commented
LOGTABLE	Commented
PAUSE ACQUISITION	Commented
RELEASE MLOAD	Commented
ROUTE MESSAGES	Commented
RUN FILE	Commented
SET	Commented
SYSTEM	Commented
TABLE	Commented
UPDATE	Transformed	This is taken as a Teradata Statement, so it doesn't appear in this chapter.
VERSION	Commented

Cependant, certaines commandes exceptionnelles doivent être converties en code spécifique à Python pour qu’elles fonctionnent comme prévu dans Snowflake. Voir cette section.

Si vous avez d’autres questions concernant cette documentation, vous pouvez nous envoyer un e-mail à snowconvert-support@snowflake.com.

BEGIN MLOAD¶

La transformation de la commande .BEGIN MLOAD est une transformation en plusieurs parties qui nécessite les commandes .LAYOUT, .FIELD, .FILLER,.DML LABEL et .IMPORT pour simuler correctement son comportement.

Cette transformation est expliquée en détail dans les sous-sections suivantes.

.LAYOUT, .FIELD et .FILLER¶

La transformation des commandes .LAYOUT, .FIELD et .FILLER créera des définitions de variables qui seront utilisées dans un futur appel de fonction de l’IMPORT de cette présentation.

Teradata (MultiLoad)

.LAYOUT INFILE_LAYOUT;
.FIELD TABLE_ID        * INTEGER;
.FIELD TABLE_DESCR     * CHAR(8);
.FILLER COL1           * CHAR(1);
.FIELD TABLE_NBR       * SMALLINT;
.FIELD TABLE_SOMEFIELD * SMALLINT;

Copy

Snowflake (Python)

#*** Generated code is based on the SnowConvert AI Python Helpers version 2.0.6 ***
 
import os
import sys
import snowconvert.helpers
from snowconvert.helpers import Export
from snowconvert.helpers import exec
from snowconvert.helpers import BeginLoading
con = None
def main():
  snowconvert.helpers.configure_log()
  con = snowconvert.helpers.log_on()
  INFILE_LAYOUT_TableName = "INFILE_LAYOUT_TEMP_TABLE"
  INFILE_LAYOUT_Columns = """TABLE_ID INTEGER, 
TABLE_DESCR CHAR(8), 
COL1 CHAR(1), 
TABLE_NBR SMALLINT, 
TABLE_SOMEFIELD SMALLINT"""
  INFILE_LAYOUT_Conditions = """TABLE_ID AS TABLE_ID, TABLE_DESCR AS TABLE_DESCR, COL1 AS COL1, TABLE_NBR AS TABLE_NBR, TABLE_SOMEFIELD AS TABLE_SOMEFIELD"""
  snowconvert.helpers.quit_application()

if __name__ == "__main__":
  main()

Copy

.DML LABEL¶

La transformation pour la commande .DML LABELcréera une fonction contenant les instructions après la définition de l’étiquette. Notez qu’après la commande .DML LABEL, il y a généralement une commande Insert, Update ou Delete.

Teradata (MultiLoad)

-- Example of .DML LABEL with INSERT:
.DML LABEL INSERT_TABLE;                                                                                    
INSERT INTO mydb.mytable( TABLE_ID,TABLE_DESCR,TABLE_NBR ) VALUES( :TABLE_ID,:TABLE_DESCR,:TABLE_NBR );

-- Example of .DML LABEL with DELETE:
.DML LABEL DELETE_TABLE;              
DELETE FROM Employee WHERE EmpNo  = :EmpNo;

-- Example of .DML LABEL with an UPDATE, followed by an INSERT:
.DML LABEL UPSERT_TABLE DO INSERT FOR MISSING UPDATE ROWS;
UPDATE   mydb.mytable SET TABLE_ID = :TABLE_ID WHERE TABLE_DESCR = :somedescription
INSERT INTO mydb.mytable(TABLE_ID, TABLE_DESCR, TABLE_NBR) VALUES(:TABLE_ID, :TABLE_DESCR, :TABLE_NBR );

Copy

Snowflake (Python)

#*** Generated code is based on the SnowConvert AI Python Helpers version 2.0.6 ***
 
import os
import sys
import snowconvert.helpers
from snowconvert.helpers import Export
from snowconvert.helpers import exec
from snowconvert.helpers import BeginLoading
con = None
def main():
  snowconvert.helpers.configure_log()
  con = snowconvert.helpers.log_on()
  def INSERT_TABLE(tempTableName, queryConditions = ""):
    exec(f"""INSERT INTO mydb.mytable (TABLE_ID, TABLE_DESCR, TABLE_NBR)
SELECT
   :TABLE_ID,
   :TABLE_DESCR,
   :TABLE_NBR
FROM {tempTableName} SRC {queryConditions}""")
  exec("""
    DELETE FROM
      Employee
    WHERE
      EmpNo = :EmpNo
    """)
  def UPSERT_TABLE(tempTableName, queryConditions = ""):
    exec(f"""MERGE INTO mydb.mytable TGT USING (SELECT * FROM {tempTableName} {queryConditions}) SRC ON TABLE_DESCR = :somedescription
WHEN MATCHED THEN UPDATE SET
   TABLE_ID = :TABLE_ID
WHEN NOT MATCHED THEN INSERT (TABLE_ID, TABLE_DESCR, TABLE_NBR)
VALUES (:TABLE_ID, :TABLE_DESCR, :TABLE_NBR)""")
  snowconvert.helpers.quit_application()

if __name__ == "__main__":
  main()

Copy

.IMPORT¶

La transformation de la commande .IMPORT créera un appel à l’assistant import_file_to_temptablepour charger les données du fichier dans une table temporaire. Ensuite, les appels à toutes les étiquettesAPPLYutilisées dans l’importation originale seront créés. Enfin, les appels à une étiquetteINSERTseront transformés en paramètre de requête et pourront éventuellement être assortis d’une condition de requête.

Teradata (MultiLoad)

.IMPORT INFILE INFILE_FILENAME
    LAYOUT INFILE_LAYOUT
    APPLY INSERT_TABLE
    APPLY UPSERT_TABLE
    Apply DELETE_TABLE;

Copy

Snowflake (Python)

#*** Generated code is based on the SnowConvert AI Python Helpers version 2.0.6 ***
 
import os
import sys
import snowconvert.helpers
from snowconvert.helpers import Export
from snowconvert.helpers import exec
from snowconvert.helpers import BeginLoading
con = None
def main():
  snowconvert.helpers.configure_log()
  con = snowconvert.helpers.log_on()
  #** SSC-FDM-0027 - REMOVED NEXT STATEMENT, NOT APPLICABLE IN SNOWFLAKE. TRANSLATED BELOW **
  #.IMPORT INFILE INFILE_FILENAME LAYOUT INFILE_LAYOUT APPLY INSERT_TABLE APPLY UPSERT_TABLE Apply DELETE_TABLE
   
  snowconvert.helpers.import_file_to_temptable(fr"INFILE_FILENAME", INFILE_LAYOUT_TableName, INFILE_LAYOUT_Columns, INFILE_LAYOUT_Conditions, ',')
  INSERT_TABLE(INFILE_LAYOUT_TableName)
  UPSERT_TABLE(INFILE_LAYOUT_TableName)
  DELETE_TABLE(INFILE_LAYOUT_TableName)
  exec(f"""DROP TABLE {INFILE_LAYOUT_TableName}""")
  snowconvert.helpers.quit_application()

if __name__ == "__main__":
  main()

Copy

Large exemple¶

Compte tenu des transformations présentées ci-dessus pour diverses commandes, considérez l’exemple suivant.

Avec ces données d’entrée :

id,name,age
1,John,25
2,Maria,29
3,Carlos,31
4,Mike,40
5,Laura,27

Copy

Teradata (MultiLoad)

Requête

.begin import mload
        tables
	mySampleTable1
sessions 20
ampcheck none;

.layout myLayOut;
 .field ID * VARCHAR(2) NULLIF ID = '1';
 .field NAME * VARCHAR(25);
 .field AGE * VARCHAR(10);
.dml label insert_data;

INSERT INTO mySampleTable1
 ( 
    ID,
    NAME,
    AGE	
 )
VALUES
 (
    :ID,
    SUBSTRING(:NAME FROM 2),
    :AGE
 );

.import infile sampleData.txt
layout myLayOut
apply insert_data

.end mload;
.logoff;

Copy

Résultat

ROW	ID	NAME	AGE
1	NULL	ohn	25
2	2	aria	29
3	3	arlos	31
4	4	ike	40
5	5	aura	27

Snowflake (Python)

Requête

#*** Generated code is based on the SnowConvert AI Python Helpers version 2.0.6 ***
#** SSC-FDM-0007 - MISSING DEPENDENT OBJECT "mySampleTable1" **
 
import os
import sys
import snowconvert.helpers
from snowconvert.helpers import Export
from snowconvert.helpers import exec
from snowconvert.helpers import BeginLoading
con = None
def main():
  snowconvert.helpers.configure_log()
  con = snowconvert.helpers.log_on()
  #** SSC-FDM-0027 - REMOVED NEXT STATEMENT, NOT APPLICABLE IN SNOWFLAKE.  **
  #.begin import mload tables mySampleTable1 sessions 20 ampcheck none
   
  myLayOut_TableName = "myLayOut_TEMP_TABLE"
  myLayOut_Columns = """ID VARCHAR(2), 
NAME VARCHAR(25), 
AGE VARCHAR(10)"""
  myLayOut_Conditions = """CASE
   WHEN UPPER(RTRIM(ID)) = UPPER(RTRIM('1'))
      THEN NULL
   ELSE ID
END AS ID, NAME AS NAME, AGE AS AGE"""
  def insert_data(tempTableName, queryConditions = ""):
    exec(f"""INSERT INTO mySampleTable1 (ID, NAME, AGE)
SELECT
   SRC.ID,
   SUBSTRING(SRC.NAME, 2),
   SRC.AGE
FROM {tempTableName} SRC {queryConditions}""")
  #** SSC-FDM-0027 - REMOVED NEXT STATEMENT, NOT APPLICABLE IN SNOWFLAKE. TRANSLATED BELOW **
  #.import infile sampleData.txt layout myLayOut apply insert_data
   
  snowconvert.helpers.import_file_to_temptable(fr"sampleData.txt", myLayOut_TableName, myLayOut_Columns, myLayOut_Conditions, ',')
  insert_data(myLayOut_TableName)
  exec(f"""DROP TABLE {myLayOut_TableName}""")

  if con is not None:
    con.close()
    con = None
  snowconvert.helpers.quit_application()

if __name__ == "__main__":
  main()

Copy

Résultat

ROW	ID	NAME	AGE
1	NULL	ohn	25
2	2	aria	29
3	3	arlos	31
4	4	ike	40
5	5	aura	27

Problèmes connus¶

1. L’instruction delete est partiellement prise en charge

L’instruction DELETE est partiellement prise en charge car les conditions where, lorsqu’elles sont trouvées, ne sont pas converties correctement si elles pointent vers une colonne définie par LAYOUT.

Dans l’exemple ci-dessous, :EmpNo pointe vers une colonne définie par LAYOUT. Cependant, la transformation n’en tient pas compte et le code fera donc référence à une colonne qui n’existe pas.

  exec("""
    DELETE FROM
      Employee
    WHERE
      EmpNo = :EmpNo
    """)

Copy

Si vous avez d’autres questions concernant cette documentation, vous pouvez nous envoyer un e-mail à snowconvert-support@snowflake.com.

SnowConvert AI - Teradata - MLOAD¶

Traduction des commandes MultiLoad¶

BEGIN MLOAD¶

.LAYOUT, .FIELD et .FILLER¶

.DML LABEL¶

.IMPORT¶

Large exemple¶

Problèmes connus¶

EWIs connexes ¶