Quelles distributions Linux l'agent Query Streams prend-il en charge ?

Le paquet .deb est compatible avec Ubuntu 20.04 et versions ultérieures, ainsi qu'avec Debian 11 et versions ultérieures. L'archive .tar.gz contenant le script install.sh fonctionne sur toutes les distributions Linux x86-64, notamment RHEL 8 et versions ultérieures, CentOS Stream, Fedora et Amazon Linux 2.

L'agent Query Streams nécessite-t-il l'ouverture de ports de pare-feu sous Linux ?

Non. L'agent établit uniquement des connexions HTTPS sortantes sur le port 443. Aucune règle de pare-feu entrante n'est requise.

Installation · Linux

Installez l'agent Query Streams sur Linux

L'agent est un petit programme qui s'exécute à côté de vos données et assure la connexion. Installez-le une seule fois, puis configurez le reste depuis votre navigateur.

Environ 10 minutes Aucun codage nécessaire Vos données restent sur place

Vous êtes bloqué à un moment donné ? N'hésitez pas à nous demander. Ouvrir Soutien Dans la section « Flux de requêtes » (menu en haut à droite → Assistance), envoyez-nous un message. De vraies personnes le liront, et « Je ne comprends pas ce que cet écran demande » est une question tout à fait légitime.

Query Streams vous permet d'extraire des données en direct de vos bases de données et applications métier (vers Excel, Google Sheets, des rapports ou un assistant IA) sans les copier au préalable. Pour ce faire, il nécessite un petit programme auxiliaire exécuté sur un serveur ayant déjà accès à vos données. Ce programme auxiliaire est… Agent.

Ce dont vous aurez besoin avant de commencer

Une machine ou un serveur Linux

Il doit rester sous tension lorsque des requêtes sont exécutées. Un serveur éteint pendant la nuit sera tout simplement indisponible jusqu'à son redémarrage.

Votre clé de connexion

Un code unique permet d'associer cet agent à votre organisation. Vous le trouverez dans la section Flux de requêtes de la page de téléchargement, juste à côté du programme d'installation.

Détails de votre base de données

Le nom du serveur, le nom de la base de données, ainsi qu'un nom d'utilisateur et un mot de passe permettant d'y accéder. Si une autre personne gère votre base de données, c'est à elle qu'il faut demander ces informations.

Où devrait-il aller ? Installez l'agent sur une machine capable d'accéder à votre base de données (généralement le serveur de base de données lui-même ou n'importe quel PC du réseau de l'entreprise). Si vous pouvez accéder aux données depuis cette machine, l'agent le pourra également.

Installez-le en quatre étapes

Téléchargez et exécutez le programme d'installation

Connectez-vous à my.querystreams.com/télécharger Choisissez ensuite le téléchargement pour Linux. Deux paquets sont disponibles : un fichier .deb pour Ubuntu et les versions récentes de Debian, et un fichier .tar.gz pour les autres distributions. Téléchargez celui qui convient, puis ouvrez un terminal sur cette machine et exécutez les commandes ci-dessous. Vous aurez besoin des droits d'administrateur (sudo).

Vous l'avez téléchargé sur un autre ordinateur ? Copiez-le d'abord — par exemple scp querystreams-agent_*.deb vous@votre-serveur:~ — et ensuite commencer par cd ~ au lieu de cd ~/Téléchargements.

Ces deux distributions sont destinées aux machines Intel/AMD 64 bits (x86_64). Alpine Linux n'est pas pris en charge.

Ubuntu 18.04 ou version ultérieure, ou Debian 12 ou version ultérieure — utilisez le .deb. apte et vous apporte tout ce dont vous avez besoin :
Ubuntu / Debian 12+ (.deb)
```
cd ~/Téléchargements sudo apt install ./querystreams-agent_*_amd64.deb
```
Tout le reste — RHEL, Rocky, Alma, Fedora, Amazon Linux et Debian 11 ou version antérieure — utilisez le .tar.gzCommencez par installer la bibliothèque ICU requise par l'agent (la plupart des ordinateurs de bureau la possèdent déjà ; les images serveur minimales, en revanche, ne la contiennent souvent pas). Exécutez ensuite la commande suivante pour votre système :
Installer d'abord l'unité de soins intensifs
```
# RHEL, Rocky, Alma, Fedora, Amazon Linux 2023 sudo dnf install -y libicu # Amazon Linux 2, CentOS 7 sudo yum install -y libicu # Debian 11 ou version antérieure sudo apt install -y libicu-dev
```
Installez ensuite l'agent :
Autres distributions (.tar.gz)
```
cd ~/Téléchargements mkdir -p querystreams-agent tar -xzf querystreams-agent_*_linux-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
```
Le * Ce champ remplace le numéro de version ; vous n’avez donc pas besoin de le saisir. Si vous avez téléchargé plusieurs versions dans ce dossier, saisissez plutôt le nom complet du fichier.

