SnowConvert AI - Oracle - Criar tipo¶

This is a translation reference to convert Oracle Create Type Statements (UDTs) to snowflake

Descrição geral¶

SnowConvert translates many Oracle CREATE TYPE statements to Snowflake native user-defined types where the shape is supported—for example object types with attributes, VARRAY mapped to Snowflake ARRAY, and nested table types mapped to ARRAY of the element type. Unsupported options (subtype inheritance, member bodies, incomplete types, and others) are flagged with Oracle-specific EWIs; see Related EWIs and the issues reference.

Um dos recursos mais importantes que o mecanismo de banco de dados Oracle oferece é uma abordagem orientada a objetos. PL/SQL oferece recursos além de outros bancos de dados relacionais na forma de OOP usando instruções semelhantes ao Java na forma de pacotes, funções, tabelas e tipos. Este documento abrangerá o último e como o SnowConvert AI o resolve, mantendo-se em conformidade com a funcionalidade.

O Oracle é compatível com as seguintes especificações:

Tipo de dados abstrato (ADT) (incluindo um tipo de objeto SQLJ).
Tipo de matriz variável autônoma (varray).
Tipo de tabela aninhada autônoma.
Tipo de objeto incompleto.

Tudo isso de acordo com as informações encontradas na documentação da instrução Oracle Create Type

CREATE [ OR REPLACE ] [ EDITIONABLE | NONEDITIONAL ] TYPE <type name>
[ <type source creation options> ]
[<type definition>]
[ <type properties> ]

Limitações¶

Snowflake supports native user-defined types (CREATE TYPE … AS OBJECT, ARRAY, etc.) as documented in the SQL data types overview. SnowConvert maps many Oracle type definitions to those native types. Patterns that still have no or partial mapping—such as subtype inheritance (UNDER), member methods and type bodies, table types, and incomplete forward declarations—may require manual redesign or are reported via EWIs (for example SSC-EWI-OR0139 through SSC-EWI-OR0142). Semi-structured Data Types remain relevant for legacy scenarios that still use VARIANT in converted code.

A seguir, os recursos de Tipos definidos pelo usuário para os quais NO propõe uma solução alternativa:

Subtipos: Hierarquia de tipos¶

Essas instruções não são compatíveis com o Snowflake. O SnowConvert AI apenas as reconhece, mas nenhuma tradução é oferecida.

CREATE TYPE person_t AS OBJECT (name VARCHAR2(100), ssn NUMBER) 
   NOT FINAL;
/

CREATE TYPE employee_t UNDER person_t 
   (department_id NUMBER, salary NUMBER) 
   NOT FINAL;
/

CREATE TYPE part_time_emp_t UNDER employee_t (num_hrs NUMBER);
/

Propriedades de tipo¶

Elas se referem às opções normalmente usadas ao utilizar OOP em PL/SQL: Persistable, Instantiable e Final.

CREATE OR REPLACE TYPE type1 AS OBJECT () NOT FINAL NOT INSTANTIABLE NOT PERSISTABLE;
CREATE OR REPLACE TYPE type2 AS OBJECT () FINAL INSTANTIABLE PERSISTABLE;

Tipo de tabela aninhada¶

Essas instruções não são compatíveis com o Snowflake. O SnowConvert AI apenas as reconhece, mas nenhuma tradução é oferecida.

CREATE TYPE textdoc_typ AS OBJECT
    ( document_typ      VARCHAR2(32)
    , formatted_doc     BLOB
    ) ;
/

CREATE TYPE textdoc_tab AS TABLE OF textdoc_typ;
/

Opções de criação de fonte de tipo¶

Essas opções representam opções personalizadas relacionadas ao acesso e à consulta do tipo.

CREATE TYPE type1 FORCE OID 'abc' SHARING = METADATA DEFAULT COLLATION schema1.collation ACCESSIBLE BY (schema1.unitaccesor) AS OBJECT ();
CREATE TYPE type2 FORCE OID 'abc' SHARING = NONE DEFAULT COLLATION collation ACCESSIBLE BY (PROCEDURE unitaccesor) AS OBJECT ();
CREATE TYPE type3 AUTHID CURRENT_USER AS OBJECT ();
CREATE TYPE type4 AUTHID DEFINER AS OBJECT ();

Soluções alternativas propostas¶

Sobre a definição de tipos¶

Para a definição, a solução proposta é criar um tipo de dados semiestruturado para imitar o tipo de dados do Oracle.

Sobre a função de membro types¶

Para as funções de membro que contêm lógica e DML, a solução proposta depende de auxiliares para converter isso em procedimentos armazenados.

