Esegui migrazione delle applicazioni dai database SQL Server ad Autonomous Database

È possibile eseguire la migrazione delle istruzioni SQL da SQL Server a Oracle SQL ed eseguire le istruzioni su Autonomous Database.

Traduci istruzioni SQL Server in Oracle SQL

È possibile tradurre le istruzioni SQL scritte in SQL Server in Oracle SQL ed eseguire le istruzioni tradotte in Autonomous Database.

Utilizzare DBMS_CLOUD_MIGRATION.MIGRATE_SQL per tradurre un'istruzione SQL Server in Oracle SQL. Esistono varianti di procedura e di funzione di DBMS_CLOUD_MIGRATION.MIGRATE_SQL.

Esegui migrazione dell'istruzione SQL Server a Oracle SQL con la procedura MIGRATE_SQL

L'esempio seguente accetta l'istruzione SQL scritta in SQL Server come input, converte l'istruzione in Oracle SQL, assegna l'istruzione SQL tradotta a output_sql_result e stampa il risultato:

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));

Il parametro original_sql specifica l'istruzione SQL di SQL Server.

Il parametro output_sql memorizza l'istruzione SQL tradotta.

Il parametro source_db specifica il database di SQL Server.

Per ulteriori informazioni, vedere MIGRATE_SQL Procedura e funzione.

Esegui migrazione dell'istruzione SQL Server a Oracle SQL con la funzione MIGRATE_SQL

L'esempio seguente mostra la funzione DBMS_CLOUD_MIGRATION.MIGRATE_SQL all'interno di un'istruzione SELECT. L'input della funzione è un'istruzione SQL Server e la funzione restituisce l'istruzione tradotta in 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));

Utilizzare il parametro SQLSERVER per eseguire la conversione da Microsoft SQL Server.

Per ulteriori informazioni, vedere MIGRATE_SQL Procedura e funzione.

Note per l'esecuzione di DBMS_CLOUD_MIGRATION.MIGRATE_SQL:

Esegui istruzioni SQL Server in Autonomous Database

È possibile tradurre ed eseguire istruzioni SQL Server in modo interattivo in Autonomous Database.

Utilizzare la procedura ENABLE_TRANSLATION per abilitare la traduzione in tempo reale delle istruzioni SQL scritte in SQL Server. Dopo aver abilitato la traduzione in una sessione, le istruzioni SQL non Oracle vengono tradotte ed eseguite automaticamente come istruzioni SQL Oracle ed è possibile visualizzare i risultati.

Ad esempio, dopo aver abilitato la traduzione eseguendo ENABLE_TRANSLATION è possibile eseguire in modo interattivo le operazioni riportate di seguito in una sessione.
  • Creare le tabelle. Ad esempio, creare le tabelle MOVIE e INVENTORY.

  • Inserisci i dati nelle tabelle.

  • Tabelle di query.

  • Eseguire operazioni JOIN sulle tabelle. Ad esempio, è possibile eseguire un outer join sinistro sulle tabelle.

Per abilitare la traduzione con le istruzioni SQL Server ed eseguire i comandi:

  1. Connettersi all'Autonomous Database utilizzando un client SQL.

    Per ulteriori informazioni, consulta la sezione relativa alla connessione ad Autonomous Database.

    Nota

    DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION non è supportato in Database Actions e non è supportato con Oracle APEX Service.
  2. Eseguire DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION per abilitare la traduzione SQL in tempo reale nella sessione. Utilizzare il parametro SQLSERVER per eseguire la conversione da Microsoft SQL Server.
    BEGIN
     DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION('SQLSERVER');
    END;
    /

    Utilizzare la query seguente per verificare la lingua di traduzione SQL per la sessione:

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

    Per ulteriori informazioni, vedere ENABLE_TRANSLATION Procedura.

  3. Immettere le istruzioni SQL di SQL Server. Ad esempio:
    CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));
    
    Table [dbo].[movie] created.

    Questa operazione traduce ed esegue automaticamente l'istruzione CREATE TABLE di SQL Server.

    È possibile verificare utilizzando il comando DESC. Ad esempio:
    DESC movie;
    
    Name        Null?     Type          
    -------     -----     ------------- 
    FILM_ID               NUMBER(38)    
    TITLE                 VARCHAR2(255)
    Viene creata la tabella MOVIE e i tipi di dati di ciascuna colonna vengono convertiti automaticamente in tipi di dati Oracle.
  4. Inserire i dati nella tabella MOVIE. Ad esempio:
    INSERT INTO movie([film_id], [title]) VALUES (123, 'Tangled');
    
    1 row inserted.
    
    INSERT INTO movie([film_id], [title]) VALUES (234, 'Frozen');
    
    1 row inserted.

    Verificare l'inserimento dei dati eseguendo una query sulla tabella MOVIE. Ad esempio:

    SELECT * FROM movie;
    
    FILM_ID  TITLE
    –------- –--------
    123	 Tangled
    234	 Frozen
    
  5. Creare una tabella INVENTORY:
    CREATE TABLE [dbo].[inventory] ([film_id] [int], [title] [inventory_id](20));
    
    
    Table INVENTORY created.
    È possibile verificare questo passo con il comando DESC. Ad esempio:
    DESC inventory;
    
    Name        Null?     Type          
    -------     -----     ------------- 
    FILM_ID               NUMBER(38)    
    INVENTORY_ID          NUMBER(38)
    Viene creata la tabella INVENTORY e i tipi di dati di ciascuna colonna vengono convertiti automaticamente in tipi di dati Oracle.
  6. Inserire i dati nella tabella INVENTORY. Ad esempio:
    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.

    Verificare l'inserimento dei dati eseguendo una query su INVENTORY. Ad esempio:

    SELECT * FROM inventory;
    
    FILM_ID  INVENTORY_ID
    –------- –------------
    123	 223
    234	 334
  7. Eseguire un outer join sinistro sulle tabelle 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
    

    In questo esempio viene eseguito un comando LEFT OUTER JOIN sulle tabelle movie e inventory. La query viene tradotta in Oracle SQL e quindi eseguita nella sessione.

  8. Utilizzare la procedura DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION per disabilitare la traduzione in tempo reale della lingua SQL per la sessione.
    BEGIN
     DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
    END;
    /

    Viene restituito un errore se la traduzione della lingua SQL non è abilitata per la sessione.

    Vedere DISABLE_TRANSLATION Procedura

