Migrar Aplicativos de Bancos de Dados SQL Server para o Autonomous Database

Você pode migrar instruções SQL do SQL Server para o Oracle SQL e executar as instruções no Autonomous Database.

Traduzir Instruções do SQL Server para o Oracle SQL

Você pode traduzir instruções SQL gravadas no SQL Server para o Oracle SQL e executar as instruções traduzidas no Autonomous Database.

Use DBMS_CLOUD_MIGRATION.MIGRATE_SQL para traduzir uma instrução do SQL Server para o Oracle SQL. Há variantes de procedimento e função de DBMS_CLOUD_MIGRATION.MIGRATE_SQL.

Migrar Instrução do SQL Server para o Oracle SQL com o Procedimento MIGRATE_SQL

O exemplo a seguir aceita a instrução SQL gravada no SQL Server como entrada, traduz a instrução para o Oracle SQL, atribui a instrução SQL traduzida a output_sql_result e imprime o resultado:

SET SERVEROUTPUT ON
   declare output_sql_result CLOB;
BEGIN
  DBMS_CLOUD_MIGRATION.MIGRATE_SQL(      
    original_sql => 'CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));',
    output_sql   => output_sql_result,
    source_db    => 'SQLSERVER');
    DBMS_OUTPUT.PUT_LINE (output_sql_result);
END;        
/

Output
–-------------------------------------------------------------
CREATE TABLE movie (film_id NUMBER(10), title VARCHAR2(20));

O parâmetro original_sql especifica a instrução SQL do SQL Server.

O parâmetro output_sql armazena o SQL traduzido.

O parâmetro source_db especifica o banco de dados do SQL Server.

Consulte MIGRATE_SQL Procedimento e Função para obter mais informações.

Migrar Instrução do SQL Server para o Oracle SQL com a Função MIGRATE_SQL

O exemplo a seguir mostra a função DBMS_CLOUD_MIGRATION.MIGRATE_SQL em uma instrução SELECT. A entrada da função é uma instrução SQL Server e a função retorna a instrução traduzida no Oracle SQL:

SELECT DBMS_CLOUD_MIGRATION.MIGRATE_SQL(
     'CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));','SQLSERVER') AS OUTPUT 
     FROM DUAL;

OUTPUT
------------------------------------------------------------------------------
CREATE TABLE movie (film_id NUMBER(10), title VARCHAR2(20));

Use o parâmetro SQLSERVER para traduzir do Microsoft SQL Server.

Consulte MIGRATE_SQL Procedimento e Função para obter mais informações.

Observações para executar DBMS_CLOUD_MIGRATION.MIGRATE_SQL:

Executar Instruções do SQL Server no Autonomous Database

Você pode traduzir e executar interativamente instruções do SQL Server no Autonomous Database.

Use o procedimento ENABLE_TRANSLATION para ativar a tradução em tempo real de instruções SQL gravadas no SQL Server. Depois de ativar a tradução em uma sessão, as instruções SQL não Oracle são automaticamente traduzidas e executadas como instruções SQL Oracle, e você pode ver os resultados.

Por exemplo, depois de ativar a tradução executando ENABLE_TRANSLATION, você poderá fazer interativamente o seguinte em uma sessão:
  • Crie as tabelas. Por exemplo, crie as tabelas MOVIE e INVENTORY.

  • inserir dados em tabelas.

  • Tabelas de consulta.

  • Executar operações JOIN em tabelas. Por exemplo, é possível fazer uma junção externa esquerda em tabelas.