Suporte atual do SnowConvert AI¶

The next table shows a summary of the current support provided by the SnowConvert AI tool. Please keep in mind that translations may still not be final, and more work may be needed.


Tipo de elemento de instrução	Status atual de reconhecimento	Status atual da tradução	Tem soluções alternativas conhecidas
Definições de tipo de objeto	Reconhecido.	Translated to Snowflake `CREATE TYPE … AS OBJECT` where supported.	Sim.
Definições de subtipo	Reconhecido.	Não traduzido.	Não.
Definições de tipo de matriz	Reconhecido.	Translated to Snowflake `CREATE TYPE … AS ARRAY` (see SSC-FDM-0043).	Sim.
Definições da tabela aninhada	Reconhecido.	Translated to Snowflake `ARRAY` of element type where supported.	Limited.
Definições da função de membro	Reconhecido.	Não traduzido.	Sim.

Problemas conhecidos¶

1. DML usages for Object Types — partial support¶

DDL definitions for User-Defined Types are translated to native Snowflake CREATE TYPE … AS OBJECT / … AS ARRAY where the shape is supported. Constructor calls (for example address_type('123 Main St', …) for object types and VARRAY_TYPE('a', 'b', 'c') for VARRAY / nested-table types) are now also translated to OBJECT_CONSTRUCT(…) :: <type> and ARRAY_CONSTRUCT(…) :: <type> respectively, in INSERT … VALUES, INSERT … SELECT, UPDATE … SET, top-level SELECT, and PL/SQL variable initialization. DML that relies on object-type member functions or other Oracle-specific UDT operations may still require manual review; an SSC-EWI-0073 is emitted in those cases.

2. Create Type creation options are not supported¶

No momento, não há nenhuma solução alternativa conhecida para nenhuma das opções de criação; por esse motivo, elas não são levadas em consideração ao definir o tipo.

Definição do tipo de matriz¶

This is a translation reference to convert the Array Variant of the Oracle Create Type Statements (UDTs) to Snowflake

Nota

Oracle VARRAY types are translated to Snowflake CREATE TYPE … AS ARRAY ( element_type ). Fixed varray capacity is not preserved; see SSC-FDM-0043. Column usages may still be migrated to VARIANT in older or mixed scenarios—verify generated DDL for your workload.

VARRAY and nested-table constructor calls (for example phone_list_typ_demo('2000-0000', '4000-0000')) used in INSERT, UPDATE and top-level SELECT are translated to ARRAY_CONSTRUCT(...) :: <type_name>. See VARRAY constructor calls in DML below.

Nota

Algumas partes do código de saída foram omitidas por motivos de clareza.

Descrição¶

Array Types definem uma estrutura de matriz de um tipo de dado existente anteriormente (incluindo outros Custom Types).

For many workloads, the type definition is emitted as a Snowflake native ARRAY type. Usages in tables and PL/SQL may still involve Semi-structured Data Types or OBJECT depending on context.

CREATE TYPE <type name>
AS { VARRAY | [VARYING] ARRAY } ( <size limit> ) OF <data type>

Amostra de padrões da origem¶

Inserções para o uso da matriz¶

VARRAY and nested-table constructor calls used in INSERT … VALUES, INSERT … SELECT, UPDATE and top-level SELECT are translated to ARRAY_CONSTRUCT(...) and explicitly cast to the original UDT name with :: <type>, so column type checks against the UDT continue to succeed.

Oracle¶

INSERT INTO customer_table_demo(customer_table_id, customer_data) VALUES
(1, phone_list_typ_demo('2000-0000', '4000-0000', '0000-0000'));

INSERT INTO customer_table_demo(customer_table_id, customer_data) VALUES
(1, phone_list_typ_demo('8000-2000', '0000-0000', '5000-0000'));

Snowflake¶

INSERT INTO customer_table_demo(customer_table_id, customer_data) VALUES
(1, ARRAY_CONSTRUCT('2000-0000', '4000-0000', '0000-0000') :: phone_list_typ_demo);

INSERT INTO customer_table_demo(customer_table_id, customer_data) VALUES
(1, ARRAY_CONSTRUCT('8000-2000', '0000-0000', '5000-0000') :: phone_list_typ_demo);

VARRAY constructor calls in DML¶

The translator handles standalone constructor calls in INSERT … VALUES, INSERT … SELECT, UPDATE … SET, and top-level SELECT statements. For nested-table types defined with CREATE TYPE … AS TABLE OF … the same ARRAY_CONSTRUCT(...) :: <type> shape is produced.

