PL/SQL para JavaScript¶
Coleções e registros¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Registros¶
Nota
Talvez você também se interesse por Declaração de registros
Oracle
CREATE OR REPLACE PROCEDURE RECORDS_PROC AS
TYPE DEPTRECTYP IS RECORD (
DEPT_ID NUMBER(4) NOT NULL := 10,
DEPT_NAME VARCHAR2(30) NOT NULL := 'ADMINISTRATION',
MGR_ID NUMBER(6) := 200,
LOC_ID NUMBER(4) := 1700
);
TYPE NAME_REC IS RECORD (
FIRST EMPLOYEES.FIRST_NAME%TYPE,
LAST EMPLOYEES.LAST_NAME%TYPE
);
TYPE CONTACT IS RECORD (
NAME NAME_REC,-- NESTED RECORD
PHONE EMPLOYEES.PHONE_NUMBER%TYPE
);
DEPT1 DEPTRECTYP;
DEPT_NAME DEPTRECTYP;
C1 CONTACT;
BEGIN
DEPT1.DEPT_NAME := 'PURCHASING';
C1.NAME.FIRST := 'FALVARADO';
C1.PHONE := '50687818481';
SELECT * INTO DEPT1 FROM FTABLE46;
INSERT INTO TABLA1 VALUES (DEPT1.DEPT_NAME);
INSERT INTO TABLA1 VALUES (DEPT_NAME.DEPT_NAME);
EXECUTE IMMEDIATE 'SELECT * FROM FTABLE46' INTO DEPT_NAME;
END;
Snowflake
Aviso
A transformação para «SELECT INTO Record» está em andamento.
CREATE OR REPLACE PROCEDURE RECORDS_PROC ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO OBJECT ***/!!!
TYPE DEPTRECTYP IS RECORD (
DEPT_ID NUMBER(4) NOT NULL := 10,
DEPT_NAME VARCHAR2(30) NOT NULL := 'ADMINISTRATION',
MGR_ID NUMBER(6) := 200,
LOC_ID NUMBER(4) := 1700
);
!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO OBJECT ***/!!!
TYPE NAME_REC IS RECORD (
FIRST EMPLOYEES.FIRST_NAME%TYPE,
LAST EMPLOYEES.LAST_NAME%TYPE
);
!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO OBJECT ***/!!!
TYPE CONTACT IS RECORD (
NAME NAME_REC,-- NESTED RECORD
PHONE EMPLOYEES.PHONE_NUMBER%TYPE
);
DEPT1 OBJECT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - DEPTRECTYP DATA TYPE CONVERTED TO OBJECT ***/!!! := OBJECT_CONSTRUCT();
DEPT_NAME OBJECT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - DEPTRECTYP DATA TYPE CONVERTED TO OBJECT ***/!!! := OBJECT_CONSTRUCT();
C1 OBJECT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - CONTACT DATA TYPE CONVERTED TO OBJECT ***/!!! := OBJECT_CONSTRUCT();
BEGIN
DEPT1 := OBJECT_INSERT(DEPT1, 'DEPT_NAME', 'PURCHASING', true);
C1 := OBJECT_INSERT(C1, 'FIRST', 'FALVARADO', true);
C1 := OBJECT_INSERT(C1, 'PHONE', '50687818481', true);
SELECT
OBJECT_CONSTRUCT( *) INTO
:DEPT1
FROM
FTABLE46;
INSERT INTO TABLA1
SELECT
:DEPT1.DEPT_NAME:DEPT_ID,
:DEPT1.DEPT_NAME:DEPT_NAME,
:DEPT1.DEPT_NAME:MGR_ID,
:DEPT1.DEPT_NAME:LOC_ID;
INSERT INTO TABLA1
SELECT
:DEPT_NAME.DEPT_NAME:DEPT_ID,
:DEPT_NAME.DEPT_NAME:DEPT_NAME,
:DEPT_NAME.DEPT_NAME:MGR_ID,
:DEPT_NAME.DEPT_NAME:LOC_ID;
!!!RESOLVE EWI!!! /*** SSC-EWI-0030 - THE STATEMENT BELOW HAS USAGES OF DYNAMIC SQL. ***/!!!
EXECUTE IMMEDIATE 'SELECT * FROM
FTABLE46'
!!!RESOLVE EWI!!! /*** SSC-EWI-0058 - FUNCTIONALITY FOR 'EXECUTE IMMEDIATE RETURNING CLAUSE' IS NOT CURRENTLY SUPPORTED BY SNOWFLAKE SCRIPTING ***/!!!
INTO DEPT_NAME;
END;
$$;
Problemas conhecidos ¶
Não foram encontrados problemas.
Compilação condicional¶
Descrição ¶
Fornece compilação condicional com base no valor verdadeiro de uma condição.
Para obter mais informações sobre compilação condicional IF no Oracle, veja aqui.
$IF conditional_expression $THEN
statement
[ statement ]...
[ $ELSIF conditional_expression $THEN
statement
[ statement ]... ]...
[ $ELSE
statement
[ statement ]... ]
$END;
Amostra de padrões de origem ¶
Possíveis variações de IF¶
Oracle ¶
CREATE OR REPLACE PROCEDURE PROCEDURE_DEMO ()
AS
BEGIN
SELECT 2 FROM DUAL;
$IF $$debug_flag
$THEN
SELECT 1 FROM DUAL;
$END
END PROCEDURE_DEMO;
Script Snowflake¶
CREATE OR REPLACE PROCEDURE PROCEDURE_DEMO ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
BEGIN
SELECT 2 FROM DUAL;
!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'DOLLAR IF STATEMENT' NODE ***/!!!
$IF $$debug_flag
$THEN
SELECT 1 FROM DUAL;
$END
END;
$$;
Problemas conhecidos¶
A transformação da compilação condicional não é suportada no momento.
EWIs relacionados¶
SSC-EWI-0073: Revisão de equivalência funcional pendente.
Instruções de controle¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Instruções IF, ELSIF e ELSE¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1
IS
sal_raise NUMBER;
BEGIN
IF jobid = 'PU_CLERK' THEN sal_raise := .09;
ELSIF jobid = 'SH_CLERK' THEN sal_raise := .08;
ELSIF jobid = 'ST_CLERK' THEN sal_raise := .07;
ELSE sal_raise := 0;
END IF;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let SAL_RAISE;
if (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT jobid MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
JOBID == `PU_CLERK`) {
SAL_RAISE = 0.09;
} else if (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT jobid MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
JOBID == `SH_CLERK`) {
SAL_RAISE = 0.08;
} else if (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT jobid MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
JOBID == `ST_CLERK`) {
SAL_RAISE = 0.07;
} else {
SAL_RAISE = 0;
}
$$;
Loop¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1
IS
BEGIN
<<outer_loop>>
LOOP
i := i + 1;
j := 0;
<<inner_loop>>
LOOP
j := j + 1;
s := s + i * j; -- Sum several products
END LOOP inner_loop;
END LOOP outer_loop;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
while ( true ) {
I =
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT i MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
I + 1;
J = 0;
while ( true ) {
J =
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT j MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
J + 1;
S =
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT s MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
S +
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT i MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
I *
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT j MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
J;
}
}
$$;
Instrução While¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1
IS
I NUMBER := 1;
J NUMBER := 10;
BEGIN
WHILE I <> J LOOP
I := I+1;
END LOOP;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let I = 1;
let J = 10;
while ( I != J ) {
I = I + 1;
}
$$;
EWIs relacionados¶
SSC-EWI-0053: O objeto pode não funcionar.
Declarações¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Declaração e atribuição de variáveis¶
Oracle
CREATE OR REPLACE PROCEDURE PROC_VARIABLES
IS
localVar1 NUMBER;
localVar2 VARCHAR(100);
localVar3 VARCHAR2 := 'local variable 3';
localVar4 VARCHAR2 DEFAULT 'local variable 4';
localVar5 VARCHAR2 NOT NULL := 'local variable 5';
localVar6 VARCHAR2 NOT NULL DEFAULT 'local variable 6';
localVar7 NUMBER := NULL;
localVar8 NUMBER := '';
BEGIN
localVar1 := 123;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC_VARIABLES ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let LOCALVAR1;
let LOCALVAR2;
let LOCALVAR3 = `local variable 3`;
let LOCALVAR4 = `local variable 4`;
let LOCALVAR5 = `local variable 5`;
let LOCALVAR6 = `local variable 6`;
let LOCALVAR7 = undefined;
let LOCALVAR8 = undefined;
LOCALVAR1 = 123;
$$;
Declaração de variável de registro¶
Nota
Talvez você também se interesse pela seção de transformação de registros.
Oracle
CREATE OR REPLACE PROCEDURE PROC_RECORDS
IS
TYPE DEPTRECTYP IS RECORD (
DEPT_ID NUMBER(4) NOT NULL := 10,
DEPT_NAME VARCHAR2(30) NOT NULL := 'ADMINISTRATION',
MGR_ID NUMBER(6) := 200,
LOC_ID NUMBER(4) := 1700
);
TYPE NAME_REC IS RECORD (
FIRST EMPLOYEES.FIRST_NAME%TYPE,
LAST EMPLOYEES.LAST_NAME%TYPE
);
TYPE CONTACT IS RECORD (
NAME NAME_REC,-- NESTED RECORD
PHONE EMPLOYEES.PHONE_NUMBER%TYPE
);
BEGIN
null;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC_RECORDS ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
class DEPTRECTYP {
DEPT_ID = 10
DEPT_NAME = `ADMINISTRATION`
MGR_ID = 200
LOC_ID = 1700
constructor() {
[...arguments].map((element,Index) => this[(Object.keys(this))[Index]] = element)
}
}
class NAME_REC {
FIRST
LAST
constructor() {
[...arguments].map((element,Index) => this[(Object.keys(this))[Index]] = element)
}
}
class CONTACT {
NAME = new NAME_REC()
PHONE
constructor() {
[...arguments].map((element,Index) => this[(Object.keys(this))[Index]] = element)
}
}
null;
$$;
Declaração da variável de registro Rowtype¶
Oracle
CREATE OR REPLACE PROCEDURE ROWTYPE_PROC AS
varname number := 1;
CURSOR BOOK_CURSOR IS SELECT * FROM BOOK where 1 = varname;
BOOK_REC BOOK%ROWTYPE;
BOOK_CUR_REC BOOK_CURSOR%ROWTYPE;
BEGIN
BOOK_REC.ID := 10;
BOOK_REC.TITLE := 'A STUDY IN SCARLET';
BOOK_REC.AUTHOR := 'SIR ARTHUR CONAN DOYLE';
INSERT INTO BOOK VALUES(BOOK_REC.ID, BOOK_REC.TITLE, BOOK_REC.AUTHOR);
OPEN BOOK_CURSOR;
FETCH BOOK_CURSOR INTO BOOK_CUR_REC;
CLOSE BOOK_CURSOR;
END;
Snowflake
CREATE OR REPLACE PROCEDURE ROWTYPE_PROC ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VARNAME = 1;
let BOOK_CURSOR = new CURSOR(`SELECT * FROM
BOOK
where 1 = ?`,() => [VARNAME]);
let BOOK_REC = ROWTYPE(`BOOK`);
let BOOK_CUR_REC = BOOK_CURSOR.ROWTYPE();
BOOK_REC.ID = 10;
BOOK_REC.TITLE = `A STUDY IN SCARLET`;
BOOK_REC.AUTHOR = `SIR ARTHUR CONAN DOYLE`;
EXEC(`INSERT INTO BOOK
VALUES(
!!!RESOLVE EWI!!! /*** SSC-EWI-0026 - THE VARIABLE BOOK_REC.ID MAY REQUIRE A CAST TO DATE, TIME OR TIMESTAMP ***/!!!
?,
!!!RESOLVE EWI!!! /*** SSC-EWI-0026 - THE VARIABLE BOOK_REC.TITLE MAY REQUIRE A CAST TO DATE, TIME OR TIMESTAMP ***/!!!
?,
!!!RESOLVE EWI!!! /*** SSC-EWI-0026 - THE VARIABLE BOOK_REC.AUTHOR MAY REQUIRE A CAST TO DATE, TIME OR TIMESTAMP ***/!!!
?)`,[BOOK_REC.ID,BOOK_REC.TITLE,BOOK_REC.AUTHOR]);
BOOK_CURSOR.OPEN();
BOOK_CURSOR.FETCH(BOOK_CUR_REC) && ([BOOK_CUR_REC] = BOOK_CURSOR.INTO());
BOOK_CURSOR.CLOSE();
$$;
Declaração de constante¶
Oracle
CREATE OR REPLACE PROCEDURE PROC_CONSTANTS
IS
MY_VAR1 NUMBER;
MY_CONST_VAR1 CONSTANT INTEGER(4) := 40;
MY_CONST_VAR2 CONSTANT INTEGER(4) NOT NULL := MY_CONST_VAR1;
MY_CONST_VAR3 CONSTANT VARCHAR(20) DEFAULT 'const variable';
MY_CONST_VAR4 CONSTANT REAL NOT NULL DEFAULT 3.14159;
BEGIN
MY_VAR1 := MY_CONST_VAR1 + MY_CONST_VAR2 + 1;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC_CONSTANTS ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let MY_VAR1;
const MY_CONST_VAR1 = 40;
const MY_CONST_VAR2 = MY_CONST_VAR1;
const MY_CONST_VAR3 = `const variable`;
const MY_CONST_VAR4 = 3.14159;
MY_VAR1 = MY_CONST_VAR1 + MY_CONST_VAR2 + 1;
$$;
Declarações e definições de cursor¶
Oracle
Nota
Talvez você também se interesse por Auxiliar de Cursor
CREATE OR REPLACE PROCEDURE PROC_CURSORS
IS
CURSOR C1 RETURN Table1%ROWTYPE;
CURSOR C2 RETURN UserDefinedRecordType;
CURSOR C3 RETURN Table1%ROWTYPE IS
SELECT * FROM Table1 WHERE ID = 110;
CURSOR C4 IS
SELECT * FROM Table1 WHERE ID = 123;
CURSOR C5 (cursorParam NUMBER ) RETURN Table1%ROWTYPE IS
SELECT * FROM Table1 WHERE ID = cursorParam;
BEGIN
null;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-lo aqui
CREATE OR REPLACE PROCEDURE PROC_CURSORS ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let C1 = new CURSOR();
let C2 = new CURSOR();
let C3 = new CURSOR(`SELECT * FROM
Table1
WHERE ID = 110`,() => []);
let C4 = new CURSOR(`SELECT * FROM
Table1
WHERE ID = 123`,() => []);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
let C5 = new CURSOR(`SELECT * FROM
Table1
WHERE ID = ?`,(CURSORPARAM) => [CURSORPARAM]);
null;
$$;
Problemas conhecidos ¶
Não foram encontrados problemas.
EWIs Relacionados ¶
Sem EWIs relacionados.
SSC-EWI-0022: Um ou mais identificadores nessa instrução foram considerados parâmetros por padrão.
SSC-EWI-0026: A variável pode exigir uma conversão para data, hora ou carimbo de data/hora.
Expressões e operadores¶
Expressões¶
Operador de concatenação¶
Nota
Talvez você também se interesse pelo auxiliar Concat
A concatenação do Oracle é obtida no JavaScript usando o literal Template. Além disso, ele usa o Auxiliar Concat para tratar adequadamente as concatenações com nulos.
Oracle
CREATE OR REPLACE PROCEDURE CONCAT_TEST
IS
NUM1 INTEGER := 123;
NUM2 INTEGER := 321;
VAR1 VARCHAR(10) := 'value';
concat_var VARCHAR(100);
sql_stmt VARCHAR(100);
BEGIN
concat_var := NUM1 || NUM2 || VAR1 || 'literal';
sql_stmt := 'INSERT INTO t1 VALUES (''' || concat_var || ''')';
EXECUTE IMMEDIATE sql_stmt;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE CONCAT_TEST ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let NUM1 = 123;
let NUM2 = 321;
let VAR1 = `value`;
let CONCAT_VAR;
let SQL_STMT;
CONCAT_VAR = `${concatValue(NUM1)}${concatValue(NUM2)}${concatValue(VAR1)}literal`;
SQL_STMT = `INSERT INTO t1
VALUES ('${concatValue(CONCAT_VAR)}')`;
EXEC(SQL_STMT);
$$;
Operadores de lógica¶
Oracle
CREATE OR REPLACE PROCEDURE BOOLEAN_PROC (b_name VARCHAR2, b_value BOOLEAN)
IS
BOOL1 BOOLEAN := FALSE;
x NUMBER := 5;
y NUMBER := NULL;
BEGIN
IF b_value IS NULL THEN
null;
ELSIF b_value = TRUE THEN
null;
ELSIF b_value = TRUE AND b_value = BOOL1 OR b_value = BOOL1 THEN
null;
ELSIF x > y THEN
null;
ELSIF x != y AND x <> y THEN
null;
ELSE
null;
END IF;
END;
Snowflake
Nota
Talvez você também se interesse pelo auxiliar IS NULL.
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE BOOLEAN_PROC (b_name STRING, b_value BOOLEAN)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let BOOL1 = false;
let X = 5;
let Y = undefined;
if (IS_NULL(B_VALUE)) {
null;
} else if (B_VALUE == true) {
null;
} else if (B_VALUE == true && B_VALUE == BOOL1 || B_VALUE == BOOL1) {
null;
} else if (X > Y) {
null;
} else if (X != Y && X != Y) {
null;
} else {
null;
}
$$;
Operador de comparação¶
Documentação em andamento.
IS [NOT] NULL¶
Nota
Talvez você também se interesse pelo auxiliar IS NULL.
Oracle
CREATE OR REPLACE PROCEDURE NULL_TEST
IS
NUM1 INTEGER := 789;
BEGIN
IF NUM1 IS NOT NULL THEN
NULL;
END IF;
NUM1 := NULL;
IF NUM1 IS NULL THEN
NULL;
END IF;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE NULL_TEST ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let NUM1 = 789;
if (!IS_NULL(NUM1)) {
null;
}
NUM1 = undefined;
if (IS_NULL(NUM1)) {
null;
}
$$;
OperadorLike¶
Nota
Talvez você também se interesse pelo auxiliar do operador Like.
Quando houver uma operação LIKE, a função do auxiliar será chamada em seu lugar.
Oracle
CREATE OR REPLACE PROCEDURE PROCEDURE_WITH_LIKE AS
BEGIN
IF 'ABC' LIKE '%A%' THEN
null;
END IF;
IF 'ABC' LIKE 'A%' THEN
null;
END IF;
IF 'ABC' NOT LIKE 'D_%' THEN
null;
END IF;
IF 'ABC' NOT LIKE 'D/%%' ESCAPE '/' THEN
null;
END IF;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROCEDURE_WITH_LIKE ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
if (LIKE(`ABC`,`%A%`)) {
null;
}
if (LIKE(`ABC`,`A%`)) {
null;
}
if (!LIKE(`ABC`,`D_%`)) {
null;
}
if (!LIKE(`ABC`,`D/%%`,`/`)) {
null;
}
$$;
Operador Between¶
Nota
Você também pode estar interessado no auxiliar do operador Between
Oracle
CREATE OR REPLACE PROCEDURE BETWEEN_TEST
IS
NUM1 INTEGER := 789;
US INTEGER := 1000;
BEGIN
IF 800 BETWEEN US AND NUM1 THEN
NULL;
END IF;
IF 'BA' BETWEEN 'B' AND 'CA' THEN
NULL;
END IF;
-- Assign null to the variable num1
NUM1 := NULL;
IF (0 BETWEEN NULL AND NUM1) IS NULL THEN
NULL;
END IF;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE BETWEEN_TEST ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let NUM1 = 789;
let US = 1000;
if (BetweenFunc(800,US,NUM1)) {
null;
}
if (BetweenFunc(`BA`,`B`,`CA`)) {
null;
}
// Assign null to the variable num1
NUM1 = undefined;
if (IS_NULL(BetweenFunc(0,undefined,NUM1))) {
null;
}
$$;
Operador IN¶
Oracle
CREATE OR REPLACE PROCEDURE IN_PROC
IS
letter VARCHAR2(1) := 'm';
BEGIN
IF letter IN ('a', 'b', 'c') THEN
null;
ELSE
null;
END IF;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE IN_PROC ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let LETTER = `m`;
if ([`a`,`b`,`c`].includes(LETTER)) {
null;
} else {
null;
}
$$;
Expressões boolianas¶
Oracle
CREATE OR REPLACE PROCEDURE BOOLEAN_TEST
IS
done BOOLEAN;
BEGIN
-- These WHILE loops are equivalent
done := FALSE;
WHILE done = FALSE
LOOP
done := TRUE;
END LOOP;
done := FALSE;
WHILE NOT (done = TRUE)
LOOP
done := TRUE;
END LOOP;
done := FALSE;
WHILE NOT done
LOOP
done := TRUE;
END LOOP;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE BOOLEAN_TEST ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let DONE;
// These WHILE loops are equivalent
DONE = false;
while ( DONE == false ) {
DONE = true;
}
DONE = false;
while ( !(DONE == true) ) {
DONE = true;
}
DONE = false;
while ( !DONE ) {
DONE = true;
}
$$;
Expressões de função¶
Para expressões de função dentro de procedimentos, elas estão sendo convertidas para a função ou expressão correspondente no Snowflake. Essas chamadas de função são passadas para um EXEC com um CALL ou um SELECT, dependendo do valor convertido.
Oracle
CREATE OR REPLACE PROCEDURE FUNCTIONS_TEST(DATEPARAM DATE)
IS
STRING_VALUE VARCHAR(20) := 'HELLO';
BEGIN
STRING_VALUE := TO_CHAR(123);
STRING_VALUE := TO_CHAR(DATEPARAM, 'dd-mm-yyyy', 'NLS_DATE_LANGUAGE = language');
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE FUNCTIONS_TEST (DATEPARAM TIMESTAMP /*** SSC-FDM-OR0042 - DATE TYPE COLUMN HAS A DIFFERENT BEHAVIOR IN SNOWFLAKE. ***/)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let STRING_VALUE = `HELLO`;
STRING_VALUE = (EXEC(`SELECT
TO_CHAR(123)`))[0];
STRING_VALUE = (EXEC(`SELECT
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0013 - NLS PARAMETER 'NLS_DATE_LANGUAGE = language' NOT SUPPORTED ***/!!!
TO_CHAR(PUBLIC.CAST_DATE_UDF(?), 'dd-mm-yyyy')`,[DATEPARAM]))[0];
$$;
Para obter mais informações sobre as transformações da função, veja aqui.
Problemas conhecidos ¶
Não foram encontrados problemas.
EWIs Relacionados ¶
Sem EWIs relacionados.
SSC-EWI-OR0013: o parâmetro NLS não é compatível.
SSC-FDM-OR0042: O tipo de data transformado em carimbo de data/hora tem um comportamento diferente.
Funções definidas pelo usuário¶
Descrição geral¶
A maioria dos Oracle UDFs e dos UDFs dentro de pacotes está sendo transformada em procedimentos armazenados do Snowflake para manter a equivalência funcional, pois Snowflake UDFs têm algumas limitações na execução de instruções DML (Data Manipulation Language).
Como as funções estão sendo transformadas em procedimentos, a referência de transformação para PL/SQL também se aplica aqui.
Conversão¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Função Create¶
Oracle
CREATE OR REPLACE FUNCTION FUN1(PAR1 VARCHAR)
RETURN VARCHAR
IS
VAR1 VARCHAR(20);
VAR2 VARCHAR(20);
BEGIN
SELECT COL1 INTO VAR1 FROM TABLE1 where col1 = 1;
VAR2 := PAR1 || VAR1;
RETURN VAR2 ;
END;
Snowflake
CREATE OR REPLACE FUNCTION FUN1 (PAR1 VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
(
SELECT COL1
FROM
TABLE1
where col1 = 1) AS VAR1,
NVL(PAR1 :: STRING, '') || NVL(VAR1 :: STRING, '') AS
VAR2
)
SELECT
VAR2
FROM
declaration_variables_cte1
$$;
Função dentro de pacote¶
Oracle
CREATE OR REPLACE PACKAGE BODY pkg1 AS
FUNCTION f1(PAR1 VARCHAR) RETURN VARCHAR IS
VAR1 VARCHAR(20);
VAR2 VARCHAR(20);
BEGIN
SELECT COL1 INTO VAR1 FROM TABLE1 where col1 = 1;
VAR2 := PAR1 || VAR1;
RETURN VAR2 ;
END f1;
END pkg1;
Snowflake
CREATE OR REPLACE FUNCTION pkg1.f1(PAR1 VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
(
SELECT COL1
FROM
TABLE1
where col1 = 1) AS VAR1,
NVL(PAR1 :: STRING, '') || NVL(VAR1 :: STRING, '') AS
VAR2
)
SELECT
VAR2
FROM
declaration_variables_cte1
$$;
Mapeamento do tipo de dados de retorno¶
Tipo Oracle PL SQL |
Equivalente ao Snowflake |
---|---|
NUMBER |
FLOAT |
LONG |
VARCHAR |
VARCHAR2 |
STRING |
BLOB |
BINARY |
BFILE |
BINARY |
Chamada¶
Consultas internas¶
As chamadas de funções que foram transformadas em procedimentos dentro de consultas são convertidas em um Snowflake JavaScript UDF vazio. Esse Snowflake UDF é gerado no arquivo STUB_UDF.sql dentro do diretório UDF Helpers.
Oracle
CREATE VIEW VIEW1 AS SELECT FUN1(COL2) FROM TABLE1;
CREATE VIEW VIEW2 AS SELECT PKG1.F1(COL1) FROM TABLE1;
Snowflake
CREATE OR REPLACE VIEW VIEW1
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
AS
SELECT FUN1(COL2) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'FUN1' NODE ***/!!! FROM
TABLE1;
CREATE OR REPLACE VIEW VIEW2
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
AS
SELECT PKG1.F1(COL1) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'PKG1.F1' NODE ***/!!! FROM
TABLE1;
Dentro de outras funções ou procedimentos armazenados¶
Oracle
As funções que são convertidas em procedimentos são chamadas usando o auxiliar do Snowflake EXEC.
Oracle
CREATE OR REPLACE FUNCTION FUN1(x NUMBER) RETURN NUMBER IS
VAR1 NUMBER;
BEGIN
-- FUN2 is another UDF
VAR1 := FUN2(pkg1.f1(X, FUN2(10)));
RETURN VAR1;
END f1;
Snowflake:
CREATE OR REPLACE FUNCTION FUN1 (x NUMBER(38, 18))
RETURNS NUMBER(38, 18)
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
FUN2(pkg1.f1(X, FUN2(10) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'FUN2' NODE ***/!!!) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'pkg1.f1' NODE ***/!!!) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'FUN2' NODE ***/!!! AS
-- FUN2 is another UDF
VAR1
)
SELECT
VAR1
FROM
declaration_variables_cte1
$$;
Oracle
CREATE OR REPLACE FUNCTION FUN1(x NUMBER) RETURN NUMBER IS
VAR1 NUMBER;
BEGIN
-- FUN2 is another UDF
VAR1 := FUN2(X);
RETURN VAR1;
END f1;
Snowflake
CREATE OR REPLACE FUNCTION FUN1 (x NUMBER(38, 18))
RETURNS NUMBER(38, 18)
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
FUN2(X) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'FUN2' NODE ***/!!! AS
-- FUN2 is another UDF
VAR1
)
SELECT
VAR1
FROM
declaration_variables_cte1
$$;
Diferentes casos e limitações¶
Funções com DMLs¶
Essas funções não podem ser executadas em consultas no Oracle, portanto, seu uso será limitado ao transformá-las em procedimentos do Snowflake.
Oracle
CREATE OR REPLACE FUNCTION FUN1(x NUMBER)
RETURN NUMBER IS
VAR1 NUMBER;
BEGIN
VAR1 := VAR1 + 1;
INSERT INTO TABLE1(col1, col2) VALUES(X, VAR1);
UPDATE TABLE2 SET COL1 = VAR1 WHERE ID = X;
RETURN VAR1;
END FUN1;
Snowflake
--** SSC-FDM-0029 - USER DEFINED FUNCTION WAS TRANSFORMED TO SNOWFLAKE PROCEDURE **
CREATE OR REPLACE PROCEDURE FUN1 (x FLOAT)
RETURNS FLOAT
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1;
VAR1 = VAR1 + 1;
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`INSERT INTO TABLE1(col1, col2) VALUES(?, ?)`,[X,VAR1]);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`UPDATE TABLE2
SET COL1 = ?
WHERE ID = ?`,[VAR1,X]);
return VAR1;
$$;
Funções com apenas um SELECT INTO¶
Essas funções são transformadas em funções Snowflake SQL removendo a parte INTO da seleção.
Oracle
CREATE OR REPLACE FUNCTION FUN1(PAR1 VARCHAR)
RETURN VARCHAR
IS
VAR1 VARCHAR(20);
BEGIN
SELECT COL1 INTO VAR1 FROM TABLE1 where col1 = PAR1;
RETURN VAR1;
END;
Snowflake
CREATE OR REPLACE FUNCTION FUN1 (PAR1 VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
(
SELECT COL1
FROM
TABLE1
where col1 = PAR1) AS VAR1
)
SELECT
VAR1
FROM
declaration_variables_cte1
$$;
Funções apenas com lógica¶
UDFs que não usam nenhuma instrução SQL são convertidos em Snowflake JavaScript UDFs.
Nota
Quando as funções SQL internas são incluídas na lógica, a função definida pelo usuário é convertida em um procedimento do Snowflake. A conversão de funções internas para um equivalente em JavaScript está planejada para ser entregue no futuro.
Exemplos de funções internas: UPPER(), TRIM(), ABS().
Oracle
CREATE OR REPLACE FUNCTION FUN1(x NUMBER)
RETURN NUMBER IS
VAR1 NUMBER;
BEGIN
IF x < 5 THEN
VAR1 := 1;
ELSE
VAR1 := 0;
END IF;
RETURN VAR1;
END FUNC01;
Snowflake
CREATE OR REPLACE FUNCTION FUN1 (x NUMBER(38, 18))
RETURNS NUMBER(38, 18)
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
CASE
WHEN x < 5
THEN 1
ELSE 0
END AS VAR1
)
SELECT
VAR1
FROM
declaration_variables_cte1
$$;
Funções com mais de uma instrução SQL¶
UDFs transformados em procedimentos não podem ser chamados a partir de uma consulta.
Oracle
CREATE OR REPLACE FUNCTION FUN1(x NUMBER)
RETURN NUMBER IS
VAR1 NUMBER;
BEGIN
SELECT COL1 INTO VAR1 FROM TABLE1 WHERE ID = X;
IF VAR1 < 5 THEN
VAR1 := 1;
ELSE
VAR1 := 0;
END IF;
UPDATE TABLE1 SET COL1 = VAR1 WHERE ID = X;
RETURN VAR1;
END FUN1;
Snowflake
--** SSC-FDM-0029 - USER DEFINED FUNCTION WAS TRANSFORMED TO SNOWFLAKE PROCEDURE **
CREATE OR REPLACE PROCEDURE FUN1 (x FLOAT)
RETURNS FLOAT
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1;
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
[VAR1] = EXEC(`SELECT
COL1
FROM
TABLE1
WHERE ID = ?`,[X]);
if (VAR1 < 5) {
VAR1 = 1;
} else {
VAR1 = 0;
}
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`UPDATE TABLE1
SET COL1 = ?
WHERE ID = ?`,[VAR1,X]);
return VAR1;
$$;
Funções com apenas lógica e funções SQL internas
Nota
Essa transformação está planejada para ser entregue no futuro; atualmente, todas as funções estão sendo transformadas em procedimentos armazenados.
Oracle
CREATE OR REPLACE FUNCTION FUN1(x FLOAT)
RETURN NUMBER IS
VAR1 NUMBER;
BEGIN
IF TRUNC(X) < 5 THEN
VAR1 := 1;
ELSE
VAR1 := 0;
END IF;
RETURN VAR1;
END FUNC01;
Transformação atual para Snowflake
CREATE OR REPLACE FUNCTION FUN1 (x FLOAT)
RETURNS NUMBER(38, 18)
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
WITH declaration_variables_cte1 AS
(
SELECT
CASE
WHEN TRUNC(X) < 5
THEN 1
ELSE 0
END AS VAR1
)
SELECT
VAR1
FROM
declaration_variables_cte1
$$;
RETURN CASE¶
A transformação é a mesma quando CASE é usado para atribuir uma variável. Você pode verificar a transformação de CASE na seção PL/SQL.
Oracle
CREATE OR REPLACE FUNCTION FUN1 (flag FLOAT)
RETURN NUMBER IS
BEGIN
return CASE flag
WHEN 1 THEN 'one'
WHEN 2 THEN 'two'
WHEN 3 THEN 'three'
WHEN 4 THEN 'four'
ELSE 'unknown' END;
END FUN1;
SnowFlake
CREATE OR REPLACE FUNCTION FUN1 (flag FLOAT)
RETURNS NUMBER(38, 18)
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "11/13/2024", "domain": "test" }}'
AS
$$
SELECT
CASE flag
WHEN 1 THEN 'one'
WHEN 2 THEN 'two'
WHEN 3 THEN 'three'
WHEN 4 THEN 'four'
ELSE 'unknown' END
$$;
Problemas conhecidos ¶
Não foram encontrados problemas.
EWIs relacionados¶
SSC-EWI-0022: Um ou mais identificadores nessa instrução foram considerados parâmetros por padrão.
SSC-EWI-0073: Revisão de equivalência funcional pendente.
SSC-FDM-0029: A função definida pelo usuário foi transformada em um procedimento do Snowflake.
Pacotes¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Declaração de pacote¶
Esta seção mostra a equivalência entre os membros da Declaração de Pacote Oracle e as instruções do Snowflake.
Opções de conversão de pacotes ¶
Há duas opções para migrar pacotes, e cada opção afetará diretamente a nomeação dos objetos dentro do pacote. Veja aqui para saber como alterar esse modo na UI, ou veja aqui para alterar usando a interface de linha de comando.
Vamos supor o seguinte cenário no Oracle:
Um pacote chamado
MY_PACKAGE.
Um procedimento dentro do pacote chamado
MY_PROCEDURE.
Opção 1 (Usando o novo esquema)¶
Com essa opção, os pacotes são transformados em novos esquemas. Os elementos do pacote, como funções e procedimentos, são criados dentro do novo esquema. Se o pacote já estiver dentro de um esquema, o nome do pacote será unido ao nome do esquema com um sublinhado.
Essa é a opção padrão para converter pacotes.
Resultado:
Será criado um esquema com o nome
MY_PACKAGE
.O nome qualificado do procedimento será atualizado para
MY_PACKAGE.MY_PROCEDURE
.Se o pacote estiver dentro de um esquema, o procedimento será atualizado para
MY_SCHEMA_MY_PACKAGE.MY_PROCEDURE
.
Opção 2¶
Com essa opção, o nome dos elementos do pacote será unido ao nome do pacote com um sublinhado. Não serão criados novos esquemas.
Resultado:
O nome do procedimento será atualizado para
MY_PACKAGE_MY_PROCEDURE
.Se o pacote estiver dentro de um esquema, o procedimento será atualizado para
MY_SCHEMA.MY_PACKAGE_MY_PROCEDURE
.
Create Package¶
A instrução CREATE PACKAGE será convertida em uma instrução CREATE SCHEMA. Qualquer membro dentro do pacote será convertido fora do pacote.
Oracle
CREATE OR REPLACE PACKAGE MY_PACKAGE AS
-- Other elements...
END MY_PACKAGE ;
Transformação com a opção 1 (usando o novo esquema)¶
CREATE IF NOT EXISTS SCHEMA MY_PACKAGE
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
;
-- Other elements...
Transformação com a opção 2¶
Com essa opção, o esquema não será gerado, e somente os elementos internos serão mantidos, mas com seus nomes renomeados.
-- Other elements...
Declaração de procedimentos e funções¶
As instruções de procedimentos e funções não são necessárias para a transformação para o Snowflake. As instruções de procedimentos ou funções existentes serão comentadas.
Oracle
CREATE OR REPLACE PACKAGE MY_PACKAGE AS
PROCEDURE MY_PROCEDURE(PARAM1 VARCHAR2);
FUNCTION MY_FUNCTION(PARAM1 VARCHAR2) RETURN NUMBER ;
END MY_PACKAGE;
Transformação com a opção 1 (usando o novo esquema)¶
CREATE SCHEMA IF NOT EXISTS MY_PACKAGE
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
;
Nota
Observe que, para a opção 1, a definição de PROCEDURE
no pacote é removida, pois não é exigida pelo Snowflake.
Declaração de variáveis¶
Nota
Você também pode estar interessado no auxiliar de variáveis
As variáveis do pacote Oracle são transformadas em variáveis de sessão do Snowflake. Um prefixo é adicionado aos valores para saber de que tipo são dentro dos procedimentos armazenados. Se o valor for nulo, será adicionado um «~». Por esse motivo, as variáveis que dependem de outras variáveis exigirão um SUBSTR e um CAST.
Tipo de dados e mapeamentos de código¶
Tipo de dados ou valor |
Código |
---|---|
Tipos numéricos |
# |
Tipos de data e hora |
& |
Tipos de cadeia de caracteres |
$ |
Valores NULL |
~ |
A transformação das variáveis será sempre a mesma, independentemente da opção de transformação.
Oracle
CREATE OR REPLACE PACKAGE PACKAGE_VARIABLES AS
VAR1 integer := 333;
VAR2 INTEGER := VAR1 + 456;
VAR3 DATE := CURRENT_DATE;
VAR4 VARCHAR(20) := 'HELLO WORLD';
VAR5 INTEGER;
END;
Snowflake
CREATE SCHEMA IF NOT EXISTS PACKAGE_VARIABLES
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
;
SET "PACKAGE_VARIABLES.VAR1" = '' || (333);
SET "PACKAGE_VARIABLES.VAR2" = (SELECT
'' || (GETVARIABLE('PACKAGE_VARIABLES.VAR1') :: INTEGER + 456));
SET "PACKAGE_VARIABLES.VAR3" = (SELECT
'' || (CURRENT_DATE()));
SET "PACKAGE_VARIABLES.VAR4" = '' || ('HELLO WORLD');
SET "PACKAGE_VARIABLES.VAR5" = '~';
Declaração de constantes¶
A declaração de constantes será declarada dentro do procedimento ou das funções que as utilizam. A declaração de constantes de pacotes existentes será comentada e um aviso será adicionado.
Oracle
CREATE OR REPLACE PACKAGE PACKAGE_CONSTANTS
IS
const_name CONSTANT VARCHAR(10) := 'Snow';
PROCEDURE PROCEDURE1;
END PACKAGE_CONSTANTS;
CREATE OR REPLACE PACKAGE BODY PACKAGE_CONSTANTS
IS
PROCEDURE MY_PROCEDURE IS
BEGIN
INSERT INTO DBUSER ("USER_NAME")
VALUES (const_name);
END;
END PACKAGE_CONSTANTS;
Transformação com a opção 1
CREATE SCHEMA IF NOT EXISTS PACKAGE_CONSTANTS
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
;
CREATE OR REPLACE PROCEDURE PACKAGE_CONSTANTS.MY_PROCEDURE ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
CONST_NAME VARCHAR(10) := 'Snow';
BEGIN
INSERT INTO DBUSER("USER_NAME")
VALUES (:CONST_NAME);
END;
$$;
Nota
Observe que a definição de PROCEDURE
no pacote foi removida, pois não é exigida pelo Snowflake.
Outros membros do pacote¶
A transformação de outros membros do pacote, como cursores, exceções e tipos definidos pelo usuário, ainda é um trabalho em andamento.
Oracle
CREATE OR REPLACE PACKAGE MY_PACKAGE_EX AS
an_exception EXCEPTION;
END MY_PACKAGE_EX;
Transformação com a opção 1¶
CREATE SCHEMA IF NOT EXISTS MY_PACKAGE_EX
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
;
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0049 - PACKAGE EXCEPTIONS in stateful package MY_PACKAGE_EX are not supported yet ***/!!!
an_exception EXCEPTION;
Transformação com a opção 2¶
/*** MSC-ERROR - MSCEWI3049 - PACKAGE EXCEPTIONS in stateful package MY_PACKAGE_EX are not supported yet ***/
/*an_exception EXCEPTION;*/;
Definição do corpo do pacote¶
Esta seção mostra a equivalência entre os membros do Oracle Package Body Definition e as instruções do Snowflake.
Create Package Body¶
Os elementos dentro de um corpo de pacote serão extraídos do pacote. O corpo do pacote desaparecerá, portanto, a instrução Create Package Body será removida no código convertido.
Definição do procedimento¶
Os procedimentos armazenados dentro de pacotes usam as mesmas transformações definidas na referência de conversão de PL/SQL.
Oracle
CREATE OR REPLACE PACKAGE BODY PACKAGE_PROCEDURE
IS
PROCEDURE MY_PROCEDURE (MY_PARAM VARCHAR) IS
BEGIN
null;
END;
END PACKAGE_PROCEDURE;
Transformação com a opção 1¶
CREATE OR REPLACE PROCEDURE PACKAGE_PROCEDURE.MY_PROCEDURE (MY_PARAM STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
null;
$$;
Transformação com a opção 2¶
CREATE OR REPLACE PROCEDURE PACKAGE_PROCEDURE_MY_PROCEDURE (MY_PARAM STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// REGION SnowConvert Helpers Code
null;
$$;
Definição da Função¶
As funções dentro dos corpos dos pacotes são convertidas em procedimentos armazenados do Snowflake.
Oracle
CREATE OR REPLACE PACKAGE BODY PACKAGE_FUNCTION
IS
FUNCTION MY_FUNCTION (MY_PARAM VARCHAR) RETURN NUMBER
AS
BEGIN
null;
END;
END PACKAGE_FUNCTION;
Transformação com a opção 1¶
$1
RETURNS FLOAT
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
AS
$$
// SnowConvert Helpers Code section is omitted.
null;
$$;
Transformação com a opção 2¶
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE FUNCTION PACKAGE_FUNCTION_MY_FUNCTION (MY_PARAM STRING)
RETURNS NUMBER
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
AS
$$
// REGION SnowConvert Helpers Code
null;
$$;
Outros membros do corpo do pacote¶
Consulte a seção «outros membros do pacote» em Declaração de pacote
Uso de membros do pacote¶
Chamada de procedimentos dentro de pacotes¶
Se o procedimento estiver dentro de um pacote e o pacote estiver dentro de um esquema, a chamada será renomeada.
Oracle
CREATE OR REPLACE PROCEDURE PROCEDURE02(param1 NUMBER, param2 VARCHAR)
IS
BEGIN
SCHEMA1.PACKAGE1.PROCEDURE01(param1, param2);
END;
CALL SCHEMA1.PACKAGE1.PROCEDURE01(param1, param2);
Transformação com a opção 1¶
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROCEDURE02 (param1 FLOAT, param2 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
EXEC(`CALL
SCHEMA1.PACKAGE1.PROCEDURE01(?, ?)`,[PARAM1,PARAM2]);
$$;
CALL SCHEMA1.PACKAGE1.PROCEDURE01(param1, param2);
Transformação com a opção 2¶
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
Com essa opção, a chamada dos procedimentos será renomeada de acordo com a renomeação da declaração do procedimento. O nome do esquema será separado do nome do procedimento por um ponto.
Snowflake
CREATE OR REPLACE PROCEDURE PUBLIC.PROCEDURE02 (param1 FLOAT, param2 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// REGION SnowConvert Helpers Code
EXEC(`CALL SCHEMA1.PACKAGE1_PROCEDURE01(?, ?)`,[PARAM1,PARAM2]);
$$;
CALL SCHEMA1.PACKAGE1_PROCEDURE01(param1, param2);
Variáveis de pacote dentro de procedimentos¶
Nota
As variáveis dos pacotes são transformadas em variáveis de sessão. Essas variáveis podem ser usadas por meio do «auxiliar de variáveis do pacote».
Nota
Esta amostra está usando variáveis declaradas na seção de pacotes Declaração de variáveis.
Oracle
CREATE OR REPLACE PACKAGE BODY PACKAGE_VARIABLES AS
PROCEDURE P1 AS
BEGIN
VAR1 := VAR1 + 888;
INSERT INTO TABLE1 values (VAR1);
INSERT INTO TABLE2 values (VAR4);
END;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PACKAGE_VARIABLES.P1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
VAR1 =
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT VAR1 MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
VAR1 + 888;
EXEC(`INSERT INTO TABLE1
values (VAR1)`);
EXEC(`INSERT INTO TABLE2
values (VAR4)`);
$$;
Problemas conhecidos¶
Não foram encontrados problemas.
EWIs relacionados¶
SSC-EWI-0053: O objeto pode não funcionar.
SSC-EWI-OR0049: Ainda não há suporte para constantes de pacote no pacote stateful.
Procedimentos¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Exemplo 1: Conversão de procedimento básico
Oracle
CREATE OR REPLACE PROCEDURE PROC1
IS
BEGIN
null;
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
null;
$$;
Exemplo 2: Conversão de procedimento com instruções básicas: Declaration, Assignment, Cursor Declaration, FOR Cursor, Open, LOOP, CLOSE, IF,
Oracle
CREATE OR REPLACE PROCEDURE PROC1
(
param1 NUMBER
)
IS
localVar1 NUMBER;
countRows NUMBER;
tempSql VARCHAR(100);
tempResult NUMBER;
CURSOR MyCursor
IS
SELECT COL1 FROM Table1;
BEGIN
localVar1 := param1;
countRows := 0;
tempSql := 'SELECT COUNT(*) FROM Table1 WHERE COL1 =' || localVar1;
FOR myCursorItem IN MyCursor
LOOP
localVar1 := myCursorItem.Col1;
countRows := countRows + 1;
END LOOP;
INSERT INTO Table2 VALUES(countRows, 'ForCursor: Total Row count is: ' || countRows);
countRows := 0;
OPEN MyCursor;
LOOP
FETCH MyCursor INTO tempResult;
EXIT WHEN MyCursor%NOTFOUND;
countRows := countRows + 1;
END LOOP;
CLOSE MyCursor;
INSERT INTO Table2 VALUES(countRows, 'LOOP: Total Row count is: ' || countRows);
EXECUTE IMMEDIATE tempSql INTO tempResult;
IF tempResult > 0 THEN
INSERT INTO Table2 (COL1, COL2) VALUES(tempResult, 'Hi, found value:' || localVar1 || ' in Table1 -- There are ' || tempResult || ' rows');
COMMIT;
END IF;
END PROC1;
Snowflake
CREATE OR REPLACE PROCEDURE PROC1
(param1 FLOAT
)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// REGION SnowConvert Helpers Code
var formatDate = (arg) => (new Date(arg - (arg.getTimezoneOffset() * 60000))).toISOString().slice(0,-1);
var fixBind = function (arg) {
arg = arg instanceof Date ? formatDate(arg) : IS_NULL(arg) ? null : arg;
return arg;
};
var SQL = {
FOUND : false,
NOTFOUND : false,
ROWCOUNT : 0,
ISOPEN : false
};
var _RS, _ROWS, SQLERRM = "normal, successful completion", SQLCODE = 0;
var getObj = (_rs) => Object.assign(new Object(),_rs);
var getRow = (_rs) => (values = Object.values(_rs)) && (values = values.splice(-1 * _rs.getColumnCount())) && values;
var fetch = (_RS,_ROWS,fmode) => _RS.getRowCount() && _ROWS.next() && (fmode ? getObj : getRow)(_ROWS) || (fmode ? new Object() : []);
var EXEC = function (stmt,binds,opts) {
try {
binds = !(arguments[1] instanceof Array) && ((opts = arguments[1]) && []) || (binds || []);
opts = opts || new Object();
binds = binds ? binds.map(fixBind) : binds;
_RS = snowflake.createStatement({
sqlText : stmt,
binds : binds
});
_ROWS = _RS.execute();
if (opts.sql !== 0) {
var isSelect = stmt.toUpperCase().trimStart().startsWith("SELECT");
var affectedRows = isSelect ? _RS.getRowCount() : _RS.getNumRowsAffected();
SQL.FOUND = affectedRows != 0;
SQL.NOTFOUND = affectedRows == 0;
SQL.ROWCOUNT = affectedRows;
}
if (opts.row === 2) {
return _ROWS;
}
var INTO = function (opts) {
if (opts.vars == 1 && _RS.getColumnCount() == 1 && _ROWS.next()) {
return _ROWS.getColumnValue(1);
}
if (opts.rec instanceof Object && _ROWS.next()) {
var recordKeys = Object.keys(opts.rec);
Object.assign(opts.rec,Object.fromEntries(new Map(getRow(_ROWS).map((element,Index) => [recordKeys[Index],element]))))
return opts.rec;
}
return fetch(_RS,_ROWS,opts.row);
};
var BULK_INTO_COLLECTION = function (into) {
for(let i = 0;i < _RS.getRowCount();i++) {
FETCH_INTO_COLLECTIONS(into,fetch(_RS,_ROWS,opts.row));
}
return into;
};
if (_ROWS.getRowCount() > 0) {
return _ROWS.getRowCount() == 1 ? INTO(opts) : BULK_INTO_COLLECTION(opts);
}
} catch(error) {
RAISE(error.code,error.name,error.message)
}
};
var RAISE = function (code,name,message) {
message === undefined && ([name,message] = [message,name])
var error = new Error(message);
error.name = name
SQLERRM = `${(SQLCODE = (error.code = code))}: ${message}`
throw error;
};
var FETCH_INTO_COLLECTIONS = function (collections,fetchValues) {
for(let i = 0;i < collections.length;i++) {
collections[i].push(fetchValues[i]);
}
};
var IS_NULL = (arg) => !(arg || arg === 0);
var CURSOR = function (stmt,binds,isRefCursor,isOut) {
var statementObj, result_set, total_rows, ISOPEN = false, result_set_table = '', self = this, row_count, found;
this.CURRENT = new Object;
this.INTO = function () {
return self.res;
};
this.OPEN = function (openParameters) {
if (ISOPEN && !isRefCursor) RAISE(-6511,"CURSOR_ALREADY_OPEN","cursor already open");
var finalStmt = openParameters && openParameters.query || stmt;
var parameters = openParameters && openParameters.binds || [];
var finalBinds = binds instanceof Function ? binds(...parameters) : binds;
finalBinds = finalBinds || parameters;
try {
if (isOut) {
if (!temptable_prefix) {
temptable_prefix = `${procname}_TEMP_${(EXEC(`select current_session() || '_' || to_varchar(current_timestamp, 'yyyymmddhh24missss')`,{
sql : 0
}))[0]}_`;
}
if (!result_set_table) {
result_set_table = temptable_prefix + outCursorResultNumber++;
EXEC(`CREATE OR REPLACE TEMPORARY TABLE ${result_set_table} AS ${finalStmt}`,{
sql : 0
});
}
finalStmt = "SELECT * FROM " + result_set_table
}
[result_set,statementObj,total_rows] = [EXEC(finalStmt,finalBinds,{
sql : 0,
row : 2
}),_RS,_RS.getColumnCount()]
ISOPEN = true;
row_count = 0;
} catch(error) {
RAISE(error.code,"error",error.message);
}
return this;
};
this.NEXT = function () {
if (total_rows && result_set.next()) {
this.CURRENT = new Object;
for(let i = 1;i <= statementObj.getColumnCount();i++) {
(this.CURRENT)[statementObj.getColumnName(i)] = result_set.getColumnValue(i);
}
return true;
} else return false;
};
this.FETCH = function (record) {
var recordKeys = record ? Object.keys(record) : undefined;
self.res = [];
if (!ISOPEN) RAISE(-1001,"INVALID_CURSOR","invalid cursor");
if (recordKeys && recordKeys.length != statementObj.getColumnCount()) RAISE(-6504,"ROWTYPE_MISMATCH","Return types of Result Set variables or query do not match");
self.res = fetch(statementObj,result_set);
if (self.res && self.res.length > 0) {
found = true;
row_count++;
if (recordKeys) {
for(let i = 0;i < self.res.length;i++) {
record[recordKeys[i]] = (self.res)[i];
}
return false;
}
return true;
} else found = false;
return false;
};
this.CLOSE = function () {
if (!ISOPEN) RAISE(-1001,"INVALID_CURSOR","invalid cursor");
found = row_count = result_set_table = total_rows = result_set = statementObj = undefined;
ISOPEN = false;
};
this.FETCH_BULK_COLLECT_INTO = function (variables,limit) {
if (variables.length != statementObj.getColumnCount()) RAISE(-6504,"ROWTYPE_MISMATCH","Return types of Result Set variables or query do not match");
if (limit) {
for(let i = 0;i < limit && this.FETCH();i++)FETCH_INTO_COLLECTIONS(variables,self.res);
} else {
while ( this.FETCH() )
FETCH_INTO_COLLECTIONS(variables,self.res);
}
};
this.FOUND = () => ISOPEN ? typeof(found) == "boolean" ? found : null : RAISE(-1001,"INVALID_CURSOR","invalid cursor");
this.NOTFOUND = () => ISOPEN ? typeof(found) == "boolean" ? !found : null : RAISE(-1001,"INVALID_CURSOR","invalid cursor");
this.ROWCOUNT = () => ISOPEN ? row_count : RAISE(-1001,"INVALID_CURSOR","invalid cursor");
this.ISOPEN = () => ISOPEN;
this.SAVE_STATE = function () {
return {
tempTable : result_set_table,
position : row_count
};
};
this.RESTORE_STATE = function (tempTable,position) {
result_set_table = tempTable
if (result_set_table) {
isOut = true
this.OPEN();
for(let i = 0;i < position;i++)this.FETCH();
}
};
this.ROWTYPE = () => ROWTYPE(stmt,binds());
};
var outCursorResultNumber = 0;
var concatValue = (arg) => IS_NULL(arg) ? "" : arg;
// END REGION
let LOCALVAR1;
let COUNTROWS;
let TEMPSQL;
let TEMPRESULT;
let MYCURSOR = new CURSOR(`SELECT COL1 FROM
Table1`,() => []);
LOCALVAR1 = PARAM1;
COUNTROWS = 0;
TEMPSQL = `SELECT COUNT(*) FROM
Table1
WHERE COL1 =${concatValue(LOCALVAR1)}`;
MYCURSOR.OPEN();
while ( MYCURSOR.NEXT() ) {
let MYCURSORITEM = MYCURSOR.CURRENT;
LOCALVAR1 = MYCURSORITEM.COL1;
COUNTROWS = COUNTROWS + 1;
}
MYCURSOR.CLOSE();
EXEC(`INSERT INTO Table2
VALUES(?, 'ForCursor: Total Row count is: ' || NVL(? :: STRING, ''))`,[COUNTROWS,COUNTROWS]);
COUNTROWS = 0;
MYCURSOR.OPEN();
while ( true ) {
MYCURSOR.FETCH(TEMPRESULT) && ([TEMPRESULT] = MYCURSOR.INTO());
if (MYCURSOR.NOTFOUND()) {
break;
}
COUNTROWS = COUNTROWS + 1;
}
MYCURSOR.CLOSE();
EXEC(`INSERT INTO Table2
VALUES(?, 'LOOP: Total Row count is: ' || NVL(? :: STRING, ''))`,[COUNTROWS,COUNTROWS]);
[TEMPRESULT] = EXEC(TEMPSQL);
if (TEMPRESULT > 0) {
// ** 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) VALUES(?, 'Hi, found value:' || NVL(? :: STRING, '') || ' in Table1 -- There are ' || NVL(? :: STRING, '') || ' rows')`,[TEMPRESULT,LOCALVAR1,TEMPRESULT]);
EXEC(`--** SSC-FDM-OR0012 - COMMIT REQUIRES THE APPROPRIATE SETUP TO WORK AS INTENDED **
COMMIT;`);
}
$$;
Chamada de procedimentos dentro de outro procedimento¶
Oracle
CREATE OR REPLACE PROCEDURE PROCEDURE01(param1 NUMBER, param2 VARCHAR)
IS
BEGIN
INSERT INTO TABLE1 VALUES(param1, param2);
END;
CREATE OR REPLACE PROCEDURE PROCEDURE02(param1 NUMBER, param2 VARCHAR)
IS
BEGIN
PROCEDURE01(param1, param2);
END;
Snowflake
CREATE OR REPLACE PROCEDURE PROCEDURE01 (param1 FLOAT, param2 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
EXEC(`INSERT INTO TABLE1
VALUES(?, ?)`,[PARAM1,PARAM2]);
$$;
CREATE OR REPLACE PROCEDURE PROCEDURE02 (param1 FLOAT, param2 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
EXEC(`CALL
PROCEDURE01(?, ?)`,[PARAM1,PARAM2]);
$$;
Problemas conhecidos ¶
Não foram encontrados problemas.
EWIs Relacionados ¶
SSC-EWI-0022: Um ou mais identificadores nessa instrução foram considerados parâmetros por padrão.
SSC-FDM-OR0012: as instruções COMMIT e ROLLBACK requerem uma configuração adequada para funcionar como pretendido.
Elementos de linguagem SQL¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Cursor FOR LOOP¶
Nota
Talvez você também se interesse por auxiliar de Cursor e declaração de Cursor.
Oracle
CREATE OR REPLACE PROCEDURE PROC1
IS
MyVariable1 NUMBER;
MyOtherVariable2 NUMBER := 1;
CURSOR C1 IS
SELECT * FROM Table1 WHERE ID = 123;
CURSOR C2 (paramCursor1 NUMBER) IS
SELECT COL1 AS C_1 FROM TABLE1 WHERE ID = paramCursor1;
BEGIN
FOR myCursorRecord IN C1
LOOP
MyVariable1 := myCursorRecord.Col1;
END LOOP;
FOR myCursorRecord IN (SELECT * FROM Table1 WHERE ID = MyVariable1)
LOOP
MyVariable1 := myCursorRecord.Col1;
END LOOP;
<<Block1>>
FOR myCursorRecord IN C2 (MyOtherVariable2)
LOOP
MyVariable1 := myCursorRecord.Col1;
END LOOP Block1;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let MYVARIABLE1;
let MYOTHERVARIABLE2 = 1;
let C1 = new CURSOR(`SELECT * FROM
Table1
WHERE ID = 123`,() => []);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
let C2 = new CURSOR(`SELECT COL1 AS C_1 FROM
TABLE1
WHERE ID = ?`,(PARAMCURSOR1) => [PARAMCURSOR1]);
C1.OPEN();
while ( C1.NEXT() ) {
let MYCURSORRECORD = C1.CURRENT;
MYVARIABLE1 = MYCURSORRECORD.COL1;
}
C1.CLOSE();
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
for(var MYCURSORRECORD_CURSOR = new CURSOR(`(SELECT * FROM
Table1
WHERE ID = ?
)`,[MYVARIABLE1]).OPEN();MYCURSORRECORD_CURSOR.NEXT();) {
let MYCURSORRECORD = MYCURSORRECORD_CURSOR.CURRENT;
MYVARIABLE1 = MYCURSORRECORD.COL1;
}
MYCURSORRECORD_CURSOR.CLOSE();
C2.OPEN({
binds : [MYOTHERVARIABLE2]
});
while ( C2.NEXT() ) {
let MYCURSORRECORD = C2.CURRENT;
MYVARIABLE1 = MYCURSORRECORD.COL1;
}
C2.CLOSE();
$$;
Instruções OPEN, FETCH e CLOSE¶
Nota
Talvez você também se interesse por auxiliar de Cursor e declaração de Cursor.
Oracle
CREATE OR REPLACE PROCEDURE PROC2
IS
col1Value table1.COL1%TYPE;
col2Value table1.COL2%TYPE;
entireRow table1%ROWTYPE;
TYPE MyRowType IS RECORD ( COLUMN1 NUMBER, COLUMN2 NUMBER);
entireRow_1 MyRowType;
CURSOR C1 IS SELECT * FROM table1;
C2 SYS_REFCURSOR;
TYPE COLLECTION_TYPE IS TABLE OF TABLE1.COL1%TYPE;
MY_COLLECTION MY_COLLECTION_TYPE := MY_COLLECTION_TYPE();
SOME_SELECT VARCHAR(200);
BEGIN
OPEN C1;
FETCH C1 INTO col1Value, col2Value;
CLOSE C1;
OPEN C1;
FETCH C1 INTO entireRow;
CLOSE C1;
OPEN C1;
FETCH C1 INTO entireRow_1;
CLOSE C1;
OPEN C2 FOR 'SELECT COL1 FROM TABLE1 WHERE COL1 <> :v' USING 123;
FETCH C2 BULK COLLECT INTO MY_COLLECTION LIMIT 2;
CLOSE C2;
OPEN C2 FOR SELECT * FROM TABLE1 WHERE COL1 = NUM1;
CLOSE C2;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC2 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "12/16/2024", "domain": "test" }}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let COL1VALUE;
let COL2VALUE;
let ENTIREROW = ROWTYPE(`table1`);
class MYROWTYPE {
COLUMN1
COLUMN2
constructor() {
[...arguments].map((element,Index) => this[(Object.keys(this))[Index]] = element)
}
}
let ENTIREROW_1 = new MYROWTYPE();
let C1 = new CURSOR(`SELECT * FROM
table1`,() => []);
let C2 = new CURSOR(undefined,undefined,true);
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0072 - PROCEDURAL MEMBER TYPE DEFINITION NOT SUPPORTED. ***/!!!
/* TYPE COLLECTION_TYPE IS TABLE OF TABLE1.COL1%TYPE */
;
let MY_COLLECTION = new MY_COLLECTION_TYPE();
let SOME_SELECT;
C1.OPEN();
C1.FETCH(COL1VALUE,COL2VALUE) && ([COL1VALUE,COL2VALUE] = C1.INTO());
C1.CLOSE();
C1.OPEN();
C1.FETCH(ENTIREROW) && ([ENTIREROW] = C1.INTO());
C1.CLOSE();
C1.OPEN();
C1.FETCH(ENTIREROW_1) && ([ENTIREROW_1] = C1.INTO());
C1.CLOSE();
C2.OPEN({
query : `SELECT COL1 FROM
TABLE1
WHERE COL1 <> ?`,
binds : [123]
});
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0104 - UNUSABLE VARIABLE, ITS TYPE WAS NOT TRANSFORMED ***/!!!
/* FETCH C2 BULK COLLECT INTO MY_COLLECTION LIMIT 2 */
;
C2.CLOSE();
C2.OPEN({
query : `SELECT * FROM
TABLE1
WHERE COL1 = NUM1`
});
C2.CLOSE();
$$;
Aviso
A transformação para as linhas a seguir corresponde a tipos personalizados que estão em andamento:
entireRow table1%ROWTYPE; // ROW TYPES
TYPE COLLECTION_TYPE IS TABLE OF TABLE1.COL1%TYPE; // COLLECTIONS
Atualmente, a próxima instrução está sendo emitida, mas a classe ainda não está sendo criada. No futuro, um aviso será aplicado a todos os usos de tipos personalizados sem suporte.
let MY_COLLECTION = new MY_COLLECTION_TYPE();
Cursor implícito SQL¶
Oracle
CREATE OR REPLACE PROCEDURE SP_IMPLICIT_CURSOR_SAMPLE AUTHID DEFINER IS
VAR_AUX NUMBER(3);
STMT_STAT1 NUMBER(3):= 0;
STMT_STAT2 NUMBER(3):= 0;
STMT_STAT3 NUMBER(3):= 0;
BEGIN
EXECUTE IMMEDIATE 'CREATE TABLE FTABLE35(COL1 NUMBER(3))';
IF SQL%FOUND THEN
STMT_STAT1 := 1;
END IF;
IF SQL%NOTFOUND THEN
STMT_STAT2 := 1;
END IF;
IF SQL%ISOPEN THEN
STMT_STAT3 := 1;
END IF;
EXECUTE IMMEDIATE 'INSERT INTO FTABLE33 VALUES(:D1,:D2,:D3,:D4)' USING SQL%ROWCOUNT, STMT_STAT1, STMT_STAT2, STMT_STAT3;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE SP_IMPLICIT_CURSOR_SAMPLE ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "12/16/2024", "domain": "test" }}'
EXECUTE AS CALLER
AS
$$
!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'PlInvokerRightsClause' NODE ***/!!!
//AUTHID DEFINER
null
// SnowConvert Helpers Code section is omitted.
let VAR_AUX;
let STMT_STAT1 = 0;
let STMT_STAT2 = 0;
let STMT_STAT3 = 0;
EXEC(`CREATE OR REPLACE TABLE FTABLE35 (COL1 NUMBER(3)
)`);
if (SQL.FOUND) {
STMT_STAT1 = 1;
}
if (SQL.NOTFOUND) {
STMT_STAT2 = 1;
}
if (SQL.ISOPEN) {
STMT_STAT3 = 1;
}
EXEC(`INSERT INTO FTABLE33
VALUES(?, ?, ?, ?)`,[SQL.ROWCOUNT /*** SSC-FDM-OR0009 - SQL IMPLICIT CURSOR VALUES MAY DIFFER ***/,STMT_STAT1,STMT_STAT2,STMT_STAT3]);
$$;
EXIT¶
Aviso
A transformação dos rótulos é um trabalho em andamento.
Oracle
CREATE OR REPLACE PROCEDURE PROCEDURE1
IS
i NUMBER := 0;
j NUMBER := 0;
k NUMBER := 0;
BEGIN
<<loop_a>>
LOOP
i := i + 1;
<<loop_b>>
LOOP
j := j + 1;
<<loop_c>>
LOOP
k := k + j + i;
EXIT;
END LOOP loop_c;
EXIT loop_b WHEN (j > 3);
END LOOP loop_b;
EXIT loop_a WHEN (i > 3);
END LOOP loop_a;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROCEDURE1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "12/16/2024", "domain": "test" }}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let I = 0;
let J = 0;
let K = 0;
while ( true ) {
I = I + 1;
while ( true ) {
J = J + 1;
while ( true ) {
K = K + J + I;
break;
}
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0075 - LABELS IN STATEMENTS ARE NOT SUPPORTED. ***/!!!
/*
EXIT loop_b WHEN (j > 3) */
;
}
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0075 - LABELS IN STATEMENTS ARE NOT SUPPORTED. ***/!!!
/*
EXIT loop_a WHEN (i > 3) */
;
}
$$;
Execute Immediate¶
Nota
Talvez você também se interesse por auxiliar EXEC
Oracle
CREATE OR REPLACE PROCEDURE sp_sample5 AS
sql_stmt VARCHAR2(200);
plsql_block VARCHAR2(500);
emp_id NUMBER(4) := 7566;
dept_id NUMBER(2) := 20;
dept_id2 NUMBER(2) := 12;
dept_id_upd VARCHAR(14);
dept_name VARCHAR2(14) := 'PERSONNEL';
location VARCHAR2(13) := 'DALLAS';
dept_rec deptt%ROWTYPE;
TYPE NumList IS TABLE OF NUMBER;
sals NumList;
BEGIN
EXECUTE IMMEDIATE 'CREATE TABLE dept (id NUMBER, name varchar(14), location varchar2(13))';
sql_stmt := 'INSERT INTO dept VALUES (:1, :2, :3)';
EXECUTE IMMEDIATE sql_stmt USING dept_id, dept_name, location;
sql_stmt := 'SELECT * FROM dept WHERE id = :idd';
EXECUTE IMMEDIATE sql_stmt INTO dept_rec USING dept_id;
sql_stmt := 'UPDATE dept SET id = 200 WHERE id = :1 RETURNING name INTO :2';
EXECUTE IMMEDIATE sql_stmt USING dept_id RETURNING INTO dept_id_upd;
sql_stmt := 'delete from dept where id = :1 RETURNING name INTO :2';
EXECUTE IMMEDIATE sql_stmt USING dept_id RETURNING INTO dept_id_upd;
EXECUTE IMMEDIATE 'INSERT INTO dept VALUES (12, ''NAME1'', ''TEXAS'')';
EXECUTE IMMEDIATE 'INSERT INTO DEPT VALUES(13, ''' || dept_name || ''', ''LA'')';
EXECUTE IMMEDIATE 'DELETE FROM dept WHERE id = :num' USING dept_id2;
EXECUTE IMMEDIATE 'ALTER SESSION SET NLS_DATE_FORMAT = ''DD-MM-YYYY''';
EXECUTE IMMEDIATE 'SELECT id FROM dept' BULK COLLECT INTO sals;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE sp_sample5 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "12/16/2024", "domain": "test" }}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let SQL_STMT;
let PLSQL_BLOCK;
let EMP_ID = 7566;
let DEPT_ID = 20;
let DEPT_ID2 = 12;
let DEPT_ID_UPD;
let DEPT_NAME = `PERSONNEL`;
let LOCATION = `DALLAS`;
let DEPT_REC = ROWTYPE(`deptt`);
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0072 - PROCEDURAL MEMBER TYPE DEFINITION NOT SUPPORTED. ***/!!!
/* TYPE NumList IS TABLE OF NUMBER */
;
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0104 - UNUSABLE VARIABLE, ITS TYPE WAS NOT TRANSFORMED ***/!!!
/* sals NumList */
;
EXEC(`CREATE OR REPLACE TABLE dept (id NUMBER(38, 18),
name varchar(14),
location VARCHAR(13))`);
SQL_STMT = `INSERT INTO dept
VALUES (?, ?, ?)`;
EXEC(SQL_STMT,[DEPT_ID,DEPT_NAME,LOCATION]);
SQL_STMT = `SELECT * FROM
dept
WHERE id = ?`;
EXEC(SQL_STMT,[DEPT_ID],{
rec : dept_rec
});
SQL_STMT = `UPDATE dept
SET id = 200 WHERE id = ?
RETURNING name INTO :2`;
!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'THIS EXECUTE IMMEDIATE CASE' NODE ***/!!!
/* EXECUTE IMMEDIATE sql_stmt USING dept_id RETURNING INTO dept_id_upd */
;
SQL_STMT = `delete FROM
dept
where id = ?
RETURNING name INTO :2`;
!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'THIS EXECUTE IMMEDIATE CASE' NODE ***/!!!
/* EXECUTE IMMEDIATE sql_stmt USING dept_id RETURNING INTO dept_id_upd */
;
EXEC(`INSERT INTO dept
VALUES (12, 'NAME1', 'TEXAS')`);
EXEC(`INSERT INTO DEPT
VALUES(13, '${concatValue(DEPT_NAME)}', 'LA')`);
EXEC(`DELETE FROM
dept
WHERE id = ?`,[DEPT_ID2]);
EXEC(`ALTER SESSION SET DATE_INPUT_FORMAT = 'DD-MM-YYYY' DATE_OUTPUT_FORMAT = 'DD-MM-YYYY'`);
!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'THIS EXECUTE IMMEDIATE CASE' NODE ***/!!!
/* EXECUTE IMMEDIATE 'SELECT id FROM dept' BULK COLLECT INTO sals */
;
$$;
Aviso
Como a cláusula «RETURNING INTO» exige uma análise especial da instrução executada, sua conversão está planejada para ser entregue no futuro.
Aviso
A transformação para a linha seguinte corresponde aos tipos de coleção que estão em andamento:
TYPE NumList IS TABLE OF NUMBER;
Atualmente, a próxima instrução está sendo emitida, mas a classe ainda não está sendo criada. No futuro, um aviso será aplicado a todos os usos de tipos personalizados sem suporte.
let SALS = new NUMLIST();
Além disso, o seguinte EXECUTE IMMEDIATE
relacionado a BULK COLLECT
na variável sals
também está em andamento.
EXECUTE IMMEDIATE 'SELECT id FROM dept' BULK COLLECT INTO sals;
Erros e tratamento de exceções¶
Nota
Talvez você também se interesse por auxiliar Raise
Uso do auxiliar Raise¶
Oracle
CREATE OR REPLACE PROCEDURE HANDLERS_WITH_OTHERS_COMMENTS AUTHID DEFINER IS
deadlock_detected EXCEPTION;
deadlock_dex EXCEPTION;
PRAGMA EXCEPTION_INIT(deadlock_detected, -60);
PRAGMA EXCEPTION_INIT(deadlock_dex, -63);
BEGIN
IF true THEN
RAISE NO_DATA_FOUND;
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20010, SQLERRM);
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20000, SQLERRM, PARM);
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20000, SQLERRM, TRUE);
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20000, SQLERRM, FALSE);
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20000, 'CUSTOM ERROR MESSAGE', TRUE);
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20010, 'SECOND CUSTOM ERROR MESSAGE', TRUE);
END IF;
IF TRUE THEN
RAISE_APPLICATION_ERROR(-20010, 'OTHER CUSTOM ERROR MESSAGE', FALSE);
END IF;
EXCEPTION
WHEN EXC_NAME THEN
--Handle Exc_name found exception
null;
WHEN NO_DATA_FOUND THEN
--Handle No data found exception
null;
WHEN OTHERS THEN
--Handler for others exception
null;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE HANDLERS_WITH_OTHERS_COMMENTS ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": { "major": 0, "minor": 0, "patch": "0" }, "attributes": { "component": "oracle", "convertedOn": "12/16/2024", "domain": "test" }}'
EXECUTE AS CALLER
AS
$$
!!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'PlInvokerRightsClause' NODE ***/!!!
//AUTHID DEFINER
null
// SnowConvert Helpers Code section is omitted.
try {
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0052 - EXCEPTION DECLARATION IS HANDLED BY RAISE FUNCTION ***/!!!
/* deadlock_detected EXCEPTION */
;
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0052 - EXCEPTION DECLARATION IS HANDLED BY RAISE FUNCTION ***/!!!
/* deadlock_dex EXCEPTION */
;
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0051 - PRAGMA EXCEPTION_INIT IS NOT SUPPORTED ***/!!!
/* PRAGMA EXCEPTION_INIT(deadlock_detected, -60) */
;
!!!RESOLVE EWI!!! /*** SSC-EWI-OR0051 - PRAGMA EXCEPTION_INIT IS NOT SUPPORTED ***/!!!
/* PRAGMA EXCEPTION_INIT(deadlock_dex, -63) */
;
if (true) {
RAISE(100,`NO_DATA_FOUND`,`Single row SELECT returned no rows or your program referenced a deleted element in a nested table or an uninitialized element in an associative array (index-by table).`);
}
if (true) {
RAISE(-20010,SQLERRM);
}
if (true) {
// ** SSC-FDM-OR0011 - ADD TO STACK OF ERRORS IS NOT SUPPORTED, BOOLEAN ARGUMENT PARM WAS REMOVED. **
RAISE(-20000,SQLERRM);
}
if (true) {
// ** SSC-FDM-OR0011 - ADD TO STACK OF ERRORS IS NOT SUPPORTED, BOOLEAN ARGUMENT TRUE WAS REMOVED. **
RAISE(-20000,SQLERRM);
}
if (true) {
RAISE(-20000,SQLERRM);
}
if (true) {
// ** SSC-FDM-OR0011 - ADD TO STACK OF ERRORS IS NOT SUPPORTED, BOOLEAN ARGUMENT TRUE WAS REMOVED. **
RAISE(-20000,`CUSTOM ERROR MESSAGE`);
}
if (true) {
// ** SSC-FDM-OR0011 - ADD TO STACK OF ERRORS IS NOT SUPPORTED, BOOLEAN ARGUMENT TRUE WAS REMOVED. **
RAISE(-20010,`SECOND CUSTOM ERROR MESSAGE`);
}
if (true) {
RAISE(-20010,`OTHER CUSTOM ERROR MESSAGE`);
}
} catch(error) {
switch(error.name) {
case `EXC_NAME`: {
//Handle Exc_name found exception
null;
break;
}
case `NO_DATA_FOUND`: {
//Handle No data found exception
null;
break;
}
default: {
//Handler for others exception
null;
break;
}
}
}
$$;
Quando não há um manipulador OTHERS, o SnowConvert usa o caso «padrão» no switch que lança o objeto de erro original.
Commit¶
Nota
Talvez você também se interesse por auxiliar EXEC
Oracle
CREATE OR REPLACE PROCEDURE PROC1 (param1 NUMBER, param2 NUMBER)
IS
BEGIN
INSERT INTO TABLE1 VALUES(param1, param2);
COMMIT;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 (param1 FLOAT, param2 FLOAT)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
EXEC(`INSERT INTO TABLE1
VALUES(?, ?)`,[PARAM1,PARAM2]);
EXEC(`--** SSC-FDM-OR0012 - COMMIT REQUIRES THE APPROPRIATE SETUP TO WORK AS INTENDED **
COMMIT;`);
$$;
CASE¶
Oracle
CREATE OR REPLACE EDITIONABLE PROCEDURE PROCEDURE2 ()
IS
localVar1 NUMBER;
localVar2 VARCHAR(100);
BEGIN
CASE (localVar1)
WHEN 1 THEN
localVar2 := 'one';
WHEN 2 THEN
localVar := 'two';
WHEN 3 THEN
lovalVar := 'three';
ELSE
localVar := 'error';
END CASE;
CASE
WHEN localVar = 1 THEN
localVar2 := 'one';
WHEN localVar = 2 THEN
localVar := 'two';
WHEN localVar = 3 THEN
lovalVar := 'three';
ELSE
localVar := 'error';
END CASE;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
--** SSC-FDM-OR0007 - SNOWFLAKE DOESN'T SUPPORT VERSIONING OF OBJECTS. DEVELOPERS SHOULD CONSIDER ALTERNATE APPROACHES FOR CODE VERSIONING. **
CREATE OR REPLACE PROCEDURE PROCEDURE2 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let LOCALVAR1;
let LOCALVAR2;
switch(LOCALVAR1) {
case 1:LOCALVAR2 = `one`;
break;
case 2:LOCALVAR = `two`;
break;
case 3:LOVALVAR = `three`;
break;
default:LOCALVAR = `error`;
break;
}
if (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT localVar MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
LOCALVAR == 1) {
LOCALVAR2 = `one`;
} else if (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT localVar MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
LOCALVAR == 2) {
LOCALVAR = `two`;
} else if (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT localVar MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
LOCALVAR == 3) {
LOVALVAR = `three`;
} else {
LOCALVAR = `error`;
}
$$;
CASE em uma atribuição de variável¶
Oracle
CREATE OR REPLACE EDITIONABLE PROCEDURE PROCEDURE2 ()
IS
localVar1 NUMBER;
BEGIN
var1 := CASE flag
WHEN 1 THEN 'one'
WHEN 2 THEN 'two'
WHEN 3 THEN 'three'
WHEN 4 THEN 'four'
ELSE 'unknown' END;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
--** SSC-FDM-OR0007 - SNOWFLAKE DOESN'T SUPPORT VERSIONING OF OBJECTS. DEVELOPERS SHOULD CONSIDER ALTERNATE APPROACHES FOR CODE VERSIONING. **
CREATE OR REPLACE PROCEDURE PROCEDURE2 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let LOCALVAR1;
VAR1 =
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT flag MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
FLAG == 1 && `one` || (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT flag MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
FLAG == 2 && `two` || (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT flag MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
FLAG == 3 && `three` || (
!!!RESOLVE EWI!!! /*** SSC-EWI-0053 - OBJECT flag MAY NOT WORK PROPERLY, ITS DATATYPE WAS NOT RECOGNIZED ***/!!!
FLAG == 4 && `four` || `unknown`)));
$$;
Chamada para programas externos em C ou Java¶
Oracle
CREATE OR REPLACE EDITIONABLE PROCEDURE "OWB_REP_OWNER"."WB_RT_DP_CREATE_FKPARTITION" (prfID IN NUMBER,datatype IN VARCHAR2) AUTHID CURRENT_USER AS LANGUAGE JAVA NAME 'oracle.wh.service.impl.dataProfile.analysis.storedprocs.ForeignKey.createFKPartition(int,java.lang.String)';
Snowflake
----** SSC-OOS - OUT OF SCOPE CODE UNIT. CREATE PROCEDURE IS OUT OF TRANSLATION SCOPE. **
--CREATE OR REPLACE EDITIONABLE PROCEDURE "OWB_REP_OWNER"."WB_RT_DP_CREATE_FKPARTITION" (prfID IN NUMBER,datatype IN VARCHAR2) AUTHID CURRENT_USER AS LANGUAGE JAVA NAME 'oracle.wh.service.impl.dataProfile.analysis.storedprocs.ForeignKey.createFKPartition(int,java.lang.String)'
;
Problemas conhecidos¶
Não foram encontrados problemas.
EWIs relacionados¶
SSC-EWI-0022: Um ou mais identificadores em uma instrução específica são considerados parâmetros por padrão.
SSC-EWI-0053: O objeto pode não funcionar.
SSC-EWI-0073: Revisão de equivalência funcional pendente.
SSC-EWI-OR0052: A declaração exceção é tratada pela função raise.
SSC-EWI-OR0072: Membro do procedimento não suportado.
SSC-EWI-OR0075: A cláusula Current of não é compatível com o Snowflake.
SSC-EWI-OR0104: Variável de coleção não utilizável.
SSC-FDM-OR0007: O Snowflake não oferece suporte ao controle de versão de objetos. Os desenvolvedores devem considerar abordagens alternativas para o controle de versão do código.
SSC-FDM-OR0009: SQL IMPLICIT CURSOR VALUES MAY DIFFER.
SSC-FDM-OR0011: O argumento booliano foi removido porque não há suporte para as opções «add to stack».
SSC-FDM-OR0012: As instruções COMMIT e ROLLBACK requerem uma configuração adequada para funcionar como pretendido.
Instruções DDL - DML¶
Nota
Algumas partes do código de saída foram omitidas por motivos de clareza.
Nota
Todas as instruções usam o auxiliar EXEC
SELECT¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1 (param1 VARCHAR)
IS
VAR1 NUMBER := 789;
BEGIN
SELECT * FROM TABLE01;
SELECT DISTINCT COL1 FROM TABLE01;
SELECT * FROM TABLE01 WHERE COL1 = VAR1;
SELECT * FROM TABLE01 WHERE COL1 = PARAM1;
SELECT * FROM TABLE01 WHERE COL1 = PARAM1 AND COL2 = VAR1;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 (param1 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1 = 789;
EXEC(`SELECT * FROM
TABLE01`);
EXEC(`SELECT DISTINCT COL1 FROM
TABLE01`);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`SELECT * FROM
TABLE01
WHERE COL1 = ?`,[VAR1]);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`SELECT * FROM
TABLE01
WHERE COL1 = ?`,[PARAM1]);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`SELECT * FROM
TABLE01
WHERE COL1 = ?
AND COL2 = ?`,[PARAM1,VAR1]);
$$;
SELECT INTO¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1 (param1 VARCHAR, param2 VARCHAR)
IS
VAR1 NUMBER;
VAR2 NUMBER;
BEGIN
SELECT COL1 INTO VAR1 FROM TABLE01;
SELECT COL1 INTO VAR1 FROM TABLE01 WHERE COL2 = PARAM1;
SELECT COL1 INTO VAR1, VAR2 FROM TABLE01;
SELECT COL1 INTO VAR1, VAR2 FROM TABLE01
WHERE COL2 = param1 AND COL3 = param1;
END
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 (param1 STRING, param2 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1;
let VAR2;
[VAR1] = EXEC(`SELECT
COL1
FROM
TABLE01`);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
[VAR1] = EXEC(`SELECT
COL1
FROM
TABLE01
WHERE COL2 = ?`,[PARAM1]);
[VAR1,VAR2] = EXEC(`SELECT
COL1
FROM
TABLE01`);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
[VAR1,VAR2] = EXEC(`SELECT
COL1
FROM
TABLE01
WHERE COL2 = ?
AND COL3 = ?`,[PARAM1,PARAM1]);
$$;
INSERT e INSERTINTOSELECT¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1 (param1 VARCHAR)
IS
var1 NUMBER := 789;
BEGIN
INSERT INTO TABLE01 VALUES('name', 123);
INSERT INTO TABLE01 VALUES(param1, 456);
INSERT INTO TABLE01 VALUES(param1, var1);
INSERT INTO TABLE01 (col1, col2)
SELECT col1, col2 FROM TABLE02 tb2
WHERE tb2.col1 = 'myName';
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 (param1 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1 = 789;
EXEC(`INSERT INTO TABLE01
VALUES('name', 123)`);
EXEC(`INSERT INTO TABLE01
VALUES(?, 456)`,[PARAM1]);
EXEC(`INSERT INTO TABLE01
VALUES(?, ?)`,[PARAM1,VAR1]);
EXEC(`INSERT INTO TABLE01(col1, col2)
SELECT col1, col2 FROM
TABLE02 tb2
WHERE tb2.col1 = 'myName'`);
$$;
DELETE¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1 (PARAM1 VARCHAR)
IS
VAR1 NUMBER := 0;
BEGIN
DELETE FROM TABLE1 WHERE COL2 = 1;
DELETE FROM TABLE1 WHERE COL2 = VAR1;
DELETE FROM TABLE1 WHERE COL1 = PARAM1;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 (PARAM1 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1 = 0;
EXEC(`DELETE FROM
TABLE1
WHERE COL2 = 1`);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`DELETE FROM
TABLE1
WHERE COL2 = ?`,[VAR1]);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`DELETE FROM
TABLE1
WHERE COL1 = ?`,[PARAM1]);
$$;
UPDATE¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1(PARAM1 VARCHAR)
IS
VAR1 NUMBER := 3;
BEGIN
UPDATE TABLE1 SET COL2 = 1 where COL2 = 0;
UPDATE TABLE1 SET COL1 = VAR1 where COL1 = 0;
UPDATE TABLE1 SET COL1 = 'name' where COL1 = PARAM11;
UPDATE TABLE1 SET COL2 = VAR1 where COL1 = PARAM1;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 (PARAM1 STRING)
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let VAR1 = 3;
EXEC(`UPDATE TABLE1
SET COL2 = 1 where COL2 = 0`);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`UPDATE TABLE1
SET COL1 = ?
where COL1 = 0`,[VAR1]);
EXEC(`UPDATE TABLE1
SET COL1 = 'name' where COL1 = PARAM11`);
// ** SSC-EWI-0022 - ONE OR MORE IDENTIFIERS IN THIS STATEMENT WERE CONSIDERED PARAMETERS BY DEFAULT. REFERENCED TABLE NOT FOUND. **
EXEC(`UPDATE TABLE1
SET COL2 = ?
where COL1 = ?`,[VAR1,PARAM1]);
$$;
MERGE¶
Oracle
CREATE OR REPLACE PROCEDURE PROC1
IS
BEGIN
MERGE INTO TABLE01 t01
USING TABLE02 t02
ON (t01.col2 = t02.col2)
WHEN MATCHED THEN
UPDATE SET t01.col1 = t02.col2;
END;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
CREATE OR REPLACE PROCEDURE PROC1 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
EXEC(`MERGE INTO TABLE01 t01
USING TABLE02 t02
ON (t01.col2 = t02.col2)
WHEN MATCHED THEN
UPDATE SET t01.col1 = t02.col2`);
$$;
Problemas conhecidos ¶
Não foram encontrados problemas.
EWIs Relacionados ¶
Sem EWIs relacionados.
SSC-EWI-0022: Um ou mais identificadores em uma instrução específica são considerados parâmetros por padrão.
Sinônimos¶
Nota
Para obter mais informações, consulte a referência de conversão Sinônimo.
Os sinônimos usados nos blocos PL/SQL são alterados para o objeto referenciado e o esquema será adicionado, se necessário.
Esquema implícito adicionado¶
Quando o procedimento ou a função estiver dentro de um esquema e o sinônimo estiver dentro desse esquema, mas estiver sendo usado sem o esquema, o código convertido adicionará o esquema.
Oracle¶
CREATE TABLE schema_one.TABLE_TEST1(
COL1 INTEGER,
COL2 DATE DEFAULT SYSDATE
);
CREATE OR REPLACE SYNONYM schema_one.MY_SYNONYM1 FOR schema_one.TABLE_TEST1;
create or replace procedure schema_one.procedure1 as
returnval integer;
begin
select col1 into returnval from my_synonym1;
end;
Snowflake¶
CREATE OR REPLACE TABLE schema_one.TABLE_TEST1 (
COL1 INTEGER,
COL2 TIMESTAMP /*** SSC-FDM-OR0042 - DATE TYPE COLUMN HAS A DIFFERENT BEHAVIOR IN SNOWFLAKE. ***/ DEFAULT CURRENT_TIMESTAMP()
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
;
-- --** SSC-FDM-OR0005 - SYNONYMS NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS SYNONYM WERE CHANGED BY THE ORIGINAL OBJECT NAME. **
-- CREATE OR REPLACE SYNONYM schema_one.MY_SYNONYM1 FOR schema_one.TABLE_TEST1
;
CREATE OR REPLACE PROCEDURE schema_one.procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
returnval integer;
BEGIN
select col1 into
:returnval
from
schema_one.TABLE_TEST1;
END;
$$;
Adicionado o esquema do objeto referenciado¶
Quando o sinônimo fizer referência a um objeto que esteja em um esquema específico, o nome do esquema será adicionado ao objeto referenciado.
Oracle¶
CREATE OR REPLACE SYNONYM MY_SYNONYM2 FOR schema_one.TABLE_TEST1;
create or replace procedure procedure2 as
returnval integer;
begin
select col1 into returnval from my_synonym2;
end;
Snowflake¶
----** SSC-FDM-OR0005 - SYNONYMS NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS SYNONYM WERE CHANGED BY THE ORIGINAL OBJECT NAME. **
--CREATE OR REPLACE SYNONYM MY_SYNONYM2 FOR schema_one.TABLE_TEST1
;
CREATE OR REPLACE PROCEDURE procedure2 ()
RETURNS STRING
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
// SnowConvert Helpers Code section is omitted.
let RETURNVAL;
[RETURNVAL] = EXEC(`SELECT
col1
from
schema_one.TABLE_TEST1`);
$$;
EWIs relacionados¶
SSC-FDM-OR0005: Os sinônimos não são compatíveis com o Snowflake, mas as referências a esse sinônimo foram alteradas pelo nome original do objeto.
SSC-FDM-OR0042: O tipo de data transformado em carimbo de data/hora tem um comportamento diferente.
Acionadores¶
Os acionadores não são compatíveis com o Snowflake e, portanto, não serão migrados automaticamente.
No momento, o Snowflake não oferece um mecanismo direto para acionadores, mas alguns recursos do Snowflake podem ser usados para obter resultados semelhantes.
Recomendamos que você faça uma análise de seus acionadores e os classifique por finalidade:
Acionadores de auditoria: a intenção desses acionadores é capturar informações e registrar as alterações feitas em algumas tabelas para outras tabelas.
Acionadores de inicialização: a intenção desses acionadores é adicionar alguns valores padrão aos novos registros. Em geral, eles estão antes ou depois dos acionadores de inserção
Acionadores de barreira de regra de negócios: geralmente se aplicam a BEFORE/AFTER DELETE ou UPDATE. O objetivo desses acionadores é criar uma barreira para evitar a entrada ou a exclusão de dados que violam algumas regras comerciais.
Em vez de Acionadores: usado, por exemplo, para permitir inserções em exibições, não é suportado. A recomendação será transformar essa lógica em um procedimento armazenado e introduzir chamadas sempre que elas forem usadas para operações de inserção/exclusão/atualização.
Acionadores de banco de dados: não podem ser replicados, também é recomendável encapsular essa lógica em um procedimento armazenado. Mas essa lógica precisará ser invocada manualmente.
Acionadores genéricos After: para alguns acionadores after, streams e tarefas podem ser aproveitados, consulte a seção abaixo.
Acionador de auditoria
CREATE OR REPLACE TRIGGER SCHEMA.TRIGGER_NAME
BEFORE UPDATE OR INSERT ON SCHEMA.TRIGGER_NAME FOR EACH ROW
BEGIN
:NEW.LAST_UPDATE := SYSDATE;
END;
Antes de acionadores UPDATE para auditoria, casos como esse não podem ser tratados diretamente. Para o caso INSERT, você pode usar o caso do valor padrão explicado para o acionador de inicialização. No entanto, no caso da atualização, a única opção será usar uma tarefa, conforme explicado mais adiante para os acionadores AFTER. No entanto, LAST_UPDATE não será exato, haverá um deslocamento porque a modificação registrada será no momento da execução da tarefa (por exemplo, se as tarefas forem executadas a cada 5 minutos, LAST_UPDATE será registrado 5 minutos depois).
Nos casos de UPDATE, não é possível tentar capturar CURRENT_USER.
Outros casos de acionadores AUDIT são quando eles registram alterações de uma tabela em uma tabela de atualização. A técnica de acionamento AFTER descrita mais adiante pode ser usada, mas novamente as informações de USER não podem ser rastreadas e as informações de TIME não serão precisas.
Acionador de inicialização
CREATE OR REPLACE TRIGGER SCHEMA.TRIGGER_NAME
BEFORE INSERT ON SCHEMA.TABLE1 FOR EACH ROW
BEGIN
SELECT SCHEMA.TABLE.NEXTVAL INTO :NEW.COLUMN_SEQ FROM DUAL;
SELECT USER INTO :NEW.UPDATED_BY FROM DUAL;
SELECT SYSTIMESTAMP INTO :NEW.UPDATED_TM FROM DUAL;
END
Para esses acionadores, você pode usar os valores de coluna padrão do Snowflake, por exemplo, para valores de sequência.
Você também pode usar CURRENT_
_ USER
() e CURRENT_TIMESTAMP
em vez de USER
ou SYS_TIMESTAMP
_
Isso se aplica somente aos casos BEFORE INSERT ou AFTER INSERT.
Barreira de regras de negócios
CREATE OR REPLACE EDITIONABLE TRIGGER SCHEMA.TRIGGER_NAME
BEFORE DELETE ON SCHEMA.TABLE FOR EACH ROW
BEGIN
IF (:OLD.termination_date is NULL OR
:OLD.termination_date >= TRUNC(SYSDATE)+1 ) THEN
RAISE_APPLICATION_ERROR(-30001,'An employee must be terminated before deleteing the row');
END IF;
Nesses casos, você precisará alinhar as ações de acionamento após/antes da execução de DELETE ou UPDATE.
Uma tarefa não é recomendada aqui porque as tarefas são executadas segundo um cronograma e, portanto, a linha já terá sido modificada.
Esta seção mostra uma solução alternativa conhecida para implementar parcialmente acionadores AFTER.
GENERIC AFTER TRIGGER
Exemplo 1: Conversão básica do acionador
Oracle
CREATE TRIGGER example_trigger
AFTER INSERT ON table1
SELECT * FROM DUAL;
Snowflake
Nota
Código de auxiliar do SnowConvert removido do exemplo. Você pode encontrá-los aqui
----** SSC-OOS - OUT OF SCOPE CODE UNIT. CREATE TRIGGER IS OUT OF TRANSLATION SCOPE. **
--CREATE TRIGGER example_trigger
--AFTER INSERT ON table1
--SELECT * FROM DUAL
Explicação detalhada do código do Snowflake¶
Fluxos¶
Eles se encarregam de armazenar as alterações feitas na tabela. Note que:
Eles armazenarão o delta entre o estado atual da tabela e o último deslocamento armazenado pelo próprio fluxo. Leve isso em consideração para fins de faturamento.
Observe que eles não armazenam as informações das atualizações, mas sim as armazenam como uma inserção.
Da mesma forma, eles não podem ser configurados para rastrear apenas exclusões ou apenas atualizações e, portanto, devem ser filtrados no procedimento e na própria tarefa (veja abaixo).
Procedimentos¶
Eles se encarregam de executar a(s) instrução(ões) SQL do acionador. Note que:
É necessário liberar o fluxo, por isso a criação de um novo fluxo no final do procedimento.
Quaisquer ações que precisem ser filtradas (como acionadores somente AFTER-INSERTs) precisarão ser filtradas no próprio procedimento armazenado.
Tarefas¶
Elas se encarregam de verificar regularmente se há alterações no fluxo e, consequentemente, executam a(s) instrução(ões) SQL do acionador. Note que:
As tarefas funcionam segundo um cronograma, uma ação não as dispara. Isso significa que haverá verificações programadas de acionamento sem alterações de dados realizadas na tabela.
As tarefas não podem ser configuradas para serem executadas mais de uma vez a cada sessenta (60) segundos, pois o tempo mínimo é de um (1) minuto.
Quando o fluxo tiver detectado alterações, haverá, na pior das hipóteses, sessenta (60) segundos de atraso entre a detecção da alteração e a execução do acionador.
Embora a adição de WHEN evite a execução da tarefa, o Snowflake ainda adiciona encargos toda vez que é avaliado; e esses encargos serão adicionados à conta quando o acionador for realmente executado.
A tarefa precisa de um warehouse para ser executada e deverá ser definida manualmente pelo cliente.
Problemas conhecidos ¶
Não foram encontrados problemas.
EWIs Relacionados ¶
Sem EWIs relacionados.
Atributo TYPE¶
Descrição¶
Este capítulo está relacionado à transformação do atributo TYPE quando ele faz referência a uma coluna, variável, registro, coleção ou cursor. A transformação envolve a obtenção do tipo de dados do item referenciado e a substituição do atributo TYPE do item referenciado pelo tipo de dados obtido.
Amostra de padrões da origem¶
Atributo TYPE para colunas¶
Nesse caso, o item referenciado é uma coluna de uma tabela criada anteriormente.
Oracle¶
CREATE TABLE table1(
col1 NUMBER
);
CREATE OR REPLACE PROCEDURE procedure1
IS
var1 table1.col1%TYPE;
BEGIN
NULL;
END;
Snowflake¶
CREATE OR REPLACE TABLE table1 (
col1 NUMBER(38, 18) /*** SSC-FDM-0006 - NUMBER TYPE COLUMN MAY NOT BEHAVE SIMILARLY IN SNOWFLAKE. ***/
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
;
CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
var1 NUMBER(38, 18);
BEGIN
NULL;
END;
$$;
Nota
Mais informações sobre o tipo de dados NUMBER podem ser encontradas na seção Tipos de dados numéricos.
Atributo TYPE para variáveis¶
Nesse caso, o item referenciado é uma variável declarada anteriormente.
Oracle¶
CREATE OR REPLACE PROCEDURE procedure1
IS
var0 FLOAT;
var1 var0%TYPE;
var2 var1%TYPE;
var3 var2%TYPE;
BEGIN
NULL;
END;
Snowflake¶
CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
var0 FLOAT;
var1 FLOAT;
var2 FLOAT;
var3 FLOAT;
BEGIN
NULL;
END;
$$;
Nota
Mais informações sobre o tipo de dados FLOAT podem ser encontradas na seção Tipo de dados FLOAT
Atributo TYPE para registros¶
Nesse caso, o item referenciado é um registro declarado anteriormente.
Oracle¶
CREATE OR REPLACE PROCEDURE procedure1
IS
TYPE record_typ_def IS RECORD(field1 NUMBER);
record_var record_typ_def;
var1 record_var%TYPE;
var2 record_var.field1%TYPE;
BEGIN
NULL;
END;
Snowflake¶
CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO OBJECT ***/!!!
TYPE record_typ_def IS RECORD(field1 NUMBER);
record_var OBJECT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - record_typ_def DATA TYPE CONVERTED TO OBJECT ***/!!! := OBJECT_CONSTRUCT();
var1 OBJECT := OBJECT_CONSTRUCT();
var2 NUMBER(38, 18);
BEGIN
NULL;
END;
$$;
No exemplo anterior, a variável que faz referência à variável de registro é alterada para OBJECT
, que é igual à variável de registro, e a variável que faz referência ao campo de registro é alterada para o tipo de dados do campo de registro (NUMBER (38, 18)
).
Essas alterações não funcionam para registros incorporados.
Nota
Mais informações sobre registros podem ser encontradas na seção Coleção e registros.
Atributo TYPE para coleções¶
Nesse caso, o item referenciado é uma variável de coleção, mas como não há suporte para coleções, o atributo TYPE do item referenciado é alterado para o tipo de dados VARIANT.
Oracle¶
CREATE OR REPLACE PROCEDURE procedure1
IS
TYPE collection_type IS TABLE OF NUMBER;
collection_var collection_type;
var1 collection_var%TYPE;
BEGIN
NULL;
END;
Snowflake¶
CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
--!!!RESOLVE EWI!!! /*** SSC-EWI-0058 - FUNCTIONALITY FOR 'PL COLLECTION TYPE DEFINITION' IS NOT CURRENTLY SUPPORTED BY SNOWFLAKE SCRIPTING ***/!!!
--TYPE collection_type IS TABLE OF NUMBER;
collection_var VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-0062 - CUSTOM TYPE 'collection_type' USAGE CHANGED TO VARIANT ***/!!!;
var1 VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-OR0129 - TYPE ATTRIBUTE 'collection_var%TYPE' COULD NOT BE RESOLVED, SO IT WAS TRANSFORMED TO VARIANT ***/!!!;
BEGIN
NULL;
END;
$$;
Atributo TYPE para cursores¶
Nesse caso, o item referenciado é uma variável de cursor, mas como não há suporte para os cursores REF, o atributo TYPE do item referenciado é alterado para o tipo de dados VARIANT.
Oracle¶
CREATE TABLE table1 (col1 NUMBER);
CREATE OR REPLACE PROCEDURE procedure1
IS
TYPE cursor_type IS REF CURSOR RETURN table1%ROWTYPE;
cursor_var cursor_type;
var1 cursor_var%TYPE;
BEGIN
NULL;
END;
Snowflake¶
CREATE OR REPLACE TABLE table1 (col1 NUMBER(38, 18) /*** SSC-FDM-0006 - NUMBER TYPE COLUMN MAY NOT BEHAVE SIMILARLY IN SNOWFLAKE. ***/
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
;
CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS VARCHAR
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
EXECUTE AS CALLER
AS
$$
DECLARE
--!!!RESOLVE EWI!!! /*** SSC-EWI-0058 - FUNCTIONALITY FOR 'PL REF CURSOR TYPE DEFINITION' IS NOT CURRENTLY SUPPORTED BY SNOWFLAKE SCRIPTING ***/!!!
--TYPE cursor_type IS REF CURSOR RETURN table1%ROWTYPE;
cursor_var_res RESULTSET;
var1_res RESULTSET;
BEGIN
NULL;
END;
$$;
Nota
Nos casos em que o tipo de dados do item referenciado não pode ser obtido, o atributo TYPE do item referenciado é alterado para VARIANT
.
Conhece os problemas¶
1. Cursors and collections declarations are not supported.¶
As instruções de variáveis de coleção e cursor ainda não são compatíveis, portanto, o atributo TYPE do item de referência é alterado para VARIANT e um aviso é adicionado nesses casos.
2. Original data type could not be obtained.¶
Quando o tipo de dados do item referenciado não puder ser obtido, o atributo TYPE do item referenciado será alterado para VARIANT e um aviso será adicionado.
EWIS relacionados¶
SSC-EWI-0036: Tipo de dados convertido em outro tipo de dados.
SSC-EWI-0056: Create Type não tem suporte.
SSC-EWI-0058: No momento, a funcionalidade não é compatível com o Snowflake Scripting.
SSC-EWI-0062: O uso do tipo personalizado foi alterado para variante.
SSC-EWI-OR0129: A instrução abaixo tem usos de cursores aninhados.
SSC-FDM-0006: A coluna de tipo de número pode não se comportar de forma semelhante no Snowflake.