Eseguire la migrazione delle applicazioni dai database PostgreSQL ad Autonomous Database

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

Tradurre le istruzioni PostgreSQL in Oracle SQL
È possibile tradurre le istruzioni SQL scritte in PostgreSQL in Oracle SQL ed eseguire le istruzioni tradotte in Autonomous Database.
Eseguire le istruzioni PostgreSQL in Autonomous Database
È possibile tradurre ed eseguire in modo interattivo le istruzioni PostgreSQL in Autonomous Database.
Eseguire la migrazione di file PostgreSQL in Oracle SQL
È possibile eseguire la migrazione di un file contenente istruzioni PostgreSQL in un file contenente istruzioni Oracle SQL.
Limitazioni per la migrazione e la conversione delle istruzioni PostgreSQL in Oracle SQL
In questa sezione vengono riepilogate le limitazioni per la migrazione delle istruzioni SQL da PostgreSQL a Oracle SQL.

Argomento padre: migrazione delle applicazioni da SQL non Oracle a Oracle SQL

Traduci le istruzioni PostgreSQL in Oracle SQL

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

Utilizzare DBMS_CLOUD_MIGRATION.MIGRATE_SQL per convertire l'istruzione PostgreSQL in Oracle SQL. Esistono varianti di procedura e di funzione di DBMS_CLOUD_MIGRATION.MIGRATE_SQL.

Eseguire la migrazione dell'istruzione PostgreSQL in Oracle SQL con la procedura MIGRATE_SQL

L'esempio seguente accetta l'istruzione SQL scritta in PostgreSQL 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 => 'SELECT e.employee_id, e.last_name, e.salary FROM employees AS e;',
    output_sql   => output_sql_result,
    source_db    => 'POSTGRES');
    DBMS_OUTPUT.PUT_LINE (output_sql_result);
END;        
/

Output
–-------------------------------------------------------------
SELECT e.employee_id, e.last_name, e.salary FROM employees e;

Il parametro original_sql specifica l'istruzione PostgreSQL.

Il parametro output_sql memorizza l'istruzione SQL tradotta.

Il parametro source_db specifica il nome del database PostgreSQL.

Per ulteriori informazioni, vedere MIGRATE_SQL Procedura e funzione.

Eseguire la migrazione dell'istruzione PostgreSQL in 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 PostgreSQL e la funzione restituisce l'istruzione tradotta in Oracle SQL:

SELECT DBMS_CLOUD_MIGRATION.MIGRATE_SQL(
     'CREATE TABLE IF NOT EXISTS cars (brand VARCHAR(255), model VARCHAR(255), year INT)',
     'POSTGRES') AS output FROM DUAL;

