Aggiornamento di Qlik Data Gateway - Direct Access

Nuove funzioni e miglioramenti

Il gateway di Direct Access 1.6.5 introduce le seguenti funzionalità e miglioramenti:

• Supporto per il connettore SAP ODP

  Questa versione introduce la possibilità di accedere alla sorgente SAP ODP tramite il Gateway di Direct Access. Per facilitare questa operazione, al connettore SAP ODP è stato aggiunto il nuovo campo Gateway dati. Il nuovo campo consente ai clienti di scegliere il gateway da utilizzare per accedere alla sorgente SAP ODP.

  Vedere anche: Connettore SAP ODP (solo in lingua inglese)

• Funzioni di accesso estese

  Questa versione introduce un nuova funzionalità di accesso che il Supporto Qlik può utilizzare per risolvere i problemi con componenti del gateway specifici.

• Supporto di una nuova regione

  Il Giappone ora è supportato come regione del tenant Qlik Cloud.

• Ottimizzazione delle prestazioni

  Miglioramento delle allocazioni di memoria per le sessioni crittografate.

Problemi risolti

Il gateway di Direct Access 1.6.5 risolve i seguenti problemi:

• Vulnerabilità di sicurezza

  Quando si utilizzava il connettore ODBC, i segreti venivano scritti nel registro DCAAS.

• Prestazioni dell'isolamento del processo

  Con i carichi elevati, i processi richiedevano molto tempo per avviarsi.

• Percorso di installazione incorretto

  L'installazione di Gateway di Direct Access impostava sempre Qlik come cartella radice, anche quando l'utente sceglieva una cartella differente nell'installazione guidata.

Nuove funzioni e miglioramenti

• Supporto per la visualizzazione e il download dei file di registro da Console di gestione

  Questa versione introduce la possibilità di visualizzare i file di registro del Gateway di Direct Access in Console di gestione e condividerli con il Supporto Qlik. In circostanze normali, non vi è alcuna ragione per visualizzare i file di registro, ma nel caso in cui si verificano errori ripetuti o altri problemi, i file di registro spesso aiutano a individuare la causa.

  Vedere anche: Visualizzazione e download dei file di registro

• Supporto per l'installazione automatica del Gateway di Direct Access

  Ora i clienti possono installare il Gateway di Direct Access automaticamente, una funzionalità utile se è necessario installare il Gateway di Direct Access su più computer in tutta l'organizzazione.

  Vedere anche: Installazione automatica di Gateway di Direct Access

• Continuità migliorata delle sessioni

  Quando una sessione di ricaricamento scade, a volte può verificarsi l'errore DirectAccess-1012. Ora, il Gateway di Direct Access tenterà di mantenere attiva la sessione di ricaricamento eseguendo il ping Qlik Cloud più frequentemente.

Problemi risolti

Il gateway di Direct Access 1.6.4 risolve i seguenti problemi:

• Nome del parametro incorretto nel file configuration.properties

  Quando si effettua una nuova installazione del Gateway di Direct Access, il nome del parametro EXTEND_FIRST_REQUEST_TIMEOUT nel file configuration.properties verrebbe denominato incorrettamente FIRST_REQUEST_TIME_EXTENSION.

• Disponibilità di pod di ricaricamento

  Quando più ricaricamenti condividono lo stesso ID di ricaricamento, il numero di pod di ricaricamento in QCS raggiungerebbe il numero massimo.

Gateway di Direct Access 1.6.3 include i seguenti miglioramenti e correzioni di errori:

• Prevenzione perdita di dati

  In versioni precedenti, per impedire la perdita potenziale di dati, il gateway di Direct Access non si riconnetteva automaticamente alla sorgente dati durante il ricaricamento. A partire da questa versione, il gateway di Direct Access si riconnette automaticamente alla sorgente dati, in base alle necessità. Per impedire la perdita di dati, il riepilogo del ricaricamento completato viene verificato prima della riconnessione. Se viene rilevata una perdita di dati, il ricaricamento non viene completato.

• Timeout per le sessioni di ricaricamento

  In rari casi, la sessione di ricaricamento rimane attiva per un tempo indefinito. Per impedire tali occorrenze, questa versione introduce un timeout di tre ore per le sessioni di ricaricamento.

• Ampliamento timeout per le richieste di caricamento

  I ricaricamenti non vengono completati generando i seguenti errori:

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

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

  Per mitigare il problema, è stato aggiunto un parametro EXTEND_FIRST_REQUEST_TIMEOUT (per estendere il timeout della richiesta di caricamento) al file configuration.properties. Il valore predefinito è "0". I clienti che riscontrano spesso questi errori devono provare a impostare il timeout a 5-10 minuti.

