Workspace della conversione

Le aree di lavoro di conversione consentono di trasformare lo schema e gli oggetti del database di origine nella sintassi SQL compatibile con il database di destinazione. Questa pagina fornisce una panoramica degli spazi di lavoro di conversione di Database Migration Service:

• Le panoramiche delle conversioni forniscono una sezione trasversale dello stato di avanzamento della conversione dello schema.

• Oggetti supportati dalla conversione deterministica di codice e schema elenca gli oggetti Oracle supportati per la conversione deterministica dello schema.

• Editor SQL interattivo descrive gli oggetti che puoi modificare direttamente nell'editor dell'area di lavoro della conversione.

• Le funzionalità di conversione basate su Gemini mostrano come integrare il supporto dell'AI generativa per accelerare il processo di conversione dello schema.

• La sezione File di mappatura delle conversioni fornisce una panoramica delle direttive di personalizzazione che puoi utilizzare per eseguire l'override delle regole di conversione deterministica dello schema.

• Workspace di conversione legacy descrive le workspace legacy che non supportano l'editor SQL interattivo.

Esistono alcuni tipi di dati non supportati per le migrazioni Oracle. Per ulteriori informazioni, vedi Limitazioni note per i tipi di dati.

Panoramiche dello stato di avanzamento della conversione

Informazioni di riepilogo dettagliate delle aree di lavoro di conversione, dove puoi ottenere approfondimenti sul numero totale di problemi di conversione in sospeso o risolti, sui miglioramenti assistiti da Gemini e sullo stato generale del processo di conversione.

Figura 1. Schermata di panoramica dello spazio di lavoro di conversione, in cui puoi monitorare l'avanzamento della conversione, visualizzare i problemi e ispezionare il codice PostgreSQL risultante. (fai clic per ingrandire)

Puoi utilizzare questa visualizzazione per filtrare gli oggetti nello schema in base a tipo, gravità del problema, azioni necessarie o stato della conversione.

Figura 2. Oggetti convertiti filtrati per stato e tipo di oggetto. (fai clic per ingrandire)

Per ulteriori informazioni sull'utilizzo delle panoramiche delle conversioni per esaminare i risultati delle conversioni, consulta Utilizzare i workspace della conversione.

Conversione deterministica di codice e schema

Quando crei uno spazio di lavoro di conversione, Database Migration Service esegue immediatamente la conversione iniziale dello schema utilizzando un insieme di regole di conversione deterministiche in cui tipi di dati e oggetti Oracle specifici vengono mappati a tipi di dati e oggetti PostgreSQL specifici. Questa procedura supporta un sottoinsieme molto specifico degli oggetti di database Oracle disponibili.

La conversione deterministica del codice fornisce il supporto per i seguenti oggetti del database Oracle:

Elementi dello schema Oracle supportati

• Vincoli
• Indici (solo gli indici creati nello stesso schema della tabella)
• Viste materializzate
• Tipi di oggetti (supporto parziale)
• Sequenze
• Sinonimi
• Tabelle
• Visualizzazioni

Elementi di codice Oracle supportati

• Trigger (solo a livello di tabella)
• Pacchetti
• Funzioni
• Stored procedure

Editor SQL interattivo

L'editor SQL interattivo ti consente di modificare la sintassi PostgreSQL convertita direttamente in Database Migration Service. Puoi utilizzarlo per risolvere i problemi di conversione o modificare lo schema in base alle tue esigenze. Alcuni oggetti non possono essere modificati nell'editor integrato.

Oggetti Oracle modificabili

Dopo aver convertito il codice e lo schema del database di origine, puoi utilizzare l'editor interattivo per modificare il codice SQL generato per determinati tipi di oggetti. I seguenti oggetti Oracle sono supportati dall'editor:

