Uppgradera Qlik Data Gateway – direktåtkomst

File (via Gateway med direktåtkomst) koppling: Begränsa filsystemsåtkomst till specifika utrymmen

När du använder File (via Gateway med direktåtkomst) kopplingen kan du nu begränsa filsystem- eller nätverksenhetsåtkomst till specifika utrymmen. Att koppla varje sökväg till utrymmen inom din Qlik Cloud klientorganisation innebär att endast utrymmesmedlemmar med rollen Kan konsumera data eller högre kommer att kunna komma åt den angivna sökvägen. När inget utrymme är konfigurerat kommer de angivna sökvägarna att vara tillgängliga för alla utrymmen.

Den nya konfigurationen kan göras via det offentliga API:et, eller direkt i konfigurationsfilen på gateway-servern.

Offentligt API

File (via Gateway med direktåtkomst) koppling (endast på engelska)

Stöd för att tillämpa ändringar utan att kräva en gateway-omstart

Från och med den här versionen, när du uppdaterar de tillåtna sökvägarna/URL:erna för File (via Gateway med direktåtkomst) och REST (via Gateway med direktåtkomst) kopplingarna, behöver du inte längre starta om Gateway med direktåtkomst-tjänsten för att tillämpa ändringarna. Detta gäller även när du gör ändringar i följande ODBC (via Gateway med direktåtkomst) egenskaper:

• Tillåtna drivrutiner

• Tillåtna DSN:er

• Anpassade typmappningar

Oracle (via Gateway med direktåtkomst) koppling: Stöd för Oracle TNS Names kopplingsmetod

Den här versionen lägger till stöd för att komma åt Oracle med TNS Names.

Skapa en Oracle-koppling (endast på engelska)

Fil (via Gateway med direktåtkomst) koppling: Processisolering aktiverad som standard

Vid en ren installation av Gateway med direktåtkomst kommer processisolering nu att vara aktiverad som standard med Antal samtidiga omladdningsprocesser inställt på 10.

Processisolering

Tillåter kopplingar till localhost med REST (via Gateway med direktåtkomst) koppling

Du kan nu tillåta REST (via Gateway med direktåtkomst) koppling att ansluta till localhost. Detta underlättar användningen av lokala (till gateway-servern) REST-slutpunkter, till exempel genom att använda koppling-agent/ status slutpunkten för att fastställa det aktiva antalet belastningar på en agent.

Detta kan också konfigureras med hjälp av det publika API:et, när lokala URL:er (till exempel http://localhost:5050/status) läggs till i filen restconnector_allowed_urls.txt.

Tillåta kopplingar till localhost med hjälp av REST-kopplingen (via Gateway med direktåtkomst)

Publikt API

Stöd för att använda det publika API:et för att utföra asynkrona förfrågningar om att "ladda data"

Att utföra begäran om inläsningsdata asynkront i agenten förkortar den tid molntjänsten behöver vänta på svar från agenten signifikant.

Denna funktion, som introducerades i Gateway med direktåtkomst 1.7.5, är nu tillgänglig via det publika API:et med hjälp av parametern OPTIONAL_CAPABILITIES.

Publikt API

Förbättringar av processisolering i scenarier med hög belastning

När en gateway är under hög belastning med begränsade resurser, gjordes förbättringar för att förhindra följande problem:

• Kopplingsportkonflikter när processisolering är aktiverad

• Alltför frekventa försök att starta kopplingsprocessen

Lösta problem

Gateway med direktåtkomst 1.7.6 löser följande problem:

• Oracle (via Gateway med direktåtkomst) eller ODBC (via Gateway med direktåtkomst) kopplingar: Redundanta metadataanrop

  När Oracle (via Gateway med direktåtkomst) eller ODBC (via Gateway med direktåtkomst) kopplingar används, skulle vissa av kopplingsegenskaperna göra redundanta metadataanrop när ingen gateway valdes.

• Prestandaförsämring på grund av för lång hämtningstid för gateway-mått

  För varje omladdningsbegäran hämtas gateway-mått. Tiden det tog att hämta måtten (~200 ms) skulle påverka omladdningstiden. Problemet löstes genom att hämta måtten var 15:e sekund istället för vid varje laddningsbegäran.

• AWS Athena (via Gateway med direktåtkomst) koppling: Omladdningsfel vid försök att ladda om tabell- eller kolumnnamn med japanska tecken

  När AWS Athena (via Gateway med direktåtkomst) kopplingen används, skulle försök att ladda om tabell- eller kolumnnamn med japanska tecken orsaka följande fel:

  Unable to show the preview column data. User does not have permission to access data, or column data type is not supported.

• Google BigQuery (via Gateway med direktåtkomst) koppling: Kunde inte lägga till data med Data Manager

  När du använder Google BigQuery-koppling (via Gateway med direktåtkomst) uppstod ett felmeddelande ”Det gick inte att lägga till data” när du försökte lägga till data med Data Manager.

• Lösenordsförtydligande vid installation av Gateway med direktåtkomst under ett LocalSystem-konto

  Lösenordsfältet i Gateway med direktåtkomst-installationsprogrammet fick vissa kunder att tro att ett lösenord alltid krävdes vid installation av Gateway med direktåtkomst under ett LocalSystem-användarkonto. För att lösa problemet lades följande förtydligande text till i installationsprogrammet:

  A password is only required if you are not using the default local system account.

Loggningskontext har lagts till för förhandsgranskning av metadata

För att underlätta felsökning av fel vid inläsning har följande fält lagts till i loggarna för anrop av förhandsgranskning av metadata: requestguid, sessionid, och datasourceid.

Extra stöd för "Användardefinierade autentiseringsuppgifter" i kopplingarna MongoDB (via Gateway med direktåtkomst) och Google BigQuery (via Gateway med direktåtkomst)

Ett fält för användardefinierade referenser lades till i kopplingarna MongoDB (via Gateway med direktåtkomst) och Google BigQuery (via Gateway med direktåtkomst), vilket innebar en justering av dem till motsvarande kopplingar som inte finns på Gateway med direktåtkomst.

När Användardefinierade autentiseringsuppgifter är valt måste alla användare som vill komma åt kopplingen ange sina egna autentiseringsuppgifter innan de kan välja tabeller eller ladda data. De här inloggningsuppgifterna tillhör en användare, inte en koppling. Användardefinierade inloggningsuppgifter kan sparas och användas för flera kopplingar av samma kopplingstyp.

Stöd för AsyncCommand med begäranden om att ladda data

Genom att utföra begäran om att ladda data asynkront på agenten förkortas den tid som molntjänsten väntar på responsiva svar från agenten avsevärt.

Utföra Load Data-förfrågningar asynkront

Stöd för att ändra egenskapen AGENT_LOG_OPTIONS utan att behöva starta om tjänsten Gateway med direktåtkomst

Det är nu möjligt att justera egenskapen AGENT_LOG_OPTIONS utan att behöva starta om tjänsten Gateway med direktåtkomst. Denna egenskap ska endast ändras på begäran av Qlik Support.

Lösta problem

Gateway med direktåtkomst 1.7.5 löser följande problem:

• Fel som returneras för giltiga operationer

  Agenten för kopplingen kunde ibland returnera ett "500"-fel för giltiga laddnings- och händelseanrop.

• API för konfiguration:

  • Egenskapen "Max process count" för REST- och FILE-kopplingar uppdaterades för att täcka värden mellan 2-100

  • Ett standardvärde lades till för egenskapen AGENT_LOG_OPTIONS

  • DCaaS loggnivåvärden har uppdaterats

• Hålla levande-evenemang:

  • Hålla levande-evenemang kunde ibland inte krypteras

  • Ett felaktigt svar om att frigöra resurser i molnet kunde skickas när sessionen på agenten inte längre var aktiv

Stöd för att åsidosätta standardkontot för Windows-tjänster under installationen

I tidigare versioner av Gateway med direktåtkomst var det möjligt att ändra Windows tjänstkonto först efter installationen och endast interaktivt (på varje Gateway med direktåtkomst -maskin). Gateway med direktåtkomst 1.7.4 introducerar möjligheten att installera Gateway med direktåtkomst under ett Windows-tjänstkonto som inte är standard. Det här alternativet är tillgängligt när du använder installationsguiden och när du utför en tyst installation.

För mer information se Steg två: installera Gateway med direktåtkomst på en server bakom brandväggen som skyddar dina datakällor

Stöd för Windows Server 2025

Gateway med direktåtkomst version 1.7.0 och senare har certifierats för installation på Windows Server 2025.

Lösta problem

Gateway med direktåtkomst 1.7.4 löser följande problem:

• Säkerhetshärdning

  När du använder kopplingen Fil (via Gateway med direktåtkomst ) utförs alla filåtgärder under Windows tjänstkonto "NT AUTHORITY\SYSTEM". Problemet löstes genom att lägga till möjligheten att åsidosätta standardkontot för Windows-tjänster under installationen.

• Kopplingen Google BigQuery (via Gateway med direktåtkomst): Fel vid bearbetning av TIMESTAMP-data utanför ett specifikt intervall

  Vid bearbetning av TIMESTAMP-data utanför intervallet 1400–9999 (år), skulle följande fel uppstå:

  The data contains unsupported data type or row content. Invalid row status.

• Anpassat Windows-tjänstkonto bibehålls inte efter uppgradering

  Efter uppgraderingen ändras det angivna tjänstkontot Gateway med direktåtkomst tillbaka till det lokala standardkontot (LocalSystem).

• Läs in fel igen

  På grund av ett problem med krypteringen av keepAlive-händelser (som skickas från Qlik Cloud till gateway), kunde följande fel ibland uppstå vid inläsning:

  Internal error. (Connector error: Reload web socket was aborted due to a failure (DirectAccess-1103))

Förbättringar vid felsökning

• Maskinmätvärdena för Gateway med direktåtkomst (kärnor, diskutrymme, minne, CPU och så vidare) kommer nu att överföras till fjärrloggningen för att underlätta felsökning.
• Loggmeddelandets tidsmarkör kommer nu att vara i UTC-format för alla loggar, utom loggarna för SAP-kopplingar.
• Namnet på loggen för filkopplingen (via Gateway med direktåtkomst) innehåller nu portnumret (i stället för process-ID).
• Loggmeddelanden i filkopplingen (via Gateway med direktåtkomst) innehåller nu en kolumn för process-ID.

Förbättrad ODBC-koppling (via Gateway med direktåtkomst)

När du använder ODBC-kopplingen (via Gateway med direktåtkomst) kommer ANSI ODBC-drivrutiner (som inte stöds) nu att uteslutas från listan över ODBC-drivrutiner som visas i kopplingen.

Lösta problem

Gateway med direktåtkomst 1.7.3 löser följande problem:

• REST-koppling (via Gateway med direktåtkomst): inläsningsfel

  Inläsning av stora datastrukturer misslyckades ibland med följande fel:

  Received message exceeds the maximum configured message size.

• REST-koppling (via Gateway med direktåtkomst): alltför restriktiv lista över tillåtna URL:er

  URL:er utan ett efterföljande snedstreck blockerades felaktigt, medan samma URL:er med ett efterföljande snedstreck tilläts.

• ODBC-koppling (via Gateway med direktåtkomst): överdriven minnesanvändning

  När Multiple SELECT användes i laddningsskriptet frigjordes inte VRAM-minnet på källsystemet, utan fortsatte att växa vid varje inläsning.

• MySQL-koppling (via Gateway med direktåtkomst): problem med datatyp

  När du använde MySQL-kopplingen (via Gateway med direktåtkomst) för att läsa in en tabell med datatypen "int(9) unsigned", returnerades data för den kolumnen som -1.

• SAP SQL-koppling (via Gateway med direktåtkomst): MixedMode fungerar inte

  Egenskapen MixedMode-kopplingssträng fungerade inte som förväntat.

• Datakälla av SQL-typ: problem med laddningsskript

  Vid koppling till en datakälla av SQL-typ placerades "TableName" i laddningsskriptet felaktigt i mitten av tabelldefinitionen istället för i början av laddningsskriptet.

• Databrickskoppling (via Gateway med direktåtkomst): säkerhetshärdning

  Data som laddas via Databrickskopplingen (via Gateway med direktåtkomst) kommer nu alltid att använda SSL för kommunikation och data i transit. Det tidigare alternativet att aktivera eller inaktivera SSL har tagits bort.

• Säkerhetshärdning

  End-to-end-kryptering var inte ömsesidigt tvingande för nyttolaster för loggningskommandon som returnerade kundhysta loggar från aktivitetscentret för Qlik Cloud Administration.

Ställa in ett threshold för återupptagning av segmentåterställning

Du kan nu ange ett threshold (i minuter) för segmentets återställningstid. Om inläsningen inte har återupptagits när threshold för återhämtningstiden har nåtts, kommer den att misslyckas med ett lämpligt meddelande.

Detta alternativ är användbart för inläsningar som annars skulle kunna överskrida gränsen på tre timmar, efter en lång återhämtning. Det tar exempelvis tar 90 minuter att hämta data från databasen, men så snart inläsningen startar skadas ett av segmenten. I det här fallet lagras alla segment i cacheminnet och skickas från cacheminnet. I ett sådant scenario kan hela inläsningsprocessen (lagring i cache + faktisk inläsning) ta tre timmar att slutföra.

Se även Ställa in tröskelvärde för varaktighet för segmentåterställning

Lösta problem

Gateway med direktåtkomst 1.7.2 löser följande problem:

• Konfiguration saknas för kopplingen REST (via Gateway med direktåtkomst)

  Parametern REST_MAX_PROCESS_COUNT saknades i filen configuration.properties på Gateway med direktåtkomst 1.7.1

• Automatisk omstart av Gateway med direktåtkomst-processer fungerar inte som förväntat

  Gateway med direktåtkomst-processer startade ibland inte om automatiskt när de kraschade eller avslutades på annat sätt.

• Cache-mappar för segmentåterställning skapade på fel plats

  När inställningen OVERRIDE_CHUNKS_CACHE_DIR i filen configuration.properties var tom skapades cachemapparna för segmentåterställning i mappen [install folder] \ConnectorAgent i stället för i C:\ProgramData\Qlik\Gateway\tmp (standardmappen).

• Inläsningsfel i segementåterställningsläge

  Vid arbete i segementåterställningsläge misslyckades ibland inläsningar med ett DirectAccess-4021-fel. Problemet berodde på att EODAck anlände till agenten något efter EODAck-timeouten. Problemet löstes genom att marginellt öka EODAck-tidsgränsen.

• Problem med loggningsnivå för filkoppling (via Gateway med direktåtkomst)

  DEBUG-loggningsnivån för filkopplingen (via Gateway med direktåtkomst) ignoreras.

• Innehållet i mappen [Gateway med direktåtkomst install folder]\data\logs\reloads rensades aldrig bort

  Gamla JSON-filer rensades aldrib bort från [Gateway med direktåtkomst install folder]\data\logs\reloads Ackumuleringen av många loggar kan förbruka en betydande mängd diskutrymme över tid. Dessutom skulle det vara en utmaning att säkerhetskopiera den här mappen (som kan innehålla tusentals loggfiler).

• Säkerhetshärdning

  Denna förbättring lägger till ytterligare en nivå av kryptering för händelser och meddelanden som skickas mellan Qlik Cloud och Gateway med direktåtkomst, som innehåller känsliga data som Pod IP och Gateway ID.

Nya funktioner och förbättringar

• REST Connector

  Den nya kopplingen REST (via Direct Access gateway) ger säker åtkomst till privata REST API-slutpunkter via Gateway med direktåtkomst, så att du kan strömma data direkt till dinQlik Sense app.

  Mer information finns i REST-datakällor (endast på engelska).

  Anteckning om information

  Kopplingen REST (via Direct Access gateway) kommer att rullas ut till Qlik Cloud-regioner i fyra faser, där fas 4 planeras vara klar den 17 februari.

  • Fas 1: SE (Sverige), JP (Japan) och UK (Storbritannien)
  • Fas 2: DE (Tyskland), SG (Singapore), AP (Asien och Stillahavsområdet) och IN (Indien)

  • Fas 3: US (USA) och Qlik Cloud Government

  • Fas 4: EU (Europeiska unionen)
    

• Åsidosätta standardkatalogen för cachesegment

  För varje omladdning kan Gateway med direktåtkomst cachelagra databitar i minnet och ladda om dem till disk (när storleken som tilldelats för cachelagring överskrids). Du kan åsidosätta standardkatalogen för cachesegment (C:\ProgramData\Qlik\Gateway\tmp) om du inte har tillräckligt med diskutrymme på systemenheten.

  Mer information finns i Åsidosätta standardkatalogen för cachesegment.

• Åsidosätta standardantalet tabeller som hämtas när du arbetar med ODBC-kopplingen (via Gateway med direktåtkomst)

  Som standard hämtas 10 000 tabeller för urval, vilket kan vara otillräckligt vid arbete med mycket stora databaser. Denna version introducerar möjligheten att åsidosätta standardinställningen genom att öka egenskapen ODBC_TABLES_LIMIT_FOR_GENERICODBC i filen Gateway med direktåtkomst configuration.properties.

  Mer information finns i Maximalt antal tabeller att avlasta.

• Stöd för flera kataloger med Google BigQuery (via Gateway med direktåtkomst) Connector

  Google BigQuery (via Gateway med direktåtkomst) Connector stöder nu åtkomst till flera kataloger (motsvarande Google BigQuery-projekt) i en enda koppling.

  Mer information finns i Skapa en Google BigQuery-koppling (endast på engelska).

• Stöd för Unity-katalogen med Databricks (via Gateway med direktåtkomst) Connector

  På Databricks (via Gateway med direktåtkomst) Connector finns nu stöd för åtkomst till data i Unity Catalog på Databricks.

  Mer information hittar du under Skapa en Databricks-koppling (endast på engelska).

• Minska datafel som orsakas av ODBC-drivrutinen när du använder ODBC-kopplingen (via Gateway med direktåtkomst)

  Ibland, på grund av ett problem med leverantörens ODBC-drivrutinshantering av källdatatyper, kommer antingen ett fel att inträffa under inläsningen eller felaktiga data att laddas till Qlik Cloud. I sådana fall kan du åsidosätta Qlik Cloud-datatypen eller dess specifikation (t.ex. skala eller precision).

  Mer information finns i Åsidosätta standard för Qlik Cloud-datatypen när du arbetar med ODBC-kopplingen (via Gateway med direktåtkomst).

• Omlokalisering av logghändelser för start, avslut och omstart av koppling

  Från och med Gateway med direktåtkomst 1.7.1 skrivs start-, avslutnings- och omstartshändelser för kopplingar till loggfilen Gateway med direktåtkomst(DirectAccessAgent). I tidigare versioner skrevs de till loggfilen Loggar för kopplingsagenter (connector-agent_logs_<date>).

Lösta problem

Gateway med direktåtkomst 1.7.1 löser följande problem:

• I vissa scenarier kan inläsningsprestandan påverkas när alternativet RELOAD_CACHE_MEMORY_MB aktiveras (som cachar data för inläsning i händelse av problem).

• När alternativet RELOAD_CACHE_MEMORY_MB aktiverades kunde inläsningar ibland misslyckas med följande felmeddelande, som indikerade att åtkomst nekades eller att filen inte kunde hittas:

  (Connector error: data loading error (DirectAccess-4008) (DirectAccess-4001))

• I vissa scenarier, främst om den port som krävs av kopplingen inte var tillgänglig, fortsatte kopplingen att krascha, även när processisolering var aktiverad.

• Gateway med direktåtkomst försökte ibland återansluta till datakällan, även efter att inläsningen hade slutförts.

• Ibland uppstod felet "Could not find file" när agenten för kopplingen försökte läsa en bit från disken efter att den hade laddats till minnet.

• När du arbetade med SAP BW-kopplingen uppstod följande fel:

  Error when parsing '0TCT_C03': The given key 'CHABASNM' was not present in the dictionary.

  Problemet åtgärdades genom att lägga till stöd för äldre transporter utan metadatafältet CHABASNM.

• När filen configuration.properties innehöll kopior av poster gick det inte att starta tjänsten Gateway med direktåtkomst.

• Vid försök att ansluta till datakällan Azure SQL Database (via Direct_Access-gateway) med autentiseringsmetoden Azure Active Directory misslyckades testkopplingen med följande fel:

  Communication link failure - ERROR [08S01] [Qlik][SqlServer] Connection broken unexpectedly

• I vissa fall, när Gateway med direktåtkomst kopplades bort från Qlik Cloud, kunde det ta upp till 10 minuter att återansluta. Under denna tid kunde inga inläsningar påbörjas. Denna tid har minskats till 45 sekunder.

  Om du märker att det tar betydligt längre tid än 45 sekunder för Gateway med direktåtkomst att återansluta kan du tvinga den att återansluta enligt beskrivningen i Tvinga Gateway med direktåtkomst att återansluta till Qlik Cloud.

Nya funktioner och förbättringar

• Fil-kopplare

  Den nya kopplingen Fil (via Direct Access gateway) ger säker åtkomst till filsystem via Gateway med direktåtkomst, så att du kan strömma data direkt till din Qlik Sense-app.

  För mer information, se Fil (via Direct Access gateway) (endast på engelska).

• Förbättrad prestanda med stöd för asynkrona kommandon

  Stöd för asynkrona kommandon ökar effektiviteten genom att Gateway med direktåtkomst kan hantera flera kommandon samtidigt, i stället för ett åt gången.

   

Lösta problem

I Direct Access gateway 1.7.0 har följande problem lösts:

• Snowflake-koppling

  Att ladda data med specialtecken skulle misslyckas med ett "SQL compilation error".

• Tyst installation

  En tyst installation av Gateway med direktåtkomst startar en interaktiv prompt för att reparera nödvändig programvara.

• Prestanda Oracle-koppling (via Direct Access gateway)

  Att ladda data med Oracle-kopplingen (via Direct Access gateway) skulle vara betydligt långsammare än att använda ODBC-drivrutinen direkt.

• ODBC-koppling (via Direct Access gateway) kraschar

  ODBC-kopplingen (via Direct Access gateway) kunde ibland krascha på grund av en bugg i SQL Server Simba-drivrutinen.

• Intermittenta fel vid inläsning

  Inläsning av flera appar misslyckades periodvis med följande fel (utdrag):

  Connector Datagateway Space:SQLCLUSTER01 not found (Requested endpoint could not be provisioned due to failure to acquire a load slot: The response body of the connector load info request was empty.

Nya funktioner och förbättringar

• Processisolering är nu aktiverad som standard

  I tidigare versioner inaktiverades processisolering som standard. Från Direct Access gateway 1.6.9 kommer den att aktiveras som standard, men endast med en ren installation. Om du uppgraderar kommer din befintliga konfiguration för processisolering att bevaras (av eller på, beroende på hur den såg ut före uppgraderingen).

  Mer information om processisolering finns i avsnittet Processisolering

• Filen Removed configuration.properties

  För att förhindra att kunder av misstag ändrar fel configuration.properties-fil har mallfilen configuration.properties tagits bort från installationsmappen Gateway med direktåtkomst. Nu kommer det endast att finnas en configuration.properties-fil, som är placerad under C:\ProgramData\Qlik\Gateway.

Lösta problem

Följande problem för segmentåterställningsfunktionen har lösts i Direct Access gateway 1.6.9:

• Segment som inte raderats efter inläsning

  Bearbetade segment kunde ibland inte tas bort från disken efter en inläsning.

• Segment som inte raderats efter en krasch

  Bearbetade segment kunde ibland inte tas bort från disken efter en Gateway med direktåtkomst-krasch.

• Hög minnesanvändning

  Hög minnesanvändning kunde ibland uppstå vid inläsning av lagrade segment.

Mer information om funktionen för återställning av datasegment finns i Minne för cachade datasegment

Nya funktioner och förbättringar

• Mekanism för återställning av datasegment

  Denna version introducerar stöd för att skicka saknade eller skadade datasegment. För att styra storleken i minnet på de omladdade datapaketen har en ny egenskap har lagts till i filen configuration.properties: RELOAD_CACHE_MEMORY_MB

  Mer information om funktionen för återställning av datablock finns i Minne för cachelagrade datablock

• .NET 6.0.x krävs inte längre

  Från och med den här versionen krävs inte längre .NET 6.0.x för att köra Gateway med direktåtkomst. Innan Gateway med direktåtkomst installeras bör nya kunder installera endast .NET 4.8 (behövs för installationen) samt .NET 8.0 och ASP.NET Core Runtime (för att arbeta med Gateway med direktåtkomst).

  Se Systemförutsättningar för mer information om förutsättningar för Gateway med direktåtkomst

• Förbättrad batchdrift för beroende processer.

  Från och med den här versionen kommer beroende processer att kontrolleras parallellt istället för sekventiellt, för att på så sätt undvika undantag orsakade av ändringar i processlistan under körning.

  Mer information om processisolering finns i Processisolering

• Förbättrad felsökning

  Mer kontext (till exempel "process ID" och "commit size") lades till i loggarnas varningar om resursanvändning.

Lösta problem

I Direct Access gateway 1.6.8 har följande problem lösts:

• Vilseledande felmeddelande

  Efter en omstart av gatewayen (manuellt eller på grund av en krasch) kan det hända att förfrågningar skickas till kopplingsagenten (ConnectorAgent.exe) innan den har initialiserats. I ett sådant fall är felmeddelandet missvisande. Nu kommer felmeddelandet att indikera att gatewayen inte är kopplad.

• Misslyckade inläsningar orsakade av bortkoppling

  Bortkopplingar av Gateway med direktåtkomst efter den första inläsningen kunde ibland orsaka att efterföljande inläsning misslyckades, med följande fel:

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Command getReloadSlot error for reload

  Inläsning misslyckades på grund av nedstängning av pod

  Analysmotorn kunde ibland cacha kopplingar från tidigare sessioner och skicka en förfrågan till en pod som hade fått en förfrågan om nedstängning. Detta skulle leda till att inläsningar misslyckades med följande fel:

  Connector error: data loading error (DirectAccess-4008)

• Omladdningen fastnade efter omstart av Gateway med direktåtkomst-tjänsten

  I vissa scenarier försökte inte kopplingsagenten återansluta efter att ha kopplats bort under inläsningen, vilket resulterade i följande fel:

  Reload web socket was aborted due to a failure (DirectAccess-1103)

• Amazon Redshift-koppling: SELECT-tabellen skulle fylla i dubbla kolumner

  När tabeller fanns i ett externt schema som refererades från den databas som skapats i Datashare, visades dubbla kolumner i förhandsgranskningen för DLE/ Datahanteraren.

Nya funktioner och förbättringar

• Stöd för automatisk portallokering vid arbete med processisolering

  Tidigare var det inte möjligt att ställa in värdet för max antal samtidiga inläsningsprocesser på högre än 10 när standardportnummer och intervallinställningar användes. Från och med den här versionen kommer portar att allokeras automatiskt, vilket gör att antalet samtidiga reload-processer kan vara större än 10.

• Förbättrad paginering i metadata när du arbetar med SAP SQL-koppling (via Direct Access gateway)

  Med den här förbättringen kommer tabeller att hämtas i batcher om 10 000 för att förhindra att tidsgräns överskrids när 10 000 eller fler tabeller hämtas.

Lösta problem

I Direct Access gateway 1.6.7 har följande problem lösts:

• Utgångna omladdningar frigörs inte vid användning av processisolering

  Vid användning av processisolering skulle anslutningsprocesser inte frigöras för utgångna omladdningar.

• Amazon Redshift-sessioner fortsätter att köras trots att appen har avbrutits

  Amazon Redshift-sessioner fortsatte att köras tills frågan var klar, även om den QCS-app som kördes avbröts.

• Åtgärdade sårbarheter i säkerheten

  • Gateway med direktåtkomst-kopplingar skulle binda alla tjänster till 0.0.0.0, tillåta kopplingar från alla IP-adresser på den lokala maskinen och potentiellt exponera servern för alla möjliga nätverk.
  • Gateway med direktåtkomst skulle försöka ladda MPR.dll från en icke-befintlig, dynamiskt genererad katalog i användarens sökväg för tillfälliga filer. Eftersom MPR.dll inte finns på den förväntade platsen kan en angripare placera en skadlig DLL på den här sökvägen, som installationsprogrammet sedan kan ladda och köra.

• Omladdningen fastnade efter omstart av Gateway med direktåtkomst-tjänsten

  Vid användning av frågor utan urval och en lagrad procedur hängde sig omladdningen i flera timmar efter omstart av Gateway med direktåtkomst-tjänsten.

• Problem med förhandsgranskning och omladdning av data

  Problem med förhandsgranskning och omladdning av data kunde ibland uppstå när man använde ODBC-kopplingen (via Gateway med direktåtkomst) för att komma åt Microsoft Fabric.

• Fel vid tillägg av en ORDER BY-sats

  Att lägga till en ORDER BY-sats skulle orsaka ett fel när du använder ODBC-kopplingen (via Gateway med direktåtkomst) och SQL Anywhere 17.

Nya funktioner och förbättringar

Gateway med direktåtkomst 1.6.6 introducerar följande funktioner och förbättringar:

• Stöd för åtkomst till ServiceNow via Gateway med direktåtkomst

  I den här versionen introduceras stöd för ServiceNow (via Gateway med direktåtkomst) -koppling, vilket gör det möjligt för kunder att på ett säkert sätt komma åt brandväggsskyddade ServiceNow-datakällor via en strikt utgående, krypterad och ömsesidigt autentiserad koppling.

• Stöd för nya autentiseringsmetoder när följande Gateway med direktåtkomst-kopplingar används:

  • Azure Synapse Analytics: Azure OAuth och Azure Active Directory
  • Azure SQL Databas: Azure OAuth och Azure Active Directory
  • Snowflake: OAuth
  • Databricks: Azure OAuth
  • MongoDB: SCRAM-SHA-256 och LDAP

• Förbättrad metadataväxling vid arbete med ODBC-kopplingar

  Med den här förbättringen kommer tabeller att hämtas i batcher om 10 000 för att förhindra att tidsgräns överskrids när 10 000 eller fler tabeller hämtas.

• Krav för .NET 8.X

  Från och med den här versionen måste kunder installera både .NET 6 och .NET 8.x för att arbeta med Gateway med direktåtkomst. Vid installation eller uppgradering kommer installationsprogrammet att installera dem automatiskt om de inte redan har installerats.

• Förbättrat stöd

  Till stöd vid felsökning har ytterligare loggning har lagts till som mäter varaktigheten för Gateway med direktåtkomst-begäran.

Lösta problem

I Direct Access gateway 1.6.6 har följande problem lösts:

• Om kopplingen mellan Gateway med direktåtkomst och Qlik Cloud var inaktiv i 30 sekunder eller mer misslyckades ibland omladdningen med följande felmeddelande: Ogiltigt objektnamn '#<TempTableName>' (vilket indikerar att Gateway med direktåtkomst-temp-tabellerna inte är tillgängliga).

  För att åtgärda detta lades en ny Tidsgräns för laddningsbegäran-inställning till. Den nya parametern ställer in laddningssessionens varaktighet för ODBC-kopplingen och har ett standardvärde på 20 sekunder.

• Att avbryta en laddning ledde ibland till att en loop där en ODBC-process skapas och avslutas.
• Kopplingen mellan Gateway med direktåtkomst och Qlik Cloud Services avslutades ibland plötsligt utan uppenbar orsak.

• Gateway med direktåtkomst-kopplingens intervall mellan försök växte kontinuerligt men återställdes aldrig. Det enda sättet att återställa intervallet mellan försök vara att starta om Gateway med direktåtkomst-tjänsten.

• När felaktig syntax användes för att anropa en lagrad procedur från Oracle hängde sig laddningsåtgärden i flera timmar i stället för att avslutas omedelbart med ett informativt fel.

Nya funktioner och förbättringar

Direct Access gateway 1.6.5 introducerar följande funktioner och förbättringar.

• Stöd för kopplingen till SAP ODP

  I den här versionen introduceras möjligheten att komma åt en SAP ODC-källa via Gateway med direktåtkomst. För att underlätta detta har ett nytt Datagateway-fält lagts till i SAP ODP-koppling. Med det nya fältet kan kunder välja vilken gateway de vill använda för att komma sin SAP ODB-källa.

  Se även: SAP ODP-koppling (endast på engelska)

• Utökade loggningsfunktioner

  I den här versionen introduceras en ny logg som Qlik Support kan använda för att felsöka problem med specifika gateway-komponenter.

• Nytt stöd för region

  Japan stöds nu som region för Qlik Cloud-klientorganisationer.

• Prestandaförbättring

  Förbättrad minnestilldelning för krypterade sessioner.

Lösta problem

I Direct Access gateway 1.6.5 har följande problem lösts:

• Säkerhetssårbarhet

  Hemligheter skrevs till DCAAS-loggen vid arbete med ODBC-kopplingen.

• Processisoleringsprestanda

  Det tog lång tid för processer att starta vid tung belastning.

• Felaktig installationssökväg

  Vid installation av Gateway med direktåtkomst konfigurerades alltid Qlik som rotmapp, även om användaren valde en annan mapp i konfigurationsguiden.

Nya funktioner och förbättringar

• Stöd för att visa och hämta loggfiler från aktivitetscentret för Administration

  I den här versionen finns det möjlighet att visa Gateway med direktåtkomst-loggfiler i aktivitetscentret för Administration och vid behov dela dem med Qlik-supporten. Normalt finns det ingen anledning att visa loggfiler men om återkommande fel eller andra problem inträffar kan loggfilerna ofta hjälpa till att identifiera orsaken.

  Se även: Visa och ladda ner loggfiler

• Stöd för att installera Gateway med direktåtkomst tyst

  Nu kan kunder installera Gateway med direktåtkomst tyst, vilket är praktiskt om du behöver installera Gateway med direktåtkomst på flera maskiner i din organisation.

  Se även: Tyst installation Gateway med direktåtkomst

• Förbättrad sessionskontinuitet

  När en laddningssession löper ut inträffade ibland ett DirectAccess-1012-fel. Nu försöker Gateway med direktåtkomst att hålla laddningssessionen igång genom att pinga Qlik Cloud oftare.

Lösta problem

I Direct Access gateway 1.6.4 har följande problem lösts:

• Felaktigt parameternamn i filen configuration.properties

  Vid en ny installation av Gateway med direktåtkomst kallades parameternamnet EXTEND_FIRST_REQUEST_TIMEOUT i filen C:\ProgramData\Qlik\Gateway\configuration.properties felaktigt för FIRST_REQUEST_TIME_EXTENSION.

• Omladdningspoddars tillgänglighet

  När flera laddningar delade samma laddnings-ID uppnådde antalet laddningspoddar i QCS sitt maximum.

Gateway med direktåtkomst 1.6.3 inkluderar följande förbättringar och felrättningar:

• Förhindra dataförlust

  I föregående versioner återanslöt inte Direct Access gateway automatiskt till datakällan under en laddning för att förhindra eventuella dataförluster. Från och med den här versionen kommer Direct Access gateway nu automatiskt att återansluta till datakällan vid behov. För att förhindra dataförlust kommer sammanfattningen av den slutförda laddningen att verifieras före återanslutning. Om dataförlust upptäcks kommer laddningen att misslyckas.

• Överskriden tidsgräns för laddningssessioner

  I sällsynta scenarier skulle laddningssessionen kunna vara igång oändligt länge. För att förhindra att det inträffar införs en tidsgräns på tre timmar för laddningssessioner i den här versionen.

• Förlängd tidsgräns för laddningsbegäran

  Laddningar misslyckades ibland med följande fel:

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

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

  För att mildra detta problem har en parameter för Tidsgräns för begäran om laddning (för att förlänga tidsgränsen för laddningsbegäran) lagts till i inställningarna på Gateway med direktåtkomst.

  Kunder som ofta stöter på dessa fel bör testa att ställa in värdet till 5–10 minuter.

  Detaljerade instruktioner finns i Tidsgräns för begäran om laddning.

• Stöd för detaljerade kopplingsfelmeddelanden

  Stöd har lagt till för att visa detaljerade kopplingsfelmeddelanden vid användning av ODBC-baserade kopplingar via Direct Access gateway. Kunder kan nu ställa in ShowErrorDetailMessage -parametern i de Avancerade kopplingsinställningarna till "true" för att se det fullständiga felet som returneras av ODBC-drivenheten. Det detaljerade felmeddelandet visas i Skriptredigeraren.

  Anteckning om informationFelmeddelandet tillhandahålls i sin helhet via den datakälla du använder. Qlik lägger inte till någon ytterligare information i felmeddelandet och redigerar det inte på något sätt.

• Hantering av flera laddningar med samma laddnings-ID

  Från och med den här versionen används motorsessions-ID för att skilja mellan flera laddningar med samma laddnings-ID. På så sätt förhindras potentiella konflikter som leder till att laddningar misslyckas med följande fel:

  Connector error: data loading error (DirectAccess-4008

I Gateway med direktåtkomst 1.6.2 har ett problem åtgärdats som ibland ledde till att kopplingsagenten kraschade vid arbete i processisoleringsläget.

Nya funktioner och förbättringar

I Direct Access gateway 1.6.1 introduceras flera viktiga funktioner och förbättringar som förbättrar den övergripande stabiliteten och prestandan.

• Stöd för att fördela laddningar på flera olika kopplingsprocesser.

  Kopplingsprocessisolering har lagts till i Direct Access gateway. Den här funktionen måste väljas aktivt och är därför avstängd som standard. Med processisolering kan administratörer med direkt åtkomst till gateway-serverns operativsystem styra hur många processer som är tillgängliga för laddningar per kopplingstyp. Att fördela laddningar på flera olika kopplingsprocesser ökar graden av isolering genom att minska antalet laddningar som körs samtidigt på varje kopplingsprocess. Detta kan i sin tur förbättra den övergripande stabiliteten för Gateway med direktåtkomst i sådana fall där krascher har inträffat.

  Mer information om processisolering finns i avsnittet Processisolering

• Lade till möjligheten att inaktivera segmentering när du arbetar med SAP BW-kopplingen (via Direct Access gateway)

  I den här versionen introduceras programparametern BEX_ONE_CHUNK för SAP BW-kopplingen (via Direct Access gateway). Vid åtkomst till SAP BW direkt från Qlik Cloud (d.v.s. inte via Direct Access gateway) delas resultatuppsättningen av prestandaskäl upp i segment i SAP-backenden och läses som separata trådar. Men vid åtkomst till SAP BW via Direct gateway finns det egentligen ingen fördel med att dela upp resultatuppsättningen i segment. Tvärtom förbrukas mer av det delade minnet i SAP eftersom ytterligare en temp-tabell måste skapas under tiden som dataöverföringen pågår. Det är möjligt (men inte obligatoriskt) att börja segmentera genom att ställa in BEX_ONE_CHUNK:false i filen appsettings.json som finns i mappen med SAP-kopplingens binärfiler.

• Diagnosförbättringar för kopplingar till SAP BW (via Direct Access gateway) och SAP SQL (via Direct Access gateway)

  För SAP BW (via Direct Access gateway) och SAP SQL (via Direct Access gateway) har ett suffix _port lagts till före loggfilnamnets filtillägg och meddelandet ProcessID=### har lagts till i kopplingens loggfiler för att göra det möjligt att skilja mellan händelser från nya instanser av kopplingen som lyssnar på samma port.

• Förbättringar av återanslutning

  Återanslutningsmekanismen under laddning har förbättrats, så att Direct Access gateway inte längre behöver ansluta till den pod som startade laddningen (som det var tidigare). Nu kommer den, i stället för att försöka ansluta till den pod som startade laddningen (vilket ofta ledde till misslyckade laddningar), att ansluta till den första tillgängliga podden.

Lösta problem

I Direct Access gateway 1.6.0 har följande problem lösts:

• Logg för ODBC-koppling via Direct Access gateway

  När laddningar utfördes från olika datakällor hamnade processer från en datakälla felaktigt i loggen för en annan datakälla.

• Saknad fil i konfigurationen

  Filen configuration.properties kopierades inte under installationen av Direct Access gateway.

• Laddningsfel under resursskalning av Qlik Cloud

  Resursskalning av Qlik Cloud ledde ibland till ett DirectAccess-1006-fel. En förbättring gjordes för att förbättra hanteringen av vissa resursskalningsscenarion i Qlik Cloud som inträffar under laddning av program via Direct Access gateway.

• Fel vid anslutning till Snowflake

  Anslutning till Snowflake via ODBC-kopplingen (via Direct Access gateway) misslyckades.

• Fel vid felsökning av programskript i DLE

  Felsökning av programskript i skriptredigeraren (DLE) med alternativet Begränsa resultat aktiverat misslyckades ibland med följande fel.

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

Lösta problem:

• ODBC (via Direct Access gateway) -koppling: Kopplingen kraschade ibland vid laddning av stora tabeller. En förbättring har gjorts för att förhindra att det sker.

• Microsoft SQL Server (via Direct Access gateway) -koppling: Vid försök att upprätta en anslutning till en SQL Server som är installerad på äldre Windows Server-versioner misslyckades anslutningen på grund av ett TLS-kompatibilitetsproblem och följande fel returnerades:

  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.

  SQL Server-drivrutinen har uppdaterats för att åtgärda problemet.

• SAP SQL (via Direct Access gateway) -koppling: Vid försök att förhandsgranska en tabell inträffade ibland följande fel:

  Exception of Type System.OutOfMemoryException

• SAP SQL (via Direct Access gateway)-koppling: Vid försök att förhandsgranska en tabell överskreds ibland en tidsgräns efter några minuter med följande fel:

  Request could not be completed.

• SAP SQL (via Direct Access gateway) - och SAP BW (via Direct Access gateway) -kopplingar: Lade till diagnostisk information i loggarna som stöd vid felsökning av flera samtidiga förfrågningar.

Nya funktioner och förbättringar:

• Har stöd för nya ODBC-kopplingen (via Direct Access gateway) (endast på engelska).

• Kolumnen Version i aktivitetscentret för Administration visar nu Gateway med direktåtkomst-versionen i stället för RepAgent-versionen (en av dess underkomponenter).

Lösta problem:

• Att uppgradera Gateway med direktåtkomst återställde avancerade loggningsinställningar för ODBC-kopplingen (som loggfilens kvarhållning och största storlek) till standardvärden.
• I sällsynta fall kunde ODBC-kopplingen krascha och kunde inte startas om av Gateway med direktåtkomst-agenten.
• När en koppling inte fungerade eller om SQL-frågan inte var giltig kunde ett generiskt fel, "Förskjutning och längd överskred gränserna …", returneras i stället för den faktiska felorsaken.
• I sällsynta scenarier kunde hubbladdningar misslyckas med felet "DirectAccess-4008" för appar över 3 GB som hade förlängda fördröjningar eller bearbetningar efter den ursprungliga gateway-frågan. Ytterligare loggning har lagts till som hjälp för att identifiera eventuella relaterade problem.

Lösta problem:

• Ändra värdet ODBC_LOG_LEVEL i filen C:\ProgramData\Qlik\Gateway\configuration.properties skulle inte ha någon effekt.

• Inläsning kommer att misslyckas med följande fel om en aktiv Direct Access-gatewaykoppling inte har använts på flera minuter:

  Connector error: Invalid load request (DirectAccess-1006)

  Problemet löstes genom att inte "timing out" om sessionen fortfarande är i gång.

• Läsa in tabeller med många kolumner från MySQL och PostgreSQL kan misslyckas ibland med följande fel:

  System.InvalidOperationException: Failed to HPACK encode the headers

• När användare inte har privilegier för ett hanterat utrymme som innehåller Direct Access-gatewayen visas följande fel:

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

  Felmeddelandet har förbättrats med en mer noggrann beskrivning av problemet.

• Flera inläsningsförsök kan ibland misslyckas på grund av alltför stor minnesförbrukning.

Funktioner och förbättringar:

Gateway med direktåtkomst kontrollerar hälsan regelbundet. Från och med den här versionen kommer hälsokontrollen att starta om Gateway med direktåtkomst-tjänsten om den inte svarar på fem minuter.

Lösta problem:

• När du inleder en laddning med en fråga som returnerar metadata omedelbart men det första dataelementet först flera minuter senare kan följande fel ibland inträffa:

  Connector error: data loading error (DirectAccess-4008)

• i vissa scenarion återanslöt inte Gateway med direktåtkomst till Qlik Cloud när en laddning avbröts.

• I sällsynta fall inträffade följande fall under laddningar:

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

• Vid anslutning till en SQL-server avkodades inte specialtecken korrekt, vilket ledde till följande fel:

  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.

• ODBC-kopplingen kraschade ibland när laddningsaktivitet från användargränssnittet avbröts samtidigt som frågan returnerade data.

• I sällsynta fall i samband med tunga laddningar misslyckas laddningar i bland med följande fel:

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

Uppdaterade de CA-certifikat som behövs för att autentisera Qlik Cloud-klientorganisationen.

I den här versionen har följande problem lösts:

Qlik Data Gateway – direktåtkomst 1.3.1 kan komma att ha ovanligt hög CPU-användning i vissa scenarier. Version 1.3.2 löser detta problem och innehåller inga andra ändringar. För att förhindra CPU-relaterade fel uppmuntrar vi alla kunder att omedelbart uppgradera till version 1.3.2.

Denna version innehåller CA-paketfilen för Qlik Cloud Government och åtgärdar flera problem.

CA-paketfil för Qlik Cloud Government

CA-paketfilen autentiserar identiteten för klientorganisationen Qlik Cloud vilket säkerställer en betrodd koppling.

I tidigare versioner av Gateway med direktåtkomst tillhandahölls CA-paketfilen för Qlik Cloud Government-kunder av Qlik vid behov. Från denna version inkluderas CA-paketfilen i installationen.

I en standardinstallation installeras CA-buntfilen på följande plats: C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Lösta problem

• En säkerhetsrisk identifierades där den HTTP-klient som användes för proxykoppling skulle följa en omdirigering.

• Gateway med direktåtkomst-agenten kraschade ibland med följande fel:

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

• Ett undantag inträffade ibland under initiering av loggning, vilket ledde till att Gateway med direktåtkomst hängde sig.
• Hantering av laddningssessioner har förbättrats så att onödiga timeouts undviks.
• Versions-kolumnen för Gateway med direktåtkomst i aktivitetscentret för Administration angav fel version.
• Agenten fortsatte skicka data till gateway efter användaren stoppat uppgiften eller kvotgränsen var nådd.
• Kryptering från början till slut för Data Gateway aktiverades inte som standard och styrdes av körningsflaggor.

I den här versionen har följande problem lösts:

• Version 1.2 av Qlik Data Gateway - direkt åtkomst kan förhindras från att installeras på grund av ett problem med dess digitala signatur.
• Konfigurationsfiler skrevs över under uppgradering, vilket ledde till att ändringar förlorades

Funktioner och förbättringar:

• Lagt till stöd för SAP BW- och SAP SQL-källor. Information om att ställa in kopplingar till dessa källor finns i SAP NetWeaver (endast på engelska).

Lösta problem:

• Förbättrad stabilitet och återställningsbarhet för Qlik Data Gateway – direktåtkomst-tjänsten vilket eliminerar behovet att starta om tjänsten manuellt
• Stöd för att skriva över standardinstallationen och standardkonfigurationsparametrarna för Gateway med direktåtkomst

Funktioner och förbättringar:

• Stöd för Windows Server 2022 tillagt

Lösta problem:

• Löste ett potentiellt stabilitetsproblem angående val av en anpassad sökväg under konfigurering

1.1.0

18 oktober 2022

Funktioner och förbättringar:

• Support för Oracle Wallets
• Stöd för Google BigQuery
• Förbättrade felmeddelanden

Lösta problem:

• Förbättrad systemåterhämtning efter drivrutinkraschar
• Qlik Data Gateway – direktåtkomst-tjänsten stannade oväntat ibland