Microsoft SQL Server

W tym temacie wyjaśniono, jak skonfigurować łączność z miejscem docelowym Microsoft SQL Server przy użyciu łącznika Microsoft SQL Server Target. Miejsca docelowego Microsoft SQL Server można używać w zadaniu replikacji lub jako docelowa platforma danych w potoku danych. W potoku danych można wykonywać różne operacje na platformie docelowej, w tym umieszczanie danych, przechowywanie danych, tworzenie data martów oraz rejestrowanie danych.. Zanim będzie można połączyć się z miejscem docelowym Microsoft SQL Server, należy skonfigurować Wymagania wstępne dotyczące użytkownika w bazie danych. Jeśli łączysz się z Microsoft SQL Server przez Brama danych ruchu danych, musisz również zainstalować sterownik zgodnie z opisem w Konfiguracja sterowników.

Aby uzyskać informacje o ograniczeniach i kwestiach do uwzględnienia w związku z używaniem łącznika Microsoft SQL Server Target, zobacz temat Ograniczenia i uwagi.

Konfiguracja właściwości połączenia

W tej sekcji opisano dostępne właściwości połączenia. Wszystkie właściwości są wymagane, chyba że zaznaczono inaczej.

Brama danych ruchu danych

Miejsca docelowego Microsoft SQL Server można używać w potoku danych lub w zadaniu replikacji. Chociaż w celu uzyskania dostępu do miejsca docelowego Microsoft SQL Server w potoku może być wymagana brama Data Movement gateway (w zależności od tego, czy baza danych jest bezpośrednio dostępna z Qlik Cloud), jest ona zawsze wymagana w przypadku używania miejsca docelowego Microsoft SQL Server w zadaniu replikacji.

Używanie miejsca docelowego Microsoft SQL Server w potoku danych

Brama danych: Brama Brama danych ruchu danych jest wymagana tylko wtedy, gdy docelowa baza danych nie jest dostępna z Qlik Cloud i można uzyskać do niej dostęp tylko za pośrednictwem łącza prywatnego (na przykład jeśli znajduje się lokalnie za zaporą lub w wirtualnej chmurze prywatnej). W takim przypadku wybierz tę bramę Brama danych ruchu danych, przez którą chcesz uzyskiwać dostęp do docelowej bazy danych.

W zależności od zastosowania będzie to ta sama Brama danych ruchu danych, która została wdrożona do umieszczania danych ze źródła, lub inna. Aby uzyskać informacje na temat możliwości wdrożenia Brama danych ruchu danych, zobacz temat Typowe zastosowania.

Jeśli docelowa baza danych jest bezpośrednio dostępna z Qlik Cloud, wybierz Brak.

Używanie miejsca docelowego Microsoft SQL Server w zadaniu replikacji

Brama danych: Wybierz bramę Brama danych ruchu danych, która będzie używana do testowania połączenia z docelowym serwerem Microsoft SQL Server. Powinna to być ta sama brama, która została użyta do uzyskania dostępu do źródła danych.

Miejsce docelowe danych

• Dostawca usługi w chmurze: Wybierz jedną z następujących opcji:

  • Brak (dla wdrożeń lokalnych)
  • Amazon RDS
  • Google Cloud
  • Microsoft Azure (obsługuje zarówno Microsoft Azure Managed Instance, jak i Microsoft Azure Database)

• Serwer: Nazwa hosta lub adres IP komputera, na którym zainstalowana jest baza danych Microsoft SQL Server.

  Informacja

  Aby zastąpić domyślny port, dodaj port do nazwy serwera, oddzielając go przecinkiem. Jeżeli na przykład nazwa serwera to myserver.company.local, a port to 3333, nazwa serwera powinna być następująca:

  myserver.company.local,3333

Właściwości konta

User Name i Password: Nazwa użytkownika i hasło użytkownika uprawnionego do dostępu do Microsoft SQL Server.

Właściwości bazy danych

• Nazwa bazy danych: istnieją dwie metody określania bazy danych:

  • Metoda 1 — wybór z listy: Ta metoda wymaga, aby użytkownik był utworzony w głównej bazie danych. Kliknij Load databases, a następnie wybierz bazę danych.
  • Metoda 2 — ręcznie: Wybierz pozycję Wprowadź nazwę bazy danych ręcznie, a następnie wprowadź nazwę bazy danych.
• Encrypt (Trust server certificate): Wybierz, aby szyfrować komunikację między Qlik Cloud a serwerem bazy danych. Po wybraniu tego ustawienia certyfikat serwera będzie automatycznie uznawany za zaufany.
  • Host name in certificate: Aby certyfikat serwera był zaufany tylko wtedy, gdy jego nazwa hosta jest zgodna z wartością określoną w tym polu, wprowadź nazwę hosta certyfikatu serwera.

Właściwości wewnętrzne

Właściwości wewnętrzne są przeznaczone dla specjalnych przypadków, w związku z czym nie są ukazywane w oknie dialogowym. Należy ich używać tylko na polecenie Qlik Pomocy technicznej.

Użyj przycisków i znajdujących się po prawej stronie pól, aby dodać lub usunąć właściwości zgodnie z potrzebą.