• Trigger tabella (richiede l'autorizzazione)
• Viste materializzate
• Pacchetti
• Funzioni, stored procedure
• Sinonimi
• Visualizzazioni
• Vincoli
• Indici
• Sequenze

Inoltre, alcuni oggetti vengono convertiti, ma non sono disponibili per la modifica diretta all'interno di Database Migration Service. Per modificare questi oggetti, devi eseguire gli aggiornamenti direttamente sul database di destinazione dopo aver applicato lo schema e il codice convertiti.

Oggetti non supportati per la modifica:

• Tipi di oggetti definiti dall'utente
• Tabelle
• Schemi

Accelerare la conversione di codice e schema con Gemini

Anteprima — Gemini in Database Migration Service

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Database Migration Service integra Gemini per Google Cloud nelle workspace di conversione per aiutarti ad accelerare e migliorare il processo di conversione nelle seguenti aree:

• Migliora i risultati della conversione deterministica con la conversione automatica basata su Gemini per sfruttare la potenza dell'AI e ridurre significativamente il numero di aggiustamenti manuali necessari nel codice PostgreSQL.

• Fornisci funzionalità di spiegazione del codice con l'assistente alla conversione: un insieme di prompt dedicati che possono aiutarti a comprendere meglio la logica di conversione, proporre correzioni per i problemi di conversione o ottimizzare il codice convertito.

• Velocizza l'applicazione delle correzioni per i problemi di conversione con i suggerimenti per la conversione del codice di Gemini: un meccanismo in cui il modello Gemini può imparare mentre correggi i problemi di conversione e suggerire modifiche ad altri oggetti difettosi nello spazio di lavoro.

Per ulteriori informazioni sulla conversione basata su Gemini, consulta le seguenti pagine:

• Converti codice e schema Oracle con l'aiuto di Gemini

• Flusso di lavoro di esempio per la correzione di oggetti di codice con problemi di conversione

File di mappatura delle conversioni

Puoi personalizzare la logica di conversione con un file di mappatura delle conversioni. Il file di mappatura della conversione è un file di testo che contiene istruzioni precise (denominate direttive di conversione) su come convertire gli oggetti Oracle in oggetti PostgreSQL.

Direttive sulle conversioni supportate

Database Migration Service supporta le seguenti direttive di conversione per i file di mapping della conversione:

EXPORT_SCHEMA

EXPORT_SCHEMA è una direttiva obbligatoria per tutti i file di mapping delle conversioni. Database Migration Service richiede questa istruzione per garantire che gli schemi di origine vengano convertiti negli schemi di destinazione corretti. Assicurati che i file di mappatura delle conversioni includano questa riga:

EXPORT_SCHEMA 1

SCHEMA

Database Migration Service deve essere in grado di determinare quale schema contiene gli oggetti da modificare con le direttive di conversione. L'istruzione SCHEMA comporta le seguenti modifiche al flusso di conversione:

• Database Migration Service converte solo questo schema. Se devi convertire altri schemi in un unico spazio di lavoro di conversione, devi caricare più file con schemi diversi.
• Tutte le altre direttive di personalizzazione fornite nel file si applicano solo agli oggetti di questo schema specifico.

Utilizza il formato seguente:

SCHEMA SCHEMA_NAME

Dove SCHEMA_NAME è il nome dello schema nel database di origine.

• Se includi questa direttiva nel file di mapping delle conversioni, tutte le personalizzazioni vengono applicate solo agli oggetti contenuti in questo schema specifico. Se vuoi personalizzare gli oggetti in altri schemi, devi creare più file di mapping della conversione e caricarli nel workspace di conversione.
• Se salti questa direttiva, devi fornire nomi di schema espliciti per gli oggetti modificati da altre direttive di conversione. Ad esempio, invece di utilizzare SOURCE_TABLE_NAME per la direttiva REPLACE_TABLES, dovrai utilizzare "SCHEMA_NAME.SOURCE_TABLE_NAME".

DATA_TYPE

Puoi utilizzare questa direttiva per mappare in modo esplicito qualsiasi tipo di dati supportato tra la sintassi Oracle e PostgreSQL. Questa direttiva prevede un elenco di mappature separate da virgole. L'intera definizione deve essere fornita su una singola riga, ma nel file di configurazione includi più direttive DATA_TYPE. Utilizza il formato seguente:

DATA_TYPE ORACLE_DATA_TYPE1:PGSQL_DATA_TYPE1
DATA_TYPE ORACLE_DATA_TYPE2:PGSQL_DATA_TYPE2...

Dove ORACLE_DATA_TYPE e PGSQL_DATA_TYPE sono tipi di dati supportati dalle rispettive versioni di Oracle e PostgreSQL che utilizzi nella migrazione. Per informazioni sulle versioni supportate, vedi Panoramica dello scenario.

Esempio:

DATA_TYPE REAL:double precision,SMALLINT:integer

Per saperne di più sui tipi di dati Oracle e PostgreSQL, consulta:

• Tipi di dati Oracle nella documentazione di Oracle.
• Tipi di dati PostgreSQL nella documentazione di PostgreSQL.

MODIFY_TYPE

La direttiva MODIFY_TYPE consente di controllare il tipo di dati a cui Database Migration Service converte una colonna specifica della tabella di origine. Questa direttiva prevede un elenco di mappature separate da virgole. L'intera definizione deve essere fornita su una singola riga, ma nel file di configurazione includi più direttive MODIFY_TYPE. Utilizza il formato seguente:

MODIFY_TYPE SOURCE_TABLE_NAME1:COLUMN_NAME:EXPECTED_END_RESULT_DATA_TYPE
MODIFY_TYPE SOURCE_TABLE_NAME2:COLUMN_NAME:EXPECTED_END_RESULT_DATA_TYPE...

Dove:

• SOURCE_TABLE_NAME è il nome della tabella che contiene la colonna in cui vuoi modificare il tipo di dati.
  Importante:se non utilizzi la direttiva SCHEMA, assicurati di utilizzare il nome completo della tabella: SCHEMA_NAME.SOURCE_TABLE_NAME
• COLUMN_NAME è il nome della colonna per cui vuoi personalizzare la mappatura delle conversioni.
• EXPECTED_END_RESULT_DATA_TYPE è il tipo di dati PostgreSQL che vuoi che utilizzi la colonna convertita.

Esempio:

MODIFY_TYPE events:dates_and_times:DATETIME,users:pseudonym:TEXT

PG_INTEGER_TYPE

Per impostazione predefinita,Database Migration Service converte i tipi NUMBER(p,s) nel tipo DECIMAL(p,s) di PostgreSQL.

Puoi modificare questo comportamento con la direttiva PG_INTEGER_TYPE. Imposta il valore su 1 e forza la conversione di tutti i tuoi NUMBER con precisione e scala (NUMBER(p,s)) nei tipi PostgreSQL smallint, integer o bigint in base al numero di cifre di precisione.

Suggerimento:puoi utilizzare questa direttiva anche per i tipi NUMBER semplici se la combini con la direttiva DEFAULT_NUMERIC.

Includi la seguente impostazione nel file di mappatura delle conversioni:

PG_INTEGER_TYPE 1

PG_NUMERIC_TYPE

Imposta questa direttiva su 1 se vuoi convertire tutti i tuoi tipi NUMBER con precisione e scala (NUMBER(p,s)) in tipi PostgreSQL real o float (in base al numero di cifre di precisione).

Se imposti questa direttiva su 0, i valori NUMBER(p,s) mantengono il loro valore originale esatto e utilizzano il tipo di dati PostgreSQL interno.

Includi la seguente impostazione nel file di mappatura delle conversioni:

PG_NUMERIC_TYPE 1

DEFAULT_NUMERIC

La conversione predefinita per i NUMBER senza precisione modifica l'utilizzo della PG_INTEGER_TYPE direttiva:

• Se utilizzi la direttiva PG_INTEGER, i valori NUMBER senza precisione vengono convertiti in valori DECIMAL.
• Se non utilizzi la direttiva PG_INTEGER, i NUMBER senza precisione vengono convertiti in valori BIGINT.

Puoi modificare questo comportamento e utilizzare la direttiva DEFAULT_NUMERIC per specificare il tipo di dati da utilizzare per i tipi NUMBER senza punti di precisione specificati. Utilizza il formato seguente:

DEFAULT_NUMERIC POSTGRESQL_NUMERIC_DATA_TYPE

Dove POSTGRESQL_NUMERIC_DATA_TYPE è uno dei seguenti valori: integer, smallint, bigint.

Esempio:

DEFAULT_NUMERIC integer

REPLACE_COLS

Puoi utilizzare la direttiva REPLACE_COLS per rinominare le colonne nello schema convertito. Questa direttiva prevede un elenco di mappature separate da virgole. Utilizza il formato seguente:

REPLACE_COLS SOURCE_TABLE_NAME1(SOURCE1_TABLE1_COLUMN_NAME1:DESTINATION_TABLE1_COLUMN_NAME1,SOURCE_TABLE1_COLUMN_NAME2:DESTINATION_TABLE1_COLUMN_NAME2),SOURCE_TABLE_NAME2(SOURCE_TABLE2_COLUMN_NAME1:DESTINATION_TABLE2_COLUMN_NAME1,SOURCE_TABLE2_COLUMN_NAME2:DESTINATION_TABLE2_COLUMN_NAME2)...

Dove:

• SOURCE_TABLE_NAME è il nome della tabella che contiene la colonna di cui vuoi modificare il nome.
  Importante:se non utilizzi la direttiva SCHEMA, assicurati di utilizzare il nome completo della tabella: SCHEMA_NAME.SOURCE_TABLE_NAME
• SOURCE_COLUMN_NAME è il nome della colonna nell'origine di cui vuoi modificare il nome.
• DESTINATION_COLUMN_NAME è il nuovo nome della colonna che vuoi utilizzare nello schema convertito.

Esempio:

REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname)

REPLACE_TABLES

Puoi utilizzare la direttiva REPLACE_TABLES per rinominare le tabelle o spostarle in un nuovo schema. Questa direttiva prevede un elenco di mapping separati da spazi. Per ulteriori informazioni sulla sintassi per ogni caso d'uso, espandi le sezioni seguenti.

Importante:se non utilizzi la direttiva SCHEMA, assicurati di utilizzare i nomi delle tabelle completi tra virgolette per le variabili di origine e di destinazione:

• "SCHEMA_NAME.SOURCE_TABLE_NAME"
• "SCHEMA_NAME.DESTINATION_TABLE_NAME"

Ridenominare le tabelle

Per rinominare le tabelle nello schema convertito, utilizza il seguente formato:

REPLACE_TABLES SOURCE_TABLE_NAME1:DESTINATION_TABLE_NAME1 SOURCE_TABLE_NAME2:DESTINATION_TABLE_NAME2

Dove:

• SOURCE_TABLE_NAME è il nome della tabella di origine che vuoi rinominare nello schema convertito.
• DESTINATION_TABLE_NAME è il nuovo nome della tabella che vuoi utilizzare nello schema convertito.

Esempio:

REPLACE_TABLES "events:login_events" "users:platform_users"

Spostare le tabelle tra gli schemi

