Opzioni della riga di comando nella console SSMA (OracleToSQL)

  • Articolo

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

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 di opzione devono essere separati dal carattere di opzione in base allo spazio vuoto.

    Esempi di sintassi:

    C:\> SSMAforOracleConsole.EXE -s scriptfile

    C:\> SSMAforOracleConsole.EXE -s "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \AssessmentReportGenerationSample.xml" -v "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\Sample Console Scripts \VariableValueFileSample.xml" -c "C Program Files\Microsoft SQL Server Migration Assistant for Oracle\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 script: -s/script

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

Esempi di sintassi:

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

Opzione file valore variabile: -v/variable

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.

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 accetta la preferenza, nel caso in cui esista una duplicazione delle variabili:

    C:\>SSMAforOracleConsole.EXE -s

    "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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 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 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:\>SSMAforOracleConsole.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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:\>SSMAforOracleConsole.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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 da console o in 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:\>SSMAforOracleConsole.EXE -s

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

  • Se non viene fornito alcun percorso file dopo l'opzione xmloutput, il file xmlout viene visualizzato nella console stessa.

    Esempio di sintassi:

    C:\>SSMAforOracleConsole.EXE -s "C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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 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:

C:\>SSMAforOracleConsole.EXE

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

Opzione cartella Ambiente del progetto: -e/projectenvironment

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

Esempio di sintassi:

C:\>SSMAforOracleConsole.EXE -s

"C:\ Program Files\Microsoft SQL Server Migration Assistant for Oracle\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 del 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 la sezione Gestione delle password.

Le seguenti opzioni secondarie 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 (nel caso in cui già esista):

    -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 decrittato, 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

Visualizzare il riepilogo della sintassi delle opzioni della console SSMA:

C:\>SSMAforOracleConsole.EXE -?

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

Opzione della Guida SecurePassword: -securepassword -?/Help

Visualizzare il riepilogo della sintassi delle opzioni della console SSMA:

C:\>SSMAforOracleConsole.EXE -securepassword -?

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

Passaggio successivo

Il passaggio successivo dipende dai requisiti del progetto: