Skapa skriptfiler (Db2ToSQL)

2025-03-05

Innan du kan starta SSMA-konsolprogrammet (SQL Server Migration Assistant) måste du skapa skriptfilen. Om det behövs kan du också skapa variabelvärdefilen och serveranslutningsfilen.

Skriptfilen kan delas in i tre avsnitt:

Sektion	Beskrivning
`config`	Ange konfigurationsparametrarna för konsolprogrammet.
`servers`	Ange käll-/målserverdefinitionerna. Kan också finnas i en separat serveranslutningsfil.
`script-commands`	Kör SSMA-arbetsflödeskommandon.

Varje avsnitt beskrivs i detalj i den här artikeln.

Konfigurera SSMA-konsolprograminställningar

Konfigurationerna av ett skript visas i konsolskriptfilen.

Om något av elementen anges i konfigurationsnoden anges de som global inställning. Med andra ord gäller de för alla skriptkommandon. Dessa konfigurationselement kan också anges i varje kommando i avsnittet script-command om du vill åsidosätta den globala inställningen.

Alternativen som kan konfigureras av användaren är:

Utdatafönsterprovider: Om suppress-messages attribut är inställt på truevisas inte de kommandospecifika meddelandena i konsolen.

Attribut	Beskrivning
`destination`	Anger om utdata måste skrivas ut till en fil eller stdout. `false` som standard.
`file-name` (valfritt)	Sökvägen till filen.
`suppress-messages`	Undertrycker meddelanden i konsolen. `false` som standard.

Exempel:

<output-providers>
  <output-window
    suppress-messages="<true/false>"   (optional)
    destination="<file/stdout>"        (optional)
    file-name="<file-name>"            (optional)
   />
</output-providers>

eller

<...All commands...>
  <output-window
     suppress-messages="<true/false>"   (optional)
     destination="<file/stdout>"        (optional)
     file-name="<file-name>"            (optional)
   />
</...All commands...>

Anslutningsprovider för datamigrering: Anger vilken käll-/målserver som ska beaktas för datamigrering. Källanvändning senast använd anger att den senast använda källservern används för datamigrering. På samma sätt indikerar "målanvändning senast-använd" att den senast använda målservern används för datamigrering. Du kan också ange servern (källa eller mål) med hjälp av attributen source-server eller target-server.

Endast ett av dessa attribut kan anges i taget:
- source-use-last-used="true" (standard) eller source-server="<source-server-unique-name>"
- target-use-last-used="true" (standard) eller target-server="<target-server-unique-name>"
Exempel:
```
<output-providers>
  <data-migration-connection   source-use-last-used="true"
                               target-server="<target-server-unique-name>"/>
</output-providers>
```
eller
```
<migrate-data>
  <data-migration-connection   source-server="<source-server-unique-name>"
                               target-use-last-used="true"/>
</migrate-data>
```

Användarinmatningspopup: Tillåter hantering av fel när objekten läses in från databasen. Du anger indatalägena och om det uppstår ett fel fortsätter konsolen enligt beskrivningen.

Läge	Beskrivning
`ask-user`	Uppmanar dig att fortsätta (`yes`) eller fel ut (`no`).
`error` (förval)	Konsolen visar ett fel och stoppar körningen.
`continue`	Konsolen fortsätter med exekveringen.

Exempel:

<output-providers>
  <user-input-popup mode="<ask-user/continue/error>"/>
</output-providers>

eller

<!-- Connect to target database -->
<connect-target-database server="<target-server-unique-name>">
  <user-input-popup mode="<ask-user/continue/error>"/>
</connect-target-database>

Återanslutningsprovider: Gör att du kan ange återanslutningsinställningarna om det uppstår ett anslutningsfel. Detta kan anges för både käll- och målservrar.

Återanslutningsläge	Beskrivning
`reconnect-to-last-used-server`	Om anslutningen inte är aktiv försöker den återansluta till den senaste servern som används högst fem gånger.
`generate-an-error` (standardvärde)	Om anslutningen inte är aktiv genereras ett fel.

Exempel:

<output-providers>
  <reconnect-manager  on-source-reconnect="<reconnect-to-last-used-server/generate-an-error>"
                      on-target-reconnect="<reconnect-to-last-used-server/generate-an-error>"/>
</output-providers>

eller

<!--synchronization-->
<synchronize-target>
  <reconnect-manager on-target-reconnect="reconnect-to-last-used-server"/>
</synchronize-target>

eller

<!--data migration-->
<migrate-data server="<target-server-unique-name>">
  <reconnect-manager
    on-source-reconnect="reconnect-to-last-used-server"
    on-target-reconnect="generate-an-error"/>
</migrate-data>

Converter Overwrite Provider: Gör att du kan hantera objekt som redan finns på målmetabasen.

Handling	Beskrivning
`error`	Konsolen visar ett fel och stoppar körningen.
`overwrite` (standard)	Skriver över befintliga objektvärden.
`skip`	Konsolen hoppar över de objekt som redan finns i databasen.
`ask-user`	Uppmanar dig att ange indata (`yes` / `no`).

Exempel:

<output-providers>
  <object-overwrite action="<error/skip/overwrite/ask-user>"/>
</output-providers>

eller

<convert-schema object-name="<object-name>">
  <object-overwrite action="<error/skip/overwrite/ask-user>"/>
</convert-schema>

Leverantör för misslyckade förutsättningar: Du kan hantera alla nödvändiga förutsättningar för att bearbeta ett kommando. Som standard är strict-modefalse. Om truegenereras ett undantag för att kraven inte uppfylls.