Puoi utilizzare questa direttiva per spostare le tabelle tra gli schemi aggiungendo il prefisso dello schema al nuovo nome della tabella. Questo meccanismo può essere utilizzato indipendentemente da come utilizzi la direttiva SCHEMA per l'intero file di conversione. Ad esempio:

REPLACE_TABLES "events:NEW_SCHEMA_NAME.login_events"
    

Alias per la personalizzazione dei tipi di dati

Quando utilizzi le direttive di conversione per modificare il modo in cui Database Migration Service converte diversi tipi di dati (ad esempio, con le direttive DATA_TYPE, MODIFY_TYPE o PG_NUMERIC_TYPE), puoi utilizzare gli alias anziché i tipi di dati SQL di origine.

Espandi la sezione seguente per visualizzare l'elenco degli alias dei tipi di dati supportati da Database Migration Service.

Alias dei tipi di dati

Alias	Convertito nel tipo PostgreSQL
bigint, int8	BIGINT
bool, boolean	BOOLEAN
bytea	BYTEA
char, character	CHAR
character varying, varchar	VARCHAR
date	DATE
decimal, numeric	DECIMAL
double precision, float8	DOUBLE PRECISION
real, float4	REAL
int, integer, int4	INTEGER
int2	SMALLINT
interval	INTERVAL
json	JSON
smallint	SMALLINT
text	TEXT
time	TIME
timestamp	TIMESTAMP
timestamptz	TIMESTAMPTZ
timetz	TIMETZ
uuid	UUID
XML	XML

