Installatie · macOS
Installeer de Query Streams Agent op macOS
De Agent is een klein programma dat naast uw gegevens draait en de verbinding tot stand brengt. Installeer het eenmalig en stel vervolgens de rest in via uw browser.
Query Streams stelt u in staat om live data uit uw databases en bedrijfsapplicaties te halen – naar Excel, Google Sheets, rapporten of een AI-assistent – zonder deze eerst ergens naartoe te kopiëren. Hiervoor is één klein hulpprogramma nodig dat ergens draait en al toegang heeft tot uw data. Dat hulpprogramma is de Tussenpersoon.
Wat je nodig hebt voordat je begint
Een Mac die wakker blijft
Het moet actief blijven wanneer mensen query's uitvoeren, dus het is de moeite waard om de energie-instellingen te controleren. Draait native op Apple Silicon (M1–M4) en op Intel Macs.
Uw inlogsleutel
Een eenmalige code die deze agent aan uw organisatie koppelt. U vindt deze code in 'Query Streams' op de downloadpagina, direct naast het installatieprogramma.
Uw databasegegevens
De servernaam, de databasenaam en een gebruikersnaam en wachtwoord waarmee de database kan worden gelezen. Als iemand anders uw database beheert, moet u deze gegevens aan die persoon vragen.
Waar moet het naartoe? Installeer de agent op een machine die uw database al kan openen — vaak de databaseserver zelf, of een willekeurige pc in hetzelfde kantoornetwerk. Als u vanaf die machine toegang hebt tot de gegevens, kan de agent dat ook.
Installeer het in vier stappen.
-
Download en voer het installatieprogramma uit.
Meld u aan bij mijn.querystreams.com/download Kies de macOS-download — er zijn native Apple Silicon- en Intel-versies beschikbaar. Download de versie die bij je Mac past en installeer deze vervolgens met een paar regels in Terminal — je hebt een beheerderswachtwoord nodig.
Open Terminal (persen ⌘ Ruimte en typ "Terminal") en plak de regels voor jouw Mac erin. Weet je niet zeker welke je hebt? Apple-menu › Over deze Mac: Chip: Apple M… betekent Apple Silicon, Processor: Intel… betekent Intel.
Apple Silicon (M1 – M4)cd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-arm64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
Intel Maccd ~/Downloads mkdir -p querystreams-agent tar -xzf querystreams-agent_*_osx-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh
De
*Dit staat voor het versienummer, dus je hoeft het niet in te typen. Als je meerdere versies in die map hebt gedownload, typ dan de volledige bestandsnaam in.sudoEr wordt om het wachtwoord van je Mac gevraagd. Er verschijnt niets terwijl je typt — dat is normaal; druk op de knop. Opbrengst als je klaar bent.Als je het bestand met Safari hebt gedownload, is het mogelijk dat Safari het al heeft uitgepakt in een map met de naam van de download (Safari doet dit wanneer...). Open “veilige” bestanden na het downloaden. is ingeschakeld). In dat geval
teerAls de regel aangeeft dat het bestand niet gevonden kan worden, ga dan naar die map en voer het installatieprogramma van daaruit uit:Als Safari het al heeft uitgepaktcd ~/Downloads/querystreams-agent_*_osx-* sudo ./install.sh
Controleer dan of het programma draait — je zou een regel moeten zien die eindigt op ... com.querystreams.agent:
Controleer de servicesudo launchctl list | grep querystreams
Als er geen reactie komt, bevindt het logboek zich op
/usr/local/querystreams/agent/logs/agent-stdout.log— bevestig het aan een ondersteuningsverzoek En dan gaan we verder. Zodra het geïnstalleerd is, kun je het verwijderen.querystreams-agentmap in Downloads.De Agent registreert zichzelf als een achtergrondservice, wat een chique manier is om te zeggen dat hij automatisch start wanneer de Mac opstart. Je hoeft er niet aan te denken om hem te starten, en dit is de enige keer dat je hem downloadt. Het wordt vanaf hier automatisch bijgewerkt..
-
Meld u aan met uw sleutel
Nadat de agent is geïnstalleerd, opent u de bijbehorende pagina op die computer:
Op de Mac waarop je het zojuist hebt geïnstalleerdhttp://localhost:1823
Plak je aanmeldsleutel erin. Kijk naar de badge in de linkerbovenhoek: zodra het leest “Verbonden met querystreams” Met een groene stip bent u hier klaar. De agent stelt zich hiermee voor aan uw account – en dit is het laatste wat u op dit apparaat hoeft te doen.
Op de pagina zelf staat hetzelfde: “Deze agent beheert uw verbindingen lokaal; het dagelijkse beheer vindt plaats in de Query Streams Portal.” Dat is het moment om het te sluiten en verder te gaan in je browser.
-
Voeg je eerste verbinding toe — vanuit je browser
Ga nu terug naar Query Streams in je browser en open Data Agents (het is onder Gegevens (in het bovenste menu). Uw nieuwe makelaar wordt daar vermeld. Klik Connector toevoegen Volg de vragen: kies het type database of app en vul vervolgens de eerder verzamelde gegevens in.
Je kunt de verbinding testen voordat je deze opslaat, zodat je meteen weet of de gegevens kloppen in plaats van dat je er later achter komt. Query Streams stelt ook verstandige instellingen voor voor veelgebruikte databases en voegt een kleine set kant-en-klare voorbeeldquery's toe, zodat je direct aan de slag kunt.
Zodra de query is opgeslagen, scant Query Streams je database en noteert de inhoud ervan: de tabellen, de kolommen en hoe ze met elkaar samenhangen. Deze informatie vormt de basis voor de lijst die je in Query Builder selecteert, en zo kan Nova bijvoorbeeld de vraag "Hoeveel bestellingen hebben we vorige maand verzonden?" beantwoorden zonder dat je ook maar één tabel hoeft te noemen. Je hoeft de functie niet in te schakelen en er is niets te configureren; de functie vernieuwt zichzelf automatisch volgens een schema, zodat deze altijd up-to-date is wanneer je database verandert.
Het leest de vorm, niet de inhoud. Deze stap gaat over tabel- en kolomnamen, niet over uw rijen. Bij een grote database kan dit een paar minuten duren. U hoeft niet te wachten, u ziet de voortgang automatisch via de connector. Data Agents.
Je wachtwoord verlaat die computer nooit. Wanneer u een verbinding opslaat, worden de gegevens via een versleutelde verbinding naar uw agent verzonden en worden de inloggegevens daar op uw eigen computer opgeslagen – niet bij ons.
-
Voer uw eerste query uit
De snelste route: druk op 'Een query starten' in het laatste scherm van de connectorconfiguratie. Dat opent Querybouwer Je nieuwe verbinding is al geselecteerd, dus je hoeft niets meer te zoeken. Je kunt er ook op elk moment naartoe gaan via het hoofdmenu.
Vervolgens kunt u een van de kant-en-klare voorbeeldquery's uitvoeren, uw eigen query schrijven of gewoon een vraag in begrijpelijke taal aan Nova – onze assistent – stellen en haar de query voor u laten schrijven.
Wanneer je een query opslaat, kun je deze overal opnieuw gebruiken: je kunt hem vernieuwen in Excel of Google Sheets, inplannen, delen met een collega, aan een AI-assistent geven of er een weblink van maken die een ander systeem kan aanroepen.
Hoe de stukken in elkaar passen
Je beheert alles vanuit de browser.
Zodra de agent is geïnstalleerd en is ingelogd, Je hoeft niet meer terug naar die machine. Alles — verbindingen, welke databases moeten worden opgenomen, hoe vaak gegevens worden vernieuwd, alle instellingen van de agent zelf — wordt beheerd vanuit Data Agents in uw browser, waar u zich ook bevindt.
Query Streams in uw browser
Alles wat je daadwerkelijk gaat doen, waar je ook bent:
- Verbindingen toevoegen, bewerken en verwijderen
- Een verbinding testen
- De keuze maken welke databases opgenomen moeten worden
- Instellen hoe vaak gegevens worden vernieuwd
- Alle agentinstellingen
De eigen pagina van de agent
Eén baan, en misschien heb je hem nooit meer nodig:
- Onderzoeken waarom de agent geen toegang heeft tot de querystreams.
Als uw agent in de browser als offline wordt weergegeven en u niet kunt zien waarom, open dan localhost:1823 op die machine. Het embleem linksboven vertelt het je meteen (zie wat de vier staten betekenen), en het kan het netwerk zien vanaf de plek waar het zich bevindt, iets wat uw browser niet kan.
De agent wordt steeds minder betrokken. Het is ontworpen om eenmalig te installeren en er vervolgens geen omkijken meer naar te hebben. Elke operatie verschuift naar... Data Agents In de browser, en het enige dat de pagina van de agent zelf bewaart, is informatie die je helpt te achterhalen waarom de agent geen toegang heeft tot de querystreams. Dus als een handleiding of een collega je vraagt om iets op de agentmachine te configureren, controleer dan eerst de browser.
Als je een oudere versie van deze handleiding hebt gelezen: Er stond dat de verbindingen op de eigen pagina van de agent moesten worden ingesteld. niet In de browser. Dat is niet langer het geval — de browser is nu de plek om het te doen. Alles wat je op de oude manier hebt ingesteld, werkt nog steeds en je vindt het terug in Data Agents.
Communiceert de agent met querystreams?
Dat icoontje linksboven op de pagina van de agent is het antwoord op bijna elke vraag als "waarom werkt dit niet?". Er staat altijd een van de volgende vier dingen, en de formulering vertelt je precies waar je staat. Dit is waar je naar op zoek bent:
Verbinden en opnieuw verbinden zien er hetzelfde uit: een bewegende kleurband betekent "er wordt aan gewerkt". Een constante groene gloed betekent verbonden. Een vlak, zwak lampje betekent dat er geen verbinding is.
Het kleine lampje is geen knop. Het geeft alleen de status weer — erop klikken heeft geen effect. Verbinden, Opnieuw verbinding maken en Verbinding verbreken De bedieningselementen zijn benoemde knoppen op het verbindingspaneel verderop op de pagina, en dat is bewust zo gedaan: een naamloos lampje dat uw agent stilletjes offline haalde wanneer erop werd geklikt, was een valkuil die we wilden verwijderen.
Alles werkt naar behoren. Uw zoekopdrachten worden uitgevoerd en alle wijzigingen die u in de browser aanbrengt, bereiken deze agent binnen enkele seconden. U hoeft niets te doen.
Normaal gesproken duurt dit een paar seconden nadat de machine is opgestart of de agent opnieuw is opgestart. Geef het even de tijd.
De verbinding is verbroken en de agent herstelt deze automatisch — meestal is dit een kortstondige netwerkstoring en heeft uw hulp niet nodig.
Als het hier langer dan een paar minuten blijft hangen, blokkeert iets op het netwerk de uitgang. Dat is iets om ons te laten weten.
In deze toestand werkt niets op deze agent. Het is de agent die de daadwerkelijke meting uitvoert, dus als die niet bereikbaar is, is er niemand die het werk kan doen.
Controleer of het apparaat online is en druk vervolgens op Opnieuw verbinding maken Op het paneel 'Verbindingen'. Als de verbinding niet terugkomt, wordt uitgaand verkeer meestal geblokkeerd door een firewall of proxy. Stuur ons een bericht en we helpen je het probleem te vinden.
Wat stopt er als een agent de verbinding verliest? Alles wat met de gegevens te maken heeft:
- Query's op de verbindingen ervan zullen niet werken — niet in Query Builder, niet in Excel of Google Sheets, niet via de REST API en ook niet via een AI-assistent.
- Geplande vernieuwingen en automatiseringen voor die gegevens vinden niet plaats.
- De verbindingen ervan kunnen niet worden getest, bekeken of vernieuwd vanuit uw browser.
- In Data Agents wordt het weergegeven als offline, en de cijfers die u ziet zijn de laatst bekende liever leven dan leven
Er gaat echter niets verloren. Wijzigingen die je in je browser opslaat terwijl deze niet beschikbaar is, worden bewaard en toegepast zodra de verbinding is hersteld. Je kunt dus gewoon verdergaan met de instellingen zonder te hoeven wachten.
Neemt u contact met ons op vanwege een verbindingsprobleem? In het paneel 'Verbinding' op die pagina staan de vier dingen die ons het meest helpen. Kopieer ze naar je... Ondersteuning Een bericht is voldoende en we kunnen het heen en weer mailen meestal overslaan:
- Machine
- op welke computer de agent zich bevindt
- Organisatie
- aan welk account het is gekoppeld
- Agentversie
- welke build er draait
- Verbonden sinds
- toen het voor het laatst lukte om verbinding te maken
Het houdt zichzelf up-to-date.
Je installeert de Agent eenmalig. Je wordt niet gevraagd om hem opnieuw te downloaden en je krijgt geen vervelende meldingen zoals "update beschikbaar" — wanneer we een nieuwe versie uitbrengen, installeert je Agent deze automatisch, meestal binnen enkele ogenblikken.
Er zijn drie manieren om erachter te komen, zodat je geen update mist:
Zodra we een update publiceren, sturen we deze direct door via de verbinding die uw agent al open heeft staan. De update vindt ter plekke plaats en de agent start zichzelf opnieuw op.
Het systeem vraagt enkele seconden nadat het weer online is of het iets gemist heeft, en haalt het vervolgens in.
Het voert ook eenmaal per dag een controle uit via zijn eigen uitgaande verbinding, zodat het zelfs op een streng beveiligd netwerk actueel blijft.
Hoe weet je of het de achterstand nog aankan? Het verbindingspaneel op de pagina van de agent toont AgentversieOnder normale omstandigheden volgt dat automatisch onze huidige release. Als je merkt dat de update dagenlang ver achterloopt, blokkeert iets op het netwerk de update — dat is iets om rekening mee te houden. bericht aan onsOmdat de agent zich daar niet uit kan praten.
Wanneer begint een nieuwe verbinding te werken?
Vrijwel altijd binnen enkele seconden. Het exacte antwoord hangt af van uw agent:
De agent draait en is up-to-date, dus hij detecteert de wijziging direct. Geen herstart nodig.
Uw wijziging wordt veilig opgeslagen en is van kracht zodra de machine weer online is.
Dit komt zelden voor, omdat agents zichzelf bijwerken. Query Streams geeft op het scherm aan of dit voor uw agent geldt.
Reading files on a network share
If a connector needs a file or folder on a network share, mount the share on this Mac before you add the connector. Mount it from Terminal with sudo, in a folder under /Volumes, so the Agent, which runs as a system background service, can see it. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\server\share path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, Testverbinding says it is not mounted and shows the exact command to run.
How to mount a share for the Agent on a Mac
Veelgestelde vragen
Waar kan ik verbindingen toevoegen, bewerken of verwijderen?
In uw browser, op de Data Agents pagina — gebruik Connector toevoegenWijzigingen bereiken uw agent doorgaans binnen enkele seconden. Als de agent offline is geweest, worden de wijzigingen toegepast zodra deze opnieuw verbinding maakt. U hoeft de agentmachine niet aan te raken om een verbinding toe te voegen of te wijzigen.
Worden mijn gegevens naar Query Streams gekopieerd?
Nee. Uw database blijft op zijn huidige locatie. Wanneer u een query uitvoert, leest de agent uw database en retourneert alleen de rijen waar de query om vraagt. Uw databasewachtwoord blijft op de computer van de agent staan.
Moet ik een poort openen of onze firewall aanpassen?
Normaal gesproken niet. De agent maakt een uitgaande verbinding met ons, net zoals een webbrowser dat doet. Niets hoeft inkomend verkeer van het internet te accepteren.
Kan ik meer dan één agent gebruiken?
Ja, veel organisaties hebben er één per locatie of per netwerk. Ze verschijnen allemaal samen in uw account, dus het maakt voor degene die een query schrijft niet uit welke agent welke verbinding beheert.
Moet ik het steeds blijven bijwerken?
Nee, en er is niets om op te klikken. Wanneer we een nieuwe versie publiceren, wordt deze via de reeds geopende verbinding naar uw agent gepusht, waardoor deze doorgaans binnen enkele ogenblikken wordt bijgewerkt en zichzelf opnieuw opstart. Als extra controle voert de agent ook dagelijks een automatische controle uit. U kunt de huidige versie bekijken onder Agentversie op het aansluitpaneel.
Wat als ik halverwege vastloop?
Stuur ons een bericht vanuit Ondersteuning Ga naar Query Streams en vertel ons waar je bent gebleven. Als het makkelijker is, geef dan aan naar welk scherm je kijkt en wat je verwachtte te zien — dat is meestal voldoende voor ons om het te kunnen vinden.
Windows
LinuxSetup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish