Aktualisierung von Qlik Data Gateway - Direct Access

Neue Funktionen und Verbesserungen

In Direct Access Gateway 1.6.5 werden die folgenden Funktionen und Verbesserungen eingeführt:

• Unterstützung für den SAP ODP-Konnektor

  In dieser Version wird die Möglichkeit eingeführt, über Direct Access Gateway auf eine SAP ODP-Quelle zuzugreifen. Um dies zu ermöglichen, wurde dem SAP ODP-Konnektor ein neues Feld Daten-Gateway hinzugefügt. Über das neue Feld können die Kunden wählen, welches Gateway für den Zugriff auf die SAP ODP-Quelle verwendet werden soll.

  Siehe auch: SAP ODP-Konnektor (nur auf Englisch)

• Erweiterte Protokollierfunktionen

  In dieser Version wird eine neue Protokollierfunktion eingeführt, die der Qlik-Support zur Fehlerbehebung für bestimmte Gateway-Komponenten nutzen kann.

• Neu unterstützte Region

  Japan wird jetzt als Qlik Cloud Mandantenregion unterstützt.

• Leistungsverbesserung

  Verbesserte Speicherzuweisungen für verschlüsselte Sitzungen.

Behobene Probleme

In Direct Access Gateway 1.6.5 wurden die folgenden Probleme behoben:

• Sicherheitsschwachstelle

  Schlüssel wurden bei der Arbeit mit dem ODBC-Konnektor in das DCAAS-Protokoll geschrieben.

• Leistung bei der Prozessisolierung

  Unter hohen Arbeitslasten dauerte das Starten von Prozessen sehr lang.

• Falscher Installationspfad

  Beim Installieren von Direct Access Gateway wurde immer Qlik als Root-Ordner festgelegt, auch wenn der Benutzer im Einrichtungs-Assistenten einen anderen Ordner auswählte.

Neue Funktionen und Verbesserungen

• Unterstützung für das Anzeigen und Herunterladen von Protokolldateien über die Verwaltungskonsole

  In dieser Version wird die Möglichkeit eingeführt, die Protokolldateien für Direct Access Gateway in der Verwaltungskonsole anzuzeigen und bei Bedarf mit dem Qlik-Support zu teilen. Unter normalen Umständen ist es nicht erforderlich, die Protokolldateien anzuzeigen. Wenn aber häufig Ausfälle oder andere Probleme auftreten, können die Protokolldateien bei der Ursachenermittlung helfen.

  Siehe auch: Anzeigen und Herunterladen von Protokolldateien

• Unterstützung für die Installation von Direct Access Gateway im Hintergrund

  Kunden können jetzt Direct Access Gateway im Hintergrund installieren. Das ist nützlich, wenn Sie Direct Access Gateway auf mehreren Rechnern in Ihrer Organisation installieren müssen.

  Siehe auch: Installieren von Direct Access Gateway im Hintergrund

• Verbesserte Sitzungskontinuität

  Bei Ablauf einer Ladesitzung trat manchmal ein Fehler „DirectAccess-1012“ auf. Jetzt versucht Direct Access Gateway, die Ladesitzung durch häufigeres Pingen von Qlik Cloud aktiv zu halten.

Behobene Probleme

In Direct Access Gateway 1.6.4 wurden die folgenden Probleme behoben:

• Falscher Parametername in der Datei configuration.properties

  Bei einer neuen Installation von Direct Access Gateway wurde der Parametername EXTEND_FIRST_REQUEST_TIMEOUT in der Datei configuration.properties fälschlicherweise FIRST_REQUEST_TIME_EXTENSION genannt.

• Verfügbarkeit von Lade-Pods

  Wenn mehrere Ladevorgänge die gleiche Lade-ID teilten, konnte die Anzahl der Lade-Pods in QCS die Höchstzahl erreichen.

Direct Access Gateway 1.6.3 umfasst die folgenden Verbesserungen und Fehlerkorrekturen:

• Vermeidung von Datenverlust

  In früheren Versionen stellte Direct Access Gateway nicht automatisch eine erneute Verbindung zur Datenquelle während eines Ladevorgangs her, um mögliche Datenverluste zu vermeiden. Ab dieser Version stellt Direct Access Gateway automatisch bei Bedarf eine erneute Verbindung zur Datenquelle her. Um Datenverluste zu vermeiden, wird die Übersicht des abgeschlossenen Ladevorgangs vor der erneuten Verbindung geprüft. Wenn Datenverlust festgestellt wird, schlägt der Ladevorgang fehl.

