SnowConvert AI – Teradata – SQL in JavaScript (Prozeduren)¶
GET DIAGNOSTICS EXCEPTION¶
Übersetzungsreferenz zur Konvertierung der GET DIAGNOSTICS EXCEPTION-Anweisung von Teradata in Snowflake Scripting
Beschreibung ¶
GET DIAGNOSTICS ruft Informationen über Erfolgs-, Ausnahme- oder Abschlussbedingungen aus dem Diagnosebereich ab.
Weitere Informationen zu GET DIAGNOSTICS in Teradata finden Sie hier.
GET DIAGNOSTICS
{
[ EXCEPTION < condition_number >
[ < parameter_name | variable_name > = < information_item > ]...
]
|
[ < parameter_name | variable_name > = < information_item > ]...
}
Bemerkung
Einige Teile des Ausgabecodes werden aus Gründen der Übersichtlichkeit weggelassen.
Beispielhafte Quellcode-Muster ¶
Teradata ¶
Abfrage¶
-- Additional Params: -t JavaScript
CREATE PROCEDURE getDiagnosticsSample ()
BEGIN
DECLARE V_MESSAGE, V_CODE VARCHAR(200);
DECLARE V_Result INTEGER;
SELECT c1 INTO V_Result FROM tab1;
GET DIAGNOSTICS EXCEPTION 1 V_MESSAGE = MESSAGE_TEXT;
END;
Snowflake ¶
Javascript¶
CREATE OR REPLACE PROCEDURE getDiagnosticsSample ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
var V_MESSAGE;
var V_CODE;
var V_RESULT;
EXEC(`SELECT c1 FROM tab1`,[]);
[V_RESULT] = INTO();
V_MESSAGE = MESSAGE_TEXT;
$$;
Probleme kennen¶
Nicht unterstützte BEDINGUNGSATTRIBUT-Anweisungen
CLASS_ORIGIN
CONDITION_IDENTIFIER
CONDITION_NUMBER
MESSAGE_LENGTH
RETURNED_SQLSTATE
SUBCLASS_ORIGIN
If¶
Die Transformation für die IF-Anweisung lautet:
Teradata
IF value = 2 THEN
Snowflake
if(value == 2){
}
Case¶
Die Transformation für die CASE-Anweisung lautet:
Teradata
case value
when 0 then
select * from table1
else
update table1 set name = "SpecificValue" where id = value;
end case
Snowflake
switch(value) {
case 0:EXEC(`SELECT * FROM PUBLIC.table1`,[]);
break;
default:EXEC(`UPDATE PUBLIC.table1 set name = "SpecificValue" where id = value`,[]);
break;
}
Cursor-Deklaration, OPEN, FETCH und CLOSE¶
Die Transformation für CURSOR-Anweisungen lautet:
Teradata
Cursor¶
-- Additional Params: -t JavaScript
CREATE PROCEDURE procedure1()
DYNAMIC RESULT SETS 2
BEGIN
-------- Local variables --------
DECLARE sql_cmd VARCHAR(20000) DEFAULT ' ';
DECLARE num_cols INTEGER;
------- Declare cursor with return only-------
DECLARE resultset CURSOR WITH RETURN ONLY FOR firststatement;
------- Declare cursor -------
DECLARE cur2 CURSOR FOR SELECT COUNT(columnname) FROM table1;
-------- Set --------
SET sql_cmd='sel * from table1';
-------- Prepare cursor --------
PREPARE firststatement FROM sql_cmd;
-------- Open cursors --------
OPEN resultset;
OPEN cur1;
-------- Fetch -------------
FETCH cur1 INTO val1, val2;
-------- Close cursor --------
CLOSE cur1;
END;
Snowflake
JavaScript Cursor¶
CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
//------ Local variables --------
var SQL_CMD = ` `;
var NUM_COLS;
var RESULTSET = new CURSOR(() => FIRSTSTATEMENT,[],true);
//----- Declare cursor -------
var CUR2 = new CURSOR(`SELECT COUNT(columnname) FROM table1`,[],false);
//------ Set --------
SQL_CMD = `SELECT * from table1`;
//------ Prepare cursor --------
var FIRSTSTATEMENT = SQL_CMD;
//------ Open cursors --------
RESULTSET.OPEN();
CUR1.OPEN();
//------ Fetch -------------
CUR1.FETCH() && ([val1,val2] = CUR1.INTO());
//------ Close cursor --------
CUR1.CLOSE();
return PROCRESULTS();
$$;
While¶
Die Transformation für die WHILE-Anweisung lautet:
Teradata
While¶
while (counter < 10) do
set counter = counter + 1;
Snowflake¶
While¶
while ( counter < 10) {
counter = counter + 1;
}
Security¶
Die Transformation für Sicherheitsanweisungen ist:
Teradata |
Snowflake |
|---|---|
SQL SECURITY CREATOR |
EXECUTE AS OWNER |
SQL SECURITY INVOKER |
EXECUTE AS CALLER |
SQL SECURITY DEFINER |
EXECUTE AS OWNER |
FOR-CURSOR-FOR-Loop¶
Die Transformation für die FOR-CURSOR-FOR-Schleife ist:
Teradata
For-Cursor-For-Loop¶
-- Additional Params: -t JavaScript
REPLACE PROCEDURE Database1.Proc1()
BEGIN
DECLARE lNumber INTEGER DEFAULT 1;
FOR class1 AS class2 CURSOR FOR
SELECT COL0,
TRIM(COL1) AS COL1ALIAS,
TRIM(COL2),
COL3
FROM someDb.prefixCol
DO
INSERT INTO TempDB.Table1 (:lgNumber, :lNumber, (',' || :class1.ClassCD || '_Ind CHAR(1) NOT NULL'));
SET lNumber = lNumber + 1;
END FOR;
END;
Snowflake
JavaScript For-Cursor-For-Loop¶
CREATE OR REPLACE PROCEDURE Database1.Proc1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
var LNUMBER = 1;
/*** SSC-EWI-0023 - PERFORMANCE REVIEW - THIS LOOP CONTAINS AN INSERT, DELETE OR UPDATE STATEMENT ***/
for(var CLASS2 = new CURSOR(`SELECT
COL0,
TRIM(COL1) AS COL1ALIAS,
TRIM(COL2),
COL3
FROM
someDb.prefixCol`,[],false).OPEN();CLASS2.NEXT();) {
let CLASS1 = CLASS2.CURRENT;
EXEC(`INSERT INTO TempDB.Table1
VALUES (:lgNumber, :1, (',' || :
!!!RESOLVE EWI!!! /*** SSC-EWI-0026 - THE VARIABLE class1.ClassCD MAY REQUIRE A CAST TO DATE, TIME OR TIMESTAMP ***/!!!
:2 || '_Ind CHAR(1) NOT NULL'))`,[LNUMBER,CLASS1.CLASSCD]);
LNUMBER = LNUMBER + 1;
}
CLASS2.CLOSE();
$$;
_Anmerkung: Die in der Teradata-Prozedur vorhandene FOR -Schleife wird in einen FOR-Block in Javascript transformiert, der ihre Funktionalität emuliert
Prozedurparameter und -variablen, die in Anweisungen referenziert werden¶
Die Transformation für die Parameter und Variablen der Prozedur, auf die innerhalb der Anweisungen der Prozedur verwiesen wird, lautet:
Teradata
Parameter und Variablen¶
-- Additional Params: -t JavaScript
REPLACE PROCEDURE PROC1 (param1 INTEGER, param2 VARCHAR(30))
BEGIN
DECLARE var1 VARCHAR(1024);
DECLARE var2 SMALLINT;
DECLARE weekstart date;
set weekstart= '2019-03-03';
set var1 = 'something';
set var2 = 123;
SELECT * FROM TABLE1 WHERE SOMETHING = :param1;
SELECT * FROM TABLE1 WHERE var1 = var1 AND date1 = weekstart AND param2 = :param2;
INSERT INTO TABLE2 (col1, col2, col3, col4, col5) VALUES (:param1, :param2, var1, var2, weekstart);
END;
Snowflake
JavaScript-Parameter und -Variablen¶
CREATE OR REPLACE PROCEDURE PROC1 (PARAM1 FLOAT, PARAM2 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
var VAR1;
var VAR2;
var WEEKSTART;
WEEKSTART = `2019-03-03`;
VAR1 = `something`;
VAR2 = 123;
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`SELECT * FROM TABLE1 WHERE SOMETHING = :1`,[PARAM1]);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`SELECT * FROM TABLE1 WHERE :1 = :1 AND date1 = :2 AND param2 = :3`,[VAR1,WEEKSTART,PARAM2]);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`INSERT INTO TABLE2 (col1, col2, col3, col4, col5) VALUES (:1, :2, :3, :4, :5)`,[PARAM1,PARAM2,VAR1,VAR2,WEEKSTART]);
$$;
Anmerkung: Wann immer ein Prozedurparameter oder eine innerhalb der Prozedur deklarierte Variable in einer Teradata-Anweisung referenziert wird, die konvertiert werden muss, wird diese Referenz aus dem resultierenden Text ausgeblendet, um die Funktionalität der ursprünglichen Referenz zu erhalten.
Leave¶
In Javascript ist es möglich, break mit einem zusätzlichen Parameter zu verwenden und so die Verhaltensweise eines Teradata LEAVE-Sprungs zu emulieren.
Labels können auch durch die Verwendung von LABELED-Anweisungen in Javascript emuliert werden.
Die Transformation für die LEAVE-Anweisung lautet:
Teradata
Leave¶
-- Additional Params: -t JavaScript
REPLACE PROCEDURE PROC1 ()
BEGIN
DECLARE v_propval VARCHAR(1024);
DECLARE Cur1 cursor for
Select
propID
from viewName.viewCol
where propval is not null;
LABEL_WHILE:
WHILE (SQLCODE = 0)
DO
IF (SQLSTATE = '02000' )
THEN LEAVE LABEL_WHILE;
END IF;
LABEL_INNER_WHILE:
WHILE (SQLCODE = 0)
DO
IF (SQLSTATE = '02000' )
THEN LEAVE LABEL_INNER_WHILE;
END IF;
END WHILE LABEL_INNER_WHILE;
SELECT * FROM TABLE1;
END WHILE L1;
END;
Snowflake
JavaScript Leave¶
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
var V_PROPVAL;
var CUR1 = new CURSOR(`SELECT propID from viewName.viewCol
where
propval is not null`,[],false);
LABEL_WHILE: {
while ( SQLCODE == 0 ) {
if (SQLSTATE == `02000`) {
break LABEL_WHILE;
}
LABEL_INNER_WHILE: {
while ( SQLCODE == 0 ) {
if (SQLSTATE == `02000`) {
break LABEL_INNER_WHILE;
}
}
}
EXEC(`SELECT * FROM TABLE1`,[]);
}
}
$$;
Ergebnisse aus Prozeduren abrufen¶
Beschreibung der Übersetzung¶
In Teradata gibt es zwei Möglichkeiten, Daten aus einer Prozedur zurückzugeben. Die erste ist durch Ausgabeparameter und die zweite durch Dynamische Resultsets und Cursors. Beide werden im folgenden Beispiel gezeigt. Jeder wichtige Punkt wird im Folgenden erläutert.
Beispiel für die Rückgabe von Daten aus einer gespeicherten Prozedur¶
Teradata
Out-Parameter¶
-- Additional Params: -t JavaScript
REPLACE PROCEDURE Procedure1(OUT P1 INTEGER)
DYNAMIC RESULT SETS 2
BEGIN
DECLARE SQL_CMD,SQL_CMD_1 VARCHAR(20000) DEFAULT ' ';
DECLARE RESULTSET CURSOR WITH RETURN ONLY FOR FIRSTSTATEMENT;
SET SQL_CMD = 'SEL * FROM EMPLOYEE';
PREPARE FIRSTSTATEMENT FROM SQL_CMD;
OPEN RESULTSET;
SET P1 = (SEL CAST(AVG(AGE) AS INTEGER) FROM EMPLOYEE);
END;
Snowflake
JavaScript Out-Parameter¶
CREATE OR REPLACE PROCEDURE Procedure1 (P1 FLOAT)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
var SQL_CMD = ` `;
var SQL_CMD_1 = ` `;
var RESULTSET = new CURSOR(() => FIRSTSTATEMENT,[],true);
SQL_CMD = `SELECT * FROM EMPLOYEE`;
var FIRSTSTATEMENT = SQL_CMD;
RESULTSET.OPEN();
EXEC(`(
SELECT
CAST(AVG(AGE) AS INTEGER)
FROM
EMPLOYEE
)`,[]);
var subQueryVariable0;
[subQueryVariable0] = INTO();
P1 = subQueryVariable0;
return PROCRESULTS(P1);
$$;
In diesem konvertierten SQL finden mehrere Konvertierungen statt:
Die Definition
DYNAMIC RESULT SETS 2wird in eine VariableDYNAMIC_RESULTSumgewandelt.
var DYNAMIC_RESULTS = 2;
Wenn ein Cursor mit dem Attribut
WITH RETURNgeöffnet wird (und damit eine Abfrage ausgeführt wird), wird seine Abfrage-ID in der Sammlung_ OUTQUERIESgespeichert, um später zurückgegeben zu werden. Die Abfrage-ID wird mit der FunktiongetQueryId()ermittelt, die in der Funktion JavaScript API für gespeicherte Prozeduren in Snowflake bereitgestellt wird.Nur die ersten k Abfragen-IDs werden in der Sammlung gespeichert, wobei k der Wert der Variable
DYNAMIC_RESULTSist. Damit wird die Verhaltensweise von Teradata emuliert, das nur die ersten k geöffneten Cursor zurückgibt, auch wenn in der gespeicherten Prozedur mehr geöffnet sind.Die Kombination von
DECLARE CURSOR WITH RETURNmitPREPAREwird übersetzt mit:
var RESULTSET = new CURSOR(() => FIRSTSTATEMENT,[],true);
Die Ausgabeparameter werden über die RETURN-Anweisung der Prozedur unterstützt. Es wird ein Array erstellt, das die Werte der einzelnen Ausgabeparameter und die Sammlung
_OUTQUERIESenthält. Die FunktionPROCRESULTSkümmert sich um die Erstellung und Befüllung dieses Arrays. Siehe PROCRESULTS() Hilfsfunktion für weitere Informationen.
return PROCRESULTS(P1);
Beispiel für den Abruf von Daten aus einer gespeicherten Prozedur.¶
Wenn die Ausgabeparameter und die Abfrage-IDs von einer Prozedur zurückgegeben werden, könnte eine zweite Prozedur die erste aufrufen, um diese Werte zu erhalten, wie unten gezeigt:
Teradata
Call-Prozedur¶
-- Additional Params: -t JavaScript
CREATE PROCEDURE Procedure2()
BEGIN
DECLARE x INTEGER;
CALL Procedure1(x);
END;
Snowflake
JavaScript Call-Prozedur¶
CREATE OR REPLACE PROCEDURE Procedure2 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"teradata"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert AI Helpers Code section is omitted.
var X;
EXEC(`CALL Procedure1(:1)`,[X]);
$$;
Der Wert des Arguments
P1vonProcedure1wird zurückgegeben und in der VariablenXgespeichert.Die von
Procedure1zurückgegebenen_ OUTQUERIESwerden in der Variablenresultsetgespeichert.
Bemerkung
Diese Verhaltensweise gilt auch für die INOUT-Parameter.
Bekannte Probleme¶
Es wurden keine Probleme gefunden.
Zugehörige EWIs¶
[SSC-EWI-0022](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0022): Ein oder mehrere Bezeichner in dieser Anweisung wurden standardmäßig als Parameter betrachtet.
[SSC-EWI-0023](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0023): Leistungsüberprüfung - Eine Schleife enthält eine Insert-, DELETE- oder UPDATE-Anweisung.
[SSC-EWI-0026](../../general/technical-documentation/issues-and-troubleshooting/conversion-issues/generalEWI. md#ssc-ewi-0026): Die Variable kann eine Umwandlung in ein Datum, eine Zeit oder einen Zeitstempel erfordern.
SSC-FDM-TD0001: Diese Nachricht wird angezeigt, wenn SnowConvert AI einen BLOB-Datentyp findet.