AWS SCT Riferimento CLI - AWS Schema Conversion Tool
PrerequisitiModalità interattivaOttenere scenari CLIModifica degli scenari CLIModalità scriptMateriale di riferimento

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à.

AWS SCT Riferimento CLI

Questa sezione descrive come iniziare a usare l'interfaccia a riga di AWS SCT comando (CLI). Inoltre, questa sezione fornisce informazioni sui comandi da tastiera e sulle modalità di utilizzo. Per un riferimento completo dei comandi AWS SCT CLI, vedere. Materiale di riferimento

Prerequisiti per l'utilizzo dell'interfaccia a AWS SCT riga di comando

Scarica e installa l'ultima versione di Amazon Corretto 11. Per ulteriori informazioni, consulta Download per Amazon Corretto 11 nella Guida per l'utente di Amazon Corretto 11.

Scarica e installa la versione più recente di AWS SCT. Per ulteriori informazioni, consulta Installazione AWS SCT.

AWS SCT modalità interattiva CLI

È possibile utilizzare l'interfaccia a riga di AWS SCT comando in modalità interattiva. In questa modalità, i comandi vengono immessi nella console uno per uno. È possibile utilizzare questa modalità interattiva per saperne di più sui comandi CLI o scaricare gli scenari CLI più utilizzati.

Per convertire lo schema del database di origine AWS SCT, esegui un'operazione di sequenza: crea un nuovo progetto, connettiti ai database di origine e di destinazione, crea regole di mappatura e converti gli oggetti del database. Poiché questo flusso di lavoro può essere complesso, consigliamo di utilizzare gli script in modalità AWS SCT CLI. Per ulteriori informazioni, consulta Modalità script.

È possibile eseguire i comandi AWS SCT CLI dalla app cartella del percorso di AWS SCT installazione. In Windows, il percorso di installazione predefinito èC:\Program Files\AWS Schema Conversion Tool\. Assicurati che questa cartella includa il AWSSchemaConversionToolBatch.jar file.

Per accedere alla modalità interattiva AWS SCT CLI, utilizzare il comando seguente dopo aver completato i prerequisiti.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Ora puoi eseguire i comandi AWS SCT CLI. Assicurati di terminare i comandi / in una nuova riga. Inoltre, assicuratevi di utilizzare le virgolette singole diritte (') prima e dopo i valori dei parametri del comando.

Nota

Se il comando precedente viene restituitoUnexpected error, provate quanto segue:

java -Djdk.jar.maxSignatureFileSize=20000000 -jar AWSSchemaConversionToolBatch.jar

Per visualizzare l'elenco dei comandi disponibili in modalità interattiva AWS SCT CLI, esegui il comando seguente.

help
/

Per visualizzare informazioni su un comando AWS SCT CLI, utilizzare il comando seguente.

help -command: 'command_name'
/

Nell'esempio precedente, sostituite command_name con il nome di un comando.

Per visualizzare informazioni sui parametri di un comando AWS SCT CLI, utilizzare il comando seguente.

help -command: 'command_name' -parameters: 'parameters_list'
/

Nell'esempio precedente, sostituite command_name con il nome di un comando. Quindi, sostituite parameters_list con un elenco di nomi di parametri separati da una virgola.

Per eseguire uno script da un file in modalità interattiva AWS SCT CLI, utilizzare il comando seguente.

ExecuteFile -file: 'file_path'
/

Nell'esempio precedente, sostituite file_path con il percorso del file con uno script. Assicurati che il file abbia un'estensione. .scts

Per uscire dalla modalità interattiva AWS SCT CLI, esegui il quit comando.

Esempi

L'esempio seguente visualizza le informazioni sul Convert comando.

help -command: 'Convert'
/

L'esempio seguente visualizza le informazioni su due parametri del Convert comando.

help -command: 'Convert' -parameters: 'filter, treePath'
/

Ottenere AWS SCT scenari CLI

Per ottenere gli AWS SCT scenari più utilizzati, è possibile utilizzare il GetCliScenario comando. È possibile eseguire questo comando in modalità interattiva, quindi modificare i modelli scaricati. Usa i file modificati in modalità script.

Il GetCliScenario comando salva il modello selezionato o tutti i modelli disponibili nella directory specificata. Il modello contiene il set completo di comandi per eseguire uno script. Assicurati di modificare i percorsi dei file, le credenziali del database, i nomi degli oggetti e altri dati in questi modelli. Inoltre, assicuratevi di rimuovere i comandi che non utilizzate e di aggiungere nuovi comandi allo script dove necessario.

Per eseguire il GetCliScenario comando, completa i prerequisiti e accedi alla modalità AWS SCT interattiva CLI. Per ulteriori informazioni, consulta Modalità interattiva.

Quindi, utilizzate la seguente sintassi per eseguire il GetCliScenario comando e ottenere gli scenari. AWS SCT 

GetCliScenario -type: 'template_type' -directory: 'file_path'
/

Nell'esempio precedente, sostituite template_type con uno dei tipi di modello della tabella seguente. Quindi, sostituisci file_path con il percorso della cartella in cui desideri scaricare gli script. Assicurati che AWS SCT possa accedere a questa cartella senza richiedere i diritti di amministratore. Inoltre, assicuratevi di utilizzare le virgolette singole diritte (') prima e dopo i valori dei parametri del comando.

Per scaricare tutti i modelli AWS SCT CLI, esegui il comando precedente senza l'opzione. -type

La tabella seguente include i tipi di modelli AWS SCT CLI che è possibile scaricare. Per ogni modello, la tabella include il nome del file e la descrizione delle operazioni che è possibile eseguire utilizzando lo script.

Tipo di modello Nome file Descrizione

BTEQ ScriptConversion

BTEQScriptConversionTemplate.scts

Converte Teradata Basic Teradata Query (BTEQ) FastExport e FastLoad gli script in Amazon Redshift RSQL. MultiLoad Per ulteriori informazioni, consulta Conversione dei processi ETL.

ConversionApply

ConversionTemplate.scts

Converte gli schemi del database di origine e applica il codice convertito al database di destinazione. Facoltativamente, salva il codice convertito come script SQL e salva il rapporto di valutazione. Per ulteriori informazioni, consulta Conversione di schemi di database.

GenericAppConversion

GenericApplicationConversionTemplate.scts

Converte il codice SQL incorporato nelle applicazioni con il convertitore di AWS SCT applicazioni generico. Per ulteriori informazioni, consulta Conversione del codice SQL nelle tue applicazioni.

HadoopMigration

HadoopMigrationTemplate.scts

Esegue la migrazione del cluster Hadoop locale su Amazon EMR. Per ulteriori informazioni, consulta Utilizzo di Apache Hadoop come fonte per AWS SCT.

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

Riprende una migrazione interrotta del cluster Hadoop locale su Amazon EMR. Per ulteriori informazioni, consulta Utilizzo di Apache Hadoop come fonte per AWS SCT.

Informatica

InformaticaConversionTemplate.scts

Converte il codice SQL incorporato negli script di estrazione, trasformazione e caricamento (ETL) di Informatica. Configura le connessioni ai database di origine e di destinazione negli script ETL e salva gli script convertiti dopo la conversione. Per ulteriori informazioni, consulta Conversione di script ETL di Informatica.

LanguageSpecificAppConversion

LanguageSpecificAppConversionTemplate.scts

Converte il codice SQL incorporato nelle applicazioni C#, C++, Java e Pro*C con il convertitore di applicazioni. AWS SCT Per ulteriori informazioni, consulta Conversione del codice SQL di un'applicazione.

OozieConversion

OozieConversionTemplate.scts

Converte i flussi di lavoro di Apache Oozie in. AWS Step Functions Per ulteriori informazioni, consulta Utilizzo di Apache Oozie come fonte per AWS SCT.

RedshiftAgent

DWHDataMigrationTemplate.scts

Converte gli schemi di data warehouse di origine e applica il codice convertito al database Amazon Redshift di destinazione. Quindi registra un agente di estrazione dei dati, crea e avvia un'attività di migrazione dei dati. Per ulteriori informazioni, consulta Migrazione da un data warehouse ad Amazon Redshift.

ReportCreation

ReportCreationTemplate.scts

Crea un rapporto sulla migrazione del database per diversi schemi di database di origine. Quindi salva questo rapporto come file CSV o PDF. Per ulteriori informazioni, consulta Rapporti di valutazione della migrazione.

SQL ScriptConversion

SQLScriptConversionTemplate.scts

Converte gli script SQL*Plus o TSQL in PL/SQL e salva gli script convertiti. Inoltre, salva un rapporto di valutazione.

Dopo aver scaricato il modello AWS SCT CLI, utilizza l'editor di testo per configurare lo script da eseguire sui database di origine e di destinazione. Quindi, usa la modalità script AWS SCT CLI per eseguire lo script. Per ulteriori informazioni, consulta AWS SCT modalità script CLI.

Esempi

L'esempio seguente scarica tutti i modelli nella C:\SCT\Templates cartella.

GetCliScenario -directory: 'C:\SCT\Templates'
/

L'esempio seguente scarica il modello per l'ConversionApplyoperazione nella C:\SCT\Templates cartella.

GetCliScenario -type: 'ConversionApply' -directory: 'C:\SCT\Templates'
/

Modifica degli AWS SCT scenari CLI

Dopo aver scaricato i modelli di scenario, configurali per ottenere script funzionanti da eseguire sui tuoi database.

Per tutti i modelli, assicurati di fornire il percorso dei driver per i database di origine e di destinazione. Per ulteriori informazioni, consulta Scaricamento dei driver di database richiesti.

Assicurati di includere le credenziali del database per i database di origine e di destinazione. Inoltre, assicuratevi di impostare delle regole di mappatura per descrivere una coppia sorgente-destinazione per il vostro progetto di conversione. Per ulteriori informazioni, consulta Creazione di regole di mappatura.

Quindi, configura l'ambito delle operazioni da eseguire. È possibile rimuovere i comandi che non si utilizzano o aggiungere nuovi comandi allo script.