Oracle¶

CREATE TYPE VARRAY_TYPE AS VARRAY(3) OF VARCHAR2(50);
/

CREATE TABLE my_varray_table (id NUMBER, varray_column VARRAY_TYPE);
/

INSERT INTO my_varray_table SELECT 1, VARRAY_TYPE('Apple', 'Banana', 'Orange') FROM dual;

CREATE TYPE NUMBER_LIST AS TABLE OF NUMBER;
/

INSERT INTO my_table SELECT 1, NUMBER_LIST(10, 20, 30) FROM dual;

Snowflake¶

--** SSC-FDM-0043 - ARRAY SIZE LIMIT '3' WAS REMOVED. SNOWFLAKE ARRAYS ARE DYNAMICALLY SIZED. **
CREATE TYPE VARRAY_TYPE AS ARRAY ( VARCHAR(50) );

CREATE OR REPLACE TABLE my_varray_table (
  id NUMBER(38, 18) /*** SSC-FDM-0006 - NUMBER TYPE COLUMN MAY NOT BEHAVE SIMILARLY IN SNOWFLAKE. ***/,
  varray_column ARRAY
)
;

INSERT INTO my_varray_table
SELECT
  1,
  ARRAY_CONSTRUCT('Apple', 'Banana', 'Orange') :: VARRAY_TYPE
FROM
  dual;

CREATE TYPE NUMBER_LIST AS ARRAY ( NUMBER(38, 18) );

INSERT INTO my_table
SELECT
  1,
  ARRAY_CONSTRUCT(10, 20, 30) :: NUMBER_LIST
FROM
  dual;

Oracle (top-level SELECT)¶

CREATE TYPE STRING_ARRAY AS VARRAY(5) OF VARCHAR2(100);
/

SELECT STRING_ARRAY('hello', 'world') FROM dual;

Snowflake¶

--** SSC-FDM-0043 - ARRAY SIZE LIMIT '5' WAS REMOVED. SNOWFLAKE ARRAYS ARE DYNAMICALLY SIZED. **
CREATE TYPE STRING_ARRAY AS ARRAY ( VARCHAR(100) );

SELECT
  ARRAY_CONSTRUCT('hello', 'world') :: STRING_ARRAY
FROM
  dual;

Uso do tipo de matriz¶

Oracle¶

CREATE TYPE phone_list_typ_demo AS VARRAY(3) OF VARCHAR2(25);
/

CREATE TABLE customer_table_demo (
    customer_table_id INTEGER,
    customer_data phone_list_typ_demo
);
/

SELECT * FROM customer_table_demo;
/

Resultados¶


CUSTOMER_TABLE_ID	CUSTOMER_DATA
1	[[“2000-0000”,”4000-0000”,”0000-0000”]]
1	[[“8000-2000”,”0000-0000”,”5000-0000”]]

Snowflake¶

--** SSC-FDM-0043 - ARRAY SIZE LIMIT '3' WAS REMOVED. SNOWFLAKE ARRAYS ARE DYNAMICALLY SIZED. **
CREATE TYPE phone_list_typ_demo AS ARRAY ( VARCHAR(25) );

CREATE OR REPLACE TABLE customer_table_demo (
        customer_table_id INTEGER,
        customer_data phone_list_typ_demo
    )
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
;

CREATE OR REPLACE VIEW PUBLIC.customer_table_demo_view
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "" }}'
AS
SELECT
        customer_table_id,
        customer_data
FROM
        customer_table_demo;

    SELECT * FROM
        customer_table_demo_view;

Resultados¶


CUSTOMER_TABLE_ID	CUSTOMER_DATA
1	[[“2000-0000”, “4000-0000”, “0000-0000”]]
1	[[“8000-2000”, “0000-0000”, “5000-0000”]]

Problemas conhecidos¶

1. Create Type creation options are not supported¶

No momento, não há nenhuma solução alternativa conhecida para nenhuma das opções de criação; por esse motivo, elas não são levadas em consideração ao definir o tipo.

2. Migrated code output is not functional¶

As instruções estão sendo alteradas desnecessariamente, o que faz com que elas não sejam mais funcionais no código de saída. Isso será resolvido quando houver uma transformação adequada para elas.

EWIs relacionados¶

SSC-EWI-0062: O uso do tipo personalizado foi alterado para variante.
SSC-EWI-0073: Revisão de equivalência funcional pendente.

Definições de funções de membro¶

This is a translation reference to convert the Member Functions of the Oracle Create Type Statements (UDTs) to Snowflake

