CLIRiferimento per AWS Schema Conversion Tool - AWS Schema Conversion Tool
PrerequisitiModalità interattivaOttenere CLI scenariModifica CLI degli scenariModalità 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à.

CLIRiferimento per AWS Schema Conversion Tool

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 AWS SCT CLI comandi, vederemateriale di riferimento.

Prerequisiti per l'utilizzo dell'interfaccia AWS SCT a 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 Schema Conversion Tool.

AWS SCT CLImodalità interattiva

È 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 CLI comandi o scaricare gli CLI scenari 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 questa modalità. AWS SCT CLI Per ulteriori informazioni, consulta Modalità script.

È possibile eseguire i AWS SCT CLI comandi 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à AWS SCT CLI interattiva, utilizzate il seguente comando dopo aver completato i prerequisiti.

java -jar AWSSchemaConversionToolBatch.jar -type interactive

Ora puoi eseguire AWS SCT CLI i comandi. 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à AWS SCT CLI interattiva, esegui il comando seguente.

help
/

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

help -command: 'command_name'
/

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

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

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

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

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

ExecuteFile -file: 'file_path'
/

Nell'esempio precedente, replace file_path con il percorso del file con uno script. Assicurati che il file abbia un'.sctsestensione.

Per uscire dalla modalità AWS SCT CLI interattiva, 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 CLI scenari

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 CLI interattiva. Per ulteriori informazioni, consulta Modalità interattiva.

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

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

Nell'esempio precedente, sostituisci template_type con uno dei tipi di modello indicati nella tabella seguente. Quindi, sostituisci file_path con il percorso della cartella in cui si desidera 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 AWS SCT CLI modelli, eseguite il comando precedente senza l'-typeopzione.

La tabella seguente include i tipi di AWS SCT CLI modelli 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

BTEQScriptConversion

BTEQScriptConversionTemplate.scts

Converte Teradata Basic Teradata Query (BTEQ) e gli script MultiLoad in FastExport Amazon FastLoad Redshift. RSQL Per ulteriori informazioni, consulta Conversione di dati utilizzando 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 SQL script e salva il rapporto di valutazione. Per ulteriori informazioni, consulta Conversione di schemi.

GenericAppConversion

GenericApplicationConversionTemplate.scts

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

HadoopMigration

HadoopMigrationTemplate.scts

Migra il tuo cluster Hadoop locale su Amazon. EMR Per ulteriori informazioni, consulta Connessione ai database Apache Hadoop con AWS Schema Conversion Tool.

HadoopResumeMigration

HadoopResumeMigrationTemplate.scts

Riprende una migrazione interrotta del cluster Hadoop locale su Amazon. EMR Per ulteriori informazioni, consulta Connessione ai database Apache Hadoop con AWS Schema Conversion Tool.

Informatica

InformaticaConversionTemplate.scts

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

LanguageSpecificAppConversion

LanguageSpecificAppConversionTemplate.scts

Converte il SQL codice incorporato nelle applicazioni C#, C++, Java e Pro*C con il convertitore di applicazioni. AWS SCT Per ulteriori informazioni, consulta Applicazione di conversione SQL.

OozieConversion

OozieConversionTemplate.scts

Converte i flussi di lavoro di Apache Oozie in. AWS Step Functions Per ulteriori informazioni, consulta Connessione ai flussi di lavoro di Apache Oozie con AWS Schema Conversion Tool.

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.

ReportCreation

ReportCreationTemplate.scts

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

SQLScriptConversion

SQLScriptConversionTemplate.scts

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

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

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'
/

AWS SCT CLIScenari di modifica

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 Installazione JDBC dei driver per AWS Schema Conversion Tool.

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 Mappatura dei tipi di dati.

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 nel database Oracle di origine in Postgre. SQL Quindi intendete salvare il rapporto di valutazione della migrazione del database come file PDF e applicare il codice convertito al database di destinazione. In questo caso, è possibile utilizzare il modello per l'ConversionApplyoperazione. Per modificare il AWS SCT CLI modello, utilizzare la procedura seguente.

Per modificare il AWS SCT CLI modello per l'ConversionApplyoperazione

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

  2. Rimuovi CreateFilter, converti -filter, ApplyToTarget -filter e SaveReportCSVoperazioni dallo script. SaveTargetSQLSaveTargetSQLbyStatement

  3. Per oracle_driver_file nell'SetGlobalSettingsoperazione, inserisci il percorso del tuo driver Oracle. Quindi, per postgresql_driver_file, inserisci il percorso del driver Postgre. SQL

    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 CLImodalità script

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

È possibile eseguire AWS SCT CLI gli script 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 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, è possibile eseguire AWS SCT CLI gli script da qualsiasi cartella.

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

RunSCTBatch.cmd --pathtoscts "file_path"

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

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

RunSCTBatch.sh --pathtoscts "file_path"

Nell'esempio precedente, sostituisci 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 CLImateriale di riferimento

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