Upgrade uitvoeren Qlik Gegevensgateway - Directe toegang

Nieuwe functies en verbeteringen

Direct Access gateway 1.6.5 introduceert de volgende functies en verbeteringen:

• Ondersteuning voor de SAP ODP-connector

  Deze versie introduceert de mogelijkheid om via Gateway voor directe toegang toegang te krijgen tot een SAP ODP-bron. Om dit mogelijk te maken is er een nieuw veld Gegevensgateway toegevoegd aan de SAP ODP-connector. Het nieuwe veld stelt klanten in staat om de gewenste gateway te kiezen om toegang te krijgen tot hun SAP ODP-bron.

  Zie ook: SAP ODP-connector (alleen in het Engels)

• Uitgebreide mogelijkheden voor logboekregistratie

  Deze versie introduceert een nieuwe logboekregistratie die Qlik Support kan gebruiken om problemen met specifieke gatewaycomponenten op te lossen.

• Nieuw ondersteunde regio

  Japan wordt nu ondersteund als een tenantregio voor Qlik Cloud.

• Prestatieverbeteringen

  Verbeterde geheugentoewijzing voor versleutelde sessies.

Opgeloste problemen

Direct Access gateway 1.6.5 verhelpt de volgende problemen:

• Beveiligingsprobleem

  Geheimen werden geschreven naar het DCAAS-logboek tijdens het werken met de ODBC-connector.

• Prestaties procesisolatie

  Bij een zware belasting duurde het lang voordat processen werden gestart.

• Onjuist installatiepad

  Bij het installeren van Gateway voor directe toegang werd Qlik altijd als de hoofdmap ingesteld, zelfs als de gebruiker een andere map koos in de installatiewizard.

Nieuwe functies en verbeteringen

• Ondersteuning voor het tonen en downloaden van logbestanden uit de Beheerconsole

  Deze versie introduceert de mogelijkheid om logboekbestanden Gateway voor directe toegang te bekijken in de Beheerconsole en ze indien nodig te delen met Qlik. Onder normale omstandigheden is er geen reden om de logbestanden te bekijken, maar als u herhaaldelijk fouten of andere problemen hebt, kunnen de logbestanden vaak aangeven wat de oorzaak is.

  Zie ook: Logbestanden weergeven en downloaden

• Ondersteuning voor het stilzwijgend installeren van Gateway voor directe toegang

  Klanten kunnen nu stilzwijgend Gateway voor directe toegang installeren, wat handig is als u Gateway voor directe toegang op verschillende machines binnen uw organisatie moet installeren.

  Zie ook: Gateway voor directe toegang stilzwijgend installeren

• Verbeterde continuïteit van sessies

  Als een laadsessie is verlopen, trad er soms een DirectAccess-1012 fout op. Nu probeert Gateway voor directe toegang de laadsessies actief te houden door Qlik Cloud vaker te pingen.

Opgeloste problemen

Direct Access gateway 1.6.4 verhelpt de volgende problemen:

• Onjuiste parameternaam in het bestand configuration.properties

  Bij het uitvoeren van een nieuwe installatie van Gateway voor directe toegang werd de parameternaam EXTEND_FIRST_REQUEST_TIMEOUT in het bestand configuration.properties gewijzigd in FIRST_REQUEST_TIME_EXTENSION.

• Beschikbaarheid van laadpod

  Als meerdere ladingen dezelfde laad-ID delen, wordt het maximumaantal laadpods in QCS bereikt.

Gateway voor directe toegang 1.6.3 bevat de volgende verbeteringen en opgeloste problemen:

• Gegevensverlies voorkomen

  In vorige versies maakte de Direct Access gateway niet automatisch verbinding met de gegevensbron tijdens een lading om mogelijk gegevensverlies te voorkomen. Vanaf deze versie maakt de Direct Access gateway wel automatisch verbinding met de gegevensbron zoals vereist. Het volledige laadoverzicht wordt geverifieerd voordat er opnieuw verbinding wordt gemaakt om gegevensverlies te voorkomen. Als er gegevensverlies wordt gedetecteerd, zal de lading mislukken.

• Time-out voor laadsessies

  In zeldzame gevallen zal de laadsessie voor onbepaalde tijd actief blijven. Om dit te voorkomen, introduceert deze versie een time-out van drie uur voor laadsessies.

• Verlenging van time-out voor laadaanvragen

  Ladingen mislukten soms vanwege de volgende fouten:

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

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

  Om dit probleem tot een minimum te beperken, is de parameter EXTEND_FIRST_REQUEST_TIMEOUT (voor het verlengen van de time-out van de laadaanvraag) toegevoegd aan het bestand configuration.properties. De standaardwaarde is '0'. Klanten die regelmatig last hebben van deze fouten moeten proberen om de time-out in te stellen op 5-10 minuten.

