Delen via

Scriptbestanden maken (SybaseToSQL)

De eerste stap voordat u de SSMA-consoletoepassing start, is het maken van het scriptbestand en, indien nodig, het maken van het variabele-waardebestand en het serververbindingsbestand.

Het scriptbestand kan worden onderverdeeld in drie secties, viz..,:

  1. configuratie: Hiermee kan de gebruiker de configuratieparameters voor de consoletoepassing instellen.

  2. Servers: Hiermee kan de gebruiker de bron-/doelserverdefinities instellen. Dit kan ook in een afzonderlijk serververbindingsbestand staan.

  3. script-opdrachten: Hiermee kan de gebruiker SSMA-werkstroomopdrachten uitvoeren.

Elke sectie wordt hieronder gedetailleerd beschreven:

Sybase-consoleinstellingen configureren

De configuraties van een script worden weergegeven in het consolescriptbestand.

Als een van de elementen is opgegeven in het configuratieknooppunt, worden deze ingesteld als de globale instelling, dat wil willen stellen dat ze van toepassing zijn op alle scriptopdrachten. Deze configuratie-elementen kunnen ook worden ingesteld binnen elke opdracht in de sectie scriptopdracht als de gebruiker de globale instelling wil overschrijven.

De door de gebruiker configureerbare opties zijn onder andere:

  1. Uitvoervensterprovider: Als het kenmerk berichten onderdrukken is ingesteld op 'true', worden de opdrachtspecifieke berichten niet weergegeven op de console. Hieronder ziet u de beschrijving van de kenmerken:

    • doel: Hiermee geeft u op of de uitvoer moet worden afgedrukt naar een bestand of stdout. Dit is standaard onwaar.

    • bestandsnaam: het pad van het bestand (optioneel).

    • suppress-messages: onderdrukt berichten op de console. Dit is standaard 'false'.

    Voorbeeld:

    <output-providers>  

  <output-window  

    suppress-messages="<true/false>"   (optional)  

    destination="<file/stdout>"        (optional)  

    file-name="<file-name>"            (optional)  

   />  

</output-providers>

    of

    <...All commands...>  

  <output-window  

     suppress-messages="<true/false>"   (optional)  

     destination="<file/stdout>"        (optional)  

     file-name="<file-name>"            (optional)  

   />  

</...All commands...>

  2. Gegevensmigratieverbindingsprovider: Hiermee geeft u op welke bron-/doelserver moet worden overwogen voor gegevensmigratie. Brongebruik-laatst gebruikt geeft aan dat de laatst gebruikte bronserver wordt gebruikt voor gegevensmigratie. Op dezelfde manier geeft target-use-last-used aan dat de laatst gebruikte doelserver wordt gebruikt voor gegevensmigratie. De gebruiker kan ook de server (bron of doel) opgeven met behulp van de kenmerken bron-server of doelserver.

    Slechts één of het andere opgegeven kenmerk kan worden gebruikt, bijvoorbeeld:

    • source-use-last-used="true" (standaard) of source-server="source_servername"

    • target-use-last-used="true" (standaard) of target-server="target_servername"

    Voorbeeld:

    <output-providers>  

  <data-migration-connection   source-use-last-used="true"  

                               target-server="<target-server-unique-name>"/>  

</output-providers>

    of

    <migrate-data>  

  <data-migration-connection   source-server="<source-server-unique-name>"  

                               target-use-last-used="true"/>  

</migrate-data>

  3. Pop-up voor gebruikersinvoer: Hierdoor kunnen fouten worden verwerkt wanneer de objecten uit de database worden geladen. De gebruiker geeft de invoermodi op, en in het geval van een fout gaat de console verder zoals de gebruiker opgeeft.

    De modi omvatten onder andere:

    • ask-user - Vraagt de gebruiker om door te gaan ('ja') of een foutmelding te geven ('nee').

    • fout- In de console wordt een fout weergegeven en wordt de uitvoering gestopt.

    • voortzetten- De console gaat verder met de uitvoering.

    De standaardmodus is een fout.

    Voorbeeld:

    <output-providers>  

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

