Tworzenie plików skryptów (Db2ToSQL)

Przed uruchomieniem aplikacji konsolowej programu SQL Server Migration Assistant (SSMA) należy utworzyć plik skryptu. W razie potrzeby można również utworzyć plik wartości zmiennej i plik połączenia serwera.

Plik skryptu można podzielić na trzy sekcje:

Sekcja	Opis
`config`	Ustaw parametry konfiguracji dla aplikacji konsolowej.
`servers`	Ustaw definicje serwera źródłowego/docelowego. Może również znajdować się w osobnym pliku połączenia serwera.
`script-commands`	Wykonaj polecenia przepływu pracy SSMA.

Każda sekcja została szczegółowo opisana w tym artykule.

Konfigurowanie ustawień aplikacji konsolowej SSMA

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 ustawiane jako ustawienie globalne. Innymi słowy, 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 chcesz zastąpić ustawienie globalne.

Opcje konfigurowalne dla użytkownika obejmują:

dostawca okna wyjściowego: jeśli atrybut suppress-messages jest ustawiony na true, komunikaty specyficzne dla polecenia nie są wyświetlane w konsoli.

Atrybut	Opis
`destination`	Określa, czy dane wyjściowe muszą być drukowane w pliku lub stdout. `false` domyślnie.
`file-name` (opcjonalnie)	Ścieżka pliku.
`suppress-messages`	Pomija komunikaty na konsoli. `false` domyślnie.

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

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. Można również określić serwer (źródło lub obiekt docelowy) przy użyciu atrybutów source-server lub target-server.

Jednocześnie można ustawić tylko jeden z tych atrybutów:
- source-use-last-used="true" (ustawienie domyślne) lub source-server="<source-server-unique-name>"
- target-use-last-used="true" (ustawienie domyślne) lub target-server="<target-server-unique-name>"
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>
```

Okienko Dane Wejściowe Użytkownika: umożliwia zarządzanie błędami podczas gdy obiekty są ładowane z bazy danych. Podajesz tryby wejściowe, a jeśli wystąpi błąd, konsola postępuje zgodnie z określonymi instrukcjami.

Tryb	Opis
`ask-user`	Monituje o kontynuowanie (`yes`) lub błąd (`no`).
`error` (ustawienie domyślne)	Konsola wyświetla błąd i zatrzymuje wykonywanie.
`continue`	Konsola kontynuuje wykonanie.

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>

Reconnect Provider: Umożliwia ustawienie parametrów ponownego nawiązywania połączenia w przypadku awarii. Można to ustawić zarówno dla serwerów źródłowych, jak i docelowych.

Tryb ponownego nawiązywania połączenia	Opis
`reconnect-to-last-used-server`	Jeśli połączenie nie jest aktywne, próbuje ponownie nawiązać połączenie z ostatnim serwerem używanym pięć razy.
`generate-an-error` (ustawienie domyślne)	Jeśli połączenie nie jest aktywne, zostanie wygenerowany błąd.

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>

Converter Overwrite Provider: umożliwia obsługę obiektów, które są już obecne w docelowej metabazie.

Akcja	Opis
`error`	Konsola wyświetla błąd i zatrzymuje wykonywanie.
`overwrite` (ustawienie domyślne)	Zastępuje istniejące wartości obiektów.
`skip`	Konsola pomija obiekty, które już istnieją w bazie danych.
`ask-user`	Prosi 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>

Dostawca wymagań wstępnych, których nie udało się spełnić,: możesz obsłużyć wszelkie wymagania wstępne wymagane do przetworzenia polecenia. Domyślnie strict-mode jest false. Jeśli true, zostanie wygenerowany wyjątek z powodu niespełnienia wymagań wstępnych.

Przykład:
```
<output-providers>
  <prerequisites strict-mode="<true/false>"/>