Perigo

O SnowConvert AI ainda não reconhece funções de membro nem definições de corpo do tipo. Esta página é usada apenas como uma referência futura para tradução.

Nota

Algumas partes do código de saída foram omitidas por motivos de clareza.

Descrição¶

Como outras definições de classe, o TYPE da Oracle pode implementar métodos para expor comportamentos com base em seus atributos. MEMBER FUCTION serão transformados em procedimentos armazenados do Snowflake, para manter a equivalência funcional devido às limitações.

Como as funções estão sendo transformadas em procedimentos, a referência de transformação para PL/SQL também se aplica aqui.

Amostra de padrões da origem¶

Inserções para a função de membro Simple square()¶

Os próximos dados serão inseridos na tabela antes de consultar select. Observe que, no momento, essas inserções precisam ser migradas manualmente para o Snowflake.

Oracle¶

INSERT INTO table_member_function_demo(column1) VALUES
(type_member_function_demo(5));

Snowflake¶

INSERT INTO table_member_function_demo (column1)
SELECT OBJECT_CONSTRUCT('a1', 5);

Função de membro Simple square()¶

Oracle¶

-- TYPE DECLARATION
CREATE TYPE type_member_function_demo AS OBJECT (
    a1 NUMBER,
    MEMBER FUNCTION get_square RETURN NUMBER
);
/

-- TYPE BODY DECLARATION
CREATE TYPE BODY type_member_function_demo IS
   MEMBER FUNCTION get_square
   RETURN NUMBER
   IS x NUMBER;
   BEGIN
      SELECT c.column1.a1*c.column1.a1 INTO x
      FROM table_member_function_demo c;
      RETURN (x);
   END;
END;
/

-- TABLE
CREATE TABLE table_member_function_demo (column1 type_member_function_demo);
/

-- QUERYING DATA
SELECT
    t.column1.get_square()
FROM
    table_member_function_demo t;
/

Resultados¶


T.COLUMN1.GET_SQUARE()
25

Snowflake¶

-- TYPE DECLARATION
!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO VARIANT ***/!!!
CREATE TYPE type_member_function_demo AS OBJECT (
    a1 NUMBER,
    MEMBER FUNCTION get_square RETURN NUMBER
)
;

---- TYPE BODY DECLARATION
--!!!RESOLVE EWI!!! /*** SSC-EWI-OR0007 - CREATE TYPE WITHOUT BODY IS NOT SUPPORTED IN SNOWFLAKE ***/!!!
--CREATE TYPE BODY type_member_function_demo IS
--   MEMBER FUNCTION get_square
--   RETURN NUMBER
--   IS x NUMBER;
--   BEGIN
--      SELECT c.column1.a1*c.column1.a1 INTO x
--      FROM table_member_function_demo c;
--      RETURN (x);
--   END;
--END
   ;

-- TABLE
CREATE OR REPLACE TABLE table_member_function_demo (column1 VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-0062 - CUSTOM TYPE 'type_member_function_demo' USAGE CHANGED TO VARIANT ***/!!!
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"oracle"}}'
;

CREATE OR REPLACE VIEW PUBLIC.table_member_function_demo_view
<strong>COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "" }}'
</strong><strong>AS
</strong>SELECT
    column1:a1 :: NUMBER AS a1
FROM
    table_member_function_demo;

-- QUERYING DATA
SELECT
    t.column1.get_square() !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 't.column1.get_square' NODE ***/!!!
FROM
    table_member_function_demo t;

Resultados¶


GET_SQUARE()
25

Problemas conhecidos¶

Nenhum problema conhecido.

EWIs relacionados¶

SSC-EWI-0056: Criar tipo não suportado.
SSC-EWI-0062: O uso do tipo personalizado foi alterado para variante.
SSC-EWI-0073: Revisão de equivalência funcional pendente.
SSC-EWI-OR0007: Create Type não compatível no Snowflake

Definição do tipo de tabela aninhada¶

This is a translation reference to convert the Nested Table Variant of the Oracle Create Type Statements (UDTs) to Snowflake

Nota

Standalone CREATE TYPE … AS TABLE OF element_type is translated to Snowflake CREATE TYPE … AS ARRAY ( element_type ) when the element type is supported. Nested tables used as table columns may still require manual review depending on DML and PL/SQL usage.

Descrição¶

Nested Table Types define an embedded table structure of a previously existing datatype (including other Custom Types). They are closely related to Array Type definitions; SnowConvert maps many patterns to Snowflake ARRAY.

CREATE TYPE <type name> AS TABLE OF <data type>