• Zeitüberschreitung für Ladesitzungen

  In seltenen Szenarios blieb die Ladesitzung für unbegrenzte Zeit aktiv. Um solche Fälle zu vermeiden, wird in dieser Version eine Zeitüberschreitung nach drei Stunden für Ladesitzungen eingeführt.

• Verlängerung der Zeitüberschreitung für Ladeanforderungen

  Ladevorgänge schlugen manchmal mit den folgenden Fehlern fehl:

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

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

  Um dieses Problem zu beheben, wurde ein Parameter EXTEND_FIRST_REQUEST_TIMEOUT (zum Verlängern der Zeitüberschreitung für die Ladeanforderung) zur Datei configuration.properties hinzugefügt. Der Standardwert ist „0“. Kunden, bei denen diese Fehler häufig auftreten, sollten versuchen, die Zeitüberschreitung auf 5-10 Minuten einzustellen.

• Unterstützung für detaillierte Verbindungsfehlermeldungen

  Es wurde Unterstützung für die Anzeige detaillierter Verbindungsfehlermeldungen bei der Verwendung von ODBC-basierten Konnektoren über Direct Access Gateway hinzugefügt. Kunden können jetzt den Parameter ShowErrorDetailMessage in den erweiterten Konnektoreinstellungen auf „true“ setzen, um den vollständigen vom ODBC-Treiber zurückgegebenen Fehler anzuzeigen. Die detaillierte Fehlermeldung wird im Dateneditor angezeigt.

  InformationshinweisDie Fehlermeldung wird komplett von der verwendeten Datenquelle bereitgestellt. Qlik hängt keine weiteren Informationen an die Fehlermeldung an und bearbeitet diese nicht.

