Condividi tramite

Opzioni della riga di comando nella console SSMA (Db2ToSQL)

  • Articolo

SQL Server Migration Assistant (SSMA) offre un set affidabile di opzioni della riga di comando per eseguire e controllare le attività db2. Le sezioni successive descrivono in dettaglio lo stesso.

Opzioni della riga di comando nella console di SSMA

In questa sezione vengono descritte le opzioni dei comandi della console, note anche come opzioni.

Le opzioni non fanno distinzione tra maiuscole e minuscole e possono iniziare con o - , / carattere.

Se vengono specificate opzioni, è necessario specificare i parametri di opzione corrispondenti.

I parametri di opzione devono essere separati dal carattere di opzione in base allo spazio vuoto.

Esempi di sintassi:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ServersConnectionFileSample.xml"

Le cartelle e i nomi di file contenenti spazi devono essere specificati tra virgolette doppie.

L'output delle voci della riga di comando e dei messaggi di errore viene archiviato in STDOUT o in un file specificato.

Opzione file script: -s | copione

Un'opzione obbligatoria, il percorso/nome del file di script specifica lo script delle sequenze di comandi eseguite da SSMA.

Esempio di sintassi:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Opzione file valore variabile: -v | variabile

Questo file include variabili usate nel file di script. Questo switch è facoltativo. Se le variabili non vengono dichiarate nel file di variabile e usate nel file di script, l'applicazione genera un errore e termina l'esecuzione della console.

Esempio di sintassi:

Variabili definite in più file di valori di variabile, ad esempio uno con un valore predefinito e un altro con un valore specifico dell'istanza, se applicabile. L'ultimo file di variabile specificato negli argomenti della riga di comando accetta la preferenza, nel caso in cui esista una duplicazione delle variabili:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migration projects\global_variablevaluefile.xml -v "C:\migrationprojects\instance_variablevaluefile.xml"

Opzione file di connessione server: -c | serverconnection

Questo file contiene informazioni di connessione server per ogni server. Ogni definizione del server è identificata da un ID server univoco. Gli ID server vengono a cui viene fatto riferimento nel file di script per i comandi correlati alla connessione.

La definizione del server può far parte del file di connessione del server e/o del file di script. L'ID server nel file di script ha la precedenza sul file di connessione del server, nel caso in cui sia presente una duplicazione dell'ID server.

Esempi di sintassi:

  • Gli ID server vengono usati nel file di script e vengono definiti in un file di connessione server separato. Il file di connessione del server usa le variabili definite nel file di valore della variabile:

    SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\SsmaProjects\myvaluefile1.xml -c C:\SsmaProjects\myserverconnectionsfile1.xml

  • La definizione del server è incorporata nel file di script:

    SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Opzione di output XML: -x | xmloutput [ xmloutputfile ]

Questo comando viene usato per l'output dei messaggi di output del comando in un formato XML nella console o in un file XML.

Sono disponibili due opzioni per xmloutput, ad esempio:

  • Se il percorso del file viene fornito dopo l'opzione xmloutput , l'output viene reindirizzato al file.

    Esempio di sintassi:

    SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml

  • Se non viene specificato alcun percorso di file dopo l'opzione xmloutput , l'oggetto xmlout viene visualizzato nella console stessa.

    Esempio di sintassi:

    SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Opzione file di log: -l | registro

Tutte le operazioni SSMA nell'applicazione console vengono registrate in un file di log. Questo switch è facoltativo. Se nella riga di comando viene specificato un file di log e il relativo percorso, il log viene generato nel percorso specificato. In caso contrario, viene generato nel percorso predefinito.

Esempio di sintassi:

SSMAforDb2Console.exe "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l C:\SsmaProjects\migration1.log

Opzione cartella ambiente progetto: -e | projectenvironment

Indica la cartella delle impostazioni dell'ambiente del progetto per il progetto SSMA corrente. Questo switch è facoltativo.

Esempio di sintassi:

SSMAforDb2Console.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Db2\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e C:\SsmaProjects\CommonEnvironment

Opzione Secure password: -p | securepassword

Questa opzione indica la password crittografata per le connessioni server. Differisce da tutte le altre opzioni: l'opzione non esegue alcun script o aiuta in qualsiasi attività correlata alla migrazione. Consente invece di gestire la crittografia delle password per le connessioni server usate nel progetto di migrazione.

Non è possibile immettere altre opzioni o password come parametro della riga di comando. In caso contrario, si verificherà un errore. Per altre informazioni, vedere Gestire le password.

Sono supportate le seguenti sostituzioni per -p | securepassword:

  • Per aggiungere la password all'archiviazione protetta per un ID server specificato o per tutti gli ID server definiti nel file di connessione del server. L'opzione -overwrite aggiorna la password se esiste già:

    -p | -securepassword -a | add { "<server_id> [, ...n]" | all }
-c | -serverconnection <server-connection-file> [ -v | variable <variable-value-file> ]
[ -o | overwrite]

    -p | -securepassword -a | add { "<server_id>[, ...n]" | all }
-s | -script <server-connection-file> [ -v | variable <variable-value-file> ]
[ -o | overwrite]

  • Per rimuovere la password crittografata dall'archiviazione protetta dell'ID server specificato o per tutti gli ID server:

    -p | securepassword -r | remove { <server_id> [, ...n] | all }

  • Per visualizzare un elenco di ID server per cui la password è crittografata:

    -p | securepassword -l | list

  • Per esportare le password archiviate nell'archiviazione protetta in un file crittografato. Questo file viene crittografato con la pass-phrase specificata dall'utente.

    -p | securepassword -e | export { <server-id> [, ...n] | all } <encrypted-password-file>

  • Il file crittografato esportato in precedenza viene importato nella risorsa di archiviazione protetta locale usando la pass-phrase specificata dall'utente. Una volta decrittografato, il file viene archiviato in un nuovo file, che a sua volta viene crittografato nel computer locale.

    -p | securepassword -i | import { <server-id> [, ...n] | all } <encrypted-password-file>

    È possibile specificare più ID server usando separatori di virgole.

Opzione ?? | Guida

Visualizza il riepilogo della sintassi delle opzioni della console SSMA:

SSMAforDb2Console.exe -?

Per una visualizzazione tabulare delle opzioni della riga di comando della console SSMA, vedere Appendice 1: Opzioni della riga di comando della console.

Opzione della Guida SecurePassword: -securepassword -? | Guida

Visualizza il riepilogo della sintassi delle opzioni della console SSMA:

SSMAforDb2Console.exe -securepassword -?

Per una visualizzazione tabulare delle opzioni della riga di comando della console SSMA, vedere Appendice 1: Opzioni della riga di comando della console

Contenuto correlato