</output-providers>
```
Zatrzymanie operacji: Podczas działania operacyjnego, jeśli chcesz zatrzymać operację, użyj skrótu Ctrl+C. Program SSMA dla aplikacji konsolowej SSMA oczekuje na zakończenie operacji i zatrzymuje wykonywanie aplikacji konsolowej.

Jeśli chcesz natychmiast zatrzymać wykonywanie, ponownie naciśnij skrót klawiszowy Ctrl+C, aby zakończyć działanie aplikacji konsolowej SSMA.

Dostawca postępu: Informuje o postępie każdego polecenia konsoli. Domyślnie wyłączone. Atrybuty raportowania postępu obejmują:

off
every-1%
every-2%
every-5%
every-10%
every-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...>

Szczegółowość loggera: ustawia poziom szczegółowości. Odpowiada to opcji Wszystkie kategorie w interfejsie użytkownika.

Poziom rejestratora	Opis
`fatal-error`	Rejestrowane są tylko komunikaty o błędach krytycznych.
`error` (ustawienie domyślne)	Rejestrowane są tylko komunikaty o błędach i błędach krytycznych.
`warning`	Wszystkie poziomy z wyjątkiem komunikatów debugowania i informacji są rejestrowane.
`info`	Wszystkie poziomy z wyjątkiem komunikatów debugowania są rejestrowane.
`debug`	Wszystkie poziomy zarejestrowanych komunikatów.

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

Zastąpienie zaszyfrowanego hasła: jeśli true, hasło w postaci zwykłego tekstu, określone w sekcji definicji serwera w pliku połączenia serwera lub w pliku skryptu, zastępuje zaszyfrowane hasło przechowywane w chronionym magazynie, jeśli istnieje. Jeśli nie określono hasła w postaci zwykłego tekstu, zostanie wyświetlony monit o wprowadzenie hasła.

W tym miejscu pojawiają się dwa przypadki:
1. Jeśli opcja zastąpienia jest fałszywą, kolejność wyszukiwania to Chroniony magazyn > Plik skryptu > Plik połączenia serwera > Zapytaj użytkownika.
2. Jeśli opcja zastąpienia jest true, kolejność wyszukiwania to Plik skryptu > Plik połączenia serwera > Monituj użytkownika.
przykład :
```
<output-providers>
  <encrypted-password override="<true/false>"/>
</output-providers>
```

Opcja nieskonfigurowalna jest:

maksymalna liczba prób ponownego połączenia: gdy limit czasu nawiązania połączenia upływa lub połączenie zostaje przerwane z powodu awarii sieci, konieczne jest ponowne połączenie z serwerem. Próby ponownego nawiązania połączenia są dozwolone maksymalnie 5 razy, po czym konsola automatycznie ponownie nawiązuje połączenie. 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 Tworzenie plików połączeń serwera.

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 Db2 odbywa się według hierarchii schematu >tabeli.

Po pomyślnym wykonaniu wszystkich poleceń w pliku skryptu aplikacja konsolowa SSMA kończy działanie. Zawartość pliku skryptu jest mniej lub bardziej statyczna ze zmiennymi informacjami zawartymi w pliku wartości zmiennej lub w oddzielnej sekcji w pliku skryptu dla wartości zmiennych.

Przykład :

Oto przykładowe polecenia pliku skryptu:

<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 trzech 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 Wykonaj konsolę SSMA

Walidacja pliku skryptu

Plik skryptu można zweryfikować względem pliku definicji schematu O2SSConsoleScriptSchema.xsd, dostępnego w folderze Schemas.

Tworzenie plików wartości zmiennych (Db2ToSQL)

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-03-05

Udostępnij przez

Tworzenie plików skryptów (Db2ToSQL)

Konfigurowanie ustawień aplikacji konsolowej SSMA

Parametry połączenia serwera

Polecenia skryptu

Walidacja pliku skryptu

Powiązana zawartość

Sprzężenie zwrotne

Dodatkowe źródła