Pacchetto DBMS_CLOUD

Pacchetto DBMS_CLOUD_MIGRATION

Il package DBMS_CLOUD_MIGRATION facilita la traduzione del codice SQL da un'architettura SQL non Oracle a Oracle SQL.

Riepilogo dei sottoprogrammi DBMS_CLOUD_MIGRATION
Questa tabella contiene un riepilogo dei sottoprogrammi inclusi nel package DBMS_CLOUD_MIGRATION.

Argomento padre: riferimento al package fornito da Autonomous Database

Riepilogo dei sottoprogrammi DBMS_CLOUD_MIGRATION

La tabella seguente contiene un riepilogo dei sottoprogrammi inclusi nel pacchetto DBMS_CLOUD_MIGRATION.

Programma secondario	descrizione;
MIGRATE_SQL Procedura e funzione	`MIGRATE_SQL` facilita la traduzione di istruzioni SQL scritte in istruzioni SQL non Oracle in Oracle SQL. Le versioni SQL supportate sono PostgreSQL, MySQL e SQL Server.
MIGRATE_FILE Procedura	Questa procedura converte un file contenente istruzioni SQL da un database di origine specificato come input e converte le istruzioni SQL in Oracle SQL.
ENABLE_TRANSLATION Procedura	Questa procedura consente la traduzione SQL in tempo reale e l'esecuzione di istruzioni SQL non Oracle in un Autonomous Database. Le versioni SQL supportate sono PostgreSQL, MySQL e SQL Server.
DISABLE_TRANSLATION Procedura	Questa procedura disabilita la traduzione della lingua SQL.

MIGRATE_SQL Procedura e funzione
Il comando MIGRATE_SQL facilita la traduzione delle istruzioni SQL scritte in istruzioni SQL non Oracle in Oracle SQL. Questa procedura è sovraccaricata e ha varianti di funzione e procedura.
MIGRATE_FILE Procedura
MIGRATE_FILE accetta come input un file contenente istruzioni SQL da un database di origine specificato e converte le istruzioni SQL in Oracle SQL.
ENABLE_TRANSLATION Procedura
La procedura ENABLE_TRANSLATION consente la traduzione SQL in tempo reale e l'esecuzione di istruzioni SQL non Oracle in Autonomous Database.
DISABLE_TRANSLATION Procedura
La procedura DISABLE_TRANSLATION disabilita la traduzione della lingua SQL. Viene restituito un errore se la traduzione della lingua SQL non è abilitata per la sessione.

Argomento padre: DBMS_CLOUD_MIGRATION Package

MIGRATE_SQL Procedura e funzione

MIGRATE_SQL facilita la traduzione di istruzioni SQL scritte in istruzioni SQL non Oracle in Oracle SQL. Questa procedura è sovraccaricata e ha varianti di funzione e procedura.

Sintassi

DBMS_CLOUD_MIGRATION.MIGRATE_SQL (
   original_sql  IN  CLOB,
   output_sql    OUT CLOB,
   source_db     IN  VARCHAR2);

DBMS_CLOUD_MIGRATION.MIGRATE_SQL (
   original_sql  IN  CLOB,
   source_db     IN  VARCHAR2);
RETURN CLOB;

Parametri

Parametro descrizione;

Parametro	descrizione;
`original_sql`	Specifica l'istruzione SQL originale nel database di origine che deve essere tradotta in Oracle SQL. Questo parametro è obbligatorio.
`output_sql`	Restituisce l'istruzione SQL tradotta. Questo parametro è obbligatorio.
`source_db`	Specifica il nome del database di origine. I valori validi per questo parametro sono `POSTGRES`, `MYSQL`, `SQLSERVER`. Questo parametro è obbligatorio.

original_sql

Specifica l'istruzione SQL originale nel database di origine che deve essere tradotta in Oracle SQL.

Questo parametro è obbligatorio.

output_sql

Restituisce l'istruzione SQL tradotta.

Questo parametro è obbligatorio.

source_db

Specifica il nome del database di origine. I valori validi per questo parametro sono POSTGRES, MYSQL, SQLSERVER.

Questo parametro è obbligatorio.

Valori restituiti

Il form funzione DBMS_CLOUD_MIGRATION.MIGRATE_SQL restituisce un CLOB contenente la versione Oracle SQL tradotta dell'input ORIGINAL_SQL.

Note per uso

È possibile che si verifichi un errore durante la traduzione se l'istruzione SQL di input non è supportata in Oracle SQL. Per ulteriori informazioni, vedere gli argomenti riportati di seguito.
I sottoprogrammi DBMS_CLOUD_MIGRATION.MIGRATE_SQL accettano solo un'istruzione SQL come input. È quindi possibile tradurre una sola istruzione SQL per chiamata.
Per eseguire la procedura DBMS_CLOUD_MIGRATION.MIGRATE_SQL, è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE nel pacchetto DBMS_CLOUD_MIGRATION.