File di mappatura delle conversioni di esempio

Di seguito è riportato un file di mapping delle conversioni di esempio che utilizza tutte le direttive di conversione dello schema supportate:

EXPORT_SCHEMA 1
SCHEMA root

PG_NUMERIC_TYPE 0
PG_INTEGER_TYPE 1
DEFAULT_NUMERIC integer
DATA_TYPE NUMBER(4\,0):integer
MODIFY_TYPE events:dates_and_times:TIMESTAMP
REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname)
REPLACE_TABLES events:login_events users:platform_users

I risultati dell'utilizzo di questo file sono i seguenti:

• EXPORT_SCHEMA 1 è un'istruzione obbligatoria.
• SCHEMA root comporta i seguenti aggiustamenti al flusso di conversione:
  • Database Migration Service esegue la conversione solo per le entità nello schema root. Nessun altro schema viene convertito.
  • Tutte le altre direttive di personalizzazione in questo file si applicano solo a colonne e tipi di dati definiti nello schema root.
• PG_INTEGER_TYPE 1 fa in modo che Database Migration Service converta tutti i tipi di dati numerici Oracle trovati nelle tabelle dello schema root in tipi specifici di PostgreSQL anziché in tipi numerici portabili ANSI.
• DEFAULT_NUMERIC fa sì che Database Migration Service converta i valori NUMBER che non hanno un punto di precisione specificato nel tipo INTEGER di PostgreSQL. Questo vale solo per i valori NUMBER trovati nelle tabelle dello schema root.
• DATA_TYPE NUMBER(4\,0):integer fa sì che Database Migration Service converta valori NUMBER(4,0) specifici in INTEGER PostgreSQL.
• La direttiva MODIFY_TYPE fa sì che Database Migration Service converta i dati nella colonna dates_and_times della tabella di origine events specificamente nel tipo DATETIME di PostgreSQL, indipendentemente dal formato effettivo della colonna di origine.
• REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname) fa sì che Database Migration Service ridenomini le seguenti colonne nello schema convertito:
  • La colonna dates_and_times nella tabella events di origine viene rinominata in event_dates nella stessa tabella dello schema convertito.
  • La colonna pseudonym nella tabella users di origine viene rinominata in nickname nella stessa tabella dello schema convertito.
  L'operazione di ridenominazione viene applicata solo alle tabelle events e users nello schema root.
• REPLACE_TABLES events:login_events users:platform_users rinomina le seguenti tabelle nello schema convertito:
  • La tabella events è stata rinominata in login_events.
  • La tabella users è stata rinominata in platform_users.
  L'operazione di ridenominazione viene applicata solo alle tabelle events e users nello schema root.

Workspace di conversione legacy

I workspace della conversione legacy sono un tipo di workspace della conversione precedente e più limitato. I workspace della conversione legacy non supportano le funzionalità di conversione avanzate con Gemini o l'editor SQL interattivo. Puoi utilizzarli solo per convertire lo schema di origine con lo strumento di migrazione Ora2Pg.

Non è consigliabile utilizzare il tipo precedente di spazi di lavoro per le conversioni per le migrazioni. Se il tuo scenario richiede l'utilizzo di workspace della conversione legacy, consulta Utilizzare i workspace della conversione legacy.

Passaggi successivi

Per scoprire di più sull'utilizzo dei workspace della conversione, consulta:

• Creare un workspace della conversione

• Utilizzare i workspace di conversione