Esegui migrazione applicazioni da database SQL Server ad Autonomous Database

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

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

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

Puoi tradurre ed eseguire in modo interattivo le istruzioni di SQL Server in Autonomous Database.

1. Connettersi ad Autonomous Database utilizzando un client SQL.

   See Connect to Autonomous Database for more information.

   Nota
   
   DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION non è supportato in Database Actions e non è supportato in 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 Procedure.

3. Immettere le istruzioni SQL di SQL Server. Ad esempio:

   CREATE TABLE [dbo].[movie] ([film_id] [int], [title] [varchar](20));
   
   Table [dbo].[movie] created.

   Ciò 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 nei 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 passaggio 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 nei 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 valore LEFT OUTER JOIN nelle tabelle movie e inventory. La query viene prima tradotta in Oracle SQL e quindi eseguita nella sessione.

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

   BEGIN
    DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION;
   END;
   /

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

   Vedere DISABLE_TRANSLATION Procedura

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

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

1. Connettersi all'istanza di Autonomous Database.

   See Connect to Autonomous Database for more information.

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

   Questo passo fornisce l'accesso allo storage degli oggetti cloud in cui vengono inseriti i file di cui si sta eseguendo la migrazione:

   • Utilizzare un principal risorsa per accedere allo storage degli oggetti cloud:

     Definisci criteri e ruoli per accedere a Oracle Cloud Infrastructure Object Storage con un principal risorsa. Per ulteriori informazioni, consulta la sezione Usa principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure e Usa principal risorsa con DBMS_CLOUD.

     Se i file risiedono nello storage degli oggetti cloud di un altro fornitore, definire i criteri e i ruoli appropriati per accedere alla risorsa. Per ulteriori informazioni, vedere Configurare criteri e ruoli per accedere alle risorse.

   • Creare una credenziale per accedere allo storage degli oggetti cloud:

     È possibile creare una credenziale per accedere allo storage degli oggetti cloud.

     Ad esempio:

     BEGIN
       DBMS_CLOUD.CREATE_CREDENTIAL (
         credential_name => 'OBJ_STORE_CRED',
         username        => 'user1@example.com',
         password        => 'password'
       );
     END;
     /
     

     Per ulteriori informazioni, vedere CREATE_CREDENTIAL Procedure.

3. Facoltativamente, puoi 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 anziché il principal risorsa, OCI$RESOURCE_PRINCIPAL, specificare il nome della credenziale nel parametro credential_name.

   Per ulteriori informazioni, vedere LIST_OBJECTS Function.

4. Eseguire DBMS_CLOUD_MIGRATION.MIGRATE_FILE per eseguire la migrazione del file SQL Server a 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 dello 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è, le credenziali specificate 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 convertire 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 denominato 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 Procedure.

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 anziché il principal risorsa, OCI$RESOURCE_PRINCIPAL, specificare il nome della credenziale nel parametro credential_name.

   Per ulteriori informazioni, vedere LIST_OBJECTS Function.

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;

Questa sezione riassume le limitazioni per la migrazione delle istruzioni SQL da SQL Server a Oracle SQL.