Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

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

  • 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 Ruch danych 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:

  1. Na urządzenie bramy Ruch danych zmień katalog roboczy na:

    opt/qlik/gateway/movement/drivers/bin

  2. 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 Ruch danych. Po wykonaniu tej czynności ponownie uruchom polecenie install sqlserver.

    W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver.

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

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

  1. Na urządzenie bramy Ruch danych zmień katalog roboczy na:

    opt/qlik/gateway/movement/drivers/bin

  2. 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 Ruch danych. Po wykonaniu tej czynności ponownie uruchom polecenie update sqlserver.

    W przeciwnym razie zostanie wyświetlona umowa licencyjna dotycząca driver.

  3. 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.
  4. 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.
  5. Stary driver zostanie odinstalowany, a zainstalowany zostanie nowy driver.

driver — odinstalowywanie

Uruchom polecenie odinstalowania, jeśli chcesz odinstalować driver.

Aby odinstalować driver:

  1. Zatrzymaj wszystkie zadania skonfigurowane do korzystania z tego łącznika.

  2. Na urządzenie bramy Ruch danych zmień katalog roboczy na:

    opt/qlik/gateway/movement/drivers/bin

  3. 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 Brama danych ruchu danych 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 Brama danych ruchu danych.

Na serwerze Data Movement gateway otwórz wiersz poleceń i wykonaj następujące czynności:

  1. Zatrzymaj usługę Data Movement gateway:

    sudo systemctl stop repagent

  2. Opcjonalnie potwierdź, że usługa została zatrzymana:

    sudo systemctl status repagent

  3. Status powinien być następujący:

    Active: inactive (dead) since <timestamp> ago

  4. Zainstaluj sterownik (RPM).

  5. Zmień katalog roboczy na <katalog_produktu>/bin.

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

  7. Opcjonalnie potwierdź, że lokalizacja sterownika została skopiowana:

    cat site_arep_login.sh
  8. Uruchom usługę Data Movement gateway:

    sudo systemctl start repagent

  9. Opcjonalnie potwierdź, że usługa została uruchomiona:

    sudo systemctl status repagent

    Status powinien być następujący:

    Active: active (running) since <timestamp> ago

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

OstrzeżenieJeśli używasz miejsca docelowego Microsoft Fabric, odinstalowanie sterownika Microsoft ODBC dla sterownika SQL Server spowoduje również przerwanie połączenia z Microsoft Fabric, ponieważ korzystają one z tego samego sterownika.

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 Brama danych ruchu danych. 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:

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

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

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

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!