Opzioni della riga di comando nella console SSMA (DB2ToSQL)

  • Articolo

Microsoft offre un solido set di comandi di opzioni della riga di comando per eseguire e controllare le attività SSMA. Le sezioni successive lo descrivono in dettaglio.

Opzioni della riga di comando nella console SSMA

Di seguito sono descritte le opzioni di comando della console.

Ai fini di questa sezione, il termine 'opzione' viene anche definito 'switch'.

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

Se vengono specificate opzioni, diventa obbligatorio specificare i parametri di opzione corrispondenti.

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

Esempi di sintassi:

C:\> SSMAforDB2Console.EXE -s scriptfile

C:\> 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"

I nomi di file o cartelle 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 di script: -s/script

Uno switch obbligatorio, il percorso/nome del file di script specifica lo script delle sequenze di comandi da eseguire da SSMA.

Esempi di sintassi:

C:\>SSMAforDB2Console.EXE -s "C Program Files\Microsoft SQL Server Migration Assistant for DB2\Sample Console Scripts \ConversionAndDataMigrationSample.xml"

Opzione file valore variabile: -v/variable

Questo file include variabili usate nel file di script. Questo è uno 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.

Esempi 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 variabili specificato negli argomenti della riga di comando ha la precedenza, nel caso in cui esista una duplicazione delle variabili:

    C:\>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 connessione del 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 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 sono definiti in un file di connessione server separato, il file di connessione del server usa variabili definite nel file del valore della variabile:

    C:\>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:

    C:\>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 emettere i messaggi di output del comando in un formato xml alla console o a un file XML.

Sono disponibili due opzioni per xmloutput, viz..,:

  • Se il percorso file viene fornito dopo che lo switch xmloutput, l'output viene reindirizzato al file.

    Esempio di sintassi:

    C:\>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 fornito alcun percorso file dopo lo switch xmloutput, xmlout viene visualizzato nella console stessa.

    Esempio di sintassi:

    C:\>SSMAforDB2Console.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for DB2\Sample Console Scripts \ConversionAndDataMigrationSample.xml" -xmloutput

Opzione file di log: -l/log

Tutte le operazioni SSMA nell'applicazione console vengono registrate in un file di log. Questo è uno 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 nella posizione predefinita.

Esempio di sintassi:

C:\>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:

C:\>SSMAforDB2Console.EXE -s

"C:\ Program Files\Microsoft SQL Server Migration Assistant for DB2\Sample Console Scripts \ConversionAndDataMigrationSample.xml" -e c:\SsmaProjects\CommonEnvironment

Opzione password sicura: -p/securepassword

Questa opzione indica la password crittografata per le connessioni server. Differisce da tutte le altre opzioni: l'opzione non esegue alcuno script né consente alcuna attività correlata alla migrazione, ma consente 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, consultare la sezione Gestione delle password.

Le sottoopzioni seguenti sono supportate 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, di seguito, 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 memorizzate nell'archiviazione protetta in un file crittografato. Questo file viene crittografato con una passphrase 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 passphrase 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: -?/Help

Visualizza il riepilogo della sintassi delle opzioni della console SSMA.

C:\>SSMAforDB2Console.EXE -?

Per una visualizzazione tabulare delle opzioni della riga di comando della console SSMA, vedere Appendice - 1 (DB2ToSQL).

Opzione della Guida SecurePassword: -securepassword -?/Help

Visualizza il riepilogo della sintassi delle opzioni della console SSMA.

C:\>SSMAforDB2Console.EXE -securepassword -?

Per una visualizzazione tabulare delle opzioni della riga di comando della console SSMA, vedere Appendice - 1 (DB2ToSQL)

Passaggio successivo

Il passaggio successivo dipende dai requisiti del progetto:

  1. Per specificare una password o un'esportazione/importare password, vedere Gestione delle password (DB2ToSQL).

  2. Per la generazione di report, vedere Generazione di report (DB2ToSQL).

  3. Per la risoluzione dei problemi nella console, vedere Risoluzione dei problemi (DB2ToSQL).