• Supporto per messaggi di errore di connessione dettagliati

  Supporto aggiunto per la visualizzazione dei messaggi di errore dettagliati quando si utilizzano i connettori basati su ODBC tramite il gateway di Direct Access. I clienti ora possono impostare il parametro ShowErrorDetailMessage nelle impostazioni Avanzate del connettore su "true" per visualizzare l'errore completo restituito dal driver ODBC. Il messaggio di errore dettagliato verrà visualizzato nell'Editor caricamento dati.

  Nota informaticaIl messaggio di errore viene fornito nella sua interezza dalla sorgente dati utilizzata. Qlik non aggiunge alcuna informazione aggiuntiva al messaggio di errore né lo modifica in alcun modo.

• Gestione di più ricaricamenti con lo stesso ID di ricaricamento

  A partire da questa versione, l'ID della sessione del motore verrà utilizzato per distinguere più ricaricamenti con lo stesso ID di ricaricamento. Questo impedirà potenziali conflitti, che impediscono il completamento del ricaricamento generando il seguente errore:

  Connector error: data loading error (DirectAccess-4008

Gateway di Direct Access 1.6.2 risolve un problema che a volte causava l'arresto dell'agente connettore durante l'utilizzo della modalità di isolamento del processo.

Nuove funzionalità e miglioramenti

Direct Access gateway 1.6.1 introduce più funzionalità e ottimizzazioni importanti, che migliorano la stabilità e le prestazioni generali.

• Supporto per la distribuzione dei ricaricamenti su più processi del connettore

  La funzione di isolamento del processo del connettore è stato aggiunto al gateway di Direct Access. Questa è una funzionalità facoltativa, quindi è disattivata per impostazione predefinita. L'isolamento del processo consente agli amministratori con accesso diretto al sistema operativo del server del gateway di controllare il numero di processi disponibili per i ricaricamenti per tipo di connettore. I ricaricamenti della distribuzione di processi multipli del connettore aumenta il livello di isolamento riducendo il numero di ricaricamenti in esecuzione attualmente su ogni processo del connettore. Questo, a sua volta, può migliorare la stabilità generale di Gateway di Direct Access nei casi in cui il connettore generava errori.

  Vedere anche: Attenuare gli arresti del connettore durante il caricamento

• È stata aggiunta una funzionalità che consente di disabilitare la suddivisione in blocchi quando si utilizza il connettore SAP BW (tramite il gateway di Direct Access)

  Questa versione introduce il parametro di applicazione BEX_ONE_CHUNK per il connettore SAP BW (tramite il gateway di Direct Access). Quando si accede a SAP BW direttamente da Qlik Cloud (ossia non tramite il gateway di Direct Access), per ottimizzare le prestazioni, il set dei risultati viene suddiviso in blocchi nel backend SAP e viene letto come thread separati. Tuttavia, quando si accede SAP BW tramite il gateway di Direct Access, la suddivisione in blocchi del set dei risultati non presenta reali vantaggi. Al contrario, consuma una maggiore quantità di memoria condivisa in SAP, poiché richiede la creazione di una tabella temporanea aggiuntiva per la durata del trasferimento dati. È possibile (sebbene di solito non sia richiesto) avviare la suddivisione in blocchi impostando BEX_ONE_CHUNK:false nel file appsettings.json, che si trova nella cartella dei binari del connettore SAP.

• Miglioramenti alle funzionalità di diagnostica per SAP BW (tramite il gateway di Direct Access) e SAP SQL (tramite il gateway di Direct Access)

  Per i registri SAP BW (tramite il gateway di Direct Access) e SAP SQL (tramite il gateway di Direct Access) del connettore, è stato aggiunto un suffisso _port prima dell'estensione del nome del file di registro. Inoltre, è stato aggiunto un messaggio ProcessID=### ai file di registro del connettore per distinguere gli eventi dalle nuove istanze del connettore che utilizza la stessa porta di ascolto.

• Miglioramenti alla funzione di riconnessione

  La funzione di riconnessione durante il ricaricamento è stata migliorata, quindi il gateway di Direct Access non deve più connettersi al pod che ha avviato il ricaricamento, come in precedenza. Ora, anziché provare a connettersi al pod che ha avviato il ricaricamento (che spesso causava errori di ricaricamento), si connette al primo pod disponibile.

Problemi risolti

Il gateway di Direct Access 1.6.0 risolve i seguenti problemi:

• Registro del connettore ODBC tramite il gateway Direct Access:

  Quando i ricaricamenti erano eseguiti da sorgenti dati differenti, i processi da una sorgente dati venivano visualizzati in modo errato nei registri dell'altra sorgente dati.

• File mancante nella configurazione

  Il file configuration.properties non veniva copiato durante l'installazione del gateway di Direct Access.

• Errore di ricaricamento durante il ridimensionamento della risorsa Qlik Cloud

  Il ridimensionamento della risorsa Qlik Cloud a volte generava un errore DirectAccess-1006. È stata apportata un'ottimizzazione per migliorare la gestione di determinati scenari di ridimensionamento della risorsa Qlik Cloud che si presentano durante i ricaricamenti dell'applicazione eseguiti tramite il gateway di Direct Access.

• Errore di connessione a Snowflake

  La connessione a Snowflake tramite il connettore ODBC (tramite il gateway di Direct Access) generava errore.

• Errore nello script di debugging dell'applicazione in DLE

  Gli script di debug dell'applicazione nell'Editor caricamento dati (DLE) con l'opzione Limita risultati abilitata a volte generavano il seguente errore:

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

Problemi risolti:

• Connettore ODBC (tramite Direct Access gateway): questo connettore a volte si arrestava se si annullava il ricaricamento di tabelle di grande dimensioni. È stato apportato un miglioramento per impedire che questo accada.

• Connettore Microsoft SQL Server (tramite Direct Access gateway): quando si cercava di stabilire una connessione a un server SQL Server ospitato in versioni anteriori di Windows Server, la connessione poteva arrestarsi dovuto a un problema di compatibilità con TLS generando il seguente errore:

  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.

  Il driver di SQL Server è stato aggiornato per correggere il problema.

• Connettore SAP SQL (tramite Direct Access gateway): quando si cercava di visualizzare un'anteprima di una tabella, a volte veniva generato il seguente errore:

  Exception of Type System.OutOfMemoryException

• Connettore SAP SQL (tramite Direct Access gateway): quando si cercava di visualizzare un'anteprima di una tabella, a volte questa scadeva dopo pochi minuti generando il seguente errore:

  Request could not be completed.

• Connettori SAP SQL (tramite Direct Access gateway) e SAP BW (tramite Direct Access gateway): sono state aggiunte informazioni diagnostiche ai registri per aiutare a risolvere i problemi per le richieste multiple.

Nuove funzionalità e miglioramenti:

• Fornisce supporto per il nuovo connettore ODBC (tramite Direct Access gateway) (solo in lingua inglese).

• Ora la colonna Versione nella Console di gestione mostrerà la versione di Gateway di Direct Access invece della versione di RepAgent (uno dei suoi sottocomponenti).

Problemi risolti:

• L'aggiornamento di Gateway di Direct Access reimpostava le impostazioni avanzate di registrazione del connettore ODBC (come dimensioni massime e conservazione del file di registro) ai valori predefiniti.
• In rari casi, il connettore ODBC si arrestava e non poteva essere riavviato dall'agente Gateway di Direct Access.
• Quando una connessione non veniva stabilita o la query SQL non era valida, invece dell'effettiva causa dell'errore, veniva restituito un errore generico: "Lo scostamento e la lunghezza non erano compresi nell'intervallo...".
• Raramente, i ricaricamenti dell'hub non andavano a buon fine con un errore "DirectAccess-4008" per le app più grandi di 3 GB che presentavano elaborazioni o ritardi prolungati dopo la query gateway iniziale. Sono state aggiunte registrazioni aggiuntive per favorire l'identificazione di problemi correlati.

Problemi risolti:

• La modifica del valore ODBC_LOG_LEVEL nel file C:\ProgramData\Qlik\Gateway\configuration.properties non aveva alcun effetto.

• Il ricaricamento falliva con il seguente errore se la connessione del gateway Direct Access non veniva utilizzata per alcuni minuti:

  Connector error: Invalid load request (DirectAccess-1006)

  Il problema è stato risolto facendo in modo che la sessione non scada se è ancora attiva.

• Il caricamento delle tabelle con numerose colonne da MySQL e PostgreSQL a volte non veniva completato con il seguente errore:

  System.InvalidOperationException: Failed to HPACK encode the headers

• Quando gli utenti non avevamo le autorizzazioni per uno spazio gestito contenente il gateway di Direct Access, veniva visualizzato il seguente errore:

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

  Il messaggio di errore è stato migliorato con una descrizione più accurata della descrizione del problema.

• Più tentativi di ricaricamento a volte non venivano completati a causa del consumo eccessivo di memoria.

Funzionalità e miglioramenti:

Gateway di Direct Access verifica regolarmente la propria integrità. A partire da questa versione, la verifica dell'integrità avvierà il servizio Gateway di Direct Access se non risponde per cinque minuti.

Problemi risolti:

• Quando si avvia il ricaricamento con una query che restituisce i metadati immediatamente, ma restituisce i primi blocchi di dati molti minuti dopo, a volte può verificarsi il seguente errore:

  Connector error: data loading error (DirectAccess-4008)

• In alcuni scenari, Gateway di Direct Access non si riconnetteva a Qlik Cloud dopo l'interruzione di un ricaricamento.

• In situazioni rare, poteva verificarsi il seguente errore durante i ricaricamenti:

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

• Durante la connessione a SQL Server, i caratteri speciali nelle password non erano codificati correttamente, generando il seguente errore:

  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.

• Il connettore a volte si arrestava durante l'interruzione dell'attività di caricamento dall'interfaccia utente mentre la query restituiva i dati.

• In scenari rari collegati ai carichi elevati, i ricaricamenti a volte non riuscivano con il seguente errore:

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

Aggiornamento dei certificati CA necessari per l'autenticazione del tenant Qlik Cloud.

Questa versione risolve i seguenti problemi:

Qlik Data Gateway - Direct Access 1.3.1 tende a utilizzare in modo eccessivo la CPU in determinati scenari. La versione 1.3.2 risolve questo problema e include ulteriori modifiche. Per evitare gli errori correlati alla CPU, si consiglia a tutti i clienti di eseguire immediatamente l'aggiornamento alla versione 1.3.2.

Questa versione include il bundle CA per Qlik Cloud Government e risolve molti problemi.

File del bundle CA per Qlik Cloud Government

Il bundle CA autentica l'identità del tenant di Qlik Cloud, garantendo così una connessione affidabile.

Nelle versioni precedenti di Gateway di Direct Access, il file del bundle CA per i clienti Qlik Cloud Government era fornito da Qlik in base alle necessità. Da questa versione, il file del bundle CA è incluso nell'installazione.

Nelle configurazioni predefinite, il file del bundle CA è installato nella seguente posizione: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg_ca_bundle.pem

Problemi risolti

• È stata identificata una vulnerabilità di sicurezza per cui il client HTTP utilizzato per la connettività proxy può seguire un reindirizzamento.

• L'agente di Gateway di Direct Access a volte potrebbe arrestarsi con il seguente errore:

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

• a volte è possibile che si verifichi un'eccezione durante l'inizializzazione del registro, che può causare l'arresto di Gateway di Direct Access al riavvio.
• La gestione della sessione di ricaricamento è stata migliorata per evitare timeout non necessari.
• La colonna Versione di Gateway di Direct Access in Console di gestione può indicare la versione sbagliata.
• L'agente continuerà a inviare i dati al gateway una volta che l'utente ha interrotto l'attività o è stato raggiunto il numero massimo di quote.
• La crittografia end-to-end per Gateway dati potrebbe non venire abilitata per impostazione predefinita ed essere controllata da contrassegni in runtime.

Questa versione risolve i seguenti problemi:

• La versione 1.2 di Qlik Data Gateway - Accesso diretto potrebbe non essere installata a causa di un problema con la firma digitale.
• I file di configurazione verrebbero sovrascritti durante l'aggiornamento, determinando la perdita delle modifiche

Funzionalità e miglioramenti:

• Aggiunto il supporto per le origini SAP BW e SAP SQL. Per informazioni sull'impostazione della connettività a queste sorgenti, vedere SAP NetWeaver (solo in lingua inglese).

Problemi risolti:

• Miglioramento della stabilità e della recuperabilità del servizio Qlik Data Gateway - Direct Access, grazie all'eliminazione della necessità di riavviarlo manualmente
• Supporto della sovrascrittura dei parametri di installazione e configurazione predefiniti di Gateway di Direct Access

Funzionalità e miglioramenti:

• Aggiunto il supporto di Windows Server 2022

Problemi risolti:

• È stato risolto un problema potenziale di stabilità collegato alla selezione di un percorso personalizzato durante la configurazione

1.1.0

18 ottobre 2022

Funzionalità e miglioramenti:

• Supporto per Oracle Wallets
• Supporto per Google BigQuery
• Messaggi di errore migliorati

Problemi risolti:

• Miglioramento della recuperabilità del sistema dopo gli arresti anomali dei driver
• Il servizio Qlik Data Gateway - Direct Access a volte si arrestava in modo imprevisto