Exempel:
```
<output-providers>
  <prerequisites strict-mode="<true/false>"/>
</output-providers>
```
Stop Operation: Om du vill stoppa åtgärden under mitten av åtgärden kan du använda Ctrl+C snabbtangent. SSMA för SSMA-konsolprogrammet väntar på att åtgärden ska slutföras och avslutar konsolkörningen.

Om du vill stoppa körningen omedelbart kan Ctrl+C- snabbtangenten tryckas på igen för att avsluta SSMA-konsolprogrammet.

Progress Provider: Ger information om framstegen för varje konsolkommando. Inaktiverad som standard. Attributen för förloppsrapportering består av:

off
every-1%
every-2%
every-5%
every-10%
every-20%

Exempel:

<output-providers>
  progress-reporting   enable="<true/false>"            (optional)
                       report-messages="<true/false>"   (optional)
                       report-progress="every-1%/every-2%/every-5%/every-10%/every-20%/off" (optional)/>
</output-providers>

eller

<...All commands...>
  <progress-reporting
    enable="<true/false>"              (optional)
    report-messages="<true/false>"     (optional)
    report-progress="every-1%/every-2%/every-5%/every-10%/every-20%/off"     (optional)/>
</...All commands...>

sv-SE: Logger Verbosity: Ställer in loggverbalitetsnivå. Detta motsvarar alternativet Alla kategorier i användargränssnittet.

Loggnivå	Beskrivning
`fatal-error`	Endast fatala felmeddelanden loggas.
`error` (standard)	Endast felmeddelanden och felmeddelanden med dödlig utgång loggas.
`warning`	Alla nivåer utom felsöknings- och informationsmeddelanden loggas.
`info`	Alla nivåer utom felsökningsmeddelanden loggas.
`debug`	Alla meddelandenivåer loggas.

Obligatoriska meddelanden loggas på valfri nivå.

Exempel:

<output-providers>
  <log-verbosity level="fatal-error/error/warning/info/debug"/>
</output-providers>

eller

<...All commands...>
  <log-verbosity level="fatal-error/error/warning/info/debug"/>
</...All commands...>

Åsidosätt krypterat lösenord: Om trueåsidosätter lösenordet för klartext som anges i avsnittet serverdefinition i serveranslutningsfilen eller i skriptfilen det krypterade lösenordet som lagras i skyddat lagringsutrymme om det finns. Om inget lösenord anges i klartext uppmanas du att ange lösenordet.

Här uppstår två fall:
1. Om åsidosättningsalternativet är falseär sökordningen Skyddad lagring > skriptfil > serveranslutningsfil > Fråga användaren.
2. Om åsidosättningsalternativet är sant, är sökningsordningen skriptfil > serveranslutningsfil > fråga användare.
Exempel:
```
<output-providers>
  <encrypted-password override="<true/false>"/>
</output-providers>
```

Det icke-konfigurerbara alternativet är:

Maximalt antal återanslutningsförsök: När en upprättad anslutning överskrider tidsgränsen eller bryts på grund av nätverksfel måste servern återanslutas. Återanslutningsförsöken får ske högst 5 gånger, varefter konsolen automatiskt genomför återanslutningen. Funktionen för automatisk återanslutning minskar ditt arbete med att köra skriptet igen.

Parametrar för serveranslutning

Serveranslutningsparametrar kan definieras i skriptfilen eller i serveranslutningsfilen. Mer information finns i Skapa serveranslutningsfilerna.

Skriptkommandon

Skriptfilen innehåller en sekvens med migreringsarbetsflödeskommandon i XML-format. SSMA-konsolprogrammet bearbetar migreringen i ordningen för kommandona som visas i skriptfilen.

Till exempel följer en typisk datamigrering av en specifik tabell i en Db2-databas hierarkin för schema>tabell.

När alla kommandon i skriptfilen har körts avslutas SSMA-konsolprogrammet. Innehållet i en skriptfil är mer eller mindre statiskt med variabelinformation som antingen finns i en variabelvärdefil eller, i ett separat avsnitt i skriptfilen för variabelvärden.

Exempel:

Här är ett exempel på skriptfilkommandona:

<ssma-script-file>
  <script-commands>
    <create-new-project project-folder="<project-folder>"
                        project-name="<project-name>"
                        overwrite-if-exists="<true/false>"/>
    <connect-source-database server="<source-server-unique-name>"/>
    <save-project/>
    <close-project/>
  </script-commands>
</ssma-script-file>

Mallar som består av tre skriptfiler (för att köra olika scenarier), variabelvärdefil och en serveranslutningsfil finns i mappen Exempelkonsolskript i produktkatalogen:

AssessmentReportGenerationSample.xml
ConversionAndDataMigrationSample.xml
SqlStatementConversionSample.xml
VariableValueFileSample.xml
ServersConnectionFileSample.xml

Du kan köra mallarna (filerna) när du har ändrat parametrarna som visas däri för relevans.

Fullständig lista över skriptkommandon finns i Kör SSMA-konsolen

Validering av skriptfil

Du kan verifiera skriptfilen mot schemadefinitionsfilen O2SSConsoleScriptSchema.xsd, som är tillgänglig i mappen Schemas.

Skapa filer för variabelvärde (Db2ToSQL)

Dela via

Skapa skriptfiler (Db2ToSQL)

Konfigurera SSMA-konsolprograminställningar

Parametrar för serveranslutning

Skriptkommandon

Validering av skriptfil

Relaterat innehåll

Feedback

Ytterligare resurser