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à.
# Riferimento CLI 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 comandi AWS SCT CLI, vedere. [Materiale di riferimento](#CHAP_Reference.Download)
**Topics**
+ [Prerequisiti per l'utilizzo dell'interfaccia a AWS SCT riga di comando](#CHAP_Reference.Prerequisites)
+ [AWS SCT modalità interattiva CLI](#CHAP_Reference.InteractiveMode)
+ [Ottenere AWS SCT scenari CLI](#CHAP_Reference.Scenario)
+ [Modifica degli AWS SCT scenari CLI](#CHAP_Reference.Editing)
+ [AWS SCT modalità script CLI](#CHAP_Reference.ScriptMode)
+ [AWS SCT Materiale di riferimento CLI](#CHAP_Reference.Download)
## 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](https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html) 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](CHAP_Installing.Procedure.md).
## 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](#CHAP_Reference.ScriptMode).
È 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 restituito`Unexpected 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, sostituiscilo *command\$1name* 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, sostituisci *command\$1name* con il nome di un comando. Sostituitelo quindi *parameters\$1list* 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, sostituitelo *file\$1path* con il percorso del file con uno script. Assicurati che il file abbia un'`.scts`estensione.
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](#CHAP_Reference.InteractiveMode).
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, sostituitelo *template\$1type* con uno dei tipi di modello indicati nella tabella seguente. Sostituite *file\$1path* quindi con il percorso la cartella in cui desiderate 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 | Description |
| --- | --- | --- |
| BTEQScriptConversione | `BTEQScriptConversionTemplate.scts` | Converte Teradata Basic Teradata Query (BTEQ) FastExport e FastLoad gli script in Amazon Redshift RSQL. MultiLoad Per ulteriori informazioni, consulta [Conversione di dati mediante ETL](CHAP-converting-etl.md). |
| 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](CHAP_Converting.md). |
| GenericAppConversion | `GenericApplicationConversionTemplate.scts` | Converte il codice SQL incorporato nelle applicazioni con il convertitore di AWS SCT applicazioni generico. Per ulteriori informazioni, consulta [Codice SQL](CHAP_Converting.App.Generic.md). |
| HadoopMigration | `HadoopMigrationTemplate.scts` | Esegue la migrazione del cluster Hadoop locale su Amazon EMR. Per ulteriori informazioni, consulta [Connessione ai database Apache Hadoop con AWS Schema Conversion Tool](CHAP_Source.Hadoop.md). |
| 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](CHAP_Source.Hadoop.md). |
| 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 [Script Informatica ETL](CHAP-converting-informatica.md). |
| LanguageSpecificAppConversion | `LanguageSpecificAppConversionTemplate.scts` | Converte il codice SQL incorporato nelle applicazioni C\$1, C\$1\$1, Java e Pro\$1C con il convertitore di applicazioni. AWS SCT Per ulteriori informazioni, consulta [Conversione del codice SQL dell'applicazione](CHAP_Converting.App.md). |
| 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](CHAP_Source.Oozie.md). |
| 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](agents.md). |
| 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 [Report di valutazione](CHAP_AssessmentReport.md). |
| SQLScriptConversione | `SQLScriptConversionTemplate.scts` | Converte e salva gli script SQL\$1Plus o TSQL negli script convertiti. PL/SQL 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](#CHAP_Reference.ScriptMode).
### 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'`ConversionApply`operazione 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 [Installazione dei driver JDBC per AWS Schema Conversion Tool](CHAP_Installing.JDBCDrivers.md).
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](CHAP_Mapping.md).
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'`ConversionApply`operazione. 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](#CHAP_Reference.Scenario.Examples).
1. Rimuovi **CreateFilter**, **convert -filter**, **ApplyToTarget -filter**, le operazioni **SaveTargetSQL**, **SaveTargetSQLbyStatement** e **SaveReportCSV** dallo script.
1. Per **oracle\$1driver\$1file** nell'operazione, inserisci il percorso del driver Oracle **SetGlobalSettings**. Quindi, per **postgresql\$1driver\$1file**, 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 **SetGlobalSettings**durante l'operazione, vedere **Matrice delle impostazioni globali** in[Materiale di riferimento](#CHAP_Reference.Download).
1. (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.
1. 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.
1. 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.
1. (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](#CHAP_Reference.Download)
I valori predefiniti dell'**AddServerMapping**operazione mappano tutti gli schemi di origine con il database di destinazione.
1. Salvate il file e quindi utilizzate la modalità script per eseguirlo. Per ulteriori informazioni, consulta [Modalità script](#CHAP_Reference.ScriptMode).
## 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, sostituitelo *file\$1path* 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, sostituitelo *file\$1path* 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'indirizzo[Materiale di riferimento](#CHAP_Reference.Download).
### 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.](https://s3.amazonaws.com/publicsctdownload/AWS+SCT+CLI+Reference.pdf)