</output-providers>

    of

    <!-- Connect to target database -->  

<connect-target-database server="<target-server-unique-name>">  

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

</connect-target-database>

  4. Provider opnieuw verbinden: Hierdoor kan de gebruiker de instellingen voor opnieuw verbinding instellen in geval van verbindingsfouten. Dit kan worden ingesteld voor zowel bron- als doelservers.

    De modi voor opnieuw verbinden zijn:

    • opnieuw verbinding maken met de laatst gebruikte server: als de verbinding niet actief is, wordt geprobeerd opnieuw verbinding te maken met de laatste server die maximaal vijf keer wordt gebruikt.

    • genereren-een-fout: als de verbinding niet actief is, wordt er een fout gegenereerd.

    De standaardmodus is een fout genereren.

    Voorbeeld:

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

    of

    <!--synchronization-->  

<synchronize-target>  

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

</synchronize-target>

    of

    <!--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. Provider voor overschrijven van conversieprogramma: Hierdoor kan de gebruiker objecten verwerken die al aanwezig zijn op de doelmetabase. De mogelijke acties zijn:

    • fout: In de console wordt een fout weergegeven en wordt de uitvoering gestopt.

    • overschrijven: hiermee worden bestaande objectwaarden overschreven. Deze actie wordt standaard uitgevoerd.

    • skip: De console slaat de objecten die al in de database bestaan over

    • ask-user: vraagt de gebruiker om invoer ('ja'/ 'nee')

    Voorbeeld:

    <output-providers>  

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

</output-providers>

    of

    <convert-schema object-name="<object-name>">  

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

</convert-schema>

  6. Provider voor niet-vervulde vereisten: Hiermee kan een gebruiker alle vereisten behandelen die nodig zijn voor het verwerken van een opdracht. De strikte modus is standaard 'false'. Als deze is ingesteld op 'true', wordt er een uitzondering gegenereerd als de vereisten niet worden voldaan.

    Voorbeeld:

    <output-providers>  

  <prerequisites strict-mode="<true/false>"/>  

</output-providers>

  7. Stopbewerking: Als de gebruiker de bewerking tijdens de mid-bewerking wil stoppen, kan de sneltoets Ctrl+C worden gebruikt. SSMA voor Sybase Console wacht tot de bewerking is voltooid en beëindigt de uitvoering van de console.

    Als de gebruiker de uitvoering onmiddellijk wil stoppen, kan de sneltoets Ctrl+C opnieuw worden ingedrukt voor plotselinge beëindiging van de SSMA-consoletoepassing

  8. Voortgangsprovider: Informeert de voortgang van elke consoleopdracht. Deze optie is standaard uitgeschakeld. De kenmerken voor voortgangsrapportage bestaan uit:

    • uit

    • elke 1%

    • elke 2%

    • elke 5%

    • elke 10%

    • elke 20%

    Voorbeeld:

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

    of

    <...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. Logbook Verbosity: Stelt het verbaalheidsniveau van het logboek in. Dit komt overeen met de optie Alle categorieën in de gebruikersinterface. Standaard is het uitgebreidheidsniveau van het logboek 'error'.

    De opties op logniveau zijn:

    • fatal-error: Alleen fatale foutmeldingen worden vastgelegd.

    • Fout: Alleen fout- en fatale foutberichten worden geregistreerd.

    • waarschuwing: alle niveaus behalve foutopsporings- en informatieberichten worden vastgelegd.

    • info: Alle niveaus behalve foutopsporingsberichten worden vastgelegd.

    • Debug: Alle berichtniveaus zijn gelogd.

    Opmerking

    Verplichte berichten worden op elk niveau geregistreerd.

    Voorbeeld:

    <output-providers>  

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

