Wymagania wstępne
Zanim będzie można umieszczać lub replikować dane, należy spełnić następujące wymagania wstępne:
-
Zainstaluj wymagany driver na serwerze bramy Data Movement gateway
InformacjaJest to wymagane tylko wtedy, gdy pracujesz z bramą Data Movement gateway. Informacje o zaletach bramy Data Movement gateway i o okolicznościach, w których jest wymagana, zawiera temat Qlik Data Gateway - Data Movement.
Brama Data Movement gateway jest niedostępna z subskrypcją Qlik Talend Cloud Starter.
-
Przyznaj wymagane uprawnienia w źródle danych
-
Skonfiguruj łącznik źródła danych
Konfiguracja sterowników
Sterownik driver można zainstalować za pomocą Narzędzia do instalacji sterowników (zalecane) lub ręcznie. Instalacji ręcznej należy próbować tylko w mało prawdopodobnym przypadku wystąpienia problemu z Narzędziem do instalacji sterowników.
Używanie Narzędzia do instalacji sterowników w celu instalacji sterownika
W tej sekcji opisano, jak zainstalować wymagany driver. Proces ten obejmuje uruchomienie skryptu, który automatycznie pobierze, zainstaluje i skonfiguruje wymagany driver. W razie potrzeby można także uruchamiać skrypty, aby zaktualizować i odinstalować driver.
Przygotowanie instalacji
-
Na serwerze bramy Data Movement musi być zainstalowane środowisko Python 3.6 lub nowsze.
Środowisko Python jest preinstalowane w większości dystrybucji systemu Linux. Aby sprawdzić, która wersja środowiska Pythona jest zainstalowana w Twoim systemie, uruchom następujące polecenie:
python3 --version
Instalowanie aplikacji driver
Aby pobrać i zainstalować driver:
-
Na urządzenie bramy Data Movement zmień katalog roboczy na:
opt/qlik/gateway/movement/drivers/bin
-
Wykonaj następujące polecenie:
Składnia:
./install sqlserver
Jeśli driver nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać driver i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie install sqlserver.
W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver.
-
Wykonaj jedną z poniższych czynności:
- Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej.
- Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej.
- Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji.
-
Wykonaj jedną z poniższych czynności:
- Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację.
- Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację.
-
Wpisz „v” i naciśnij klawisz [Enter], aby ponownie wyświetlić umowę licencyjną.
Zostanie zainstalowany driver.
driver — aktualizacja
Uruchom polecenie aktualizacji, jeśli chcesz odinstalować driver w poprzedniej wersji, zanim zainstalujesz dostarczony driver.
Aby pobrać i zaktualizować driver:
-
Na urządzenie bramy Data Movement zmień katalog roboczy na:
opt/qlik/gateway/movement/drivers/bin
-
Wykonaj następujące polecenie:
Składnia:
./update sqlserver
Jeśli driver nie może zostać pobrany (ze względu na ograniczenia dostępu lub problemy techniczne), zostanie wyświetlony komunikat informujący, skąd pobrać driver i dokąd go skopiować na urządzenie bramy Data Movement. Po wykonaniu tej czynności ponownie uruchom polecenie update sqlserver.
W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver.
-
Wykonaj jedną z poniższych czynności:
- Naciśnij klawisz [Enter] wielokrotnie, aby powoli przewinąć treść umowy licencyjnej.
- Naciśnij klawisz spacji wielokrotnie, aby szybko przewinąć treść umowy licencyjnej.
- Naciśnij klawisz „q”, aby zamknąć tekst umowy licencyjnej i wyświetlić opcje jej akceptacji.
-
Wykonaj jedną z poniższych czynności:
- Wpisz „y” i naciśnij klawisz [Enter], aby zaakceptować umowę licencyjną i rozpocząć instalację.
- Wpisz „n” i naciśnij klawisz [Enter], aby odrzucić umowę licencyjną i zakończyć instalację.
- Wpisz „v” i naciśnij klawisz [Enter], aby wyświetlić umowę licencyjną od początku.
Stary driver zostanie odinstalowany, a zainstalowany zostanie nowy driver.
driver — odinstalowywanie
Uruchom polecenie odinstalowania, jeśli chcesz odinstalować driver.
Aby odinstalować driver:
-
Zatrzymaj wszystkie zadania skonfigurowane do korzystania z tego łącznika.
-
Na urządzenie bramy Data Movement zmień katalog roboczy na:
opt/qlik/gateway/movement/drivers/bin
-
Wykonaj następujące polecenie:
Składnia:
./uninstall sqlserver
Sterownik driverzostanie odinstalowany.
Instalowanie sterownika ręcznie
Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie.
Po zainstalowaniu Data Movement gateway pobierz sterownik msodbcsql<wersja>.x86_64.rpm. Łącze do bezpośredniego pobrania obsługiwanej wersji można znaleźć w sekcji binary-artifacts w pliku /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml. Po zakończeniu pobierania skopiuj plik RPM na komputer z Data Movement gateway.
Na serwerze Data Movement gateway otwórz wiersz poleceń i wykonaj następujące czynności:
-
Zatrzymaj usługę Data Movement gateway:
sudo systemctl stop repagent
-
Opcjonalnie potwierdź, że usługa została zatrzymana:
sudo systemctl status repagent
-
Zainstaluj sterownik (RPM).
-
Zmień katalog roboczy na <katalog_produktu>/bin.
-
Skopiuj lokalizację sterownika do pliku
site_arep_login.sh
w następujący sposób:echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/
msodbcsql<version>
/lib64/" >> site_arep_login.sh
Spowoduje to dodanie sterownika do ustawienia „LD_LIBRARY_PATH” i zaktualizuje lokalizację sterownika w pliku site_arep_login.sh .
-
Opcjonalnie potwierdź, że lokalizacja sterownika została skopiowana:
cat site_arep_login.sh
-
Uruchom usługę Data Movement gateway:
sudo systemctl start repagent
-
Opcjonalnie potwierdź, że usługa została uruchomiona:
sudo systemctl status repagent
Status powinien być następujący:
Active: active (running) since <timestamp> ago
-
Usługa Data Movement gateway wymaga następującej biblioteki ODBC: msodbcsql-18.1.so.1.1
Aby sprawdzić wersję obecnie zainstalowanej biblioteki, wykonaj następujące polecenie:
ls /opt/microsoft/msodbcsql<version>/lib64/
Jeżeli istniejąca już biblioteka ma inny numer wersji (np. libmsodbcsql-18.0.so.1.1), musisz utworzyć symboliczne łącze między istniejącą biblioteką a biblioteką wymaganą.
W tym celu wykonaj następujące polecenia:
cd /opt/microsoft/msodbcsql<version>/lib64/
ln -s existing_library_name
msodbcsql-18.1.so.1.1, gdzie
existing_library_name
jest nazwą obecnie zainstalowanej biblioteki (np. libmsodbcsql-18.0.so.1.1).
Status powinien być następujący:
Active: inactive (dead) since <timestamp> ago
Wybór bazy danych
Aby móc wybrać bazę danych (klikając Load databases w oknie dialogowym łącznika), użytkownik określony w ustawieniach łącznika musi zostać utworzony w głównej bazie danych.
Port
Domyślnie port 1434 musi być otwarty dla komunikacji wychodzącej na serwerze Data Movement gateway. Można to zmienić w ustawieniach złącza.
Przygotowanie bazy danych do CDC
W poniższej sekcji wyjaśniono, jak skonfigurować bazę danych na potrzeby funkcji CDC.
Aby skonfigurować bazę danych na potrzeby funkcji CDC:
-
Skonfiguruj bazę danych na potrzeby funkcji MS-CDC, wykonując następujący skrypt:
exec source_db_name.dbo.sp_cdc_enable_db
gdzie source_db_name jest nazwą źródłowej bazy danych.
-
Zadanie landing automatycznie włącza funkcję MS-CDC dla wszystkich tabel źródłowych. Aby jednak włączyć funkcję MS-CDC ręcznie, wykonaj następujący skrypt (dla poszczególnych wybranych tabel źródłowych):
exec sys.sp_cdc_enable_table
@source_schema = N'schema_name',
@source_name = N'table_name',
@role_name = NULL
gdzie schema_name i table_name są odpowiednio nazwami schematu źródłowego i tabeli źródłowej.
Informacja- Nazwy tabeli CT muszą być zgodne z domyślnym formatem nazewnictwa: <Nazwa_Schematu>_<NazwaTabeli>_CT
-
Tabela CT musi zawierać następujące kolumny: [__$start_lsn], [__$end_lsn], [__$seqval], [__$operation], [__$update_mask], <wszystkie kolumny danych>, [__$command_id]
-
Uruchom zadanie przechwytywania MS-CDC i zadanie czyszczenia.
Informacja- Zadaniami można sterować przy użyciu procedury sys.sp_cdc_change_job. Więcej informacji zawiera Pomoc firmy Microsoft.
- Aby zmniejszyć opóźnienia, można ustawić małą wartość parametru @pollinginterval.