Konfiguracja i rozwiązywanie problemów Brama danych Qlik — dostęp bezpośredni

W tym temacie opisano różne czynności, które można wykonać w celu skonfigurowania Brama dostępu bezpośredniego i rozwiązania problemów.

Konfigurowanie Brama dostępu bezpośredniego z poziomu dzierżawy Qlik Cloud

Mimo że ustawienia domyślne Brama dostępu bezpośredniego sprawdzają się w większości środowisk, może być potrzebne ich zastąpienie w celu poprawy wydajności, rozwiązania problemu (za pośrednictwem ustawień rejestrowania w dzienniku) lub rozwiązania różnych problemów z łącznością.

Aby móc edytować ustawienia w Qlik Cloud, jest wymagane jedno z poniższych uprawnień:

• Administrator dzierżawy i właściciel przestrzeni bramy

• Członek dzierżawy z uprawnieniem Może korzystać z danych w przestrzeni bramy

Aby otworzyć ustawienia bramy:

1. W dzierżawie Qlik Cloud przejdź do Administrowanie > Bramy danych i zlokalizuj swoją bramę Brama dostępu bezpośredniego.

2. Kliknij na końcu wiersza i wybierz pozycję Ustawienia bramy.

   Zostanie otwarte okno dialogowe Ustawienia bramy dla <nazwa>.

   Ustawienia są podzielone na ustawienia ogólne (poniżej) i ustawienia łącznika. Należy pamiętać, że zmiana ustawień może również wymagać ponownego uruchomienia usługi Brama dostępu bezpośredniego.

Ustawienia ogólne

Ustawienia te dotyczą ogólnej funkcjonalności Brama dostępu bezpośredniego, niezależnie od używanego łącznika.

Identyfikator agenta

Identyfikator agenta do użycia z publicznym API Brama dostępu bezpośredniego.

Port agenta łącznika

Port używany do łączenia się z agentem łącznika. Tego ustawienia nie można zmienić.

Próg awarii stanu agenta łącznika

Okresowo przeprowadzane są kontrole stanu komponentów bramy Brama dostępu bezpośredniego. Kontrole stanu czasami początkowo kończą się niepowodzeniem, a później pomyślnie. Jeśli po przekroczeniu określonego progu kontrole stanu nadal będą kończyć się niepowodzeniem, usługa Brama dostępu bezpośredniego zostanie uruchomiona ponownie. To ustawienie należy zmienić tylko na prośbę Pomocy technicznej Qlik.

Limit czasu żądania załadowania

Gdy wystąpią przerwy w działaniu sieci, przeładowanie może się zakończyć niepowodzeniem i mogą wystąpić następujące błędy:

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Jeżeli powyższe błędy występują często, spróbuj wydłużyć limit czasu do 5–10 minut.

Poziom rejestrowania agenta łącznika.

Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników komponentów agenta łącznika. To ustawienie należy zmienić tylko na prośbę Pomocy technicznej Qlik.

Opcje rejestrowania agenta łącznika

W celu rozwiązania problemów z konkretnym komponentem agenta łącznika może być konieczne wybranie odpowiadającego mu pliku dziennika. To ustawienie należy zmienić tylko na prośbę Pomocy technicznej Qlik.

Pamięć na buforowane fragmenty danych

Dla każdej operacji przeładowania Brama dostępu bezpośredniego może buforować fragmenty danych w pamięci i przenosić je na dysk (gdy rozmiar przydzielony do buforowania zostanie przekroczony). Jest to szczególnie przydatne, jeśli nie korzystasz z automatycznego odzyskiwania i często napotykasz na błędy 4025, 4020 i 4021. Po osiągnięciu określonego progu brama przekaże dalsze zaszyfrowane fragmenty na dysk komputera bramy Brama dostępu bezpośredniego.

Próg czasu odzyskiwania fragmentu

Jest to próg (w minutach) dla czasu trwania odzyskiwania fragmentów. Jeśli przeładowanie nie zostanie wznowione do czasu osiągnięcia progu czasu trwania odzyskiwania, zakończy się ono niepowodzeniem z odpowiednim komunikatem.

Opcja ta jest przydatna w przypadku przeładowań, które w przeciwnym razie mogłyby przekroczyć limit trzech godzin po długim odzyskiwaniu fragmentów. Załóżmy na przykład, że pobieranie danych z bazy danych trwa 90 minut, ale zaraz po rozpoczęciu przeładowywania jeden z fragmentów zostaje uszkodzony. W tym przypadku wszystkie fragmenty będą przechowywane w pamięci podręcznej i wysyłane z pamięci podręcznej. W takiej sytuacji cały proces przeładowania (przechowywanie w pamięci podręcznej + faktyczne przeładowanie) może zająć trzy godziny.

Port DCaaS

Port używany do łączenia się z DCaaS. Tego ustawienia nie można zmienić.

Poziom rejestrowania DCaaS

Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników DCaaS. To ustawienie należy zmienić tylko na prośbę Pomocy technicznej Qlik.

Ustawienia łącznika

Aby zmienić ustawienia łącznika, wybierz typ łącznika po lewej stronie, a następnie zmień ustawienia odpowiednio do potrzeb.

Port

Port używany do łączenia się ze źródłem danych. Tego ustawienia nie można zmienić.

Poziom rejestrowania

Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników łącznika. To ustawienie należy zmienić tylko na prośbę Pomocy technicznej Qlik.

Izolacja procesów

Izolacja procesów umożliwia administratorom mającym dostęp do systemu operacyjnego serwera Brama dostępu bezpośredniego kontrolowanie liczby procesów dostępnych do przeładowania w zależności od typu łącznika. Rozłożenie przeładowań na wiele procesów łącznika zwiększa poziom izolacji przez zmniejszenie liczby przeładowań działających jednocześnie w każdym procesie łącznika. To z kolei może poprawić ogólną stabilność Brama dostępu bezpośredniego w przypadku awarii łącznika.

W przypadku czystej instalacji izolacja procesów jest domyślnie włączona. Domyślna liczba jednoczesnych przeładowań dla każdego typu łącznika wynosi 9. Domyślne ustawienia można zastąpić w sposób opisany w temacie Liczba równoczesnych procesów przeładowywania poniżej.

Wyłączanie izolacji procesów

Pomoc techniczna Qlik może Cię poprosić o wyłączenie izolacji procesów w celu rozwiązywania problemów.

Aby wyłączyć izolację procesu, wybierz ustawienie Wyłączona.

Liczba równoczesnych procesów przeładowywania

Liczba jednoczesnych procesów przeładowywania przydzielonych do łącznika, w tym proces poleceń. Na przykład wartość 30 oznaczałaby maksymalnie 29 równoczesnych przeładowań. Należy pamiętać, że to ustawienie jest istotne tylko wtedy, gdy włączona jest izolacja procesów.

Czas trwania sesji przeładowania

Jeśli połączenie pomiędzy Brama dostępu bezpośredniego a Qlik Cloud będzie bezczynne przez co najmniej 20 sekund, operacja przeładowania może czasami zakończyć się niepowodzeniem z następującym komunikatem o błędzie:

Invalid object name '#<TempTableName>' (indicating that the Brama dostępu bezpośredniego temp tables are unavailable).

Domyślny czas trwania sesji wynosi 20 sekund, ale jeśli ten błąd często się pojawia, możesz wydłużyć czas sesji odpowiednio do potrzeb.

Maksymalna liczba tabel do rozładowania

Domyślnie z bazy danych jest pobieranych maksymalnie 10 000 tabel. Możesz pominąć ustawienie domyślne, jeśli baza danych zawiera ponad 10 000 tabel.

Ponowne uruchomienie Brama dostępu bezpośredniego po zmianie ustawień

Niektóre ustawienia zostaną zastosowane dopiero po ponownym uruchomieniu usługi Brama dostępu bezpośredniego. W takim przypadku po zapisaniu ustawień zostanie wyświetlony monit o ponowne uruchomienie usługi. Jeśli są aktywne przeładowania, nie będzie można ponownie uruchomić usługi do czasu ich zakończenia. Gdy nie ma żadnych aktywnych przeładowań, można ponownie uruchomić usługę w dowolnym momencie, wykonując następujące czynności:

1. W dzierżawie Qlik Cloud przejdź do Administrowanie > Bramy danych i zlokalizuj swoją bramę Brama dostępu bezpośredniego.

2. Kliknij na końcu wiersza i wybierz pozycję Uruchom ponownie usługę.

Usługę można również uruchomić ponownie bezpośrednio na komputerze Brama dostępu bezpośredniego, jak opisano w sekcji Uruchamianie, zatrzymywanie lub ponowne uruchamianie usługi

Konfiguracja Brama dostępu bezpośredniego bezpośrednio na komputerze Brama dostępu bezpośredniego

Podczas gdy większość ustawień Brama dostępu bezpośredniego można skonfigurować w Qlik Cloud, niektóre ustawienia można zmienić tylko przez edycję plików konfiguracyjnych bezpośrednio na komputerze Brama dostępu bezpośredniego.

Zastępowanie domyślnego katalogu pamięci podręcznej fragmentów danych

Dla każdej operacji przeładowania Brama dostępu bezpośredniego może buforować fragmenty danych w pamięci i przenosić je na dysk (gdy rozmiar przydzielony do buforowania zostanie przekroczony). Można zastąpić domyślny katalog pamięci podręcznej fragmentów danych ((C:\ProgramData\Qlik\Gateway\tmp), jeśli nie ma wystarczającej ilości miejsca na dysku systemowym.

Wykonaj następujące czynności:

1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy.

2. Zlokalizuj właściwość OVERRIDE_CHUNKS_CACHE_DIR i ustaw ją na wybrany katalog.

   Przykład:

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   InformacjaNie umieszczaj ścieżki w cudzysłowie.
3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Zob. także: Pamięć na buforowane fragmenty danych

Zastąpienie domyślnego typu danych Qlik Cloud podczas pracy z łącznikiem ODBC (za pośrednictwem Brama dostępu bezpośredniego)

Czasami, ze względu na problem z obsługą typów danych źródłowych przez sterownik ODBC dostawcy, podczas przeładowywania występował błąd lub nieprawidłowe dane były ładowane do Qlik Cloud. W takich przypadkach można zastąpić typ danych Qlik Cloud lub jego specyfikację (na przykład skalę lub precyzję).

Wykonaj następujące czynności:

1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\custom_type_mappings.json jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy. Ten plik zawiera przykładowe źródło typów danych Qlik Cloud.

2. Dodaj sekcję, która mapuje problematyczny typ danych na pożądany typ danych Qlik Cloud.

   W poniższym przykładzie (który jest zawarty w pliku custom_type_mappings.json) klient musi zmienić rozmiar typu danych Qlik Cloud DateTime na 27.

    

3. Zapisz plik custom_type_mappings.json i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
4. Przeładuj dane.

Wymuszanie ponownego połączenia Brama dostępu bezpośredniego z Qlik Cloud

Jeżeli brama Brama dostępu bezpośredniego zostanie rozłączona z Qlik Cloud, powinna domyślnie połączyć się ponownie po 45 sekundach. Jeśli zauważysz, że trwa to znacznie dłużej, możesz wymusić na bramie szybsze ponowne połączenie.

Wykonaj następujące czynności:

1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy. Ten plik zawiera przykładowe źródło typów danych Qlik Cloud.

2. Dodaj AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> do sekcji # Connector Agent na początku pliku.

    

   Przykład:

   {
   "Identifier": "Amazon Athena ODBC (x64)",
   "NativeDataType": "timestamp with time zone",
   "QlikDataType": "DateTime",
   "Size": 27,
   "IsBit": false
   }

   AGENT_PONG_TIMEOUT_SECONDS=30

   InformacjaMinimalny czas to 30 sekund.
3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Asynchroniczne wykonywanie żądań Load Data

Wykonywanie żądania Load Data asynchronicznie na agencie znacznie skraca czas oczekiwania usługi w chmurze na odpowiedzi od agenta.

Aby włączyć asynchroniczne żądania Load Data:

1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy.

2. Dodaj następujący wiersz do pliku:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

3. Zapisz plik configuration.properties.

Aby wyłączyć asynchroniczne żądania Load Data:

1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy.

2. Zamień AsyncLoadDataRequest na None następująco:

   OPTIONAL_CAPABILITIES=None

3. Zapisz plik configuration.properties.

Zezwalanie na połączenia z localhost przy użyciu łącznika REST (za pośrednictwem Brama dostępu bezpośredniego)

Można zezwolić łącznikowi REST (za pośrednictwem Brama dostępu bezpośredniego) na połączenie z localhost. Ułatwia to korzystanie z lokalnych (na serwerze bramy) punktów końcowych REST, np. używanie punktu końcowego connector-agent/ status w celu określenia aktywnej liczby obciążeń agenta.

1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy jest zaznaczona opcja Pokaż > Ukryte elementy.

2. Ustaw REST_ALLOW_LOCALHOST_CONNECTION=true (ustaw false, aby wyłączyć tę funkcję)

3. Zapisz plik configuration.properties.

Zwiększenie szczegółowości komunikatów o błędach podczas połączenia ze źródłami danych ODBC

Ze względów bezpieczeństwa domyślny komunikat o błędzie zwracany przez sterownik ODBC zawiera minimalną ilość informacji. Jednak w niektórych sytuacjach do rozwiązania problemu może być potrzebne więcej informacji. Aby uzyskać bardziej szczegółowy komunikat o błędzie, dodaj właściwość ShowErrorDetailMessage do sekcji Zaawansowanew oknie dialogowym łącznika i ustaw ją na True. Po rozwiązaniu problemu, w celu zapewnienia optymalnego bezpieczeństwa, zdecydowanie zaleca się usunięcie tej właściwości lub ustawienie jej na False.

Przeglądanie i pobieranie plików dziennika

Pliki dziennika dostarczają informacji o operacjach Brama dostępu bezpośredniego. Qlik Pomoc techniczna może Cię poprosić o dostarczenie plików dziennika w celu rozwiązania problemów. Pliki dziennika można przeglądać lub pobierać w Podglądzie dziennika. W normalnych okolicznościach nie ma powodu, aby sprawdzać pliki dziennika, ale jeśli wystąpią powtarzające się awarie lub inne problemy, pliki dziennika często pomogą określić ich przyczynę.

Aby otworzyć Podgląd dziennika:

1. W centrum aktywności Administrowanie przejdź do pozycji Bramy danych i znajdź Brama dostępu bezpośredniego.

2. Kliknij na końcu wiersza i wybierz pozycję Zobacz dzienniki.

   Zostanie otwarte okno Podgląd dziennika.

3. Z listy rozwijanej w lewym górnym rogu wybierz typ dziennika, o którego przejrzenie lub pobranie poprosił Cię zespół pomocy technicznej Qlik.

   Dostępne są następujące dzienniki:

   • Dzienniki Brama dostępu bezpośredniego (DirectAccessAgent)
   • Dzienniki DCaaS (dcaas_logs)
   • Dzienniki łącznika opartego na ODBC (odbc-connector_logs)
   • Dzienniki łącznika SAP BW (QvSAPBwConnector-<data + znacznik czasu>)
   • Dzienniki łącznika SAP SQL (QvSqlBwConnector-<data + znacznik czasu>)

   • Dzienniki agenta łącznika (connector-agent_logs_<data>)

   • Dzienniki łącznika SAP ODP (QvSapConnectorPackage-<id_procesu>)

   • Dzienniki łącznika REST (rest-connector_logs_<znacznik czasu>)

   • Dzienniki łącznika plików (file-connector_logs_<znacznik czasu>)

   InformacjaOd wersji Brama dostępu bezpośredniego 1.7.1 zdarzenia uruchomienia, wyjścia i ponownego uruchomienia łącznika będą zapisywane w pliku dziennika Brama dostępu bezpośredniego(DirectAccessAgent). W poprzednich wersjach były one zapisywane w pliku dziennika Dzienniki agenta łącznika (connector-agent_logs_<data>).

4. Z sąsiedniej listy rozwijanej wybierz dziennik, który chcesz wyświetlić lub pobrać. Pliki dzienników są uporządkowane od najnowszego (aktualnie aktywnego pliku dziennika) do najstarszego. Po wybraniu pliku dziennika można użyć przycisków i , aby przejść odpowiednio na początek lub koniec pliku dziennika.

   WskazówkaWidok pliku dziennika nie jest aktualizowany automatycznie o najnowsze komunikaty. Aby zaktualizować widok, kliknij ikonę w celu przejścia do końca pliku dziennika odświeżonego o najnowsze komunikaty.

5. Aby pobrać plik dziennika, kliknij Pobierz.

   Plik zostanie pobrany na komputer lub pojawi się monit o jego zapisanie, w zależności od ustawień przeglądarki.

Otwieranie dzienników Brama dostępu bezpośredniego na komputerze z Brama dostępu bezpośredniego

Oprócz możliwości pobierania dzienników Brama dostępu bezpośredniego (DirectAccessAgent) z centrum aktywności Administrowanie można je także otwierać bezpośrednio z komputera z Brama dostępu bezpośredniego. W przypadku domyślnej instalacji dzienniki te znajdują się w następującym folderze:

C:\Program Files\Qlik\ConnectorAgent\data\logs

Zmiana poziomu rejestrowania DirectAccessAgent

Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników DirectAccessAgent. DirectAccessAgent odpowiada za połączenie z usługami Qlik Cloud. Aby wyświetlić i zmienić poziom szczegółowości rejestrowania w dziennikach funkcji DirectAccessAgent, uruchom następujące polecenia z podfolderu ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent z domyślną instalacją):