• Handhabung mehrerer Ladevorgänge mit der gleichen Lade-ID

  Ab dieser Version wird die Sitzungs-ID der Engine verwendet, um zwischen mehreren Ladevorgängen mit der gleichen Lade-ID zu unterscheiden. Damit werden potenzielle Konflikte verhindert, die zum Fehlschlagen von Ladevorgängen mit folgendem Fehler führen:

  Connector error: data loading error (DirectAccess-4008

Direct Access Gateway 1.6.2 behebt ein Problem, das bei der Arbeit im Prozessisolierungsmodus in manchen Fällen einen Absturz des Connector Agent verursachte.

Neue Funktionen und Verbesserungen

Direct Access Gateway 1.6.1 führt mehrere wichtige Funktionen und Verbesserungen ein, die die Stabilität und Leistung insgesamt steigern.

• Unterstützung für die Verteilung von Ladevorgängen über mehrere Konnektorprozesse

  Konnektorprozessisolierung wurde zu Direct Access Gateway hinzugefügt. Dies ist eine Funktion auf Anmeldebasis, d. h., sie ist standardmäßig deaktiviert. Prozessisolierung ermöglicht Administratoren mit direktem Zugriff auf das Betriebssystem des Gateway-Servers zu steuern, wie viele Prozesse pro Konnektortyp für Ladevorgänge verfügbar sind. Wenn Ladevorgänge auf mehrere Konnektorprozesse verteilt werden, erhöht dies die Isolationsstufe, indem die Anzahl der gleichzeitig laufenden Ladevorgänge für die einzelnen Konnektorprozesse reduziert wird. Dadurch kann sich die allgemeine Stabilität von Direct Access Gateway in Fällen verbessern, in denen Konnektorabstürze aufgetreten waren.

  Siehe auch: Abmildern der Auswirkung von Konnektorabstürzen bei Ladevorgängen

• Möglichkeit hinzugefügt, Blöcke bei der Arbeit mit dem SAP BW-Konnektor (über Direct Access Gateway) zu deaktivieren

  In dieser Version wird der Anwendungsparameter BEX_ONE_CHUNK für den SAP BW-Konnektor (über Direct Access Gateway) eingeführt. Wenn auf SAP BW direkt über Qlik Cloud (d. h., nicht über Direct Access Gateway) zugegriffen wird, wird der Ergebnissatz zur Verbesserung der Leistung im SAP-Backend in Blöcke unterteilt und als getrennte Threads gelesen. Wenn jedoch über Direct Access Gateway auf SAP BW zugegriffen wird, hat die Unterteilung des Ergebnissatzs in Blöcke keinen wirklichen Vorteil. Sie verbraucht sogar mehr freigegebenen Speicher in SAP, da für die Dauer der Datenübertragung eine zusätzliche temporäre Tabelle benötigt wird. Es ist möglich (wenn auch in der Regel nicht erforderlich), die Blockerstellung zu starten, indem BEX_ONE_CHUNK:false in der Datei appsettings.json festgelegt wird. Diese Datei befindet sich im Ordner „binaries“ des SAP-Konnektors.

• Diagnoseverbesserungen für SAP BW-Konnektor (über Direct Access Gateway) und SAP SQL-Konnektor (über Direct Access Gateway)

  Für Konnektorprotokolle für SAP BW (über Direct Access Gateway) und SAP SQL (über Direct Access Gateway) wurde das Suffix _port vor der Protokolldatei-Namenserweiterung hinzugefügt und eine Nachricht ProcessID=### wurde den Protokolldateien des Konnektors hinzugefügt, um zwischen Ereignissen von neuen Instanzen des Konnektors zu unterscheiden, die am gleichen Port abhören.

• Verbesserungen bei der erneuten Verbindung

  Der Mechanismus für erneute Verbindungen während des Ladevorgangs wurde verbessert, sodass Direct Access Gateway keine Verbindung mehr mit dem Pod herstellen muss, das den Ladevorgang startete (dies war zuvor erforderlich). Statt wiederholt zu versuchen, eine Verbindung mit dem Pod herzustellen, das den Ladevorgang startete (was oft zu Ladefehlern führte), wird jetzt eine Verbindung zum ersten verfügbaren Pod hergestellt.

Behobene Probleme

In Direct Access Gateway 1.6.0 wurden die folgenden Probleme behoben:

• Protokoll des ODBC-Konnektors über Direct Access Gateway:

  Wenn Ladevorgänge aus verschiedenen Datenquellen durchgeführt wurden, wurden Prozesse einer Datenquelle fälschlicherweise in den Protokollen der anderen Datenquelle aufgeführt.

• Fehlende Datei bei der Einrichtung

  Während der Installation von Direct Access Gateway wurde die Datei configuration.properties nicht kopiert.

• Ladefehler während der Qlik Cloud Ressourcenskalierung

  Die Qlik Cloud Ressourcenskalierung führte manchmal zu einem Fehler „DirectAccess-1006“. Es wurde eine Verbesserung vorgenommen, um bestimmte Szenarios bei der Qlik Cloud Ressourcenskalierung zu verbessern, die während Anwendungsladevorgängen über Direct Access Gateway auftreten.

• Snowflake-Verbindungsfehler

  Verbindungen zu Snowflake über den ODBC-Konnektor (über Direct Access Gateway) schlugen fehl.

• Fehler beim Debuggen von Anwendungsskripten in Dateneditor

  Das Debuggen von Anwendungsskripten im Dateneditor mit aktivierter Option Ergebnisse begrenzen schlug manchmal mit dem folgenden Fehler fehl:

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

Behobene Probleme:

• ODBC-Konnektor (über Direct Access Gateway): Der Konnektor stürzte manchmal ab, wenn Ladevorgänge für große Tabellen abgebrochen wurden. Eine Verbesserung wurde vorgenommen, um dieses Problem zu verhindern.

• Microsoft SQL Server-Konnektor (über Direct Access Gateway): Bei dem Versuch, eine Verbindung mit einem SQL-Server herzustellen, der auf älteren Windows Server-Versionen gehostet war, schlug die Verbindung aufgrund eines TLS-Kompatibilitätsproblems fehl und der folgende Fehler wurde zurückgegeben:

  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.

  Der SQL Server-Treiber wurde aktualisiert, um das Problem zu beheben.

• SAP SQL-Konnektor (über Direct Access Gateway): Beim Versuch, eine Vorschau einer Tabelle anzuzeigen, trat manchmal der folgende Fehler auf:

  Exception of Type System.OutOfMemoryException

• SAP SQL-Konnektor (über Direct Access Gateway): Beim Versuch, eine Vorschau einer Tabelle anzuzeigen, trat manchmal nach einigen Minuten eine Zeitüberschreitung mit folgendem Fehler auf:

  Request could not be completed.

• SAP SQL-Konnektor (über Direct Access Gateway) und SAP BW-Konnektor (über Direct Access Gateway): Diagnoseinformationen wurden zu den Protokollen hinzugefügt, um die Fehlerbehebung bei zahlreichen gleichzeitigen Anfragen zu unterstützen.

Neue Funktionen und Verbesserungen:

• Bietet Unterstützung für den neuen ODBC-Konnektor (über Direct Access Gateway) (nur auf Englisch).

• In der Spalte Version in Verwaltungskonsole wird jetzt die Direct Access Gateway-Version anstelle der Version von RepAgent (eine der Unterkomponenten) angezeigt.

Behobene Probleme:

• Beim Upgrade von Direct Access Gateway wurden die erweiterten Protokolleinstellungen des ODBC-Konnektors (z. B. Protokolldateiaufbewahrung und maximale Größe) auf die Standardwerte zurückgesetzt.
• In seltenen Fällen stürzte der ODBC-Konnektor ab und konnte vom Direct Access Gateway-Agenten nicht neu gestartet werden.
• Wenn eine Verbindung fehlschlug oder die SQL-Abfrage ungültig war, wurde ein allgemeiner Fehler „Versatz und Länge außerhalb des zulässigen Bereichs...“ anstelle der tatsächlichen Fehlerursache zurückgegeben.
• In seltenen Fällen schlugen Ladevorgänge im Hub mit einem Fehler „DirectAccess-4008“ fehl. Dies kam bei Apps mit mehr als 3 GB vor, bei denen nach der anfänglichen Gateway-Abfrage längere Verzögerungen oder Verarbeitungszeiten auftraten. Es wurde weitere Protokollierung hinzugefügt, um zugehörige Probleme besser identifizieren zu können.

Behobene Probleme:

• Die Änderung des Werts ODBC_LOG_LEVEL in der Datei C:\ProgramData\Qlik\Gateway\configuration.properties würde ohne Wirkung bleiben.

• Ein Ladevorgang würde mit dem folgenden Fehler fehlschlagen, wenn eine aktive Direct Access-Gateway-Verbindung mehrere Minuten lang nicht verwendet wird:

  Connector error: Invalid load request (DirectAccess-1006)

  Das Problem wurde gelöst, indem eine Zeitüberschreitung ausgesetzt wird, wenn die Sitzung noch aktiv ist.

• Das Laden von Tabellen mit zahlreichen Spalten aus MySQL und PostgreSQL würde manchmal mit folgendem Fehler fehlschlagen:

  System.InvalidOperationException: Failed to HPACK encode the headers

• Wenn Benutzer keine Privilegien für einen verwalteten Bereich mit dem Direct Access-Gateway hätten, würde die folgende unklare Fehlermeldung angezeigt werden:

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

  Die Fehlermeldung wurde durch eine genauere Beschreibung des Problems verbessert.

• Mehr Ladeversuche würden manchmal aufgrund von zu hohem Arbeitsspeicherverbrauch fehlschlagen.

Funktionen und Verbesserungen:

Direct Access Gateway führt regelmäßig Zustandsprüfungen durch. Ab dieser Version startet die Zustandsprüfung den Direct Access Gateway-Dienst neu, wenn er fünf Minuten lang nicht reagiert hat.

Behobene Probleme:

• Wenn ein Ladevorgang mit einer Abfrage gestartet wurde, die Metadaten sofort, aber die ersten Daten erst einige Minuten später zurückgab, trat manchmal der folgende Fehler auf:

  Connector error: data loading error (DirectAccess-4008)

• In bestimmten Szenarios stellte Direct Access Gateway die Verbindung mit Qlik Cloud nicht wieder her, wenn ein Ladevorgang unterbrochen wurde.

• In seltenen Fällen trat der folgende Fehler bei Ladevorgängen auf:

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

• Beim Herstellen einer Verbindung zu SQL Server wurden Sonderzeichen in Kennwörtern nicht korrekt codiert, was zu dem folgenden Fehler führte:

  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.

• Der ODBC-Konnektor stürzte manchmal ab, wenn die Ladeaktivität über die Benutzeroberfläche abgebrochen wurde, während die Abfrage Daten zurückgab.

• In seltenen Fällen mit hohen Arbeitslasten schlugen Ladevorgänge manchmal mit folgendem Fehler fehl:

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

Die Zertifizierungsstellen-Zertifikate, die für die Authentifizierung des Qlik Cloud Mandanten erforderlich sind, wurden aktualisiert.

In dieser Version wird das folgende Problem behoben:

Qlik Data Gateway - Direct Access 1.3.1 ist in bestimmten Szenarios anfällig für zu hohe CPU-Auslastung. In Version 1.3.2 wird dieses Problem behoben. Die Version umfasst keine weiteren Änderungen. Um Ausfälle im Zusammenhang mit der CPU zu vermeiden, empfehlen wir allen Kunden, sofort auf Version 1.3.2 zu aktualisieren.

Diese Version enthält das Zertifizierungsstellen-Bundle für Qlik Cloud Government und behebt verschiedene Probleme.

Zertifizierungsstellen-Bundle-Datei für Qlik Cloud Government

Das Zertifizierungsstellen-Bundle authentifiziert die Identität des Qlik Cloud Mandanten und gewährleistet eine vertrauenswürdige Verbindung.

In früheren Versionen von Direct Access Gateway wurde die Zertifizierungsstellen-Bundle-Datei für Qlik Cloud Government Kunden bei Bedarf von Qlik bereitgestellt. Ab dieser Version ist die Zertifizierungsstellen-Bundle-Datei in der Installation enthalten.

In einem Standard-Setup wird die Zertifizierungsstellen-Bundle-Datei an folgendem Speicherort installiert: C:\Programmdateien\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Behobene Probleme

• Eine Sicherheitsschwachstelle wurde identifiziert, durch die der für die Proxy-Verbindung genutzte HTTP-Client einer Umleitung folgte.

• Der Direct Access Gateway-Agent stürzte manchmal mit folgendem Fehler ab:

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

• Manchmal trat eine Ausnahme während der Protokollinitialisierung auf, wodurch Direct Access Gateway beim Neustart hängen blieb.
• Die Sitzungsbehandlung beim Ladevorgang wurde verbessert, um unnötige Zeitüberschreitungen zu vermeiden.
• In der Spalte Direct Access Gateway Version in Verwaltungskonsole war die falsche Version angegeben.
• Der Agent sendete weiter Daten an das Gateway, nachdem der Benutzer die Aufgabe angehalten hatte oder die Kontingentgrenze erreicht wurde.
• End-to-End-Verschlüsselung für Data Gateway wurde standardmäßig nicht aktiviert und von Laufzeit-Flags gesteuert.

In dieser Version werden die folgenden Probleme behoben:

• Version 1.2 von Qlik Data Gateway – Direkter Zugriff kann möglicherweise aufgrund von Problemen mit der digitalen Signatur nicht installiert werden.
• Dadurch wurden während des Upgrades Konfigurationsdateien überschrieben, und Änderungen gingen verloren

Funktionen und Verbesserungen:

• Unterstützung für SAP BW- und SAP SQL-Quellen hinzugefügt. Weitere Informationen zum Einrichten der Konnektivität mit diesen Quellen finden Sie unter SAP NetWeaver (nur auf Englisch).

Behobene Probleme:

• Verbesserte Stabilität und Wiederherstellbarkeit des Qlik Data Gateway - Direct Access-Diensts mit Wegfall des manuellen Neustart des Diensts
• Unterstützung für das Überschreiben der Direct Access Gateway-Standardinstallations- und -Konfigurationsparameter

Funktionen und Verbesserungen:

• Unterstützung für Windows Server 2022 hinzugefügt

Behobene Probleme:

• Mögliches Stabilitätsproblem bei der Auswahl eines benutzerdefinierten Pfads während der Einrichtung behoben

1.1.0

18. Oktober 2022

Funktionen und Verbesserungen:

• Unterstützung für Oracle Wallets
• Unterstützung für Google BigQuery
• Verbesserte Fehlermeldungen

Behobene Probleme:

• Verbesserte Systemwiederherstellung nach Treiberabstürzen
• Der Dienst Qlik Data Gateway - Direct Access stoppte manchmal unerwartet