Amostra de padrões da origem¶

Uso do tipo de tabela aninhada¶

Oracle¶

CREATE TYPE textdoc_typ AS OBJECT (
    document_typ VARCHAR2(32),
    formatted_doc BLOB
);
/

CREATE TYPE textdoc_tab AS TABLE OF textdoc_typ;
/

Snowflake¶

CREATE TYPE textdoc_typ AS OBJECT (
    document_typ VARCHAR(32),
    formatted_doc BINARY
)
;

CREATE TYPE textdoc_tab AS ARRAY ( textdoc_typ );

Problemas conhecidos¶

1. Create Type creation options are not supported¶

Atualmente, não há nenhuma solução alternativa conhecida para nenhuma das opções de criação; por esse motivo, elas não são levadas em conta na definição do tipo.

EWIs relacionados¶

SSC-EWI-0073: Revisão de equivalência funcional pendente
SSC-EWI-0056: Criar tipo não suportado.

Definição do tipo de objeto¶

This is a translation reference to convert the Object Variant of the Oracle Create Type Statements (UDTs) to Snowflake

Nota

O SnowConvert AI oferece suporte a uma tradução para as próprias definições de tipo de objeto. No entanto, seus usos ainda são um trabalho em andamento.

Nota

Algumas partes do código de saída foram omitidas por motivos de clareza.

Descrição¶

Os tipos de objeto definem uma estrutura de dados semelhante a um registro, com as vantagens adicionais das definições de função de membro. Isso significa que seus dados podem ser usados em algum comportamento dentro do tipo.

For the translation of object types, the type definition is mapped to Snowflake’s native CREATE TYPE … AS OBJECT (…) where the attribute list is supported, and constructor calls to the type are translated to OBJECT_CONSTRUCT(<field>, <value>, …) :: <type_name>. SnowConvert AI uses the symbol table to recover the field names from the original CREATE TYPE, so positional constructor arguments are mapped to the correct field names in upper-case. When the type symbol cannot be resolved (for example, because the CREATE TYPE is not part of the migrated source set), the constructor call is preserved and an SSC-EWI-0073 is emitted for manual review.

For legacy or partially-supported scenarios where the object type cannot be expressed natively, the column in dependent tables may still be migrated to VARIANT and an auxiliary view is added so that downstream SELECTs and views to the original table continue to work.

CREATE TYPE <type name> AS OBJECT
( [{<type column definition> | type method definition } , ...]);

Amostra de padrões da origem¶

Object Type constructor calls¶

Object-type constructor calls are translated to OBJECT_CONSTRUCT('FIELD1', value1, 'FIELD2', value2, …) :: <type_name>. The cast to the original UDT name is preserved so column type checks and downstream OBJECT_INSERT / member access continue to work without changes. The transformation applies to constructor calls inside variable initialization, INSERT … VALUES, INSERT … SELECT, UPDATE … SET, and top-level SELECT expressions.

Nota

Field names in the generated OBJECT_CONSTRUCT keys are always upper-case (for example 'NAME', 'AGE'). Snowflake object key lookups are case-sensitive, so downstream references using lowercase or mixed-case semi-structured path syntax (for example obj:name) will return NULL. Use the exact upper-case key or quote it consistently throughout the migrated code.

Oracle¶

CREATE OR REPLACE TYPE Person_Type AS OBJECT (
  Name VARCHAR2(50),
  Age NUMBER
);
/

CREATE OR REPLACE PROCEDURE test_udt_constructor
AS
  person Person_Type := Person_Type('Alice', 30);
BEGIN
  NULL;
END;

Snowflake¶

CREATE TYPE Person_Type AS OBJECT (Name VARCHAR(50), Age NUMBER(38, 18));

CREATE OR REPLACE PROCEDURE test_udt_constructor ()
RETURNS VARCHAR
LANGUAGE SQL
EXECUTE AS CALLER
AS
$$
  DECLARE
    person Person_Type := OBJECT_CONSTRUCT('NAME', 'Alice', 'AGE', 30) :: Person_Type;
  BEGIN
    NULL;
  END;
$$;

Oracle (constructor in `INSERT … VALUES` and `UPDATE … SET`)¶

CREATE OR REPLACE TYPE address_type AS OBJECT (
  street VARCHAR2(100),
  city VARCHAR2(50),
  state VARCHAR2(2),
  postal_code VARCHAR2(10)
);
/

INSERT INTO employees
VALUES (1, 'John', 'Doe', address_type('123 Main St', 'Los Angeles', 'CA', '90001'));

