Udostępnij przez

Tworzenie plików skryptów (OracleToSQL)

Pierwszym krokiem przed uruchomieniem aplikacji konsolowej SSMA jest utworzenie pliku skryptu, a w razie potrzeby utworzenie pliku wartości zmiennej i pliku połączenia serwera.

Plik skryptu można podzielić na trzy sekcje: viz..,:

  1. konfiguracja: Umożliwia użytkownikowi ustawienie parametrów konfiguracji dla aplikacji konsolowej.

  2. Serwerów: Umożliwia użytkownikowi ustawienie definicji serwera źródłowego/docelowego. Może to być również w osobnym pliku połączenia serwera.

  3. script-commands: Umożliwia użytkownikowi wykonywanie poleceń przepływu pracy SSMA.

Każdą sekcję opisano szczegółowo poniżej:

Konfigurowanie ustawień konsoli Oracle

Konfiguracje skryptu są wyświetlane w pliku skryptu konsoli.

Jeśli którykolwiek z elementów jest określony w węźle konfiguracji, są one ustawione jako ustawienie globalne, tj. mają zastosowanie do wszystkich poleceń skryptu. Te elementy konfiguracji można również ustawić w ramach każdego polecenia w sekcji script-command, jeśli użytkownik chce zastąpić ustawienie globalne.

Opcje konfigurowalne dla użytkownika obejmują:

  1. Dostawca okien wyjściowych: Jeśli atrybut suppress-messages ma wartość "true", komunikaty specyficzne dla polecenia nie są wyświetlane w konsoli programu . Poniżej podano opis atrybutów:

    • miejsce docelowe: określa, czy dane wyjściowe muszą być drukowane w pliku, czy w stdout. Jest to domyślnie wartość false.

    • file-name: ścieżka pliku (opcjonalnie).

    • pomijanie komunikatów: pomija komunikaty w konsoli. Jest to domyślnie wartość "false".

    Przykład:

    <output-providers>  

  <output-window  

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

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

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

   />  

</output-providers>

    lub

    <...All commands...>  

  <output-window  

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

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

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

   />  

</...All commands...>

  2. Dostawca połączenia migracji danych: Określa, który serwer źródłowy/docelowy ma być brany pod uwagę podczas migracji danych. Opcja "źródło-użyj-ostatnio-używanego" wskazuje, że do migracji danych wykorzystywany jest ostatnio używany serwer źródłowy. Podobnie target-use-last-used wskazuje, że ostatni używany serwer docelowy jest używany do migracji danych. Użytkownik może również określić serwer (źródło lub obiekt docelowy) przy użyciu atrybutów source-server lub target-server.

    Można użyć tylko jednego lub drugiego określonego atrybutu, np.:

    • source-use-last-used="true" (wartość domyślna) lub source-server="source_servername"

    • target-use-last-used="true" (wartość domyślna) lub target-server="target_servername"

    Przykład:

    <output-providers>  

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

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

</output-providers>

    lub

    <migrate-data>  

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

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

</migrate-data>

  3. Okienko wejściowe użytkownika: Umożliwia to obsługę błędów, gdy obiekty są ładowane z bazy danych. Użytkownik udostępnia tryby wprowadzania, a w przypadku błędu konsola działa zgodnie z określeniami użytkownika.

    Tryby obejmują:

    • ask-user — Pyta użytkownika o kontynuację ('tak') lub przerwanie z błędem ('nie').

    • błąd- Konsola wyświetla błąd i zatrzymuje wykonywanie.

    • kontynuować- Konsola kontynuuje wykonywanie.

    Tryb domyślny to błąd.

    Przykład:

    <output-providers>  

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

</output-providers>

    lub

    <!-- Connect to target database -->  

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

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

</connect-target-database>

  4. Ponownie połącz dostawcę: Dzięki temu użytkownik może ustawić ustawienia ponownego nawiązywania połączenia w przypadku niepowodzeń połączenia. Można to ustawić zarówno dla serwerów źródłowych, jak i docelowych.

    Tryby ponownego nawiązywania połączenia to:

    • Ponownie połącz się z ostatnio używanym serwerem: jeśli połączenie nie jest aktywne, próbuje ponownie nawiązać połączenie z ostatnim używanym serwerem co najwyżej 5 razy.

    • generate-an-error: Jeśli połączenie nie jest aktywne, zostanie wygenerowany błąd.

    Tryb domyślny to generate-an-error.

    Przykład:

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

    lub

    <!--synchronization-->  

<synchronize-target>  

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

</synchronize-target>

    lub

    <!--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. Usługa zastępowania konwertera: Dzięki temu użytkownik może obsługiwać obiekty, które są już obecne w metabazie docelowej. Możliwe działania obejmują:

    • błąd: konsola wyświetla błąd i zatrzymuje wykonywanie.

    • nadpisuje: nadpisuje istniejące wartości obiektów. Ta akcja jest wykonywana domyślnie.

    • skip: konsola pomija obiekty, które już istnieją w bazie danych

    • ask-user: monituje użytkownika o podanie danych wejściowych ('yes'/ 'no')

    Przykład:

    <output-providers>  

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

</output-providers>

    lub

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

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

</convert-schema>

  6. Dostawca niespełnionych wymagań wstępnych: Użytkownik może dzięki temu zająć się wszelkimi wymaganiami wstępnymi potrzebnymi do przetworzenia polecenia. Domyślnie "strict-mode" jest ustawiony na "false". Jeśli jest ustawiona wartość "true", zostanie wygenerowany wyjątek z powodu niespełnienia wymagań wstępnych.

    Przykład:

    <output-providers>  

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