• Ondersteuning voor gedetailleerde berichten over verbindingsfouten

  Er is ondersteuning toegevoegd voor het bekijken van gedetailleerde berichten over verbindingsfouten bij het gebruik van op ODBC gebaseerde connectoren via Direct Access gateway. Klanten kunnen nu de parameter ShowErrorDetailMessage in de geavanceerde connectorinstellingen instellen op 'true' om de volledige fout te zien die de ODBC-driver terugstuurt. Het gedetailleerde foutbericht wordt getoond in de Editor voor laden van gegevens.

  InformatieHet foutbericht wordt volledig getoond door de gegevensbron die u gebruikt. Qlik voegt geen aanvullende informatie toe aan het foutbericht en bewerkt het foutbericht niet.

• Verwerking van meerdere ladingen met dezelfde lading-id

  Vanaf deze versie wordt de engine-sessie-id gebruikt om onderscheid te maken tussen meerdere ladingen met dezelfde lading-id. Dit voorkomt mogelijke conflicten en leidt tot ladingen die mislukken met de volgende fout:

  Connector error: data loading error (DirectAccess-4008

Gateway voor directe toegang 1.6.2 lost een probleem op dat er soms voor zorgt dat de connector-agent vastloopt in de procesisolatiemodus.

Nieuwe functies en verbeteringen

Direct Access gateway 1.6.1 introduceert verschillende belangrijke functies en verbeteringen, waardoor de stabiliteit en de prestaties verbeteren.

• Ondersteuning voor het spreiden van ladingen over meerdere connectorprocessen

  De mogelijkheid om connectorprocessen te isoleren is toegevoegd aan Direct Access gateway. Dit is een opt-infunctie, wat betekent dat deze functie standaard is uitgeschakeld. Procesisolatie stelt beheerders met directe toegang tot het besturingssysteem van de gatewayserver in staat om te beheren hoeveel processen beschikbaar zijn per connectortype voor ladingen. Het spreiden van ladingen over meerdere connectorprocessen verhoogt het isolatieniveau doordat het aantal ladingen wordt verminderd dat gelijktijdig in elk connectorproces wordt uitgevoerd. Dit kan op zijn beurt de algemene stabiliteit van Gateway voor directe toegang verbeteren in gevallen waarbij connectoruitval heeft plaatsgevonden.

  Zie ook: Connectoruitval tijdens ladingen beperken

• De mogelijkheid is toegevoegd om chunking uit te schakelen bij het werken met de SAP BW-connector (via Direct Access gateway)

  Deze versie introduceert de applicatieparameter BEX_ONE_CHUNK voor de SAP BW-connector (via Direct Access gateway). Als u SAP BW direct vanuit Qlik Cloud opent (d.w.z. niet via Direct access gateway), wordt de set resultaten onderverdeeld in chunks in de SAP back-end en als afzonderlijke threads gelezen om de prestaties te optimaliseren. Als u echter SAP BW via Direct Access gateway opent, heeft het weinig nut om de set resultaten in chunks te verdelen. Integendeel, het verbruikt meer van het gedeelde geheugen in SAP omdat een aanvullende tijdelijke tabel moet worden gemaakt voor de duur van de gegevensoverdracht. Het is mogelijk (maar meestal niet vereist) om het chunking te starten door BEX_ONE_CHUNK:false in te stellen in het bestandappsettings.json, dat zich bevindt in de binaire map van de SAP-connector.

• Diagnostische verbeteringen voor SAP BW-connectors (via Direct Access gateway) en SAP SQL-connectors (via Direct Access gateway)

  Voor logboeken van de SAP BW-connector (via Direct Access gateway) en SAP SQL-connector (via Direct Access gateway) is het suffix _port toegevoegd voorafgaand aan de extensie van de bestandsnaam van het logboek en een ProcessID=### bericht is toegevoegd aan de logboekbestanden van de connector om onderscheid te maken tussen gebeurtenissen van nieuwe vermeldingen van de connector die naar dezelfde poort luisteren.

• Verbeteringen voor het herstellen van een verbinding

  Het herstelmechanisme tijdens ladingen is verbeterd zodat Direct Access gateway niet langer verbinding hoeft te maken met de pod die de lading heeft gestart (zoals eerder het geval was). In plaats van dat voortdurend wordt geprobeerd om verbinding te maken met de pod die de lading heeft gestart (wat vaak resulteert in mislukte ladingen), wordt verbinding gemaakt met de eerst beschikbare pod.

Opgeloste problemen

Direct Access gateway 1.6.0 verhelpt de volgende problemen:

• Connectorlogboek voor ODBC via Direct Access gateway:

  Als ladingen van verschillende gegevensbronnen werden uitgevoerd, werden processen van een gegevensbron ten onrechte opgenomen in de logboeken van een andere gegevensbron.

• Ontbrekend bestand in de setup

  Het bestand configuration.properties werd niet gekopieerd tijdens de installatie van Direct Access gateway.

• Laadfout tijdens het schalen van een Qlik Cloud-resource

  Bij het schalen van een Qlik Cloud-resource ontstond soms een DirectAccess-1006-fout. Er is een verbetering doorgevoerd om de verwerking van bepaalde schaalscenario's van Qlik Cloud-resources te verbeteren die optreden tijden applicatieladingen die via Direct Access gateway worden uitgevoerd.

• Verbindingsfout Snowflake

  Er kon geen verbinding worden gemaakt met Snowflake via de ODBC-connector (via Direct Access gateway).

• Fout bij foutopsporing van applicatiescripts in DLE

  De foutopsporing van applicatiescripts in de Editor voor laden van gegevens (DLE) met de optie Resultaten beperken mislukte soms en gaf daarbij de volgende fout:

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

Opgeloste problemen:

• ODBC-connector (via Direct Access gateway): De connector crasht soms als ladingen of grote tabellen worden geannuleerd. Er is een verbetering aangebracht die helpt om dit te voorkomen.

• Microsoft SQL Server-connector (via Direct Access gateway): Bij het maken van een verbinding met een SQL Server die is gehost op oudere versies van Windows Server lukt het niet om verbinding te maken vanwege een compatibiliteitsprobleem met TLS en wordt de volgende fout weergegeven:

  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.

  Het stuurprogramma van SQL Server is bijgewerkt om het probleem op te lossen.

• SAP SQL-connector (via Direct Access gateway): Bij het tonen van een voorbeeld van een tabel, wordt soms de volgende fout getoond:

  Exception of Type System.OutOfMemoryException

• SAP SQL-connector (via Direct Access gateway): Er ontstaat bij het voorbeeld van een tabel soms na enkele minuten een time-out met de volgende fout:

  Request could not be completed.

• SAP SQL-connectors (via Direct Access gateway) en SAP BW-connectors (via Direct Access gateway): Er zijn diagnostische gegevens toegevoegd aan de logboeken om te helpen bij het oplossen van problemen bij meedere gelijktijdige aanvragen.

Nieuwe functies en verbeteringen:

• Biedt ondersteuning voor de nieuwe ODBC (via Direct Access gateway) (alleen in het Engels) connector.

• De kolom Versie in Beheerconsole toont nu de Gateway voor directe toegang versie in plaats van de RepAgent (een van de subcomponenten) versie.

Opgeloste problemen:

• Als u Gateway voor directe toegang bijwerkt, worden de geavanceerde logboekinstellingen van de ODBC-connector teruggezet (zoals het bewaren van logboekbestanden en de maximumgrootte) naar de standaardinstellingen.
• In enkele gevallen zal de ODBC-connector crashen en kan vervolgens niet meer door de Gateway voor directe toegang-agent opnieuw worden opgestart.
• Als verbinding maken niet lukt of de SQL-query niet geldig is, wordt de algemene fout 'Marge en lengte vallen buiten de grenzen...' getoond in plaats van de werkelijke oorzaak van de fout.
• In uitzonderlijke gevallen zal het opnieuw laden van de hub mislukken met een 'DirectAccess-4008'-fout voor apps die groter zijn dan 3 GB met uitgebreide vertragingen of die zijn verwerkt na de eerste query van de gateway. Er is aanvullende logboekregistratie toegevoegd om gerelateerde problemen te identificeren.

Opgeloste problemen:

• De ODBC_LOG_LEVEL-waarde wijzigen in het bestand C:\ProgramData\Qlik\Gateway\configuration.properties heeft geen effect.

• Opnieuw laden resulteert in de volgende foutmelding als een actieve gegevensgateway voor directe toegang een aantal minuten lang niet wordt gebruikt:

  Connector error: Invalid load request (DirectAccess-1006)

  Het probleem is opgelost door geen time-out toe te passen als de sessie nog actief is.

• Tabellen met meerdere kolommen uit MySQL en PostgreSQL laden resulteert soms in de volgende foutmelding:

  System.InvalidOperationException: Failed to HPACK encode the headers

• Wanneer gebruikers geen machtigingen hebben voor een beheerde ruimte met de gateway voor directe toegang, wordt de volgende, onduidelijke foutmelding weergegeven:

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

  De foutmelding is verbeterd met een nauwkeurigere beschrijving van het probleem.

• Soms mislukken meerdere laadpogingen vanwege overmatig geheugengebruik.

Functies en verbeteringen:

Gateway voor directe toegang controleert de status periodiek. Vanaf deze versie start de statuscontrole de Gateway voor directe toegang-service opnieuw als deze gedurende vijf minuten niet reageert.

Opgeloste problemen:

• Wanneer u laden opnieuw start met een query die direct metagegevens retourneert, maar een paar minuten later alleen maar de eerste batch gegevens retourneert, kan de volgende foutmelding optreden:

  Connector error: data loading error (DirectAccess-4008)

• In bepaalde gevallen maakt Gateway voor directe toegang niet opnieuw verbinding met Qlik Cloud wanneer opnieuw laden is onderbroken.

• In zeldzame gevallen kan de volgende foutmelding optreden wanneer er opnieuw wordt geladen:

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

• Wanneer er verbinding wordt gemaakt met een SQL-server, kunnen speciale tekens in wachtwoorden niet correct worden gecodeerd wat resulteert in de volgende fout:

  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.

• De ODBC-connector loopt soms vast wanneer laadactiviteit vanuit de gebruikersinterface wordt afgebroken terwijl de query bezig was met het retourneren van gegevens.

• In zeldzame gevallen die te maken hebben met zware ladingen, kan het voorkomen dat opnieuw laden mislukt met de volgende fout:

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

De CA-certificaten voor authenticatie van de Qlik Cloud-tenant zijn bijgewerkt.

Deze versie biedt oplossingen voor het volgende probleem:

Qlik Gegevensgateway - Directe toegang 1.3.1 is gevoelig voor overmatig CPU-gebruik in bepaalde scenario's. Versie 1.3.2 lost dit probleem op en bevat geen andere wijzigingen. Om CPU-gerelateerde defecten te voorkomen, moedigen we alle klanten aan direct te upgraden naar versie 1.3.2.

Deze versie bevat de CA-bundel voor Qlik Cloud Government en verhelpt enkele problemen.

Bestand van CA-bundel voor Qlik Cloud Government

De CA-bundel verifieert de identiteit van de Qlik Cloud-tenant, om te zorgen voor een betrouwbare verbinding.

In eerdere versies van Gateway voor directe toegang werd het bestand van de CA-bundel voor Qlik Cloud Government-klanten indien nodig door Qlik ter beschikking gesteld. Vanaf deze versie maakt het bestand van de CA-bundel onderdeel uit van de installatie.

Bij een standaardinstallatie wordt het bestand van de CA-bundel op de volgende locatie geïnstalleerd: C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Opgeloste problemen

• Er is een beveiligingsprobleem gedetecteerd waarbij de HTTP-client die is gebruikt voor de proxyverbinding gebruikmaakt van een omleiding.

• De Gateway voor directe toegang-agent loopt soms vast met de volgende foutmelding:

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

• Er treedt soms een uitzondering op tijdens initialiseren van het vastleggen van gebeurtenissen waardoor Gateway voor directe toegang bij opnieuw starten, vastloopt.
• De afhandeling van de herlaadsessie is verbeterd om onnodige time-outs te voorkomen.
• De kolom Gateway voor directe toegang Versie in Beheerconsole geeft de verkeerde versie aan.
• De agent blijft gegevens verzenden naar de gateway nadat de gebruiker de taak heeft gestopt of als het quotumlimiet is bereikt.
• End-to-endversleuteling voor de gegevensgateway wordt niet standaard ingeschakeld en wordt aangestuurd door runtimevlaggen.

Deze versie biedt oplossingen voor de volgende problemen:

• Versie 1.2 van Qlik Gegevensgateway – Directe toegang wordt mogelijk niet geïnstalleerd vanwege een probleem met de digitale handtekening.
• Configuratiebestanden zouden tijdens de upgrade worden overschreven, waardoor wijzigingen verloren gaan

Functies en verbeteringen:

• Ondersteuning voor SAP BW- en SAP SQL-bronnen toegevoegd. Meer informatie over het instellen van connectiviteit met deze bronnen vindt u in SAP NetWeaver (alleen in het Engels).

Opgeloste problemen:

• Verbeterde stabiliteit en herstelbaarheid van de Qlik Gegevensgateway - Directe toegang-service, waardoor het niet meer nodig is om de service handmatig opnieuw te starten
• Ondersteuning voor het overschrijven van de standaard installatie- en configuratieparameters van Gateway voor directe toegang

Functies en verbeteringen:

• Ondersteuning toegevoegd voor Windows Server 2022

Opgeloste problemen:

• Mogelijk stabiliteitsprobleem opgelost inzake het tijdens instellen kiezen van een aangepast pad

1.1.0

18 oktober 2022

Functies en verbeteringen:

• Ondersteuning voor Oracle Wallets
• Ondersteuning voor Google BigQuery
• Verbeterde foutmeldingen

Opgeloste problemen:

• Verbeterde herstelbaarheid van het systeem na het crashen van de driver
• De Qlik Gegevensgateway - Directe toegang-service stopte soms onverwacht