UPDATE employees
SET home_address = address_type('456 Oak Ave', 'New York', 'NY', '10001')
WHERE employee_id = 1;

Snowflake¶

CREATE TYPE address_type AS OBJECT (street VARCHAR(100), city VARCHAR(50), state VARCHAR(2), postal_code VARCHAR(10));

INSERT INTO employees
VALUES (1, 'John', 'Doe', OBJECT_CONSTRUCT('STREET', '123 Main St', 'CITY', 'Los Angeles', 'STATE', 'CA', 'POSTAL_CODE', '90001') :: address_type);

UPDATE employees
  SET
    home_address = OBJECT_CONSTRUCT('STREET', '456 Oak Ave', 'CITY', 'New York', 'STATE', 'NY', 'POSTAL_CODE', '10001') :: address_type
  WHERE
    employee_id = 1;

Oracle (constructor when the type symbol is not in the migrated source)¶

CREATE OR REPLACE FUNCTION Get_Person_Func
RETURN Person_Type
AS
    v_person Person_Type;
BEGIN
    v_person := Person_Type('Jane Doe', 25);
    RETURN v_person;
END;

Snowflake¶

CREATE OR REPLACE FUNCTION Get_Person_Func ()
RETURNS Person_Type
LANGUAGE SQL
AS
$$
  WITH declaration_variables_cte1 AS
  (
    SELECT
      Person_Type('Jane Doe', 25) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'Person_Type' NODE ***/!!! AS
      v_person
  )
  SELECT
    v_person
  FROM
    declaration_variables_cte1
$$;

Uso de Inserts for Simple Type¶

Os próximos dados serão inseridos na tabela antes de consultar select. Observe que, no momento, essas inserções precisam ser migradas manualmente para o Snowflake.

Oracle¶

INSERT INTO customer_table_demo(customer_table_id, customer_data)
VALUES ( 1, customer_typ_demo(1, 'First Name 1', 'Last Name 1'));

INSERT INTO customer_table_demo(customer_table_id, customer_data)
VALUES ( 2, customer_typ_demo(2, 'First Name 2', 'Last Name 2'));

Snowflake¶

INSERT INTO customer_table_demo(customer_table_id, customer_data)
VALUES ( 1, customer_typ_demo(1, 'First Name 1', 'Last Name 1') !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'customer_typ_demo' NODE ***/!!!);

INSERT INTO customer_table_demo(customer_table_id, customer_data)
VALUES ( 2, customer_typ_demo(2, 'First Name 2', 'Last Name 2') !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'customer_typ_demo' NODE ***/!!!);

Uso de Simple Type¶

Oracle¶

CREATE TYPE customer_typ_demo AS OBJECT (
    customer_id INTEGER,
    cust_first_name VARCHAR2(20),
    cust_last_name VARCHAR2(20)
);

CREATE TABLE customer_table_demo (
    customer_table_id INTEGER,
    customer_data customer_typ_demo
);

SELECT * FROM customer_table_demo;

Resultados¶


CUSTOMER_TABLE_ID	CUSTOMER_DATA
1	[1, First Name 1, Last Name 1]
2	[2, First Name 2, Last Name 2]

Snowflake¶

!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO VARIANT ***/!!!
CREATE TYPE customer_typ_demo AS OBJECT (
    customer_id INTEGER,
    cust_first_name VARCHAR2(20),
    cust_last_name VARCHAR2(20)
)
;

CREATE OR REPLACE TABLE customer_table_demo (
        customer_table_id INTEGER,
        customer_data VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-0062 - CUSTOM TYPE 'customer_typ_demo' USAGE CHANGED TO VARIANT ***/!!!
    )
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}}'
;

CREATE OR REPLACE VIEW PUBLIC.customer_table_demo_view
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "" }}'
AS
SELECT
        customer_table_id,
        customer_data:customer_id :: INTEGER AS customer_id,
        customer_data:cust_first_name :: VARCHAR AS cust_first_name,
        customer_data:cust_last_name :: VARCHAR AS cust_last_name
FROM
        customer_table_demo;

    SELECT * FROM
        customer_table_demo_view;

Resultados¶


CUSTOMER_TABLE_ID	CUST_ID	CUST_FIRST_NAME	CUST_LAST_NAME
1	1	Nome 1	Sobrenome 1
2	2	Nome 2	Sobrenome 2

Uso de Inserts for Nested Type¶

Essas instruções precisam ser colocadas entre a criação da tabela e a instrução select para testar a saída.

Oracle¶

INSERT INTO customer_table_demo(customer_id, customer_data) values
(1, customer_typ_demo('Customer 1', email_typ_demo('email@domain.com')));

