View a markdown version of this page

Rapporti di valutazione delle conversioni con DMS Schema Conversion - AWS Servizio di migrazione del database
Esecuzione di una valutazioneSalvataggio del report di valutazioneVisualizzazione del report di valutazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Rapporti di valutazione delle conversioni con DMS Schema Conversion

Una parte importante della conversione dello schema DMS è il report che genera per aiutarti a eseguire l'operazione. Questo rapporto di valutazione delle conversioni analizza gli oggetti del database nello schema di origine e identifica quali oggetti DMS Schema Conversion può convertire automaticamente e quali oggetti richiedono un'azione manuale. È possibile visualizzare il report nella AWS DMS console o salvarne una copia come file PDF o con valori separati da virgole (CSV).

Il rapporto di valutazione della conversione include quanto segue:

  • Sintesi esecutiva

  • Consigli per la conversione di oggetti di database che richiedono un'azione manuale

Quando sono presenti oggetti di database che DMS Schema Conversion non è in grado di convertire automaticamente, il rapporto fornisce stime che mostrano quanto impegno è necessario per scrivere il codice equivalente per l'istanza DB di destinazione.

Argomenti

Esecuzione di una valutazione per un report di valutazione della conversione con DMS Schema Conversion

Dopo aver creato un progetto di migrazione, utilizza uno dei seguenti metodi per eseguire una valutazione della complessità della conversione.

AWS Management Console
Per eseguire una valutazione e generare un rapporto di valutazione della conversione

  1. Accedi Console di gestione AWS e apri la AWS DMS console all'indirizzo https://console.aws.amazon.com/dms/v2/.

  2. Scegli Progetti di migrazione. Viene visualizzata la pagina Progetti di migrazione.

  3. Scegli il progetto di migrazione, quindi seleziona Conversione dello schema.

  4. Scegli Avvia conversione dello schema. Viene visualizzata la pagina Conversione dello schema.

  5. Nel riquadro del database di origine, seleziona il nodo che desideri valutare. L'azione Valuta è disponibile sul nodo Database, sui singoli nodi del database e sui nodi dello schema come dbo. Non è disponibile sui singoli nodi oggetto, ad esempio tabelle o procedure.

  6. Selezionare almeno un nodo padre nel riquadro del database di origine. Il menu Azioni diventa disponibile solo quando viene selezionato un nodo principale.

  7. Aprite il menu Azioni e scegliete Valuta. Viene visualizzata una finestra di dialogo di conferma.

  8. Seleziona Valuta nella finestra di dialogo per confermare la scelta.

AWS CLI

L'esempio seguente utilizza start-metadata-model-assessment per mettere in coda una valutazione della complessità di conversione per tutti gli oggetti dello schema. ExampleSchema

aws dms start-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules": [{"rule-type": "selection", "rule-id": "1", "rule-name": "1", "object-locator": {"server-name": "source-server", "schema-name": "ExampleSchema"}, "rule-action": "explicit"}]}'
Nota

Il --selection-rules parametro accetta una stringa JSON che specifica quali oggetti del database includere nella valutazione. Per la struttura JSON completa delle regole di selezione, vedere. Regole di selezione nella conversione dello schema DMS

La risposta contiene un messaggio RequestIdentifier che identifica la richiesta di valutazione.