Para ativar a tradução com instruções do SQL Server e executar comandos:

  1. Conecte-se ao seu Autonomous Database usando um cliente SQL.

    Consulte Estabelecer Conexão com o Autonomous Database para obter mais informações.

    Observação

    DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION não é suportado no Database Actions e não é suportado com o Oracle APEX Service.
  2. Execute DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION para ativar a conversão de SQL em tempo real em sua sessão. Use o parâmetro SQLSERVER para traduzir do Microsoft SQL Server.
    BEGIN
     DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION('SQLSERVER');
    END;
    /

    Use a consulta a seguir para verificar a linguagem de tradução SQL da sua sessão:

    SELECT SYS_CONTEXT('USERENV','SQL_TRANSLATION_PROFILE_NAME') FROM DUAL;

    Consulte Procedimento ENABLE_TRANSLATION para obter mais informações.

  3. Insira instruções SQL do SQL Server. Por exemplo:
    CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));
    
    Table [dbo].[movie] created.

    Isso traduz e executa automaticamente a instrução CREATE TABLE do SQL Server.

    Você pode verificar usando o comando DESC. Por exemplo:
    DESC movie;
    
    Name        Null?     Type          
    -------     -----     ------------- 
    FILM_ID               NUMBER(38)    
    TITLE                 VARCHAR2(255)
    A tabela MOVIE é criada e os tipos de dados de cada coluna são convertidos automaticamente em tipos de dados Oracle.
  4. Insira dados na tabela MOVIE. Por exemplo:
    INSERT INTO movie([film_id], [title]) VALUES (123, 'Tangled');
    
    1 row inserted.
    
    INSERT INTO movie([film_id], [title]) VALUES (234, 'Frozen');
    
    1 row inserted.

    Verifique a inserção de dados consultando a tabela MOVIE. Por exemplo:

    SELECT * FROM movie;
    
    FILM_ID  TITLE
    –------- –--------
    123	 Tangled
    234	 Frozen
    
  5. Crie uma tabela INVENTORY:
    CREATE TABLE [dbo].[inventory] ([film_id] [int], [title] [inventory_id](20));
    
    
    Table INVENTORY created.
    Você pode verificar essa etapa com o comando DESC. Por exemplo:
    DESC inventory;
    
    Name        Null?     Type          
    -------     -----     ------------- 
    FILM_ID               NUMBER(38)    
    INVENTORY_ID          NUMBER(38)
    A tabela INVENTORY é criada e os tipos de dados de cada coluna são convertidos automaticamente em tipos de dados Oracle.
  6. Insira dados na tabela INVENTORY. Por exemplo:
    INSERT INTO inventory([film_id], [inventory_id]) VALUES (123, 223);
    
    1 row inserted.
    
    INSERT INTO inventory(film_id, inventory_id) VALUES (234, 334);
    
    1 row inserted.

    Verifique a inserção de dados consultando INVENTORY. Por exemplo:

    SELECT * FROM inventory;
    
    FILM_ID  INVENTORY_ID
    –------- –------------
    123	 223
    234	 334
  7. Execute uma junção externa esquerda nas tabelas MOVIE e INVENTORY:
    SELECT m.film_id, m.title, inventory.inventory_id 
        FROM movie AS m LEFT JOIN inventory 
        ON inventory.film_id = m.film_id;
    
      FILM_ID  TITLE       INVENTORY_ID
    ---------- ---------- ------------
           234 Frozen      334
           123 Tangled     223
    

    Este exemplo executa um LEFT OUTER JOIN nas tabelas movie e inventory. A consulta é primeiro traduzida para o Oracle SQL e, em seguida, executada na sua sessão.

  8. Use o procedimento DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION para desativar a tradução de linguagem SQL em tempo real para sua sessão.
    BEGIN
     DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
    END;
    /

    Isso retornará um erro se a tradução do idioma SQL não estiver ativada para sua sessão.

    Consulte DISABLE_TRANSLATION Procedimento

Você pode consultar a view V$MAPPED_SQL para listar as instruções do SQL Server que são traduzidas e mapeadas na memória para instruções do Oracle SQL.

Por exemplo:

SELECT v.* 
    FROM v$mapped_sql v, dba_objects o
    WHERE v.sql_translation_profile_id = o.object_id
        AND o.object_name = 'SQLSERVER'
        AND o.object_type = 'TRANSLATION PROFILE';
Consulte V$MAPPED_SQL para obter mais informações.

Migrar Arquivos do SQL Server para o Oracle SQL

Você pode migrar um arquivo contendo instruções SQL Server para um arquivo contendo instruções Oracle SQL.

O procedimento DBMS_CLOUD_MIGRATION.MIGRATE_FILE traduz instruções SQL em um arquivo do SQL Server no Object Storage e gera um novo arquivo contendo o Oracle SQL.

Como pré-requisito, faça upload de um ou mais arquivos do SQL Server com uma extensão .sql para um local no Object Storage. Os exemplos a seguir usam o arquivo mssqltest.sql submetido a upload para o Object Storage. Consulte Colocar dados no armazenamento de objetos para obter mais informações.