INSERT INTO customer_table_demo(customer_id, customer_data) values
(2, customer_typ_demo('Customer 2', email_typ_demo('email2@domain.com')));

Snowflake¶

INSERT INTO customer_table_demo(customer_id, customer_data) values
(1, customer_typ_demo('Customer 1', email_typ_demo('email@domain.com') !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'email_typ_demo' NODE ***/!!!) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'customer_typ_demo' NODE ***/!!!);

INSERT INTO customer_table_demo(customer_id, customer_data) values
(2, customer_typ_demo('Customer 2', email_typ_demo('email2@domain.com') !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'email_typ_demo' NODE ***/!!!) !!!RESOLVE EWI!!! /*** SSC-EWI-0073 - PENDING FUNCTIONAL EQUIVALENCE REVIEW FOR 'customer_typ_demo' NODE ***/!!!);

Uso de Nested Type¶

Oracle¶

CREATE TYPE email_typ_demo AS OBJECT (email VARCHAR2(20));

CREATE TYPE customer_typ_demo AS OBJECT (
    cust_name VARCHAR2(20),
    cust_email email_typ_demo
);

CREATE TABLE customer_table_demo (
    customer_id INTEGER,
    customer_data customer_typ_demo
);

SELECT * FROM customer_table_demo;

Resultados¶


CUSTOMER_ID	CUSTOMER_DATA
1	[Customer 1, [email@domain.com]]
2	[Customer 2, [email2@domain.com]]

Snowflake¶

!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO VARIANT ***/!!!
CREATE TYPE email_typ_demo AS OBJECT (email VARCHAR2(20))
;

!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO VARIANT ***/!!!

CREATE TYPE customer_typ_demo AS OBJECT (
    cust_name VARCHAR2(20),
    cust_email email_typ_demo
)
;

CREATE OR REPLACE TABLE customer_table_demo (
    customer_id INTEGER,
    customer_data VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-0062 - CUSTOM TYPE 'customer_typ_demo' USAGE CHANGED TO VARIANT ***/!!!
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},{"attributes":{"component":"oracle"}}}'
;

CREATE OR REPLACE VIEW PUBLIC.customer_table_demo_view
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "oracle",  "convertedOn": "" }}'
AS
SELECT
    customer_id,
    customer_data:cust_name :: VARCHAR AS cust_name,
    customer_data:cust_email:email :: VARCHAR AS email
FROM
    customer_table_demo;

SELECT * FROM
    customer_table_demo_view;

Resultados¶


CUSTOMER_ID	CUST_NAME	CUST_EMAIL
1	Cliente 1	email@domain.com
2	Cliente 2	email2@domain.com

Problemas conhecidos¶

1. Migrated code output is not the same¶

A instrução view está sendo alterada desnecessariamente, o que faz com que a tabela não tenha mais o mesmo comportamento no código de saída. Há um item de trabalho para corrigir esse problema.

2. DML for User-defined Types — partial support¶

Constructor calls to object types (for example address_type('123 Main St', …)) and to collection types (VARRAY and nested-table) are now translated automatically when they appear in INSERT … VALUES, INSERT … SELECT, UPDATE … SET, and top-level SELECT expressions, as well as in PL/SQL variable initialization. See Object Type constructor calls above. Other DML shapes that depend on object-type member functions or implicit type promotion may still require manual review.

3. Create Type creation options are not supported¶

No momento, não há nenhuma solução alternativa conhecida para nenhuma das opções de criação; por esse motivo, elas não são levadas em consideração ao definir o tipo.

EWIs relacionados¶

SSC-EWI-0056: Criar tipo não suportado.
SSC-EWI-0062: O uso do tipo personalizado foi alterado para variante.
SSC-EWI-0073: Revisão de equivalência funcional pendente.

Definição do subtipo¶

This is a translation reference to convert the Subtype Variant of the Oracle Create Type Statements (UDTs) to Snowflake

Perigo

Como não há soluções alternativas conhecidas, o SnowConvert AI apenas reconhece essas definições e não oferece suporte a nenhuma tradução para elas.

Descrição¶

Os subtipos definem uma estrutura de dados semelhante a um registro, com as vantagens adicionais das definições de função de membro. Isso significa que seus dados podem ser usados em algum comportamento dentro do tipo. Ao contrário dos tipos de objeto, os subtipos são criados como uma extensão de outro tipo existente.

Com relação às definições de subtipo, ainda não há conversão, mas pode haver uma maneira de reimplementá-las usando Definições de tipo de objeto e, em seguida, usando sua respectiva conversão.

CREATE TYPE <type name> UNDER <super type name>
( [{<type column definition> | type method definition } , ...]);

Amostra de padrões da origem¶

Subtipos em um tipo de objeto¶

Oracle¶

CREATE TYPE person_t AS OBJECT (name VARCHAR2(100), ssn INTEGER) 
   NOT FINAL;
/

CREATE TYPE employee_t UNDER person_t 
   (department_id INTEGER, salary INTEGER) 
   NOT FINAL;
/

CREATE TYPE part_time_emp_t UNDER employee_t (num_hrs INTEGER);
/

Snowflake¶

!!!RESOLVE EWI!!! /*** SSC-EWI-0056 - CUSTOM TYPES ARE NOT SUPPORTED IN SNOWFLAKE BUT REFERENCES TO THIS CUSTOM TYPE WERE CHANGED TO VARIANT ***/!!!
CREATE TYPE person_t AS OBJECT (name VARCHAR2(100), ssn INTEGER)
   NOT FINAL;

--!!!RESOLVE EWI!!! /*** SSC-EWI-OR0007 - CREATE TYPE SUBTYPE IS NOT SUPPORTED IN SNOWFLAKE ***/!!!

--CREATE TYPE employee_t UNDER person_t
--   (department_id INTEGER, salary INTEGER)
--   NOT FINAL
            ;

--!!!RESOLVE EWI!!! /*** SSC-EWI-OR0007 - CREATE TYPE SUBTYPE IS NOT SUPPORTED IN SNOWFLAKE ***/!!!

--CREATE TYPE part_time_emp_t UNDER employee_t (num_hrs INTEGER)
                                                              ;

Problemas conhecidos¶

1. Create Type creation options are not supported¶

No momento, não há nenhuma solução alternativa conhecida para nenhuma das opções de criação; por esse motivo, elas não são levadas em consideração ao definir o tipo.

EWIs relacionados¶

SSC-EWI-0056: Criar tipo não suportado.
SSC-EWI-OR0007: Criar tipo não é compatível com o Snowflake.

SnowConvert AI - Oracle - Criar tipo¶

Descrição geral¶

Limitações¶

Subtipos: Hierarquia de tipos¶

Propriedades de tipo¶

Tipo de tabela aninhada¶

Opções de criação de fonte de tipo¶

Soluções alternativas propostas¶

Sobre a definição de tipos¶

Sobre a função de membro types¶

Suporte atual do SnowConvert AI¶

Problemas conhecidos¶

1. DML usages for Object Types — partial support¶

2. Create Type creation options are not supported¶

EWIs relacionados¶

Definição do tipo de matriz¶

Descrição¶

Amostra de padrões da origem¶

Inserções para o uso da matriz¶

Oracle¶

Snowflake¶

VARRAY constructor calls in DML¶

Oracle¶

Snowflake¶

Oracle (top-level SELECT)¶

Snowflake¶

Uso do tipo de matriz¶

Oracle¶

Resultados¶

Snowflake¶

Resultados¶

Problemas conhecidos¶

1. Create Type creation options are not supported¶

2. Migrated code output is not functional¶

EWIs relacionados¶

Definições de funções de membro¶

Descrição¶

Amostra de padrões da origem¶

Inserções para a função de membro Simple square()¶

Oracle¶

Snowflake¶

Função de membro Simple square()¶

Oracle¶

Resultados¶

Snowflake¶

Resultados¶

Problemas conhecidos¶

EWIs relacionados¶

Definição do tipo de tabela aninhada¶

Descrição¶

Amostra de padrões da origem¶

Uso do tipo de tabela aninhada¶

Oracle¶

Snowflake¶

Problemas conhecidos¶

1. Create Type creation options are not supported¶

EWIs relacionados¶

Definição do tipo de objeto¶

Descrição¶

Amostra de padrões da origem¶

Object Type constructor calls¶

Oracle¶

Snowflake¶

Oracle (constructor in INSERT … VALUES and UPDATE … SET)¶

Snowflake¶

Oracle (constructor when the type symbol is not in the migrated source)¶

Snowflake¶

Uso de Inserts for Simple Type¶

Oracle¶

Snowflake¶

Uso de Simple Type¶

Oracle¶

Resultados¶

Snowflake¶

Resultados¶

Uso de Inserts for Nested Type¶

Oracle¶

Snowflake¶

Uso de Nested Type¶

Oracle¶

Oracle (constructor in `INSERT … VALUES` and `UPDATE … SET`)¶