{
    "RequestIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Poiché una valutazione viene eseguita in modo asincrono, usa aws dms wait metadata-model-assessment per bloccarsi fino al completamento della valutazione prima di procedere.

aws dms wait metadata-model-assessed \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS"

Il comando esegue un polling ogni 30 secondi e ritorna quando la valutazione raggiunge uno stato terminale. Esce con il codice di ritorno 255 se la valutazione non viene completata dopo 360 controlli (circa 3 ore).

L'avvio di una valutazione non genera ogni volta un rapporto completamente nuovo da zero. Il rapporto di valutazione delle conversioni riflette lo stato attuale del progetto di migrazione, quindi include le azioni e i candidati all'IA generativa per tutto ciò che avete valutato o convertito finora. Per ulteriori informazioni, consulta Comprendere le metriche del rapporto di valutazione delle conversioni.

Salvataggio del rapporto di valutazione delle conversioni per DMS Schema Conversion

Dopo aver eseguito una valutazione o una conversione, puoi salvare una copia del rapporto di valutazione della conversione come file PDF o con valori separati da virgole (CSV).

AWS Management Console
Rapporto PDF
Per salvare un rapporto di valutazione delle conversioni come file PDF

  1. Seleziona Esporta, quindi scegli PDF. Esamina la finestra di dialogo e scegli Esporta in PDF.

  2. DMS Schema Conversion archivia il file PDF nel bucket Amazon S3 configurato nelle impostazioni di accesso al bucket S3 nel tuo progetto di migrazione.

  3. Apri il file del report di valutazione nel bucket Amazon S3.

Esportazione in formato CSV
Per salvare un rapporto di valutazione delle conversioni come file CSV

  1. Seleziona Esporta, quindi scegli CSV. Esamina la finestra di dialogo e scegli Esporta in CSV.

  2. DMS Schema Conversion archivia un archivio ZIP contenente i file CSV nel bucket Amazon S3 che hai configurato con le impostazioni di accesso al bucket S3 nel tuo progetto di migrazione.

  3. Scarica ed estrai l'archivio ZIP dal tuo bucket Amazon S3 per accedere ai file CSV.

Nomi dei bucket e dei file S3

Il bucket Amazon S3 in cui DMS Schema Conversion archivia i report esportati è il bucket specificato nelle impostazioni di accesso al bucket S3 al momento della creazione del progetto di migrazione.

I file vengono archiviati in una cartella corrispondente al nome del progetto di migrazione. Quando si esporta da Console di gestione AWS, i file vengono denominati utilizzando il motore di origine, il motore di destinazione e un timestamp UTC: project-name/SOURCE_ENGINE_TARGET_ENGINE_YYYY-MM-DDTHH-MM-SS.sssZ — ad esempio,. ora-pg-demo/ORACLE_POSTGRESQL_2026-07-01T09-00-47.846Z.pdf

L'archivio CSV contiene almeno tre file organizzati in un percorso di directory a due livelli. La directory di primo livello è il nome del server di origine esattamente come configurato nel provider di dati di origine (nome host o indirizzo IP). La sottodirectory e i nomi dei file utilizzano il nome host del database di destinazione:

  • source-server/target-host/target-host.csv— una riga per occorrenza dell'azione.

  • source-server/target-host/target-host_Action_Items_Summary.csv— una riga per tipo di elemento d'azione, con i valori di sforzo.

  • source-server/target-host/target-host_Summary.csv— una riga per tipo di oggetto, con conteggi di complessità.

  • source-server/target-host/target-host_Stub_Objects.csv— una riga per oggetto stub generato per un elemento integrato non supportato. Questo file è presente solo quando l'opzione Converti oggetti incorporati non supportati in oggetti stub è abilitata nelle impostazioni del progetto di migrazione.

AWS CLI

L'esempio seguente utilizza export-metadata-model-assessment per esportare il report di valutazione della conversione per un progetto di migrazione sia come file PDF che come archivio CSV nel bucket Amazon S3.

aws dms export-metadata-model-assessment \
        --migration-project-identifier "arn:aws:dms:us-east-1:111122223333:migration-project:EXAMPLEABCDEFGHIJKLMNOPQRS" \
        --selection-rules '{"rules":[{"rule-type":"selection","rule-id":"1","rule-name":"1","rule-action":"explicit","object-locator":{"server-name":"source-server","schema-name":"ExampleSchema"}}]}' \
        --assessment-report-types pdf csv
Nota

Il --selection-rules parametro accetta una stringa JSON che specifica quali oggetti del database includere nel report. Per la struttura JSON completa delle regole di selezione, vedere. Regole di selezione nella conversione dello schema DMS

La risposta contiene la chiave oggetto Amazon S3 e l'URL di download per ogni file di report.

Quando non lo specifichi--file-name, i file vengono archiviati in una cartella corrispondente al nome del progetto di migrazione, utilizzando un timestamp come nome del fileproject-name/YYYY-MM-DD-HH-MM-SS.zip: project-name/YYYY-MM-DD-HH-MM-SS.pdf e, ad esempio,. sqlserver-pg-pma/2026-07-15-10-08-12.zip Specificate --file-name di sovrascrivere il prefisso del timestamp all'interno di quella cartella.

{
    "PdfReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.pdf",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.pdf"
    },
    "CsvReport": {
        "S3ObjectKey": "project-name/YYYY-MM-DD-HH-MM-SS.zip",
        "ObjectURL": "https://amzn-s3-demo-bucket.s3.amazonaws.com/project-name/YYYY-MM-DD-HH-MM-SS.zip"
    }
}
Nota

Il rapporto di valutazione della conversione è disponibile anche dopo aver eseguito un'operazione di conversione, non solo dopo aver eseguito una valutazione esplicita. Dopo una conversione, il rapporto riflette gli oggetti che richiedono ancora un'azione manuale e contrassegna gli oggetti convertiti da DMS Schema Conversion utilizzando l'intelligenza artificiale generativa. Per informazioni sull'esecuzione di una conversione, vedere. Conversione dello schema del database: guida dettagliata

Visualizzazione del rapporto di valutazione delle conversioni per DMS Schema Conversion

Per visualizzare il rapporto di valutazione delle conversioni, utilizza uno dei seguenti metodi.

Importante

Il rapporto di valutazione della conversione copre solo gli oggetti del database inclusi nell'ambito dell'operazione di valutazione o conversione più recente. Gli oggetti che non sono stati selezionati durante l'esecuzione di Assess o Convert non vengono visualizzati nel rapporto, anche se esistono nel database di origine.

Ogni nuova operazione di valutazione o conversione sovrascrive il rapporto precedente. Le schede Riepilogo e Azioni riflettono sempre solo l'operazione più recente. Se devi conservare i risultati del rapporto corrente, esportalo come file PDF o CSV prima di eseguire una nuova valutazione o conversione. Per istruzioni sull'esportazione, consultaSalvataggio del report di valutazione.

AWS Management Console

Dopo aver eseguito una valutazione o una conversione, DMS Schema Conversion aggiunge informazioni nelle seguenti schede:

  • Riepilogo

  • Elementi d'azione

Scheda Riepilogo

La scheda Riepilogo mostra le informazioni di riepilogo del rapporto di valutazione della conversione. Mostra il numero di oggetti di database che DMS Schema Conversion può convertire automaticamente in oggetti di archiviazione del database e oggetti codice di database.

DMS Schema Conversion converte automaticamente molti oggetti del database e identifica quelli che richiedono un'azione manuale per completare la conversione nel motore di database di destinazione. La scheda Riepilogo fornisce una stima dello sforzo richiesto per creare oggetti di database nell'istanza DB di destinazione equivalenti a quelli dell'origine.

Per visualizzare il riepilogo della conversione per gli oggetti di archiviazione del database come tabelle, sequenze, vincoli, tipi di dati e così via, scegli Oggetti di archiviazione database.

Per visualizzare il riepilogo delle conversioni per gli oggetti di codice del database come procedure, funzioni, viste, trigger e così via, scegli Oggetti codice database.

Per modificare l'ambito del report di valutazione, seleziona il nodo richiesto nell'albero del database di origine. La conversione dello schema DMS aggiorna il riepilogo del report di valutazione in modo che corrisponda all'ambito selezionato.

Scheda attività

La scheda Elementi di azione contiene un elenco di azioni per oggetti di database che DMS Schema Conversion non può convertire automaticamente in un formato compatibile con il motore di database di destinazione. Per ogni elemento d'azione, la conversione dello schema DMS fornisce la descrizione del problema e l'azione consigliata. La conversione dello schema DMS raggruppa elementi d'azione simili e visualizza il numero di ricorrenze.

Per visualizzare il codice dell'oggetto di database correlato, seleziona un elemento d'azione nell'elenco.

IA generativa

La conversione dello schema DMS con intelligenza artificiale generativa semplifica il processo di migrazione del database offrendo consigli per aiutarti a convertire oggetti di codice precedentemente non convertiti che in genere richiedono una conversione manuale complessa. Attualmente, questa funzionalità è disponibile per Oracle, SQL Server, SAP ASE (Sybase ASE), IBM Db2 for LUW e IBM Db2 per i database di origine, con conversione in PostgreSQL o Aurora PostgreSQL. z/OS

Il rapporto di valutazione mostra quali oggetti di codice del database sono candidati alla conversione utilizzando l'IA generativa. Puoi esportare questo rapporto in un PDF per un breve elenco di cinque oggetti per azione. Puoi esportare il rapporto in un file CSV per visualizzare l'elenco completo dei candidati.

