Aktualizowanie Brama danych Qlik — dostęp bezpośredni

Nowe funkcje i ulepszenia

Brama Direct Access gateway 1.6.5 wprowadza następujące funkcje i udoskonalenia:

• Obsługa łącznika SAP ODP

  W tej wersji wprowadzono możliwość dostępu do źródła SAP ODP za pośrednictwem bramy Brama dostępu bezpośredniego. Aby to ułatwić, do łącznika SAP ODP dodano nowe pole Brama danych. Nowe pole umożliwia klientom wybór bramy, której będą używać w celu uzyskania dostępu do źródła SAP ODP.

  Zobacz także: Łącznik SAP ODP (tylko w języku angielskim)

• Rozszerzone możliwości rejestrowania

  W tej wersji wprowadzono nowy rejestrator, którego Pomoc techniczna Qlik może używać do rozwiązywania problemów z określonymi komponentami bramy.

• Nowo obsługiwany region

  Japonia jest teraz obsługiwana jako region dzierżawy Qlik Cloud.

• Poprawki wydajności

  Ulepszona alokacja pamięci na potrzeby szyfrowanych sesji.

Rozwiązane problemy

W Direct Access gateway 1.6.5 rozwiązano następujące problemy

• Luka w zabezpieczeniach

  Podczas pracy z łącznikiem ODBC klucze tajne będą zapisywane w dzienniku DCAAS.

• Wydajność podczas izolacji procesu

  Rozpoczynanie procesów przy dużym obciążeniu zajmowało dużo czasu.

• Nieprawidłowa ścieżka instalacji

  Instalacja bramy Brama dostępu bezpośredniego zawsze ustawiała Qlik jako folder główny, nawet jeśli użytkownik wybrał inny folder w kreatorze instalacji.

Nowe funkcje i ulepszenia

• Obsługa przeglądania i pobierania plików dziennika z funkcji Konsola zarządzania

  W tej wersji wprowadzono możliwość przeglądania plików dziennika bramy Brama dostępu bezpośredniego w funkcji Konsola zarządzania i udostępniania ich w razie potrzeby działowi pomocy technicznej Qlik. W normalnych okolicznościach nie ma powodu, aby wyświetlać pliki dziennika, ale jeśli wystąpią powtarzające się awarie lub inne problemy, pliki dziennika często pomogą określić ich przyczynę.

  Zob. także: Przeglądanie i pobieranie plików dziennika

• Obsługa instalacji bramy Brama dostępu bezpośredniego w trybie cichym

  Klienci mogą teraz instalować bramę Brama dostępu bezpośredniego w trybie cichym, co przydaje się, gdy trzeba przeprowadzić instalację bramy Brama dostępu bezpośredniego na kilku komputerach w całej organizacji.

  Zob. także: Instalacja bramy Brama dostępu bezpośredniego w trybie cichym

• Poprawiona ciągłość sesji

  Po wygaśnięciu sesji przeładowania czasami pojawiał się błąd DirectAccess-1012. Teraz Brama dostępu bezpośredniego próbuje podtrzymywać sesję przeładowania, częściej wysyłając polecenie ping do Qlik Cloud.

Rozwiązane problemy

W Direct Access gateway 1.6.4 rozwiązano następujące problemy

• Nieprawidłowa nazwa parametru w pliku configuration.properties

  Podczas nowej instalacji bramy Brama dostępu bezpośredniego parametr EXTEND_FIRST_REQUEST_TIMEOUT w pliku configuration.properties miał nieprawidłową nazwę FIRST_REQUEST_TIME_EXTENSION.

• Dostępność zasobników przeładowań

  Gdy wielokrotne przeładowania miały ten sam identyfikator przeładowania, liczba zasobników przeładowań w QCS osiągała maksimum.

Wersja Brama dostępu bezpośredniego 1.6.3 zawiera następujące ulepszenia i poprawki błędów:

• Zapobieganie utracie danych

  W poprzednich wersjach, aby zapobiec potencjalnej utracie danych, brama Direct Access gateway nie łączyła się automatycznie ze źródłem danych podczas przeładowywania. Od tej wersji brama Direct Access gateway będzie w razie potrzeby automatycznie łączyć się ponownie ze źródłem danych. Aby zapobiec utracie danych, przed ponownym połączeniem zostanie zweryfikowane zakończone podsumowanie przeładowania. W przypadku wykrycia utraty danych przeładowanie się nie powiedzie.

• Limit czasu sesji przeładowania

  W rzadkich przypadkach sesja przeładowania pozostanie aktywna przez czas nieokreślony. Aby temu zapobiec, w tej wersji wprowadzono trzygodzinny limit czasu sesji przeładowania.

• Rozszerzenie limitu czasu dla żądań ładowania

  Przeładowanie czasami kończyło się niepowodzeniem z powodu następujących błędów:

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

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

  Aby rozwiązać ten problem, dodano parametr EXTEND_FIRST_REQUEST_TIMEOUT (do wydłużania limitu czasu żądania ładowania) do pliku configuration.properties. Wartość domyślna to „0”. Klienci, którzy często napotykają te błędy, powinni spróbować ustawić limit czasu na 5–10 minut.

• Obsługa szczegółowych komunikatów o błędach połączenia

  Dodano obsługę przeglądania szczegółowych komunikatów o błędach połączenia podczas korzystania z łączników bramy Direct Access gateway opartych na ODBC. Klienci mogą teraz ustawić parametr ShowErrorDetailMessage w zaawansowanych ustawieniach łącznika na „true”, aby zobaczyć pełny błąd zwrócony przez sterownik ODBC. Szczegółowy komunikat o błędzie zostanie wyświetlony w Edytorze ładowania danych.

  InformacjaKomunikat o błędzie jest w całości dostarczany przez używane źródło danych. Qlik nie dołącza żadnych informacji do komunikatu o błędzie ani w żaden sposób go nie edytuje.

• Obsługa wielu przeładowań przy użyciu tego samego identyfikatora przeładowania

  Od tej wersji identyfikator sesji aparatu będzie używany do rozróżniania wielokrotnych przeładowań z tym samym identyfikatorem przeładowania. Zapobiegnie to potencjalnym konfliktom, które mogą skutkować niepowodzeniem przeładowania i wyświetleniem następującego błędu:

  Connector error: data loading error (DirectAccess-4008

W Brama dostępu bezpośredniego 1.6.2 rozwiązano problem, który czasami powodował awarię Agenta łącznika podczas pracy w trybie izolacji procesu.

Nowe funkcje i ulepszenia

Direct Access gateway 1.6.1 wprowadza kilka ważnych funkcji i ulepszeń, poprawiających ogólną stabilność i wydajność.

• Obsługa rozkładania przeładowań na wiele procesów łączników

  Do bramy Direct Access gateway dodano izolację procesu łącznika. Jest to funkcja opcjonalna, co oznacza, że jest domyślnie wyłączona. 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.

  Zobacz też: Łagodzenie awarii łącznika podczas przeładowywania

• Dodano możliwość wyłączenia fragmentacji podczas pracy z łącznikiem SAP BW (za pośrednictwem Direct Access gateway).

  W tej wersji wprowadzono parametr aplikacji BEX_ONE_CHUNK dla łącznika SAP BW (za pośrednictwem Direct Access gateway). Aby zoptymalizować wydajność podczas uzyskiwania dostępu do SAP BW bezpośrednio z Qlik Cloud (czyli nie za pośrednictwem Direct Access gateway), zestaw wyników jest dzielony na fragmenty w zapleczu SAP i odczytywany jako osobne wątki. Jednak w przypadku uzyskiwania dostępu do SAP BW za pośrednictwem Direct Access gateway dzielenie zestawu wyników na fragmenty nie zapewnia realnych korzyści. Wręcz przeciwnie, zajmuje więcej pamięci współdzielonej w SAP, ponieważ wymaga utworzenia dodatkowej tabeli tymczasowej na czas przesyłania danych. Fragmentację można rozpocząć (choć zwykle nie jest to wymagane), ustawiając wartość BEX_ONE_CHUNK:false w pliku appsettings.json, który znajduje się w folderze binarnym łącznika SAP.

• Ulepszenia diagnostyki dla łączników SAP BW (za pośrednictwem Direct Access gateway) i SAP SQL (za pośrednictwem Direct Access gateway).

  W przypadku dzienników łącznika SAP BW (za pośrednictwem Direct Access gateway) i SAP SQL (za pośrednictwem Direct Access gateway) przed rozszerzeniem nazwy pliku dziennika dodano sufiks _port, a do plików dziennika łącznika dodano komunikat ProcessID=###, aby odróżnić zdarzenia z nowych wystąpień łącznika nasłuchującego na tym samym porcie.

• Ulepszenia ponownego łączenia

  Mechanizm ponownego łączenia podczas przeładowywania został ulepszony, dzięki czemu Direct Access gateway nie musi już łączyć się z podem, który rozpoczął przeładowanie (jak to było wcześniej). Teraz, zamiast wielokrotnie próbować połączyć się z podem, który rozpoczął przeładowanie (co często kończyło się niepowodzeniem przeładowania), połączy się z pierwszym dostępnym modułem.

Rozwiązane problemy

W Direct Access gateway 1.6.0 rozwiązano następujące problemy

• Dziennik łącznika ODBC za pośrednictwem Direct Access gateway:

  W przypadku przeładowywania z różnych źródeł danych procesy z jednego źródła danych błędnie pojawiały się w rejestrowaniu zdarzeń z drugiego źródła danych.

• Brak pliku w konfiguracji

  Plik configuration.properties nie był kopiowany podczas instalacji Direct Access gateway.

• Błąd przeładowywania podczas skalowania zasobów Qlik Cloud

  Skalowanie zasobów Qlik Cloud czasami skutkowało błędem DirectAccess-1006. Wprowadzono ulepszenie mające na celu poprawę obsługi niektórych przypadków skalowania zasobów Qlik Cloud, które występują podczas przeładowywania aplikacji za pośrednictwem Direct Access gateway.

• Błąd połączenia ze Snowflake

  Połączenie ze Snowflake przez złącze ODBC (za pośrednictwem Direct Access gateway) nie udawało się.

• Debugowanie błędu skryptu aplikacji w Edytorze ładowania danych

  Debugowanie skryptów aplikacji w Edytorze ładowania danych z włączoną opcją Ogranicz wyniki czasami kończyło się niepowodzeniem i wyświetlaniem następującego błędu:

  Connector error: Invalid load request (DirectAccess-1006).

Rozwiązane problemy:

• Łącznik ODBC (przez Direct Access gateway): połączenie czasami się zrywa po anulowaniu przeładowywania dużych tabel. Wprowadzono poprawkę, która temu zapobiega.

• Łącznik Microsoft SQL Server (przez Direct Access gateway): czasami próba nawiązania połączenia z SQL Server na starszej wersji systemu Windows Server nie udaje się ze względu na problemy ze zgodnością z TLS. Zostaje zwrócony następujący błąd:

  Please check the values for Username‚ Password‚ Host and other properties. Description: Client unable to establish connection - ERROR [08001] [Qlik][SqlServer] Problem establishing connection to the server.

  Sterownik SQL Server został zaktualizowany w celu usunięcia problemu.

• Łącznik SAP SQL (przez Direct Access gateway): podczas próby podejrzenia tabeli czasami pojawia się następujący błąd:

  Exception of Type System.OutOfMemoryException

• Łącznik SAP SQL (przez Direct Access gateway): Czasami podczas próby podejrzenia tabeli po paru minutach następuje przekroczenie limitu czasu i zwrot następującego błędu:

  Request could not be completed.

• Łączniki SAP SQL (przez Direct Access gateway) i SAP BW (przez Direct Access gateway): Do dzienników dodano informacje diagnostyczne, które mają pomóc w rozwiązywaniu problemów z wieloma współbieżnymi żądaniami.

Nowe funkcje i ulepszenia:

• Zapewnia obsługę nowego łącznika ODBC (za pośrednictwem Direct Access gateway) (tylko w języku angielskim).

• W kolumnie Wersja w funkcji Konsola zarządzania będzie teraz wyświetlana wersja Brama dostępu bezpośredniego zamiast wersji RepAgent (jednego z komponentów).

Rozwiązane problemy:

• Uaktualnienie Brama dostępu bezpośredniego powodowało resetowanie zaawansowanych ustawień rejestrowania łącznika ODBC (takich jak czas przechowywania i maksymalny rozdział pliku dziennika) do ustawień domyślnych.
• W rzadkich przypadkach występowała awaria łącznika ODBC i agent Brama dostępu bezpośredniego nie mógł uruchomić go ponownie.
• W razie niepowodzenia połączenia lub nieprawidłowego zapytania SQL był zwracany ogólny komunikat o błędzie „Przesunięcie i długość były poza granicami..." zamiast faktycznej przyczyny błędu.
• Sporadycznie przeładowanie huba kończyło się niepowodzeniem z komunikatem o błędzie „DirectAccess-4008” w przypadku aplikacji mających ponad 3 GB, w których występowały wydłużone opóźnienia lub przetwarzanie po początkowym zapytaniu bramy. Dodano więcej rejestrowanych danych, co ma pomóc w identyfikacji powiązanych problemów.

Rozwiązane problemy:

• Zmiana wartości ODBC_LOG_LEVEL w pliku C:\ProgramData\Qlik\Gateway\configuration.properties nie dałaby żadnego efektu.

• Przeładowanie zakończy się niepowodzeniem z następującym błędem, jeśli aktywne połączenie z bramą Dostęp bezpośredni nie będzie używane przez kilka minut:

  Connector error: Invalid load request (DirectAccess-1006)

  Problem rozwiązano, nie dopuszczając do przekroczenia limitu czasu podczas aktywnej sesji.

• Ładowanie tabel z wieloma kolumnami z MySQL i PostgreSQL czasami kończyło się niepowodzeniem z następującym komunikatem o błędzie:

  System.InvalidOperationException: Failed to HPACK encode the headers

• Gdy użytkownicy nie mieli uprawnień do przestrzeni zarządzanej zawierającej bramę Dostęp bezpośredni, wyświetlany był następujący niejasny komunikat o błędzie:

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Object reference not set to an instance of an object.

  Komunikat o błędzie został poprawiony i zawiera dokładniejszy opis problemu.

• Wielokrotne próby przeładowania czasami kończyły się niepowodzeniem z powodu nadmiernego wykorzystania pamięci.

Funkcje i ulepszenia:

Brama dostępu bezpośredniego okresowo sprawdza swoją kondycję. Począwszy od tej wersji sprawdzanie kondycji będzie uruchamiać ponownie usługę Brama dostępu bezpośredniego, jeżeli nie będzie ona reagować przez pięć minut.

Rozwiązane problemy:

• Po uruchomieniu przeładowania przy użyciu zapytania, które zwraca natychmiast metadane, ale pierwszy fragment danych jest zwracany po kilku minutach, czasami występował błąd:

  Connector error: data loading error (DirectAccess-4008)

• W niektórych sytuacjach brama Brama dostępu bezpośredniego nie łączyła się ponownie z Qlik Cloud po przerwaniu przeładowania.

• W rzadkich sytuacjach podczas przeładowań występował błąd:

  No connection could be made because the target machine actively refused it.

• Podczas łączenia się z SQL Server znaki specjalne w hasłach nie były prawidłowo kodowane, co powodowało błąd:

  Command test connection returned non-success: Error message: Please check the values for Username‚ Password‚ Host and other properties. Description: Access credentials are not valid for this connection.

• Występowała czasami awaria łącznika ODBC po przerwaniu ładowania z interfejsu użytkownika, kiedy zapytanie zwracało dane.

• W rzadkich sytuacjach związanych z dużymi ładunkami przeładowanie nie udawało się i powodowało błąd:

  Connector error: Unknown reason:. Index was outside the bounds of the array. (DirectAccess-1500)

Zaktualizowano certyfikaty urzędu certyfikacji potrzebne do uwierzytelnienia dzierżawy Qlik Cloud.

W tej wersji rozwiązano następujący problem:

Wersja Brama danych Qlik — dostęp bezpośredni 1.3.1 ma tendencję do nadmiernego obciążania procesora w niektórych sytuacjach. Wersja 1.3.2 rozwiązuje ten problem i nie zawiera żadnych innych zmian. Aby zapobiec awariom związanym z procesorem, zachęcamy wszystkich klientów do niezwłocznej aktualizacji do wersji 1.3.2.

Ta wersja zawiera pakiet CA do Qlik Cloud Government i rozwiązuje kilka problemów.

Plik pakietu CA do Qlik Cloud Government

Pakiet CA uwierzytelnia tożsamość dzierżawy Qlik Cloud, zapewniając w ten sposób zaufane połączenie.

W poprzednich wersjach Brama dostępu bezpośredniego plik pakietu CA dla klientów używających Qlik Cloud Government był dostarczany przez Qlik w miarę potrzeb. Od tej wersji plik pakietu CA jest zawarty w instalacji.

W konfiguracji domyślnej plik pakietu CA jest instalowany w następującej lokalizacji: C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Rozwiązane problemy

• Wykryto lukę w zabezpieczeniach, w wyniku której klient HTTP używany do łączenia z serwerem proxy podążał za przekierowaniem.

• Agent Brama dostępu bezpośredniego ulega czasami awarii powodując wyświetlenie następującego komunikatu o błędzie:

  Unable to write data to the transport connection: An established connection was aborted by the software in your host machine

• Podczas inicjowania dziennika niekiedy występował wyjątek, który mógł powodować zawieszenie Brama dostępu bezpośredniego przy ponownym uruchamianiu.
• Ulepszono obsługę przeładowywania sesji, aby zapobiec niepotrzebnemu upływaniu limitów czasu.
• Kolumna Wersja Brama dostępu bezpośredniego w funkcji Konsola zarządzania wskazywała nieprawidłową wersję.
• Agent nadal wysyłał dane do bramy, gdy użytkownik zatrzymał zadanie lub został przekroczony limit przydziału.
• Kompleksowe szyfrowanie Bramy danych nie było włączane domyślnie i było kontrolowane przy użyciu flag środowiska uruchomieniowego.

W tej wersji rozwiązano następujące problemy:

• Instalację wersji 1.2 Brama danych Qlik – Dostęp bezpośredni może uniemożliwiać problem z jej podpisem cyfrowym.
• Pliki konfiguracyjne zostaną zastąpione podczas aktualizacji, co spowoduje utratę zmian

Funkcje i ulepszenia:

• Dodano obsługę źródeł SAP BW i SAP SQL. Aby uzyskać informacje na temat konfigurowania łączności z tymi źródłami, zobacz SAP NetWeaver (tylko w języku angielskim).

Rozwiązane problemy:

• Zwiększono stabilność i możliwość odzyskiwania usługi Brama danych Qlik — dostęp bezpośredni, eliminując potrzebę jej ręcznego ponownego uruchamiania
• Obsługa zastępowania domyślnych parametrów instalacji i konfiguracji usługi Brama dostępu bezpośredniego

Funkcje i ulepszenia:

• Dodano obsługę systemu Windows Server 2022

Rozwiązane problemy:

• Rozwiązano potencjalny problem ze stabilnością związany z wybieraniem niestandardowej ścieżki podczas konfiguracji

1.1.0

18 października 2022 r.

Funkcje i ulepszenia:

• Obsługa portfeli Oracle
• Wsparcie dla Google BigQuery
• Ulepszone komunikaty o błędach

Rozwiązane problemy:

• Usprawnione przywracanie sprawności systemu po awarii sterownika
• Usługa Brama danych Qlik — dostęp bezpośredni czasami nieoczekiwanie się zatrzymywała