È possibile eseguire una query sulla vista V$MAPPED_SQL per elencare le istruzioni SQL Server convertite e mappate in memoria alle istruzioni Oracle SQL.

Ad esempio:

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';
Per ulteriori informazioni, vedere V$MAPPED_SQL.

Migrazione dei file SQL Server in Oracle SQL

È possibile eseguire la migrazione di un file contenente istruzioni SQL Server in un file contenente istruzioni SQL Oracle.

La procedura DBMS_CLOUD_MIGRATION.MIGRATE_FILE converte le istruzioni SQL in un file SQL Server nello storage degli oggetti e genera un nuovo file contenente Oracle SQL.

Come prerequisito, caricare uno o più file di SQL Server con estensione .sql in una posizione nello storage degli oggetti. Gli esempi riportati di seguito utilizzano il file mssqltest.sql caricato nello storage degli oggetti. Per ulteriori informazioni, vedere Inserire i dati nello storage degli oggetti.

Per eseguire la migrazione dei file di SQL Server in Oracle SQL, procedere come segue.

  1. Connettersi all'istanza di Autonomous Database.

    Per ulteriori informazioni, consulta la sezione relativa alla connessione ad Autonomous Database.

  2. Configura l'accesso allo storage degli oggetti cloud utilizzando un principal risorsa o creando un oggetto credenziali.

    Questo passo consente di accedere allo storage degli oggetti cloud in cui inserire i file di cui si sta eseguendo la migrazione:

  3. Facoltativamente, è possibile elencare i file nello storage degli oggetti. Ad esempio:
    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
    

    In alternativa, se si crea una credenziale al posto del principal risorsa, OCI$RESOURCE_PRINCIPAL, specificare il nome della credenziale nel parametro credential_name.

    Per ulteriori informazioni, vedere LIST_OBJECTS Funzione.

  4. Eseguire DBMS_CLOUD_MIGRATION.MIGRATE_FILE per eseguire la migrazione del file SQL Server in 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;
    /

    Il parametro credential_name specifica la credenziale per accedere all'URI di storage degli oggetti cloud. L'utente che esegue DBMS_CLOUD_MIGRATION.MIGRATE_FILE deve disporre del privilegio EXECUTE per l'oggetto credenziale utilizzato per accedere all'URI dello storage degli oggetti. Cioè, la credenziale specificata con il parametro credential_name. Se si utilizza una credenziale anziché un principal risorsa, specificare il nome della credenziale nel parametro credential_name.

    Il parametro location_uri specifica l'URI del file di origine. Il formato dell'URI dipende dal servizio di storage degli oggetti cloud in uso. Per ulteriori informazioni, vedere DBMS_CLOUD Formati URI.

    Il parametro source_db specifica SQL Server come lingua del database. Utilizzare il valore SQLSERVER per tradurre i file di SQL Server in Oracle SQL.

    L'esecuzione di questo comando converte il file SQL Server mssqltest.sql in Oracle SQL e genera un nuovo file con il nome original_filename_oracle.sql.

    Per questo esempio, l'esecuzione di DBMS_CLOUD_MIGRATION.MIGRATE_FILE con il file di input mssqltest.sql genera mssqltest_oracle.sql. Dopo il passo di traduzione, la procedura carica mssqltest_oracle.sql nello storage degli oggetti.

    Facoltativamente, utilizzare il parametro target_uri per specificare la posizione in cui viene caricato il file tradotto. Il valore predefinito per questo parametro è NULL, ovvero il file tradotto viene caricato nella stessa posizione specificata nel parametro location_uri.

    Per ulteriori informazioni, vedere MIGRATE_FILE Procedura.

  5. Verificare che il file di output sia stato generato.
    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
    

    In alternativa, se si crea una credenziale al posto del principal risorsa, OCI$RESOURCE_PRINCIPAL, specificare il nome della credenziale nel parametro credential_name.

    Per ulteriori informazioni, vedere LIST_OBJECTS Funzione.

Eseguire la query seguente per visualizzare il contenuto del file 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;

In alternativa, se si crea una credenziale al posto del principal risorsa, OCI$RESOURCE_PRINCIPAL, specificare il nome della credenziale nel parametro credential_name.

Per ulteriori informazioni, vedere GET_OBJECT Procedure.

Limitazioni per la migrazione e la conversione delle istruzioni SQL Server in Oracle SQL

In questa sezione vengono riepilogate le limitazioni per la migrazione delle istruzioni SQL da SQL Server a Oracle SQL.

La seguente lista di funzioni di SQL Server non è supportata durante la migrazione dal database SQL Server a Oracle SQL:
  • ISJSON()

  • OPENJSON()