Ad esempio, supponiamo di voler convertire tutti gli schemi del database Oracle di origine in PostgreSQL. Quindi intendi salvare il rapporto di valutazione della migrazione del database in formato PDF e applicare il codice convertito al database di destinazione. In questo caso, puoi utilizzare il modello per l'ConversionApplyoperazione. Utilizza la procedura seguente per modificare il modello AWS SCT CLI.

Per modificare il modello AWS SCT CLI per l'operazione ConversionApply

  1. Apri quello ConversionTemplate.scts che hai scaricato. Per ulteriori informazioni, consulta Esempi.

  2. Rimuovi CreateFilter, converti le operazioni -filter, ApplyToTarget -filter, SaveTargetSQL, SaveTargetSQ LbyStatement e SaveReportCSV dallo script.

  3. Per oracle_driver_file nell'operazione, inserisci il percorso del tuo driver Oracle. SetGlobalSettings Quindi, per postgresql_driver_file, inserisci il percorso del tuo driver PostgreSQL.

    Se utilizzi altri motori di database, usa i nomi appropriati per le impostazioni. Per un elenco completo delle impostazioni globali che è possibile impostare SetGlobalSettingsdurante l'operazione, vedere Matrice delle impostazioni globali inMateriale di riferimento.

  4. (Facoltativo) Per CreateProject, inserite il nome del progetto e la posizione del file di progetto locale. Se scegli di procedere con i valori predefiniti, assicurati che sia AWS SCT possibile creare file nella C:\temp cartella senza richiedere i diritti di amministratore.

  5. Per AddSource, inserisci l'indirizzo IP del server del database di origine. Inoltre, inserisci il nome utente, la password e la porta per connetterti al server del database di origine.

  6. Per AddTarget, inserisci l'indirizzo IP del server di database di destinazione. Inoltre, inserisci il nome utente, la password e la porta per connetterti al server del database di destinazione.

  7. (Facoltativo) Per AddServerMapping, inserisci gli oggetti del database di origine e di destinazione che desideri aggiungere a una regola di mappatura. È possibile utilizzare targetTreePath i parametri sourceTreePath e per specificare il percorso degli oggetti del database. Facoltativamente, è possibile targetNamePath utilizzare sourceNamePath e specificare i nomi degli oggetti del database. Per ulteriori informazioni, vedere Comandi di mappatura del server in. Materiale di riferimento

    I valori predefiniti dell'AddServerMappingoperazione mappano tutti gli schemi di origine con il database di destinazione.

  8. Salvate il file e quindi utilizzate la modalità script per eseguirlo. Per ulteriori informazioni, consulta Modalità script.

AWS SCT modalità script CLI

Dopo aver creato uno script AWS SCT CLI o modificato un modello, puoi eseguirlo con il RunSCTBatch comando. Assicurati di salvare il file con lo script CLI come estensione. .scts

È possibile eseguire gli script AWS SCT CLI dalla app cartella del percorso di installazione. AWS SCT In Windows, il percorso di installazione predefinito è. C:\Program Files\AWS Schema Conversion Tool\ Assicurati che questa cartella includa il RunSCTBatch.sh file RunSCTBatch.cmd or. Inoltre, questa cartella dovrebbe includere il AWSSchemaConversionToolBatch.jar file.

In alternativa, è possibile aggiungere il percorso del RunSCTBatch file nella variabile di PATH ambiente del sistema operativo. Dopo aver aggiornato la variabile di PATH ambiente, puoi eseguire gli script AWS SCT CLI da qualsiasi cartella.

Per eseguire uno script AWS SCT CLI, utilizzate il seguente comando in Windows.

RunSCTBatch.cmd --pathtoscts "file_path"

Nell'esempio precedente, sostituite file_path con il percorso del file con uno script.

Per eseguire uno script AWS SCT CLI, utilizzare il seguente comando in Linux.

RunSCTBatch.sh --pathtoscts "file_path"

Nell'esempio precedente, sostituite file_path con il percorso del file con uno script.

È possibile fornire parametri opzionali in questo comando, come le credenziali del database, il livello di dettagli nell'output della console e altri. Per ulteriori informazioni, scaricate il riferimento all'interfaccia della riga di AWS SCT comando all'indirizzoMateriale di riferimento.

Esempi

L'esempio seguente esegue lo ConversionTemplate.scts script nella C:\SCT\Templates cartella. È possibile utilizzare questo esempio in Windows.

RunSCTBatch.cmd --pathtoscts "C:\SCT\Templates\ConversionTemplate.scts"

L'esempio seguente esegue lo ConversionTemplate.scts script nella /home/user/SCT/Templates directory. È possibile utilizzare questo esempio in Linux.

RunSCTBatch.sh --pathtoscts "/home/user/SCT/Templates/ConversionTemplate.scts"

AWS SCT Materiale di riferimento CLI

È possibile trovare materiale di riferimento sull'interfaccia a riga di AWS Schema Conversion Tool comando (CLI) nella seguente guida: CLI AWS Schema Conversion Tool Reference.