Mise à niveau de Qlik Data Gateway - Direct Access

Nouvelles fonctions et améliorations

Direct Access gateway 1.6.5 lance les nouvelles fonctions et améliorations suivantes :

• Prise en charge du connecteur SAP ODP

  Cette version permet d'accéder à une source SAP ODP via Direct Access gateway. Pour faciliter cela, un nouveau champ Passerelle de données a été ajouté au connecteur SAP ODP. Le nouveau champ permet aux clients de sélectionner la passerelle à utiliser pour accéder à leur source SAP ODP.

  Voir également : Connecteur SAP ODP (uniquement en anglais)

• Extension des fonctionnalités de journalisation

  Cette version lance un nouvel outil de journalisation que Support Qlik peut utiliser pour résoudre les problèmes de certains composants de passerelle.

• Prise en charge d'une nouvelle région

  Le Japon est désormais pris en charge comme région de client Qlik Cloud.

• Amélioration des performances

  Meilleures affectations de mémoire pour les sessions chiffrées.

Problèmes résolus

Direct Access gateway 1.6.5 résout les problèmes suivants :

• Vulnérabilité de sécurité

  Les clés secrètes pouvaient être écrites dans le journal DCAAS lors de l'utilisation du connecteur ODBC.

• Performances d'isolation des processus

  Les processus mettaient beaucoup de temps à démarrer en cas de charge importante.

• Chemin d'accès à l'installation erroné

  L'installation de Direct Access gateway utilisait toujours Qlik comme dossier racine, même si l'utilisateur sélectionnait un autre dossier dans l'assistant de configuration.

Nouvelles fonctions et améliorations

• Prise en charge de l'affichage et du téléchargement des fichiers journaux depuis la Console de gestion

  Cette version lance une fonctionnalité permettant d'afficher les fichiers journaux Direct Access gateway dans la Console de gestion et de les partager avec Qlik Support, si nécessaire. Dans des circonstances normales, il n'y a pas de raison d'afficher les fichiers journaux ; mais, si vous rencontrez des échecs répétés ou d'autres problèmes, les fichiers journaux permettront généralement de repérer la cause.

  Voir aussi : Affichage et téléchargement de fichiers journaux

• Prise en charge de l'installation de Direct Access gateway en mode silencieux

  Les clients peuvent désormais installer Direct Access gateway en mode silencieux, ce qui s'avère utile si vous devez installer Direct Access gateway sur plusieurs postes au sein de votre entreprise.

  Voir aussi : Installation en mode silencieux de Direct Access gateway

• Amélioration de la continuité de la session

  En cas d'expiration d'une session de chargement, il se produisait parfois une erreur DirectAccess-1012. Désormais, Direct Access gateway tentera de maintenir la session de chargement active en envoyant plus souvent une commande ping à Qlik Cloud.

Problèmes résolus

Direct Access gateway 1.6.4 résout les problèmes suivants :

• Nom de paramètre incorrect dans le fichier configuration.properties

  Lors de l'exécution d'une nouvelle installation de Direct Access gateway, le nom de paramètre EXTEND_FIRST_REQUEST_TIMEOUT du fichier configuration.properties était incorrectement appelé FIRST_REQUEST_TIME_EXTENSION.

• Disponibilité des pods de chargement

  Lorsque plusieurs chargements partageaient le même ID de chargement, le nombre de pods de chargement dans QCS atteignait le maximum.

Direct Access gateway 1.6.3 inclut les améliorations et corrections de bogue suivantes :

• Prévention de la perte de données

  Dans les précédentes versions, pour prévenir toute perte de données éventuelle, Direct Access gateway ne se reconnectait pas automatiquement à la source de données lors d'une actualisation. À partir de cette version, Direct Access gateway se reconnecte désormais automatiquement à la source de données selon les besoins. Pour prévenir la perte de données, le récapitulatif des chargements effectués est vérifié avant la reconnexion. En cas de détection de perte de données, l'actualisation échouera.

• Délai d'expiration des sessions d'actualisation

  Dans de rares cas, la session d'actualisation restait active indéfiniment. Pour éviter que cela ne se produise, cette version lance un délai d'expiration de trois heures pour les sessions d'actualisation.

• Extension du délai d'expiration des demandes de chargement

  Les actualisations échouaient parfois en affichant les erreurs suivantes :

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

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

  Pour atténuer ce problème, un paramètre EXTEND_FIRST_REQUEST_TIMEOUT (permettant l'extension du délai d'expiration de la demande de chargement) a été ajouté au fichier configuration.properties. La valeur par défaut est 0. Les clients qui rencontrent souvent ces erreurs doivent essayer de définir le délai d'expiration sur 5-10 minutes.

• Prise en charge des messages d'erreur de connexion détaillés

  Ajout de la prise en charge de l'affichage des messages détaillés en cas d'erreur de connexion lors de l'utilisation de connecteurs basés sur ODBC via Direct Access gateway. Les clients peuvent désormais définir le paramètre ShowErrorDetailMessage dans les paramètres de connecteur Avancés sur true pour voir l'erreur complète renvoyée par le pilote ODBC. Le message d'erreur détaillé apparaîtra dans l'Éditeur de chargement de données.

  Note InformationsLe message d'erreur complet est fourni par la source de données que vous utilisez. Qlik n'ajoute aucune information supplémentaire au message d'erreur ni ne l'édite en aucune façon.

• Traitement de plusieurs actualisations via le même ID d'actualisation

  À partir de cette version, l'ID de session du moteur sera utilisé pour faire la distinction entre plusieurs actualisations portant le même ID d'actualisation. Cela empêchera les éventuels conflits entraînant l'échec des actualisations affichant l'erreur suivante :

  Connector error: data loading error (DirectAccess-4008

Direct Access gateway 1.6.2 résout un problème qui entraînait parfois le plantage de l'agent de connecteur lors de l'utilisation en mode d'isolation de processus.

Nouvelles fonctions et améliorations

Direct Access gateway 1.6.1 lance plusieurs fonctionnalités et améliorations importantes, optimisant ainsi la stabilité et les performances générales.

• Prise en charge de la diffusion des chargements sur plusieurs processus de connecteur

  L'isolement des processus de connecteur a été ajoutée à Direct Access gateway. Il s'agit d'une fonctionnalité à activer, ce qui signifie que, par défaut, elle est désactivée. L'isolation de processus permet aux administrateurs disposant d'un accès direct au système d'exploitation du serveur de passerelles de contrôler le nombre de processus disponibles pour les chargements par type de connecteur. La diffusion des chargements sur plusieurs processus de connecteur augmente le niveau d'isolement en réduisant le nombre de chargements exécutés simultanément sur chaque processus de connecteur. Cette opération, à son tour, améliore la stabilité générale de Direct Access gateway en cas de plantage de certains connecteurs.

  Voir également : Atténuation des plantages de connecteur lors du chargement

• Ajout de la possibilité de désactiver la segmentation lors de l'utilisation du connecteur SAP BW (via Direct Access gateway)

  Cette version lance le paramètre d'application BEX_ONE_CHUNK pour le connecteur SAP BW (via Direct Access gateway). Lors de l'accès à SAP BW directement depuis Qlik Cloud (à savoir, pas via Direct access gateway), pour optimiser les performances, l'ensemble des résultats est divisé en segments dans le backend SAP et lu sous forme de threads distincts. En revanche, lors de l'accès à SAP BW via Direct Access gateway, la division de l'ensemble des résultats en segments ne présente pas de véritable avantage. Au contraire, cela consomme davantage de mémoire partagée dans SAP, car cela nécessite la création d'une table temp supplémentaire pour la durée du transfert de données. Il est possible (même s'il n'est généralement pas obligatoire) de démarrer la segmentation en définissant BEX_ONE_CHUNK:false dans le fichier appsettings.json qui se trouve dans le dossier de fichiers binaires du connecteur SAP.

• Améliorations apportées aux diagnostics pour les connecteurs SAP BW (via Direct Access gateway) et SAP SQL (via Direct Access gateway)

  Pour les journaux des connecteurs SAP BW (via Direct Access gateway) et SAP SQL (via Direct Access gateway), un suffixe _port était ajouté avant l'extension de nom du fichier journal et un message ProcessID=### était ajouté aux fichiers journaux du connecteur pour faire la distinction entre les événements des nouvelles instances du connecteur écoutant le même port.

• Améliorations apportées à la reconnexion

  Le mécanisme de reconnexion lors du chargement a été amélioré de sorte que Direct Access gateway n'ait plus besoin de se connecter au pod qui avait démarré le chargement (contrairement à ce qui était le cas auparavant). Désormais, au lieu de tenter de se connecter à répétition au pod qui avait démarré le chargement (ce qui entraînait souvent des échecs de chargement), le mécanisme se connectera au premier pod disponible.

Problèmes résolus

Direct Access gateway 1.6.0 résout les problèmes suivants :

• Journal du connecteur ODBC (via Direct Access gateway) :

  Lorsque des chargements étaient effectués depuis différentes sources de données, les processus d'une source de données apparaissaient par erreur dans la journalisation de l'autre source de données.

• Fichier manquant dans la configuration

  Le fichier configuration.properties n'était pas copié lors de l'installation de Direct Access gateway.

• Erreur de chargement lors de la mise à échelle des ressources Qlik Cloud

  La mise à échelle des ressources Qlik Cloud entraînait parfois une erreur DirectAccess-1006. Le traitement de certains scénarios de mise à échelle des ressources Qlik Cloud a été amélioré lors des chargements des applications via Direct Access gateway.

• Échec de connexion à Snowflake

  La connexion à Snowflake via le connecteur ODBC (via Direct Access gateway) échouait.

• Échec des scripts de débogage des applications dans DLE

  Les scripts de débogage des applications dans l'éditeur de chargement de données (Data Load Editor ou DLE) avec l'option Limit Results (Limiter les résultats) activée échouaient parfois avec l'erreur suivante :

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

Problèmes résolus :

• Connecteur ODBC (via Direct Access gateway) : le connecteur plantait parfois lors de l'annulation de chargements de tables volumineuses. Une amélioration a été apportée pour éviter cette situation.

• Connecteur Microsoft SQL Server (via Direct Access gateway) : lors d'une tentative d'établissement d'une connexion à un SQL Server hébergé sur des versions plus anciennes de Windows Server, la connexion échouait en raison d'un problème de compatibilité TLS et l'erreur suivante était renvoyée :

  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.

  Pour corriger le problème, le pilote SQL Server a été mis à jour.

• Connecteur SAP SQL (via Direct Access gateway) : lors d'une tentative d'affichage de l'aperçu d'une table, l'erreur suivante apparaissait parfois :

  Exception of Type System.OutOfMemoryException

• Connecteur SAP SQL (via Direct Access gateway) : il arrivait que le délai d'une tentative d'affichage de l'aperçu d'une table expire au bout de quelques minutes avec l'erreur suivante :

  Request could not be completed.

• Connecteurs SAP SQL (via Direct Access gateway) et SAP BW (via Direct Access gateway) : ajout d'informations de diagnostic aux journaux pour faciliter le dépannage en cas d'envoi de plusieurs requêtes simultanées.

**Nouvelles fonctions et améliorations :

• Prise en charge du nouveau connecteur ODBC (via Direct Access gateway) (uniquement en anglais).

• La colonne Version de la Console de gestion affiche désormais la version de la Direct Access gateway au lieu de la version du RepAgent (un de ses sous-composants).

Problèmes résolus :

• La mise à niveau de la Direct Access gateway réinitialisait les paramètres de journalisation avancés du connecteur ODBC (comme la rétention et la taille maximale des fichiers journaux) aux paramètres par défaut.
• Dans de rares cas, le connecteur ODBC plantait et l'agent Direct Access gateway ne parvenait pas à le redémarrer.
• En cas d'échec de connexion ou de requête SQL non valide, une erreur générique "Offset and length were out of bounds..." (Décalage et longueur hors limites) était renvoyée au lieu de la cause réelle de l'erreur.
• Dans de rares cas, les chargements du hub échouaient avec une erreur "DirectAccess-4008" pour les applications supérieures à 3 Go qui comportaient un traitement ou des délais prolongés après la requête de passerelle initiale. Une journalisation supplémentaire a été ajoutée pour faciliter l'identification de tout problème associé.

Problèmes résolus :

• La modification de la valeur ODBC_LOG_LEVEL du fichier C:\ProgramData\Qlik\Gateway\configuration.properties n'avait aucun effet.

• Si une connexion à la passerelle Accès direct active n'était pas utilisée pendant plusieurs minutes, cela entraînait un échec de chargement avec l'erreur suivante :

  Connector error: Invalid load request (DirectAccess-1006)

  Le problème a été résolu en empêchant l'expiration si la session est encore active.

• Le chargement de tables comportant de nombreuses colonnes provenant de MySQL et de PostgreSQL échouait parfois avec l'erreur suivante :

  System.InvalidOperationException: Failed to HPACK encode the headers

• Lorsque des utilisateurs n'avaient pas de privilèges sur un espace géré contenant la passerelle Accès direct, l'erreur confuse suivante apparaissait :

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

  Le message d'erreur a été amélioré, afin de mieux décrire le problème.

• Plusieurs tentatives de chargement échouaient parfois en raison d'une consommation de mémoire excessive.

Fonctions et améliorations :

Direct Access gateway vérifie régulièrement son intégrité. À partir de cette version, le contrôle d'intégrité démarrera le service Direct Access gateway s'il ne répond pas pendant 5 minutes.

Problèmes résolus :

• Lors du lancement d'un chargement avec une requête qui renvoie immédiatement des métadonnées, mais qui renvoie le premier bloc de données uniquement au bout de quelques minutes, l'erreur suivante se produisait parfois :

  Connector error: data loading error (DirectAccess-4008)

• Dans certain scénarios, Direct Access gateway ne se reconnectait pas à Qlik Cloud en cas d'interruption d'un chargement.

• Dans de rares situations, l'erreur suivante était rencontrée lors des chargements :

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

• Lors de la connexion à SQL Server, des caractères spéciaux dans des mots de passe n'étaient pas correctement chiffrés, entraînant l'erreur suivante :

  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.

• Le connecteur ODBC se bloquait parfois lors de l'abandon d'une activité de chargement depuis l'interface utilisateur alors que la requête renvoyait des données.

• Dans de rares scénarios associés à des chargements volumineux, les chargements échouaient parfois avec l'erreur suivante :

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

Mise à jour des certificats d'autorité de certification (CA) nécessaires pour l'authentification du client Qlik Cloud.

Cette version résout le problème suivant :

Dans certains scénarios, Qlik Data Gateway - Direct Access 1.3.1 a tendance à utiliser trop d'UC. La version 1.3.2 résout ce problème et ne contient aucune autre modification. Pour prévenir les défaillances liées à l'UC, nous encourageons tous les utilisateurs à effectuer immédiatement la mise à niveau à la version 1.3.2.

Cette version inclut le CA bundle pour Qlik Cloud Government et résout plusieurs problèmes.

Fichier CA bundle pour Qlik Cloud Government

Le CA bundle authentifie l'identité du client Qlik Cloud, garantissant ainsi une connexion fiable.

Dans les précédentes versions de Direct Access gateway, le fichier CA bundle pour les utilisateurs Qlik Cloud Government était fourni par Qlik, si nécessaire. À partir de cette version, le fichier CA bundle est inclus dans l'installation.

Dans une configuration par défaut, le fichier CA bundle est installé à l'emplacement suivant : C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Problèmes résolus

• Une vulnérabilité de la sécurité a été identifiée, selon laquelle le client HTTP utilisé pour une connexion proxy suivait une redirection.

• L'agent Direct Access gateway se bloquait parfois avec l'erreur suivante :

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

• Une exception se produisait parfois lors de l'initialisation de la connexion, ce qui figeait Direct Access gateway au redémarrage.
• La gestion de l'actualisation des sessions a été améliorée, pour éviter les délais d'expiration inutiles.
• La colonne Version Direct Access gateway dans Console de gestion indiquait la mauvaise version.
• L'agent continuait à envoyer des données à la passerelle après l'arrêt de la tâche par l'utilisateur ou la limite de quota atteinte.
• Le chiffrement de bout en bout de Passerelle de données n'était pas activé par défaut et était contrôlé par des indicateurs d'exécution.

Cette version résout les problèmes suivants :

• Il se peut que la version 1.2 de Passerelle de données Qlik – Accès direct ne puisse pas être installée en raison d'un problème avec sa signature numérique.
• Les fichiers de configuration étaient remplacés lors de la mise à niveau, entraînant la perte des modifications

Fonctions et améliorations :

• Ajout de la prise en charge des sources SAP BW et SAP SQL. Pour des informations sur la configuration de la connectivité à ces sources, voir SAP NetWeaver (uniquement en anglais).

Problèmes résolus :

• Meilleure stabilité et meilleure récupération du service Qlik Data Gateway - Direct Access, supprimant le besoin de le redémarrer manuellement
• Prise en charge du remplacement des paramètres d'installation et de configuration Direct Access gateway par défaut

Fonctions et améliorations :

• Ajout de la prise en charge de Windows Server 2022

Problèmes résolus :

• Résolution d'un problème de stabilité potentiel lié à la sélection d'un chemin d'accès personnalisé lors de la configuration

1.1.0

18 octobre 2022

Fonctions et améliorations :

• Prise en charge des portefeuilles Oracle Wallets
• Support de Google BigQuery
• Messages d'erreur améliorés

Problèmes résolus :

• Meilleure récupération du système après le plantage d'un pilote
• Le service Qlik Data Gateway - Direct Access s'arrête parfois de manière imprévue.