Gestion de Passerelle de données Qlik - Accès direct dans Administration
Dernière mise à jour : 2026-11-18Cette section explique comment gérer Direct Access gateway dans Administration.
Édition des propriétés des données des passerelles de données
-
Dans Administration, accédez à Passerelles de données.
-
Cliquez sur le bouton
à la fin de la ligne et sélectionnez Modifier.
La boîte de dialogue Modifier la passerelle de données s'ouvre.
-
Mettez les propriétés à jour, selon les besoins, puis cliquez sur Enregistrer.
Activation et désactivation des passerelles de données
-
Dans Administration, accédez à Passerelles de données.
-
Procédez de l'une des manières suivantes :
- Cochez la case au début de la ligne et cliquez sur le bouton de barre d'outils Activer ou Désactiver.
- Cliquez sur le bouton
à la fin de la ligne et sélectionnez Activer ou Désactiver.
-
Confirmez l'action.
Suppression de passerelles de données
-
Dans Administration, accédez à Passerelles de données.
-
Procédez de l'une des manières suivantes :
- Cochez la case au début de la ligne et cliquez sur le bouton de barre d'outils Supprimer.
- Cliquez sur le bouton
à la fin de la ligne et sélectionnez Supprimer.
-
Confirmez la suppression.
Configuration de l'équilibrage de charge avec des pools de passerelles
Un pool de passerelles est un groupe de passerelles Direct Access que vous pouvez attribuer à une connexion de données. Lorsqu'une opération de rechargement ou de métadonnées s'exécute via cette connexion, Qlik Cloud sélectionne automatiquement une passerelle du pool, en fonction de sa disponibilité et de sa charge actuelle.
Utilisez un pool de passerelles pour :
-
Répartir la charge : répartir les rechargements sur plusieurs passerelles afin qu'aucune passerelle ne devienne un goulot d'étranglement.
-
Améliorer la disponibilité : si une passerelle est indisponible, les opérations sont réacheminées vers une autre passerelle du pool.
-
Extension horizontale : ajoutez de la capacité en ajoutant des passerelles au pool, sans modifier les connexions de données qui l'utilisent.
Les pools de passerelles sont configurés dans le centre d'activités Administration. Lorsque vous créez une connexion de données à la passerelle, vous configurez la connexion pour une seule passerelle ou utilisez le pool de passerelles.
Comment une passerelle est sélectionnée
Lorsqu'une connexion de données utilise un pool, Qlik Cloud sélectionne une passerelle pour chaque opération en deux étapes :
-
Disponibilité : Les passerelles hors ligne ou injoignables sont exclues.
-
Charge : Parmi les passerelles restantes, celle ayant la charge la plus faible est choisie. La charge est déterminée par :
-
Utilisation du processeur
-
Utilisation de la mémoire
-
Nombre de rechargements simultanés
-
La sélection s'effectue par opération. Deux rechargements qui utilisent la même connexion de données peuvent s'exécuter sur des passerelles différentes.
Limitations et exigences
-
Toutes les passerelles d'un pool doivent avoir la même configuration. Cela inclut :
-
Connecteurs pris en charge.
-
URLs autorisées pour le connecteur REST.
-
Chemin d'accès autorisé pour le connecteur File.
-
DSN, pilotes et mappage des types de données autorisés pour le connecteur ODBC générique.
-
-
Toutes les passerelles d'un pool doivent être définies avec le même espace de passerelles afin d'éviter tout problème d'autorisations.
-
Toutes les passerelles du pool doivent pouvoir accéder aux mêmes sources de données. Il s'agit par exemple de l'accès au réseau et au pare-feu, des pilotes, ainsi que des identifiants ou certificats.
-
Une non-correspondance peut entraîner l'échec des rechargements selon la passerelle sélectionnée.
Création de pools et leur application aux passerelles
Vous créez et appliquez des pools lors de la création ou de la modification d'un Direct Access gateway.
-
Créer un nouveau Direct Access gateway, ou en modifier un existant.
-
Dans le champ Pool, sélectionnez un nom de pool de passerelles existant ou saisissez-en un nouveau pour créer un pool incluant cette passerelle.
-
Après avoir créé et appliqué le pool, configurez votre connexion de données pour sélectionner le pool ou la passerelle.
Définition des notifications pour Direct Access gateway
Notifications pour une Direct Access gateway spécifique
Vous pouvez définir des notifications pour être informé des modifications de fonctionnement de votre passerelle de données. Vous pouvez recevoir une notification dans votre navigateur, par e-mail ou via un message push dans l'application mobile Qlik Analytics.
-
Sélectionnez Administration dans le menu du lanceur (
), puis Passerelles de données.
-
Cliquez sur l'icône
d'une passerelle de données et sélectionnez Notifications.
-
Sélectionnez les événements dont vous souhaitez être informé.
Les notifications sont disponibles pour les événements suivants :
-
L'état de la passerelle de données a changé.
-
La version de la passerelle de données doit être mise à jour.
Note InformationsCette notification sera envoyée uniquement dans le rare cas où Qlik force la désactivation de la passerelle (généralement dû à un problème critique).
-
-
Cliquez sur Terminé.
Vous pouvez afficher et modifier les notifications propres aux passerelles dans vos paramètres. Vous les trouverez sous Paramètres > Notifications > Notifications personnalisées > Passerelles de données.
Notification pour une nouvelle version de la Direct Access gateway
Sous Paramètres > Notifications > Passerelles de données, vous pouvez définir la notification supplémentaire suivante :
-
Nouvelle version disponible de la passerelle de données
En cas d'activation, la notification sera envoyée uniquement au créateur de la passerelle de données chaque fois qu'une nouvelle version de la Direct Access gateway devient disponible en téléchargement.
Affichage et exécution des tests de benchmark
Vue d'ensemble
Les tests de benchmark sont des opérations de diagnostic qui mesurent la connectivité réseau et les performances entre Direct Access gateway et Qlik Cloud. Utilisez-les pour résoudre les problèmes de performances de chargement, établir des références de performances ou comparer des passerelles.
Dans le centre d'activités Administration, les tests de benchmark nécessitent Direct Access gateway 1.7.17 ou une version ultérieure. L'API de benchmark est disponible à partir de Direct Access gateway 1.7.8 ou d'une version ultérieure. Pour des informations détaillées sur l'API, consultez l'API de benchmarks Direct Access gateway.
Les résultats de benchmark peuvent vous aider à identifier les conditions réseau qui affectent les performances de chargement et fournir des informations pour le dépannage.
Conditions préalables requises
Avant d'exécuter un test de benchmark, vérifiez les conditions suivantes :
-
La passerelle exécute la version 1.7.17 ou une version ultérieure.
-
La passerelle est connectée et fonctionne dans Qlik Cloud.
-
Le rôle Tenant Admin vous est attribué et vous êtes soit le propriétaire de l'espace de la passerelle, soit un membre de l'espace de la passerelle disposant du rôle Peut consommer des données.
Création d'un nouveau test de benchmark
Pour créer un test de benchmark :
-
Dans le centre d'activités Administration, cliquez sur Passerelles de données.
-
Près d'une passerelle que vous souhaitez tester, cliquez sur
> Benchmarks.
L'onglet Benchmarks Direct Access gateway s'ouvre. Tous les tests de benchmark existants associés à la passerelle sont répertoriés.
-
Cliquez sur Créer un benchmark.
-
Saisissez un Nom et éventuellement une Description.
-
Si nécessaire, ajustez les options Taille des données et Politique de chevauchement.
-
Cliquez sur Créer un benchmark.
Exécution d'un test de benchmark
Pour exécuter un test de benchmark existant :
-
Dans le centre d'activités Administration, cliquez sur Passerelles de données.
-
Ouvrez l'onglet Benchmarks Direct Access gateway.
-
Près du test de benchmark que vous souhaitez exécuter, cliquez sur
> Exécuter.
Le benchmark s'exécute en tâche de fond. Vous pouvez également créer et surveiller un benchmark via l'API de benchmarks Direct Access Gateway.
Affichage des résultats des benchmarks
L'onglet Benchmarks Direct access gateway vous permet d'afficher et de comparer les résultats des benchmarks. Vous pouvez afficher les résultats d'une seule exécution de benchmark ou de chargement ou comparer plusieurs exécutions de benchmark et de chargement. Vous pouvez également comparer les métriques sur différentes passerelles.
Pour analyser les résultats des benchmarks :
-
Dans le centre d'activités Administration, cliquez sur Passerelles de données.
-
Ouvrez l'onglet Benchmarks Direct Access gateway.
-
Naviguez entre les sections Benchmarks et Chargements, selon les besoins, en sélectionnant les éléments que vous souhaitez analyser.
-
Vous pouvez comparer les exécutions de benchmark et de chargement sur différentes passerelles. Après avoir sélectionné un ou plusieurs éléments d'une passerelle, utilisez le sélecteur de passerelle dans la barre supérieure pour changer de passerelle, puis sélectionnez d'autres éléments.
-
Cliquez sur Afficher les résultats ou sur Comparer la sélection.
Résultats d'analyse
Les résultats de l'analyse de benchmark et de chargement se composent des éléments suivants, selon l'option utilisée :
-
Afficher les résultats : analyse des tendances pour suivre la latence au fil du temps entre les exécutions de benchmark et de chargement.
-
Comparer la sélection : métriques telles que la latence et le débit, analysées comme étant mauvaises, basiques ou bonnes, par exécution.
Dépannage des benchmarks
| Problème | Cause possible | Solution |
|---|---|---|
| La demande de benchmark est rejetée | Le demandeur ne dispose pas des autorisations d'espace de passerelle ou client requises. | Vérifiez que le rôle Tenant Admin est attribué au demandeur et qu'il est soit le propriétaire de l'espace de la passerelle, soit un membre de l'espace de la passerelle disposant du rôle Peut consommer des données. |
| Le benchmark n'est pas disponible | La version de la passerelle ne supporte l'interface demandée. | Pour le centre d'activités Administration, utilisez Direct Access gateway 1.7.17 ou une version ultérieure. Pour l'API, utilisez Direct Access gateway 1.7.8 ou une version ultérieure. |
Limitations
Seuls les 100 chargements les plus récents et les 100 benchmarks les plus récents sont présentés par passerelle.
Propriétés des passerelles de données
Pour accéder au tableau Passerelles de données, sélectionnez Administration dans le menu du lanceur (), puis Passerelles de données. Le tableau Passerelles de données indique les informations de base de chaque passerelle de données.
Propriétés des passerelles de données

Les colonnes du tableau sont les suivantes :
-
Nom – Nom spécifié lors de la création de la passerelle de données.
-
Type – Doit être Direct Access gateway.
-
Version – La version actuelle. Pour plus d'informations, consultez Mise à niveau et désinstallation de Passerelle de données Qlik - Accès direct.
-
Description – Description fournie lors de la création de la passerelle de données.
-
ID de passerelle de données – Identificateur unique pouvant être utile à des fins de dépannage.
-
État – Peut être l'un des états suivants :
- Connecté - Indique que le service de passerelle de données a établi une connexion avec Qlik Cloud.
-
Déconnecté - Si le statut est Déconnecté, démarrez le service de passerelle de données comme décrit ci-dessus.
- Désactivé - La passerelle de données est désactivée dans la Centre d'activités Administration.
- Établissement de la session - Affiché lorsque la passerelle de données établit une connexion à la source de données.
-
Espace - Espace auquel la passerelle de données est associée.
-
Date de création – Date de création de la passerelle de données.