Nazwa

Nazwa wyświetlana dla połączenia.

Wymagania wstępne

Wymagania wstępne dotyczące użytkownika

• Użytkownik określony w ustawieniach łącznika musi mieć co najmniej rolę użytkownika db_owner w docelowej bazie danych Microsoft SQL Server.
• 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.

Konfiguracja sterowników

Sterownik jest wymagany tylko do uzyskiwania dostępu za pośrednictwem Brama danych ruchu danych. Więcej informacji na temat zastosowań, gdy wymagana jest brama Brama danych ruchu danych, można znaleźć w temacie Brama danych ruchu danych powyżej.

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. Zatrzymaj usługę Brama danych ruchu danych:

   sudo systemctl stop repagent

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

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: inactive (dead) since <timestamp> ago

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

   opt/qlik/gateway/movement/drivers/bin

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

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

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

7. Poczekaj na zakończenie instalacji (wskazane komunikatem „Ukończono!”), a następnie uruchom usługę Brama danych ruchu danych:

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

driver — aktualizacja

Uruchom polecenie aktualizacji, jeśli chcesz odinstalować driver w poprzedniej wersji, zanim zainstalujesz dostarczony driver.

Aby pobrać i zaktualizować driver:

1. Zatrzymaj usługę Brama danych ruchu danych:

   sudo systemctl stop repagent

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

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: inactive (dead) since <timestamp> ago

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

   opt/qlik/gateway/movement/drivers/bin

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

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

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

7. Poczekaj na zakończenie instalacji (wskazane komunikatem „Ukończono!”), a następnie uruchom usługę Brama danych ruchu danych:

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

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 sterowników ręcznie

Sterownik driver należy instalować ręcznie tylko wtedy, gdy automatyczna instalacja nie zakończyła się pomyślnie.

W przypadku używania serwera Microsoft SQL Server jako miejsca docelowego w potoku danych należy zainstalować zarówno sterownik ODBC, jak i sterownik JDBC. Jeśli używasz serwera Microsoft SQL Server jako miejsca docelowego w zadaniu replikacji, wystarczy zainstalować sterownik ODBC.

Instalowanie sterownika ODBC

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

Status powinien być następujący:

Active: inactive (dead) since <timestamp> ago

3. Zainstaluj sterownik (RPM).

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

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

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

   cat site_arep_login.sh

7. Uruchom usługę Data Movement gateway:

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   Status powinien być następujący:

   Active: active (running) since <timestamp> ago

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

Instalowanie sterownika JDBC

1. Pobierz plik mssql-jdbc-<wersja>.jar. Łą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 JAR do następującego folderu na komputerze z Brama danych ruchu danych:

   /opt/qlik/gateway/movement/qcs_agents/qdi-db-commands/lib

2. Uruchom ponownie usługę Brama danych ruchu danych, używając polecenia opisanego w temacie Ponowne uruchamianie usługi.

Ograniczenia i uwagi

Ograniczenia i uwagi dotyczące stosowania w potoku danych

• Podczas umieszczania danych na serwerze Microsoft SQL Server w potoku danych widoki na żywo nie są obsługiwane. Więcej informacji o widokach na żywo zawiera temat Przechowywanie zestawów danych.

Ograniczenia i uwagi dotyczące wszystkich zadań danych

Jeśli następujące typy dużych obiektów będą puste w źródłowej bazie danych (0 bajtów), nie będą puste po pełnym załadowaniu:

• BLOB zostanie zapisany jako 0x0000 (2 bajty)
• TEXT (VARCHAR(max)) zostanie zapisany jako 0X00 (1 bajt)

• NTEXT (NVARCHAR(max)) zostanie zapisany jako 0x0000 (2 bajty)

Ograniczenia i uwagi dotyczące wyłącznie zadań replikacji

• Pełnowymiarowe kolumny LOB nie są obsługiwane w trybie stosowania zoptymalizowanego pod kątem partii. Można obejść to ograniczenie, ograniczając rozmiar kolumny LOB w ustawieniach zadania lub przełączając się do trybu stosowania transakcyjnego.
• Gdy włączone są opcje stosowania zoptymalizowanego pod kątem partii i Replikuj ograniczone kolumny LOB (KB), kolumny BLOB i CLOB w miejscu docelowym zostaną obcięte do jednej czwartej rozmiaru określonego w polu Ogranicz rozmiar LOB do.
• Jeśli chcesz zreplikować 4-bajtowe znaki emoji, użyj transformacji, aby przekonwertować typ danych z WSTRING(n) na WSTRING (n*2).

Typy danych

Informacje o natywnym typie danych są zachowywane i wyświetlane w widokach zestawu danych w kolumnie Natywny typ danych. Jeśli kolumna nie jest widoczna, otwórz selektor kolumn w widoku zestawu danych i wybierz kolumnę Natywny typ danych.

Następujące typy danych SQL Server nie są obsługiwane. Dane nie zostaną odczytane.

• CURSOR

• SQL_VARIANT

• TABLE

Następujące typy danych są konwertowane na VARCHAR (MAX):

• XML

• GEOGRAPHY

• GEOMETRY