• Aby wyświetlić bieżący poziom rejestrowania, wykonaj:

  connectoragent configuration getloggers

• Aby ustawić poziom rejestrowania na Trace, wykonaj:

  connectoragent configuration setloggers -l Root -v DEBUG

• Aby ustawić poziom rejestrowania na Verbose, wykonaj:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Dodatkowe opcje rejestrowania znajdują się w sekcji Konfigurowanie Brama dostępu bezpośredniego w Qlik Cloud poniżej.

Aktualizacja klucza rejestracyjnego

W mało prawdopodobnym przypadku uszkodzenia klucza lub jeśli pojawi się podejrzenie nieautoryzowanego dostępu do serwera bramy danych, może być konieczna zmiana klucza rejestracyjnego.

Aby zaktualizować klucz rejestracyjny:

1. Na serwerze bramy Direct Access gateway otwórz wiersz poleceń i zmień katalog roboczy na podfolder ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent w przypadku domyślnej instalacji).

2. Wykonaj następujące polecenia:

   • Wygeneruj nowy klucz:

     connectoragent qcs generate_keys

   • Wyświetl klucz:

     connectoragent qcs get_registration

     Klucz jest pokazany:

     

3. Skopiuj cały klucz, jak pokazano w powyższym przykładzie.

4. W centrum aktywności Administrowanie otwórz ustawienia bramy danych, klikając przycisk na końcu odpowiedniego wiersza i wybierając pozycję Edytuj.

5. Wklej klucz w polu Klucz (zastępując obecny klucz) i zapisz ustawienia.

6. Wróć do serwera bramy dostępu bezpośredniego i ponownie uruchom usługę Brama danych Qlik — dostęp bezpośredni zgodnie z opisem w temacie Zarządzanie usługą Brama danych Qlik — dostęp bezpośredni.