Esempi

Form della procedura DBMS_CLOUD_MIGRATION.MIGRATE_SQL per convertire l'istruzione PostgreSQL in Oracle SQL:

BEGIN
  DBMS_CLOUD_MIGRATION.MIGRATE_SQL(      
    original_sql => 'SELECT e.employee_id, e.last_name, e.salary FROM employees AS e;',
    output_sql   => output_variable,
    source_db    => 'POSTGRES');
END;        
/

Form della funzione DBMS_CLOUD_MIGRATION.MIGRATE_SQL per convertire l'istruzione PostgreSQL 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);

Argomento padre: Riepilogo dei sottoprogrammi DBMS_CLOUD_MIGRATION

MIGRATE_FILE Procedura

MIGRATE_FILE accetta come input un file contenente istruzioni SQL da un database di origine specificato e converte le istruzioni SQL in Oracle SQL.

Sintassi

DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
    credential_name  IN VARCHAR2,
    location_uri     IN VARCHAR2,
    target_uri       IN VARCHAR2 DEFAULT NULL,
    source_db        IN VARCHAR2,
    params           IN CLOB

Parametri

Parametro	descrizione;
`credential_name`	Il nome della credenziale per accedere allo storage degli oggetti cloud. Questo parametro è obbligatorio. Facoltativamente, la credenziale utilizzata per accedere all'area di memorizzazione degli oggetti cloud può essere definita configurando criteri e ruoli. Per ulteriori informazioni, vedere Configura criteri e ruoli per accedere alle risorse.
`location_uri`	L'URI del file di origine. Il formato dell'URI dipende dal servizio di storage degli oggetti cloud in uso. Per i dettagli, vedere DBMS_CLOUD Formati URI. Questo parametro è obbligatorio.
`target_uri`	URI del file di destinazione, in cui deve essere memorizzato il file tradotto. Se non si specifica un valore per questo parametro, il file tradotto viene memorizzato nella stessa posizione del file di origine. Il formato dell'URI dipende dal servizio di storage degli oggetti cloud in uso. Per i dettagli, vedere DBMS_CLOUD Formati URI.
`source_db`	Specifica la lingua del database di origine. I valori validi per questo parametro sono `POSTGRES`, `MYSQL`, `SQLSERVER`. Questo parametro è obbligatorio.
`params`	Specifica i parametri aggiuntivi che possono essere passati in formato JSON.

Note per uso

Per eseguire DBMS_CLOUD_MIGRATION.MIGRATE_FILE è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_MIGRATION.
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.must 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.

Esempio

BEGIN
 DBMS_CLOUD_MIGRATION.MIGRATE_FILE (
     credential_name => 'OBJ_STORE_CRED',
     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.

location_uri è 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.

In questo esempio, namespace-string è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Informazioni sugli spazi di nomi dello storage degli oggetti.

Argomento padre: Riepilogo dei sottoprogrammi DBMS_CLOUD_MIGRATION

ENABLE_TRANSLATION Procedura

La procedura ENABLE_TRANSLATION consente la traduzione SQL in tempo reale e l'esecuzione di istruzioni SQL non Oracle in Autonomous Database.

Sintassi

Parametri

DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION (
   source_db  IN  VARCHAR2);

Parametro descrizione;

Parametro	descrizione;
`source_db`	Specifica la lingua del database di origine. I valori validi per questo parametro sono `POSTGRES`, `MYSQL`, `SQLSERVER`. Questo parametro è obbligatorio.

source_db

Specifica la lingua del database di origine. I valori validi per questo parametro sono POSTGRES, MYSQL, SQLSERVER.

Questo parametro è obbligatorio.

Nota per l'uso

Per eseguire DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_MIGRATION.

Esempio

BEGIN
  DBMS_CLOUD_MIGRATION.ENABLE_TRANSLATION (source_db => 'POSTGRES');
END;        
/

Argomento padre: Riepilogo dei sottoprogrammi DBMS_CLOUD_MIGRATION

DISABLE_TRANSLATION Procedura

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

Sintassi

DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION();

Nota per l'uso

Per eseguire DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION è necessario aver eseguito il login come utente ADMIN o disporre del privilegio EXECUTE su DBMS_CLOUD_MIGRATION.

Esempio

BEGIN
  DBMS_CLOUD_MIGRATION.DISABLE_TRANSLATION();
END;        
/

Argomento padre: Riepilogo dei sottoprogrammi DBMS_CLOUD_MIGRATION

Documentazione di Oracle Cloud Infrastructure