</output-providers>

    of

    <...All commands...>  

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

</...All commands...>

  10. Versleuteld wachtwoord overschrijven: Als 'waar' wordt gebruikt, zal het gewone tekstwachtwoord dat is gespecificeerd in de serverdefinitiesectie van het serververbindingsbestand of in het scriptbestand, het versleutelde wachtwoord overschrijven dat, indien aanwezig, is opgeslagen in beveiligde opslag. Als er geen wachtwoord is opgegeven in duidelijke tekst, wordt de gebruiker gevraagd het wachtwoord in te voeren.

    Hier ontstaan twee gevallen:

    1. Als de optie voor overschrijven onwaar is, is de volgorde van de zoekopdracht: Beveiligde opslag->Scriptbestand->Serververbindingsbestand->Prompt gebruiker.

    2. Als de optie voor overschrijven waar is, zal de volgorde van zoeken zijn: Scriptbestand - > Serververbinding Bestand - > Gebruiker Vragen.

    Voorbeeld:

    <output-providers>  

  <encrypted-password override="<true/false>"/>  

</output-providers>

De niet-configureerbare optie is:

  • Maximum aantal pogingen om opnieuw verbinding te maken: Wanneer er een time-out optreedt voor een tot stand gebrachte verbinding of onderbrekingen als gevolg van een netwerkfout, moet de server opnieuw worden verbonden. De pogingen om opnieuw verbinding te maken, mogen maximaal 5 nieuwe pogingen uitvoeren, waarna de console automatisch de nieuwe verbinding uitvoert. De faciliteit voor automatisch opnieuw verbinden vermindert uw inspanning bij het opnieuw uitvoeren van het script.

Server-verbindingsparameters

Serververbindingsparameters kunnen worden gedefinieerd in het scriptbestand of in het serververbindingsbestand. Raadpleeg de sectie Serververbindingsbestanden (SybaseToSQL) maken voor meer informatie

Scriptopdrachten

Het scriptbestand bevat een reeks migratiewerkstroomopdrachten in de XML-indeling. De SSMA-consoletoepassing verwerkt de migratie in de volgorde van de opdrachten die worden weergegeven in het scriptbestand.

Een typische gegevensmigratie van een specifieke tabel in een Sybase-database volgt bijvoorbeeld de hiërarchie van: Database-Schema> ->Table.

Wanneer alle opdrachten in het scriptbestand zijn uitgevoerd, wordt de SSMA-consoletoepassing afgesloten en wordt het besturingselement geretourneerd aan de gebruiker. De inhoud van een scriptbestand is meer of minder statisch met variabele informatie in een variabele-waardebestanden of in een afzonderlijke sectie in het scriptbestand voor variabele waarden.

Voorbeeld:

<!--Sample of script file commands -->  
  
<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>

Sjablonen die bestaan uit drie scriptbestanden (voor het uitvoeren van verschillende scenario's), een bestand met variabele waarden en een serververbindingsbestand worden geleverd in de map Voorbeeldconsolescripts van de productmap:

  • AssessmentReportGenerationSample.xml

  • ConversionAndDataMigrationSample.xml

  • SqlStatementConversionSample.xml

  • VariableValueFileSample.xml

  • ServersConnectionFileSample.xml

U kunt de sjablonen (bestanden) uitvoeren nadat u de daarin weergegeven parameters hebt gewijzigd voor relevantie.

Volledige lijst met scriptopdrachten vindt u in het uitvoeren van de SSMA-console (SybaseToSQL)

Validatie van scriptbestand

De gebruiker kan eenvoudig het scriptbestand valideren op basis van het schemadefinitiebestand 'S2SSConsoleScriptSchema.xsd' dat beschikbaar is in de map Schema's

Volgende stap

De volgende stap bij het gebruik van de console is het maken van variabele waardebestanden (SybaseToSQL).

Zie ook

Variabele waardebestanden (SybaseToSQL) maken

  • Last updated on