Quando abiliti Convert schema using generative AI ed esegui una conversione, il report di valutazione aggiornato contrassegna ogni oggetto del database con un'azione corrispondente, sia oggetti che sono stati convertiti correttamente utilizzando l'IA generativa sia oggetti che l'IA generativa non è riuscita a convertire, facilitando l'identificazione e il monitoraggio dei risultati della conversione. AI-assisted

Per individuare rapidamente gli oggetti convertiti dall'IA generativa:

  1. Vai alla scheda Action Items.

  2. Nell'angolo in alto a destra, individua il menu a discesa.

  3. Seleziona Generato dall'IA tra le opzioni.

Questo metodo di filtro consente di visualizzare in modo efficiente tutti gli oggetti del database che sono stati convertiti correttamente utilizzando questa funzionalità. Per ulteriori informazioni sulla conversione degli oggetti del database con l'intelligenza artificiale generativa, vedere. Ambito della conversione dell'IA generativa

PDF report

Il report PDF contiene i quattro capitoli seguenti, in questo ordine:

  • Riepilogo: una panoramica della complessità della migrazione. Mostra il numero di oggetti del database che DMS Schema Conversion è in grado di convertire automaticamente e il numero che richiedono un'azione manuale, suddivisi per tipo di oggetto (tabelle, viste, procedure, trigger e così via) e per categoria di complessità (convertiti automaticamente, azioni semplici, azioni di media complessità e azioni complesse). Per ulteriori informazioni su queste categorie, vedere. Categorie di complessità

  • Oggetti di database con azioni di conversione: un'analisi degli oggetti di database specifici che richiedono un'azione manuale, organizzata per tipo di oggetto. Ogni voce identifica l'oggetto per nome ed elenca il codice dell'azione.

  • Candidati per la conversione con intelligenza artificiale generativa: gli oggetti del database che DMS Schema Conversion identifica come candidati per la conversione automatica utilizzando l'intelligenza artificiale generativa. Il PDF elenca fino a cinque oggetti candidati per tipo di azione. Per visualizzare l'elenco completo dei candidati, esporta il rapporto in formato CSV.

  • Consigli dettagliati per le migrazioni: un'analisi per oggetto di ogni oggetto del database che richiede un'azione manuale. Per ogni oggetto, questo capitolo mostra il codice dell'azione (vediCodici degli elementi d'azione), una descrizione dell'incompatibilità specifica con il motore di database di destinazione e l'azione di conversione manuale consigliata. A differenza della scheda Azioni in Console di gestione AWS, che raggruppa le azioni per tipo in tutti gli oggetti, questo capitolo elenca ogni oggetto interessato singolarmente.

Per esportare il report in formato PDF, consultaSalvataggio del report di valutazione.

CSV report

Quando si esporta il rapporto di valutazione in formato CSV, DMS Schema Conversion crea un archivio contenente almeno tre file CSV. L'archivio utilizza una struttura di directory a due livelli: la directory di primo livello è il nome del server di origine esattamente come configurato nel provider di dati di origine (nome host o indirizzo IP) e la sottodirectory e i nomi dei file utilizzano il nome host del database di destinazione.

File delle azioni (.csv) target-host

Il file CSV principale (senza suffisso) contiene una riga per occorrenza dell'azione. Contiene le seguenti colonne:

  • Categoria: il tipo di oggetto del database a cui si applica l'azione, ad esempio procedure oview-constraint.

  • Occorrenza: il percorso completo dell'istanza specifica dell'oggetto di database su cui influisce l'azione, ad esempioSchemas.schema_name.Procedures.procedure_name.

  • Elemento di azione: il codice numerico dell'azione che identifica il tipo di problema di conversione. Per ulteriori informazioni, consulta Codici degli elementi d'azione.

  • Oggetto: il nome o l'elemento di codice specifico dell'oggetto del database a cui fa riferimento l'azione, ad esempio un identificatore non risolto. Questo campo è vuoto quando l'azione non fa riferimento a un nome di oggetto specifico.

  • Gruppo: una descrizione generica del tipo di problema condivisa da ogni occorrenza del codice dell'azione. DMS Schema Conversion utilizza questo valore per raggruppare le occorrenze correlate.

  • Descrizione: una descrizione dettagliata dell'incompatibilità specifica per questa occorrenza.

  • Riferimenti alla documentazione: collegamenti alla documentazione pertinente per la risoluzione dell'incompatibilità.

  • Azione consigliata: la fase di conversione manuale suggerita per risolvere l'incompatibilità.

  • Filtrato: indica se l'azione è stata esclusa dalla visualizzazione del report.

  • Complessità stimata: la categoria di complessità assegnata a questo evento: azioni semplici convertite automaticamente, azioni di media complessità o azioni complesse.

  • Linea: il numero di riga nel codice dell'oggetto sorgente in cui si verifica l'incompatibilità.

  • Posizione: la posizione del carattere sulla riga in cui si verifica l'incompatibilità.

  • Fonte: il motore del database di origine.

  • Target: il motore di database di destinazione.

  • Indirizzo IP e porta del server: l'host e la porta del server del database di origine.

  • Nome del database: il nome del database di origine.

  • Nome dello schema: il nome dello schema di origine contenente l'oggetto interessato.

  • AI/ML Raccomandazione: la raccomandazione dell'IA generativa per la conversione di questo oggetto, quando la conversione AI generativa è stata abilitata e ha prodotto un risultato per questa occorrenza.