Vérifiez ensuite qu'il est en cours d'exécution. Vous devriez voir actif (course) en vert ; appuyez q pour récupérer votre message.
Vérifier le service
```
systemctl status querystreams-agent
```
Sous RHEL, Rocky, Alma ou Fedora, si l'état affiche 203/EXECSELinux considère toujours ces fichiers comme s'ils se trouvaient dans votre répertoire personnel. Renommez-les et redémarrez.
Famille RHEL : correctif 203/EXEC
```
sudo restorecon -R /opt/querystreams/agent sudo systemctl restart querystreams-agent
```
S'il ne fonctionne toujours pas, journalctl -u querystreams-agent -n 40 --no-pager affiche les dernières lignes du journal — collez-les dans un demande d'assistance et nous verrons ensuite. Si vous avez utilisé le fichier .tar.gz, vous pouvez supprimer le agent de flux de requêtes Le dossier se trouve dans Téléchargements une fois l'application installée.

L'agent s'enregistre comme un service systemd, ce qui signifie qu'il démarre automatiquement au démarrage de la machine. Vous n'avez pas besoin de penser à le lancer, et vous ne le téléchargerez qu'une seule fois. Il se met à jour automatiquement à partir de maintenant..
Connectez-vous avec votre clé

Une fois l'agent installé, ouvrez sa page sur cette machine :
Sur la machine sur laquelle vous venez de l'installer
```
http://localhost:1823
```
Collez votre clé de connexion. Regardez le badge dans le coin supérieur gauche: une fois qu'il est lu « Connecté aux flux de requêtes » Un point vert indique que l'opération est terminée. L'agent vient de se connecter à votre compte ; c'est la dernière chose que vous avez à faire sur cet appareil.

Si ce serveur ne dispose pas d'interface graphique pour ouvrir un navigateur, vous pouvez toujours accéder à la page depuis votre ordinateur via un tunnel SSH. Exécutez cette commande sur ton ordinateur, en remplaçant votre identifiant et le nom du serveur par les vôtres, puis ouvrez http://localhost:1823 Ouvrez votre navigateur. C'est une opération ponctuelle ; fermez le terminal une fois terminé.
Sur votre propre ordinateur
```
ssh -L 1823:localhost:1823 vous@votre-serveur
```
La page elle-même vous dira la même chose : « Cet agent gère vos connexions localement ; la gestion quotidienne s'effectue dans le portail Query Streams. » C'est le moment de fermer cette fenêtre et de continuer dans votre navigateur.
Ajoutez votre première connexion — depuis votre navigateur

