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

Rozwiązywanie problemów z Brama dostępu bezpośredniego

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

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

InformacjaWyświetlanie i pobieranie dzienników wymaga roli Może używać danych.

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 Więcej 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 ODP (QvSapConnectorPackage-<process_id>)
    • Dzienniki łącznika SAP SQL (QvSqlBwConnector-<data + znacznik czasu>)
    • 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 Strzałka do przewijania do góry i Strzałka do przewijania do dołu, 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ę Strzałka do przewijania do dołu 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

OstrzeżenieZmień poziom rejestrowania tylko wtedy, gdy poprosi o to przedstawiciel pomocy technicznej Qlik.

Poziom rejestrowania dzienników bramy Brama dostępu bezpośredniego można zmienić w sposób opisany poniżej.

Zmiana poziomu rejestrowania komponentów łącznika

Do celów rozwiązywania problemów może być konieczna zmiana poziomu rejestrowania dzienników komponentów łącznika.

W tym celu:

  1. Otwórz 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ść <KOMPONENT>_LOG_LEVEL, gdzie COMPONENT może być jedną z następujących wartości:

    • AGENT
    • DCAAS
    • ODBC
    • SAPBW
    • SAPSQL
    • SAPPACKAGE
    • FILE
  3. Ustaw ją na jedną z następujących wartości: ERROR, WARN, INFO lub DEBUG
  4. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

    InformacjaPocząwszy od wersji Brama dostępu bezpośredniego 1.7.1, jeśli zmieniono tylko komponent AGENT, nie trzeba ponownie uruchamiać usługi Brama danych Qlik — dostęp bezpośredni.

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

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:

      Obraz klucza rejestracyjnego bezpośredniego dostępu

  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 Więcej 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 Direct Access gateway 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.

Wydłużenie czasu 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 następująco:

  1. Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.

  2. Znajdź parametr ODBC_RELOAD_SESSION_LIFE i zwiększ jego wartość odpowiednio do potrzeb.
  3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Wydłużenie limitu czasu żądań ł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 ustawić parametr EXTEND_FIRST_REQUEST_TIMEOUT na 5–10 minut.

InformacjaJednostką miary wartości parametru są minuty.

Wykonaj następujące czynności:

  1. Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.

  2. Znajdź parametr EXTEND_FIRST_REQUEST_TIMEOUT i zwiększ jego wartość do 5–10 minut. Wartość domyślna to 0.
  3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.

Łagodzenie awarii łącznika podczas przeładowywania

Izolacja procesów umożliwia administratorom mającym bezpośredni dostęp do systemu operacyjnego serwera bramy 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.

Informacja

Wymaga Brama dostępu bezpośredniego w wersji 1.6.1 lub nowszej.

Wyłączanie izolacji procesu

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

InformacjaW 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 zmienić w sposób opisany w temacie Włączanie izolacji procesów lub zmiana liczby jednoczesnych przeładowań poniżej.

Aby wyłączyć izolację procesu:

  1. Otwórz plik C:\ProgramData\Qlik\Gateway\configuration.properties. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.
  2. Ustaw opcję [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Koloruj wszystkie wiersze wg warunku) na wartość None (Wskazane wiersze).

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

Włączanie izolacji procesów lub zmiana liczby jednoczesnych przeładowań

Aby włączyć izolację procesów lub zmienić liczbę jednoczesnych przeładowań:

  1. Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.

    Plik zawiera trzy prefiksy odpowiadające różnym typom łącznika:ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> i SAPPACKAGE_<property-name>

  2. Ustaw [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE na Load i [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT na N.

    Gdzie:

    N= Jeden proces polecenia + Liczba jednoczesnych procesów przeładowania do przydzielenia. Na przykład wartość 10 oznaczałaby maksymalnie 9 równoczesnych przeładowań.

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

Przykłady izolacji procesu łącznika ODBC

Poniższy fragment pliku configuration.properties pokazuje, jak włączyć izolację procesu łącznika ODBC dla maksymalnie 12 przeładowań:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

InformacjaPocząwszy od wersji Brama dostępu bezpośredniego 1.6.7, wartość MAX_PROCESS_COUNT może przekroczyć 10 bez konieczności zmiany innych ustawień. Aby w pełni odizolować przeładowania z określonym typem łączników (tj. nie więcej niż jedno przeładowywanie na proces łącznika), wartość ta powinna wynosić minimum 30, ale może być konieczne ustawienie jej nawet na 60, w zależności od obciążenia.

Buforowanie danych na potrzeby przeładowania w razie problemu

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. Funkcję tę można włączyć, ustawiając próg rozmiaru pamięci podręcznej na potrzeby przenoszenia fragmentów danych na dysk (do każdego przeładowania). Po osiągnięciu określonego progu brama przekaże dalsze zaszyfrowane fragmenty na dysk komputera bramy Brama dostępu bezpośredniego.

InformacjaWymaga bramy Brama dostępu bezpośredniego w wersji 1.6.8 lub nowszej.

Aby ustawić rozmiar pamięci podręcznej:

  1. Otwórz C:\ProgramData\Qlik\Gateway\configuration.properties jako administrator. Jeśli robisz to za pomocą Eksploratora Windows, sprawdź, czy zaznaczona jest opcja Pokaż ukryte pliki, foldery i dyski.

  2. Ustaw RELOAD_CACHE_MEMORY_MB na N (wartość domyślna to 0, co oznacza, że funkcja nie jest włączona).

    Gdzie:

    N = ilość pamięci przydzielonej do buforowania fragmentów danych (na przeładowanie)

    InformacjaWłączenie tej funkcji zwiększy zużycie pamięci na komputerze z Brama dostępu bezpośredniego, dlatego zalecamy monitorowanie wpływu na pamięć, gdy jest ona włączona. W większości sytuacji ustawienie wartości RELOAD_CACHE_MEMORY_MB na 100 powinno wystarczyć.
  3. Zapisz plik configuration.properties i uruchom ponownie usługę Brama danych Qlik — dostęp bezpośredni.
InformacjaAby zapobiec pogorszeniu wydajności w wyniku gromadzenia się niepotrzebnych plików, przetworzone fragmenty danych będą usuwane z pamięci komputera i dysku.

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

InformacjaWymaga Brama dostępu bezpośredniego w wersji 1.7.1 lub nowszej.

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.

InformacjaAby zapewnić stabilność i zoptymalizować wydajność, najlepszą praktyką jest korzystanie wyłącznie ze ścieżek lokalnych.

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.

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

InformacjaWymaga Brama dostępu bezpośredniego w wersji 1.7.1 lub nowszej.

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

OstrzeżenieChociaż wiele problemów można rozwiązać, po prostu zmieniając QlikDataType na String, jeśli nie jest to możliwe, zalecamy skontaktowanie się z pomocą techniczną Qlik w celu uzyskania wskazówek dotyczących typów danych Qlik Cloud, do których można zamapować źródłowy typ danych.

Wykonaj następujące czynności:

  1. W edytorze tekstowym otwórz plik C:\ProgramData\Qlik\Gateway\custom_type_mapping.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_mapping.json) klient musi zmienić rozmiar typu danych Qlik Cloud DateTime na 27.

    {

    "Identifier": "Amazon Athena ODBC (x64)",

    "NativeDataType": "timestamp with time zone",

    "QlikDataType": "DateTime",

    "Size": 27,

    "IsBit": false

    }

  3. Zapisz plik custom_type_mapping.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:

    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.

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.

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ć!