</output-providers>

  7. Operacja zatrzymywania: Jeśli użytkownik chce zatrzymać operację w trakcie operacji, można użyć skrótu Ctrl+C . Program SSMA dla konsoli Oracle będzie czekać na zakończenie operacji i zakończy działanie konsoli Oracle.

    Jeśli użytkownik chce natychmiast zatrzymać wykonywanie, "Ctrl+C" można nacisnąć ponownie w celu nagłego zakończenia działania aplikacji konsolowej SSMA.

  8. Dostawca postępu: Informuje o postępie każdego polecenia konsoli. Ta opcja jest domyślnie wyłączona. Atrybuty raportowania postępu obejmują:

    • wyłączone

    • wszyscy-1%

    • co-2%

    • co 5%

    • co 10%

    • co 20%

    Przykład:

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

    lub

    <...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. Czasownik rejestratora: Ustawia poziom szczegółowości dziennika. Odpowiada to opcji Wszystkie kategorie w interfejsie użytkownika. Domyślnie poziom szczegółowości dziennika to "error".

    Opcje na poziomie rejestratora obejmują:

    • błąd krytyczny: rejestrowane są tylko komunikaty o błędach krytycznych.

    • błąd: rejestrowane są tylko komunikaty o błędach i błędach krytycznych.

    • ostrzeżenie: rejestrowane są wszystkie poziomy z wyjątkiem komunikatów debugowania i informacji.

    • info: wszystkie poziomy z wyjątkiem komunikatów debugowania są rejestrowane.

    • debugowanie: wszystkie poziomy zarejestrowanych komunikatów.

    Uwaga / Notatka

    Obowiązkowe komunikaty są rejestrowane na dowolnym poziomie.

    Przykład:

    <output-providers>  

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

</output-providers>

    lub

    <...All commands...>  

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

</...All commands...>

  10. Zastąp zaszyfrowane hasło: Jeśli ustawiono na 'true', hasło w postaci zwykłego tekstu określone w sekcji definicji serwera pliku połączenia serwera lub w pliku skryptu zastępuje zaszyfrowane hasło, przechowywane w chronionym magazynie, jeśli istnieje. Jeśli hasło nie zostanie określone w postaci zwykłego tekstu, użytkownik zostanie poproszony o wprowadzenie hasła.

    Oto dwa przypadki:

    1. Jeśli opcja zastąpienia jest fałsz, kolejność wyszukiwania będzie chronione magazynowanie->Plik skryptu->Plik połączenia serwera->Pytać użytkownika.

    2. Jeśli opcja przesłonięcia ma wartość true, kolejność wyszukiwania to Plik skryptu>-Plik połączenia z serwerem>-Zapytaj użytkownika.

    Przykład:

    <output-providers>  

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

</output-providers>

Opcja niekonfigurowalna to:

  • Maksymalna liczba ponownych prób nawiązania połączenia: Gdy upłynął limit czasu ustanowionego połączenia lub przerwy z powodu awarii sieci, serwer jest wymagany do ponownego nawiązania połączenia. Próby ponownego nawiązania połączenia mogą mieć maksymalnie 5 ponownych prób, po których konsola automatycznie wykonuje ponowne nawiązywanie połączenia. Funkcja automatycznego ponownego łączenia zmniejsza nakład pracy podczas ponownego uruchamiania skryptu.

Parametry połączenia serwera

Parametry połączenia serwera można zdefiniować w pliku skryptu lub w pliku połączenia serwera. Aby uzyskać więcej informacji, zobacz sekcję Tworzenie plików połączeń serwera (OracleToSQL ).

Polecenia skryptu

Plik skryptu zawiera sekwencję komend przepływu migracji w formacie XML. Aplikacja konsolowa SSMA przetwarza migrację w kolejności poleceń wyświetlanych w pliku skryptu.

Na przykład typowa migracja danych określonej tabeli w bazie danych Oracle jest zgodna z hierarchią: Schema -> Table.

Po pomyślnym wykonaniu wszystkich poleceń w pliku skryptu aplikacja konsolowa SSMA kończy działanie i zwraca kontrolkę użytkownikowi. Zawartość pliku skryptu jest mniej lub bardziej statyczna ze zmiennymi informacjami zawartymi w plikach tworzenia wartości zmiennych (OracleToSQL) lub w oddzielnej sekcji w pliku skryptu dla wartości zmiennych.

Przykład:

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

Szablony składające się z 3 plików skryptów (do wykonywania różnych scenariuszy), pliku wartości zmiennej i pliku połączenia serwera są dostępne w folderze Przykładowe skrypty konsoli katalogu produktu:

  • AssessmentReportGenerationSample.xml

  • ConversionAndDataMigrationSample.xml

  • SqlStatementConversionSample.xml

  • VariableValueFileSample.xml

  • ServersConnectionFileSample.xml

Szablony (pliki) można wykonać po zmianie wyświetlanych tam parametrów w celu uzyskania trafności.

Pełną listę poleceń skryptów można znaleźć w temacie Wykonywanie konsoli SSMA (OracleToSQL)

Walidacja pliku skryptu

Użytkownik może łatwo zweryfikować swój plik skryptu względem pliku definicji schematu "O2SSConsoleScriptSchema.xsd" dostępnego w folderze "Schematy".

Następny krok

Następnym krokiem w obsłudze konsoli jest tworzenie plików wartości zmiennych (OracleToSQL).

Zobacz też

tworzenie plików wartości zmiennych (OracleToSQL)

  • Last updated on