OUTPUT
------------------------------------------------------------------------------
create table cars (brand VARCHAR2(255), model VARCHAR2(255), year NUMBER(10);

Per ulteriori informazioni, vedere MIGRATE_SQL Procedura e funzione.

Note per l'esecuzione di DBMS_CLOUD_MIGRATION.MIGRATE_SQL:

È possibile che si verifichi un errore durante la traduzione se l'istruzione SQL di input non è supportata in Oracle SQL. Per ulteriori informazioni, vedere Limitazioni per la migrazione e la traduzione delle istruzioni PostgreSQL in Oracle SQL.
I sottoprogrammi DBMS_CLOUD_MIGRATION.MIGRATE_SQL accettano solo un'istruzione SQL come input. È quindi possibile tradurre una sola istruzione SQL per chiamata.

Argomento padre: migrazione delle applicazioni dai database PostgreSQL ad Autonomous Database

Eseguire le istruzioni PostgreSQL in Autonomous Database

È possibile tradurre ed eseguire in modo interattivo le istruzioni PostgreSQL in Autonomous Database.

Utilizzare la procedura ENABLE_TRANSLATION per abilitare la traduzione in tempo reale delle istruzioni SQL scritte in PostgreSQL. Dopo aver abilitato la traduzione in una sessione, le istruzioni PostgreSQL vengono convertite ed eseguite automaticamente come istruzioni Oracle SQL 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 PostgreSQL ed eseguire i comandi:

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.
Eseguire DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION per abilitare la traduzione SQL in tempo reale nella sessione.
```
BEGIN
 DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION('POSTGRES');
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.
Immettere le istruzioni PostgreSQL. Ad esempio:
```
CREATE TABLE movie (film_id int, title varchar(255));

Table MOVIE created.
```
Questa operazione traduce ed esegue automaticamente l'istruzione PostgreSQL CREATE TABLE.
È 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.
È possibile che si verifichi un errore durante la traduzione se l'istruzione SQL di input non è supportata. Per ulteriori informazioni, vedere Limitazioni per la migrazione e la traduzione delle istruzioni PostgreSQL in Oracle SQL.

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

Creare una tabella INVENTORY:

CREATE TABLE inventory (film_id int, inventory_id int);

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.

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

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 parola chiave AS per gli alias di tabella nella clausola FROM non è supportata in Oracle SQL. La query viene tradotta in Oracle SQL e quindi eseguita nella sessione.
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 PostgreSQL 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 = 'POSTGRES'
        AND o.object_type = 'TRANSLATION PROFILE';

Per ulteriori informazioni, vedere V$MAPPED_SQL.

Argomento padre: migrazione delle applicazioni dai database PostgreSQL ad Autonomous Database

Eseguire la migrazione dei file PostgreSQL in Oracle SQL

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

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

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

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

Connettersi all'istanza di Autonomous Database.

Per ulteriori informazioni, consulta la sezione relativa alla connessione ad Autonomous Database.
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:
- 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 relativa all'uso del principal delle risorse per accedere alle risorse di Oracle Cloud Infrastructure e all'uso del principal delle risorse 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 Configura criteri e ruoli per accedere alle risorse.
- Creare una credenziale per accedere allo storage degli oggetti cloud:
  
  Puoi 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 Procedura.
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
---------------------
postgrestest.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 Function.
Eseguire DBMS_CLOUD_MIGRATION.MIGRATE_FILE per eseguire la migrazione del file PostgreSQL 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/postgrestest.sql',
     source_db       => 'POSTGRES'
    );
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. Vedere DBMS_CLOUD Formati URI per ulteriori informazioni.

Il parametro source_db specifica PostgreSQL come lingua del database. Utilizzare il valore POSTGRES per tradurre i file PostgreSQL in Oracle SQL.
L'esecuzione di questo comando converte il file PostgreSQL postgrestest.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 postgrestest.sql genera postgrestest_oracle.sql. Dopo il passo di traduzione, la procedura carica postgrestest_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.
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
---------------------
postgrestest.sql
postgrestest_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 Function.

Eseguire la query seguente per visualizzare il contenuto del file postgrestest_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
--------------------------------------------------------------------------------
SELECT f.film_id, f.title, inventory_id
FROM film f LEFT JOIN inventory
ON inventory.film_id = f.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.

Argomento padre: migrazione delle applicazioni dai database PostgreSQL ad Autonomous Database

Limitazioni per la migrazione e la conversione delle dichiarazioni PostgreSQL in Oracle SQL

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

La lista di istruzioni PostgreSQL riportata di seguito non è supportata durante la migrazione ad Autonomous Database.

CREATE DOMAIN
CREATE EXTENSION
CREATE DATABASE
CREATE TYPE
SET

L'elenco di istruzioni PostgreSQL riportato di seguito è supportato con limitazioni.

ALTER TABLE: solo ALTER TABLE ADD CONSTRAINT è supportato durante la migrazione ad Autonomous Database.
DELETE: la parola chiave RETURNING * nell'istruzione DELETE non è supportata in Autonomous Database. È necessario sostituire la clausola RETURNING * con la clausola RETURNING INTO. Ad esempio, DELETE FROM tasks WHERE status = 'DONE' RETURNING *;.
Per ulteriori informazioni, vedere RESTituzione della clausola.
CREATE FUNCTION: i seguenti elementi non sono supportati con CREATE FUNCTION:
- Il tipo restituito da SETOF è necessario sostituire SETOF con i tipi restituiti CURSORS o COLLECTIONS.
- La clausola IMMUTABLE.
- Dichiarazioni dei parametri nel formato FUNCTION_NAME (DATATYPE, DATATYPE).
ALTER FUNCTION: gli argomenti della funzione ALTER FUNCTION, ad esempio RENAME TO, OWNER TO e SET SCHEMA, non sono supportati.

Argomento padre: migrazione delle applicazioni dai database PostgreSQL ad Autonomous Database

Documentazione di Oracle Cloud Infrastructure