File di riepilogo delle azioni (_ .csv) target-host Action_Items_Summary

Contiene una riga per tipo di elemento d'azione con le seguenti colonne:

  • Schema: il nome dello schema di origine contenente gli oggetti interessati.

  • Azione: codice numerico dell'azione che identifica il tipo di problema di conversione. Per ulteriori informazioni, consulta Codici degli elementi d'azione.

  • Numero di occorrenze: il numero totale di oggetti del database interessati da questo tipo di azione.

  • Fasi della curva di apprendimento: l'impegno una tantum richiesto per progettare un approccio di conversione per questo tipo di azione. Questo costo viene sostenuto una volta per tipo di azione, indipendentemente dal numero di occorrenze. I valori utilizzano una scala ponderata che va da basso (minimo sforzo) ad alto (massimo sforzo).

  • Sforzi per convertire un evento: lo sforzo richiesto per risolvere ogni singola occorrenza di questo tipo di azione, seguendo l'approccio di conversione progettato. I valori utilizzano la stessa scala ponderata degli sforzi relativi alla curva di apprendimento.

  • Descrizione dell'azione: una descrizione dell'incompatibilità rappresentata da questo tipo di azione.

  • Azione consigliata: la fase di conversione manuale suggerita per risolvere questo tipo di azione.

File di riepilogo (target-host_Summary.csv)

Contiene una riga per tipo di oggetto del database con le seguenti colonne:

  • Categoria: il tipo di oggetto del database riepilogato dalla riga, ad esempio TABLEVIEW,PROCEDURE,TRIGGER,,INDEX, CONSTRAINTSEQUENCE, oFUNCTION. Il file include anche righe di metriche aggregate con un Category valore diStorage_objects_count,, Code_objects_count o. SQL_syntax_elements_number Per ulteriori informazioni su questi valori aggregati, vedere. Statistiche di conversione e metriche SQL

  • Numero di oggetti: il numero totale di oggetti di database di questo tipo nell'ambito valutato.

  • Oggetti convertiti automaticamente: il numero di oggetti che DMS Schema Conversion può convertire senza alcuna azione manuale.

  • Oggetti con azioni semplici: il numero di oggetti che richiedono un piccolo sforzo manuale per la conversione.

  • Oggetti con azioni di media complessità: il numero di oggetti che richiedono un moderato sforzo manuale per la conversione.

  • Oggetti con azioni complesse: il numero di oggetti che richiedono un notevole sforzo manuale per la conversione.

  • Righe di codice totali: il numero totale di righe di codice sorgente in tutti gli oggetti di questo tipo.

Per esportare il report in formato CSV, consultaSalvataggio del report di valutazione.

File di oggetti stub (target-host_ Stub_Objects .csv)

Questo file è presente solo quando l'opzione Converti oggetti incorporati non supportati in oggetti stub è abilitata nelle impostazioni del progetto di migrazione. Contiene una riga per oggetto stub generato per un oggetto incorporato non supportato, con le seguenti colonne:

  • Categoria: il tipo di oggetto stub, ad esempio. scalar-function

  • Nome dell'oggetto stub: il nome completo dello stub generato, inclusi schema e firma.

  • Numero di occorrenze: il numero di volte in cui si fa riferimento a questo oggetto stub nel codice convertito.