Retournez maintenant à Query Streams dans votre navigateur et ouvrez Agents de données (c'est sous Données (dans le menu du haut). Votre nouvel agent y sera répertorié. Cliquez Ajouter un connecteur et répondez aux questions : choisissez le type de base de données ou d’application, puis complétez les informations que vous avez recueillies précédemment.

Agents de données ouvertes

Vous pouvez tester la connexion avant de l'enregistrer, ce qui vous permet de vérifier immédiatement si les paramètres sont corrects. Query Streams propose également des paramètres adaptés aux bases de données courantes et fournit quelques exemples de requêtes prêtes à l'emploi pour une utilisation immédiate.

Une fois enregistrée, Query Streams analyse votre base de données et en recense les éléments : les tables, les colonnes et leurs relations. Ces informations alimentent la liste que vous sélectionnez dans le générateur de requêtes, et c’est ainsi que Nova peut répondre à la question « Combien de commandes avons-nous expédiées le mois dernier ? » sans que vous ayez à nommer une seule table. Aucune configuration n’est requise ; le service s’actualise automatiquement à intervalles réguliers pour s’adapter aux modifications de votre base de données.

Il analyse la forme, pas le contenu. Cette étape concerne les noms des tables et des colonnes, et non vos lignes. Sur une base de données volumineuse, elle peut prendre quelques minutes ; vous n’avez pas besoin d’attendre, et vous verrez une notification sur le connecteur une fois l’opération terminée. Agents de données.

Votre mot de passe ne quitte jamais cette machine. Lorsque vous enregistrez une connexion, les détails sont transmis à votre agent via une connexion cryptée et les identifiants sont stockés sur votre ordinateur, et non chez nous.
Exécutez votre première requête

La méthode la plus rapide : appuyez sur « Lancer une requête » sur le dernier écran de la configuration du connecteur. Cela ouvre Générateur de requêtes Votre nouvelle connexion étant déjà sélectionnée, vous n'avez rien à chercher. Vous pouvez également y accéder à tout moment depuis le menu du haut.

À partir de là, exécutez l'une des requêtes d'exemple prêtes à l'emploi, écrivez la vôtre ou posez simplement une question en langage clair à Nova — notre assistant — et laissez-le écrire la requête pour vous.

Lorsque vous enregistrez une requête, elle devient réutilisable partout : actualisez-la dans Excel ou Google Sheets, planifiez son exécution, partagez-la avec un collègue, transmettez-la à un assistant IA ou transformez-la en un lien Web qu’un autre système peut appeler.

Ouvrir le générateur de requêtes Obtenez le complément Excel et Sheets

Comment les pièces s'assemblent

Vous configurez tout dans votre navigateur. L'agent effectue la lecture, au sein de votre réseau. Seules les lignes correspondant à votre requête sont renvoyées ; l'agent se connecte toujours à Internet, donc rien n'a besoin d'être ouvert pour que cela fonctionne.

Vous gérez tout depuis le navigateur

Une fois l'agent installé et connecté, Vous ne devriez pas avoir besoin de retourner à cette machine. Tout — les connexions, les bases de données à inclure, la fréquence d'actualisation des données, tous les paramètres propres à l'agent — est géré depuis Agents de données dans votre navigateur, où que vous soyez.

Flux de requêtes, dans votre navigateur

Tout ce que vous ferez concrètement, où que vous soyez :

Ajout, modification et suppression de connexions
Tester une connexion
Choisir les bases de données à inclure
Définir la fréquence d'actualisation des données
Tous les paramètres de l'agent

La page personnelle de l'agent

Un seul emploi, et vous n'en aurez peut-être jamais besoin :

Vérification des raisons pour lesquelles l'agent ne peut pas accéder aux flux de requêtes

Si votre agent apparaît comme hors ligne dans le navigateur et que vous ne voyez pas pourquoi, ouvrez localhost:1823 sur cette machine. Le badge dans son coin supérieur gauche vous l'indique immédiatement (Découvrez ce que signifient les quatre États), et il peut voir le réseau depuis sa position, ce que votre navigateur ne peut pas faire.

L'agent devient totalement passif. Il est conçu pour être installé une fois et oublié. Chaque opération se déplace vers Agents de données Dans le navigateur, la page de l'agent ne vous fournira que des informations utiles pour comprendre pourquoi il ne peut pas accéder aux flux de requêtes. Par conséquent, si un guide ou un collègue vous demande de configurer quelque chose sur la machine de l'agent, vérifiez d'abord dans le navigateur.

Si vous avez lu une version antérieure de ce guide : Il était indiqué que les connexions devaient être établies sur la propre page de l'agent et pas Dans le navigateur. Ce n'est plus le cas : c'est désormais dans le navigateur qu'il faut effectuer ces opérations. Tout ce que vous avez configuré de l'ancienne manière reste fonctionnel et vous le retrouverez dans les agents de données.

L'agent communique-t-il avec les flux de requêtes ?

Ce badge en haut à gauche de la page de l'agent répond à presque toutes les questions du type « Pourquoi ça ne marche pas ? ». Il affiche toujours l'une des quatre informations suivantes, et son libellé vous indique précisément où vous en êtes. Voici ce que vous cherchez :

Connecté aux flux de requêtes

Connexion aux flux de requêtes Se reconnecter aux flux de requêtes

Déconnecté des flux de requêtes

La connexion et la reconnexion sont signalées de la même manière : une bande de couleur animée signifie « en cours ». Une lueur verte fixe indique que la connexion est établie. Un badge plat et peu lumineux indique qu’elle est interrompue.

La petite lumière n'est pas un bouton. Il ne fait qu'afficher l'état — cliquer dessus ne produit aucun effet. Connecter, Reconnect et Déconnecter Les commandes sont des boutons nommés sur le panneau Connexion plus bas sur la page, ce qui est intentionnel : un voyant sans étiquette qui déconnectait discrètement votre agent lorsqu’on cliquait dessus était un piège qu’il valait mieux supprimer.

Tout va bienConnecté aux flux de requêtes

Tout fonctionne. Vos requêtes seront exécutées et toute modification effectuée dans le navigateur sera transmise à cet agent en quelques secondes. Aucune action requise.

DémarrageConnexion aux flux de requêtes

C'est normal pendant quelques secondes après le démarrage de la machine ou le redémarrage de l'agent. Veuillez patienter un instant.

J'y travailleSe reconnecter aux flux de requêtes

La connexion a été interrompue et l'Agent la rétablit automatiquement — il s'agit généralement d'une brève interruption de réseau, et il n'a besoin d'aucune aide de votre part.

Si la connexion reste bloquée plus de quelques minutes, cela signifie qu'un problème sur le réseau empêche la sortie. Dans ce cas, il est important de nous en informer.

Nécessite une attention particulièreDéconnecté des flux de requêtes

Tant qu'il est dans cet état, rien ne fonctionne sur cet agent. C'est l'Agent qui effectue la lecture proprement dite ; s'il est injoignable, rien ne peut faire le travail.

Vérifiez que la machine est en ligne, puis appuyez sur Reconnect Dans le panneau Connexion. Si le problème persiste, il s'agit généralement d'un pare-feu ou d'un proxy bloquant le trafic sortant ; envoyez-nous un message et nous vous aiderons à identifier la cause.

Que se passe-t-il lorsqu'un agent est déconnecté ? Tout ce qui a besoin d'accéder à ses données :

Les requêtes sur ses connexions ne s'exécuteront pas, que ce soit dans Query Builder, Excel, Google Sheets, l'API REST ou un assistant IA.
Les actualisations planifiées et les automatisations de ces données ne se produisent pas.
Ses connexions ne peuvent être testées, consultées ou actualisées depuis votre navigateur.
Dans les agents de données, il apparaît comme hors ligne, et les chiffres que vous voyez sont les dernière connaissance ceux plutôt que de vivre

Rien n'est perdu pour autant. Les modifications que vous enregistrez dans votre navigateur pendant son absence sont conservées et appliquées dès qu'il se reconnecte ; vous pouvez donc continuer à configurer vos paramètres sans attendre.

Vous nous contactez concernant un problème de connexion ? Le panneau Connexion de cette page répertorie les quatre éléments qui nous sont le plus utiles. Copiez-les dans votre Soutien Nous envoyons un message et nous pouvons généralement éviter les allers-retours :

Machine: sur quel ordinateur se trouve l'agent
Organisation: à quel compte il est rattaché
Version de l'agent: quelle version est en cours d'exécution
Connecté depuis: quand a-t-il réussi à se connecter pour la dernière fois

Il se tient à jour

Vous installez l'Agent une seule fois. Vous n'aurez plus besoin de le télécharger ni de vous soucier des mises à jour : lorsqu'une nouvelle version est disponible, votre Agent s'en charge automatiquement, généralement en quelques instants.

Il existe trois façons de s'informer, afin qu'aucune mise à jour ne soit manquée :

Généralement En quelques instants

Dès la publication d'une mise à jour, nous la déployons directement via la connexion déjà ouverte par votre agent. La mise à jour s'effectue sur place et l'agent redémarre automatiquement.

S'il était éteint Quelques secondes après la reconnexion

Quelques secondes après sa remise en ligne, il demande s'il a manqué quelque chose, puis il rattrape son retard.

Ceinture et bretelles Une fois par jour, seul

Il effectue également une vérification quotidienne via sa propre connexion sortante, ce qui lui permet de rester à jour même sur un réseau strictement sécurisé.

Comment savoir si ça fonctionne correctement ? Le panneau Connexion sur la page de l'agent affiche Version de l'agentDans des conditions normales, la mise à jour se fait automatiquement. Si vous constatez un retard important pendant plusieurs jours, cela signifie qu'un élément du réseau bloque la mise à jour ; il est donc important de le signaler. message à nous, car l'Agent ne peut pas se sortir de cette situation par la seule force de sa parole.

Quand une nouvelle connexion commence-t-elle à fonctionner ?

Presque toujours en quelques secondes. La réponse exacte dépend de votre agent.

Généralement Quelques secondes

L'agent est en cours d'exécution et à jour ; il prend donc immédiatement en compte la modification. Aucun redémarrage n'est nécessaire.

S'il est éteint Lorsqu'il se reconnecte

Votre modification est enregistrée en toute sécurité et sera appliquée dès que la machine sera de nouveau en ligne.

Agents plus âgés Lors de son prochain redémarrage

Rare, car les agents se mettent à jour automatiquement. Query Streams vous indique à l'écran si cela s'applique au vôtre.

If a connector needs a file or folder on a network share, mount the share on this machine before you add the connector. That’s an administrator step, and the mount has to go under /mnt ou /médias, because the Agent’s service can’t see /home ou /run/user. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\serveur\partage path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, Test de connexion says it is not mounted and shows the exact command to run.

How to mount a share for the Agent on Linux

Questions fréquentes

Où puis-je ajouter, modifier ou supprimer des connexions ?

Dans votre navigateur, sur le Agents de données page — utiliser Ajouter un connecteurLes modifications sont généralement prises en compte par votre agent en quelques secondes. Si l'agent était hors ligne, elles s'appliquent dès sa reconnexion. Vous n'avez pas besoin d'intervenir sur le serveur de l'agent pour ajouter ou modifier une connexion.

Mes données sont-elles copiées dans Query Streams ?

Non. Votre base de données reste à son emplacement actuel. Lorsque vous exécutez une requête, l'Agent lit votre base de données et ne renvoie que les lignes demandées. Le mot de passe de votre base de données reste stocké sur la machine de l'Agent.

Dois-je ouvrir un port ou modifier notre pare-feu ?

Normalement non. L'agent établit une connexion sortante vers nous, de la même manière qu'un navigateur web. Aucun dispositif n'a besoin de recevoir de trafic entrant depuis Internet.

Puis-je utiliser plusieurs agents ?

Oui, de nombreuses organisations en gèrent un par site ou par réseau. Ils apparaissent tous ensemble dans votre compte ; la personne qui effectue la requête peut donc ignorer quel agent gère quelle connexion.

Dois-je continuer à le mettre à jour ?

Non, et il n'y a rien sur quoi cliquer. Lorsqu'une nouvelle version est publiée, elle est envoyée à votre agent via la connexion déjà ouverte. La mise à jour est donc généralement instantanée et l'agent redémarre automatiquement. Par sécurité, une vérification quotidienne est également effectuée. Vous pouvez consulter la version installée sous Version de l'agent sur son panneau de connexion.

Et si je reste bloqué à mi-chemin ?

Envoyez-nous un message depuis Soutien Dans Query Streams, indiquez-nous où vous vous êtes arrêté. Si possible, précisez l'écran affiché et ce que vous vous attendiez à voir ; cela nous suffit généralement pour résoudre le problème.

Ça ne s'est pas passé comme prévu ? Ça vaut la peine de nous le dire. Ouvrir Soutien Utilisez la fonction « Flux de requêtes » pour contacter l'équipe ou consultez l'onglet « Base de connaissances » pour accéder à d'autres guides. Si une étape de cette page ne correspond pas à ce que vous avez vu à l'écran, merci de nous le signaler : cela signifie que le guide doit être corrigé, et non votre rôle.

Installation ailleurs ?

Fenêtres

macOS

Setup trouble?

Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

Ce dont vous aurez besoin avant de commencer

Une machine ou un serveur Linux

Votre clé de connexion

Détails de votre base de données

Installez-le en quatre étapes

Téléchargez et exécutez le programme d'installation

Connectez-vous avec votre clé

Ajoutez votre première connexion — depuis votre navigateur

Exécutez votre première requête