Dela via

Skapa skriptfiler (Db2ToSQL)

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:

  1. 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...>

  2. 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>

  3. 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>

  4. Å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>

  5. 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>

  6. 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>

  7. 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.

  8. 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...>

  9. 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...>

  10. Å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.

Relaterat innehåll

  • Last updated on