Para migrar arquivos do SQL Server para o Oracle SQL:

  1. Conecte-se à sua instância do Autonomous Database.

    Consulte Estabelecer Conexão com o Autonomous Database para obter mais informações.

  2. Configure o acesso ao Cloud Object Storage usando um controlador de recursos ou criando um objeto de credencial.

    Esta etapa fornece acesso ao Cloud Object Storage no qual você coloca os arquivos que está migrando:

  3. Opcionalmente, você pode listar os arquivos no Object Storage. Por exemplo:
    VAR function_list CLOB;
    SELECT object_name FROM DBMS_CLOUD.LIST_OBJECTS
       (credential_name => 'OCI$RESOURCE_PRINCIPAL', location_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files');
    
    OBJECT_NAME
    ---------------------
    mssqltest.sql
    

    Como alternativa, se você criar uma credencial em vez do controlador de recursos, OCI$RESOURCE_PRINCIPAL, especifique o nome da credencial no parâmetro credential_name.

    Consulte Função LIST_OBJECTS para obter mais informações.

  4. Execute DBMS_CLOUD_MIGRATION.MIGRATE_FILE para migrar o arquivo do SQL Server para o Oracle SQL:
    BEGIN
     DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
         credential_name => 'OCI$RESOURCE_PRINCIPAL',
         location_uri    => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files/mssqltest.sql',
         source_db       => 'SQLSERVER'
        );
    END;
    /

    O parâmetro credential_name especifica a credencial para acessar o URI do Cloud Object Storage. O usuário que executa DBMS_CLOUD_MIGRATION.MIGRATE_FILE deve ter o privilégio EXECUTE para o objeto de credencial usado para acessar o URI do Object Storage. Ou seja, a credencial especificada com o parâmetro credential_name. Se você usar uma credencial em vez de um controlador de recursos, especifique o nome da credencial no parâmetro credential_name.

    O parâmetro location_uri especifica o URI do arquivo de origem. O formato do URI depende do serviço Cloud Object Storage que você está usando. Consulte DBMS_CLOUD Formatos de URI para obter mais informações.

    O parâmetro source_db especifica o SQL Server como a linguagem do banco de dados. Use o valor SQLSERVER para converter arquivos do SQL Server para o Oracle SQL.

    A execução desse comando traduz o arquivo do SQL Server mssqltest.sql para o Oracle SQL e gera um novo arquivo com o nome original_filename_oracle.sql.

    Para este exemplo, a execução de DBMS_CLOUD_MIGRATION.MIGRATE_FILE com o arquivo de entrada mssqltest.sql gera mssqltest_oracle.sql. Após a etapa de tradução, o procedimento faz upload de mssqltest_oracle.sql para o Object Storage.

    Opcionalmente, use o parâmetro target_uri para especificar o local em que o upload do arquivo traduzido é feito. O valor padrão desse parâmetro é NULL, o que significa que o upload do arquivo traduzido é feito na mesma localização especificada no parâmetro location_uri.

    Consulte Procedimento MIGRATE_FILE para obter mais informações.

  5. Verifique se o arquivo de saída foi gerado.
    SELECT object_name FROM DBMS_CLOUD.LIST_OBJECTS (
        credential_name => 'OCI$RESOURCE_PRINCIPAL', location_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files');
    
    OBJECT_NAME
    ---------------------
    mssqltest.sql
    mssqltest_oracle.sql
    

    Como alternativa, se você criar uma credencial em vez do controlador de recursos, OCI$RESOURCE_PRINCIPAL, especifique o nome da credencial no parâmetro credential_name.

    Consulte Função LIST_OBJECTS para obter mais informações.

Execute a consulta a seguir para exibir o conteúdo do arquivo mssqltest_oracle.sql:

SELECT UTL_RAW.CAST_TO_VARCHAR2 (DBMS_CLOUD.GET_OBJECT(
   credential_name => 'OCI$RESOURCE_PRINCIPAL', 
   object_uri => 'https://objectstorage.region.oraclecloud.com/n/namespace/b/bucket/o/files')) 
FROM dual;

UTL_RAW.CAST_TO_VARCHAR2(DBMS_CLOUD.GET_OBJECT(CREDENTIAL_NAME=>'CRED1',OBJECT_U
--------------------------------------------------------------------------------
DROP TABLE movie;
CREATE TABLE movie (film_id NUMBER(10), title VARCHAR2(20));
 
INSERT INTO movie (film_id, title) VALUES (123, 'Tangled');
INSERT INTO movie (film_id, title) VALUES (234, 'Frozen');
 
CREATE TABLE inventory(film_id NUMBER(10), inventory_id NUMBER(10));
INSERT INTO inventory(film_id, inventory_id) VALUES (123, 223);
INSERT INTO inventory(film_id, inventory_id) VALUES (234, 334);
 
SELECT * FROM movie;
SELECT * FROM inventory;
SELECT m.film_id, m.title, inventory_id FROM movie m LEFT JOIN inventory ON inventory.film_id = m.film_id;

Como alternativa, se você criar uma credencial em vez do controlador de recursos, OCI$RESOURCE_PRINCIPAL, especifique o nome da credencial no parâmetro credential_name.

Consulte GET_OBJECT Procedimento e Função para obter mais informações.

Limitações para Migração e Tradução de Instruções do SQL Server para o Oracle SQL

Esta seção resume as limitações para migrar instruções SQL do SQL Server para o Oracle SQL.

A seguinte lista de funções do SQL Server não é suportada ao migrar do sabor do banco de dados do SQL Server para o Oracle SQL:
  • ISJSON()

  • OPENJSON()