Einrichtung · Windows
Installieren Sie den Query Streams Agent auf Fenster
Der Agent ist ein kleines Programm, das neben Ihren Daten läuft und die Verbindung herstellt. Installieren Sie ihn einmalig und richten Sie anschließend alles Weitere über Ihren Browser ein.
Mit Query Streams können Sie Live-Daten aus Ihren Datenbanken und Geschäftsanwendungen abrufen – direkt in Excel, Google Sheets, Berichte oder einen KI-Assistenten – ohne sie vorher irgendwohin kopieren zu müssen. Dazu benötigt es lediglich ein kleines Hilfsprogramm, das auf einem System ausgeführt wird, das bereits auf Ihre Daten zugreifen kann. Dieses Hilfsprogramm ist der Query Streams. Agent.
Was Sie vor dem Start benötigen
Ein Windows-PC oder Server
Es muss eingeschaltet bleiben, solange Abfragen ausgeführt werden. Ein Rechner, der nachts im Ruhemodus ist, steht erst wieder zur Verfügung, wenn er aufgewacht ist.
Ihr Anmeldeschlüssel
Ein einmaliger Code, der diesen Agenten mit Ihrer Organisation verknüpft. Sie finden ihn auf der Downloadseite unter „Abfrageströme“, direkt neben dem Installationsprogramm.
Ihre Datenbankdetails
Der Servername, der Datenbankname sowie ein Benutzername und ein Passwort mit Leseberechtigung. Falls Ihre Datenbank von jemand anderem verwaltet wird, fragen Sie diese Person danach.
Wohin soll es gehen? Installieren Sie den Agenten auf einem Rechner, der Ihre Datenbank bereits heute öffnen kann – häufig auf dem Datenbankserver selbst oder einem beliebigen PC im selben Büronetzwerk. Wenn Sie von diesem Rechner aus auf die Daten zugreifen können, kann auch der Agent darauf zugreifen.
Installation in vier Schritten
-
Laden Sie das Installationsprogramm herunter und führen Sie es aus.
Anmelden unter my.querystreams.com/download Wählen Sie den Windows-Download aus. Führen Sie die Datei aus und bestätigen Sie die Anweisungen.
Der Agent installiert sich als Windows-Dienst, was bedeutet, dass er bei jedem Systemstart automatisch startet. Sie müssen ihn nicht manuell starten, und dies ist das einzige Mal, dass Sie ihn herunterladen. Es aktualisiert sich ab hier selbst..
-
Melden Sie sich mit Ihrem Schlüssel an
Wenn der Agent installiert ist, öffnen Sie dessen Seite auf dem betreffenden Rechner:
Auf dem Rechner, auf dem Sie es gerade installiert haben.http://localhost:1823
Fügen Sie Ihren Anmeldeschlüssel ein. Sehen Sie sich das Abzeichen im obere linke Ecke: sobald es liest „Mit Abfrageströmen verbunden“ Mit einem grünen Punkt ist der Vorgang abgeschlossen. Der Agent stellt sich Ihrem Konto vor – und das ist der letzte Schritt, den Sie auf diesem Gerät durchführen müssen.
Die Seite selbst wird Ihnen dasselbe mitteilen: „Dieser Agent verwaltet Ihre Verbindungen lokal – die tägliche Verwaltung erfolgt im Query Streams Portal.“ Das ist Ihr Signal, das Fenster zu schließen und im Browser fortzufahren.
-
Fügen Sie Ihre erste Verbindung hinzu – über Ihren Browser.
Gehen Sie nun zurück zu Query Streams in Ihrem Browser und öffnen Sie Datenagenten (es ist unter Daten (im oberen Menü). Ihr neuer Agent wird dort aufgeführt. Anschluss hinzufügen und folgen Sie den Fragen: Wählen Sie die Art der Datenbank oder App aus und tragen Sie dann die zuvor gesammelten Details ein.
Sie können die Verbindung vor dem Speichern testen und so sofort überprüfen, ob die Angaben korrekt sind. Query Streams schlägt außerdem sinnvolle Einstellungen für gängige Datenbanken vor und bietet eine kleine Auswahl an vorgefertigten Beispielabfragen, sodass Sie sofort loslegen können.
Sobald die Datenbank gespeichert ist, analysiert Query Streams sie und erfasst deren Inhalt – Tabellen, Spalten und deren Beziehungen. Diese Informationen werden in der Auswahlliste des Query Builders angezeigt. So kann Nova beispielsweise die Frage „Wie viele Bestellungen haben wir letzten Monat versendet?“ beantworten, ohne dass Sie eine einzige Tabelle angeben müssen. Query Streams ist automatisch und ohne Konfiguration nutzbar; es aktualisiert sich regelmäßig und passt sich so automatisch an Änderungen in Ihrer Datenbank an.
Es erfasst die Form, nicht den Inhalt. In diesem Schritt geht es um Tabellen- und Spaltennamen, nicht um Ihre Zeilen. Bei einer großen Datenbank kann dies einige Minuten dauern – Sie müssen nicht warten; der Abschluss wird Ihnen im Connector angezeigt. Datenagenten.
Ihr Passwort verlässt niemals diesen Rechner. Wenn Sie eine Verbindung speichern, werden die Details über eine verschlüsselte Verbindung an Ihren Agenten übermittelt und die Anmeldeinformationen werden dort auf Ihrem eigenen Computer gespeichert – nicht bei uns.
-
Führen Sie Ihre erste Abfrage aus
Der schnellste Weg: Drücken Sie auf dem letzten Bildschirm der Konnektoreinrichtung auf „Abfrage starten“. Das öffnet Abfrage-Generator Ihre neue Verbindung ist bereits ausgewählt, Sie müssen also nichts mehr suchen. Sie können sie auch jederzeit über das obere Menü aufrufen.
Von dort aus können Sie eine der vorgefertigten Beispielabfragen ausführen, Ihre eigene Abfrage schreiben oder einfach Nova – unserem Assistenten – eine Frage in einfachem Englisch stellen und ihn die Abfrage für Sie schreiben lassen.
Wenn Sie eine Abfrage speichern, ist sie überall wiederverwendbar: Sie können sie in Excel oder Google Sheets aktualisieren, einen Zeitplan dafür festlegen, sie mit einem Kollegen teilen, sie einem KI-Assistenten übergeben oder sie in einen Weblink umwandeln, den ein anderes System aufrufen kann.
Wie die einzelnen Teile zusammenpassen
Sie verwalten alles über den Browser.
Sobald der Agent installiert und angemeldet ist, Sie sollten nicht mehr zu dieser Maschine zurückkehren müssen. Alles – Verbindungen, welche Datenbanken einbezogen werden sollen, wie oft Daten aktualisiert werden, alle Einstellungen des Agenten – wird von hier aus verwaltet. Datenagenten in Ihrem Browser, egal wo Sie sich gerade befinden.
Streams abfragen, in Ihrem Browser
Alles, was Sie tatsächlich tun werden, von überall aus:
- Hinzufügen, Bearbeiten und Entfernen von Verbindungen
- Testen einer Verbindung
- Auswahl der einzubeziehenden Datenbanken
- Festlegen, wie oft Daten aktualisiert werden
- Alle Agenteneinstellungen
Die eigene Seite des Agenten
Ein Job, und vielleicht brauchen Sie ihn nie:
- Überprüfung, warum der Agent die Abfrageströme nicht erreichen kann
Wenn Ihr Agent im Browser als offline angezeigt wird und Sie den Grund dafür nicht erkennen können, öffnen Sie localhost:1823 auf dieser Maschine. Das Emblem in der oberen linken Ecke verrät es Ihnen sofort (Sehen Sie, was die vier Staaten bedeuten), und es kann das Netzwerk von seinem Standort aus sehen – was Ihr Browser nicht kann.
Der Agent greift immer weniger ein. Es ist so konzipiert, dass man es einmal installiert und dann vergisst. Alle Vorgänge verlagern sich in diese Richtung. Datenagenten Im Browser speichert die Agentenseite lediglich Informationen, die Ihnen helfen, die Ursache für den fehlenden Zugriff auf Query Streams zu ermitteln. Wenn Sie also von einem Assistenten oder Kollegen aufgefordert werden, etwas auf dem Agentenrechner zu konfigurieren, überprüfen Sie zuerst den Browser.
Falls Sie eine ältere Version dieses Leitfadens gelesen haben: Darin hieß es, die Verbindungen müssten auf der eigenen Seite des Agenten eingerichtet werden und nicht Im Browser. Das stimmt nicht mehr – der Browser ist jetzt der Ort, an dem Sie dies tun. Alle Einstellungen, die Sie auf die alte Weise vorgenommen haben, funktionieren weiterhin und stehen Ihnen in den Datenagenten zur Verfügung.
Kommuniziert der Agent mit Query Streams?
Das Symbol oben links auf der Agentenseite ist die Antwort auf fast jede Frage „Warum funktioniert das nicht?“. Es zeigt immer eine von vier Möglichkeiten an, und der Wortlaut verrät Ihnen genau, woran Sie sind. Das ist es, wonach Sie suchen:
Verbindungsaufbau und -wiederherstellung sehen gleich aus – ein sich bewegender Farbstreifen bedeutet „Wird bearbeitet“. Ein gleichmäßiges grünes Leuchten bedeutet verbunden. Ein flaches, schwaches Symbol bedeutet, dass keine Verbindung besteht.
Das kleine Licht ist kein Knopf. Es zeigt lediglich den Status an – ein Klick darauf bewirkt nichts. Verbinden, Wiederverbinden und Trennen Die Steuerelemente sind als Schaltflächen im Verbindungsfeld weiter unten auf der Seite benannt, was Absicht ist: Eine unbeschriftete Leuchte, die beim Anklicken stillschweigend Ihren Agenten offline nahm, war eine Falle, die es zu beseitigen galt.
Alles funktioniert. Ihre Abfragen werden ausgeführt und alle Änderungen, die Sie im Browser vornehmen, erreichen diesen Agenten innerhalb von Sekunden. Sie müssen nichts weiter tun.
Das ist normal und kann einige Sekunden nach dem Hochfahren des Rechners oder dem Neustart des Agenten auftreten. Warten Sie einen Moment.
Die Verbindung ist abgebrochen und der Agent stellt sie selbstständig wieder her – normalerweise nur eine kurze Netzwerkstörung, für die keine Hilfe von Ihnen erforderlich ist.
Wenn es länger als ein paar Minuten hier steht, blockiert etwas im Netzwerk den Ausgang. Das sollte uns gemeldet werden.
Solange sich der Agent in diesem Zustand befindet, funktioniert nichts. Der Agent führt die eigentliche Lesung durch. Wenn er nicht erreichbar ist, kann niemand die Arbeit erledigen.
Prüfen Sie, ob die Maschine online ist, und drücken Sie dann Wiederverbinden Im Verbindungs-Panel. Falls die Verbindung nicht wiederhergestellt wird, blockiert in der Regel eine Firewall oder ein Proxy den ausgehenden Datenverkehr. Senden Sie uns eine Nachricht, und wir helfen Ihnen, das Problem zu finden.
Was wird unterbrochen, wenn ein Agent die Verbindung verliert? Alles, was mit seinen Daten in Berührung kommen muss:
- Abfragen an die Verbindungen werden nicht ausgeführt – weder im Abfrage-Generator, noch in Excel oder Google Sheets, über die REST-API oder einen KI-Assistenten.
- Geplante Aktualisierungen und Automatisierungen für diese Daten finden nicht statt.
- Die Verbindungen können nicht über Ihren Browser getestet, durchsucht oder aktualisiert werden.
- In Data Agents wird es als offline angezeigt, und die angezeigten Zahlen sind die zuletzt bekannt eher als leben
Es geht jedoch nichts verloren. Änderungen, die Sie in Ihrem Browser speichern, während dieser offline ist, bleiben erhalten und werden angewendet, sobald die Verbindung wiederhergestellt ist – Sie können also mit der Einrichtung fortfahren, ohne darauf warten zu müssen.
Sie möchten sich wegen eines Verbindungsproblems melden? Im Verbindungsfeld auf dieser Seite sind die vier Dinge aufgelistet, die uns am meisten helfen. Kopieren Sie diese in Ihr Unterstützung Nachricht senden und wir können das Hin und Her normalerweise überspringen:
- Maschine
- auf welchem Computer sich der Agent befindet
- Organisation
- zu welchem Konto es gehört
- Agentenversion
- Welche Build-Version wird ausgeführt?
- Verbunden seit
- als es zuletzt eine Verbindung herstellen konnte
Es hält sich selbst auf dem neuesten Stand.
Sie installieren den Agenten einmal. Sie werden nicht aufgefordert, ihn erneut herunterzuladen, und es gibt keine lästigen Benachrichtigungen über verfügbare Updates – wenn wir eine neue Version veröffentlichen, kümmert sich Ihr Agent automatisch darum, und zwar in der Regel innerhalb weniger Augenblicke.
Es bietet drei Möglichkeiten, dies herauszufinden, damit kein Update verpasst wird:
Sobald wir ein Update veröffentlichen, übertragen wir es direkt über die bereits bestehende Verbindung Ihres Agenten. Es wird direkt aktualisiert und startet anschließend neu.
Es fragt einige Sekunden nach der Wiederherstellung der Verbindung, ob es etwas verpasst hat, und holt dies dann nach.
Es überprüft außerdem einmal täglich über seine eigene ausgehende Verbindung, ob es aktuell ist – so bleibt es auch in einem streng abgesicherten Netzwerk auf dem neuesten Stand.
Woran man erkennt, dass es mithält. Das Verbindungsfeld auf der Agentenseite zeigt an AgentenversionUnter normalen Umständen aktualisiert sich unsere aktuelle Version automatisch. Sollten Sie jedoch feststellen, dass die Aktualisierung mehrere Tage lang deutlich verzögert ist, blockiert etwas im Netzwerk den Aktualisierungspfad – das ist einen Blick wert. Nachricht an unsDenn der Agent kann sich da nicht einfach herausreden.
Wann beginnt eine neue Verbindung zu funktionieren?
Fast immer innerhalb weniger Sekunden. Die genaue Antwort hängt von Ihrem Agenten ab:
Der Agent läuft und ist auf dem neuesten Stand, daher erkennt er die Änderung sofort. Kein Neustart erforderlich.
Ihre Änderung wird sicher gespeichert und sofort wirksam, sobald das Gerät wieder online ist.
Selten, da sich die Agenten selbst aktualisieren. Query Streams zeigt Ihnen auf dem Bildschirm an, ob dies auf Ihren Agenten zutrifft.
Häufig gestellte Fragen
Wo kann ich Verbindungen hinzufügen, bearbeiten oder löschen?
In Ihrem Browser, auf der Datenagenten Seite — verwenden Anschluss hinzufügenÄnderungen werden Ihrem Agenten in der Regel innerhalb von Sekunden angezeigt. Wenn der Agent offline war, werden sie sofort nach der Wiederherstellung der Verbindung angewendet. Sie müssen den Agentenrechner nicht berühren, um eine Verbindung hinzuzufügen oder zu ändern.
Werden meine Daten in Query Streams kopiert?
Nein. Ihre Datenbank bleibt unverändert. Wenn Sie eine Abfrage ausführen, liest der Agent Ihre Datenbank und gibt nur die angeforderten Zeilen zurück. Ihr Datenbankpasswort verbleibt auf dem Rechner des Agenten.
Muss ich einen Port öffnen oder unsere Firewall ändern?
Normalerweise nicht. Der Agent stellt eine ausgehende Verbindung zu uns her, genau wie ein Webbrowser. Es muss kein eingehender Datenverkehr aus dem Internet empfangen werden.
Kann ich mehr als einen Agenten einsetzen?
Ja – viele Organisationen betreiben einen Agenten pro Standort oder Netzwerk. Sie werden alle zusammen in Ihrem Konto angezeigt, daher ist es für denjenigen, der eine Anfrage stellt, unerheblich, welcher Agent welche Verbindung verwaltet.
Muss ich es ständig aktualisieren?
Nein – und es gibt auch nichts anzuklicken. Wenn wir eine neue Version veröffentlichen, wird diese über die bereits bestehende Verbindung an Ihren Agenten übertragen. Daher aktualisiert er sich in der Regel innerhalb weniger Augenblicke und startet automatisch neu. Zur Sicherheit führt er außerdem einmal täglich eine automatische Überprüfung durch. Die aktuelle Version finden Sie unter Agentenversion auf dem Anschlussfeld.
Was passiert, wenn ich auf halbem Weg nicht weiterkomme?
Schreiben Sie uns von Unterstützung Gehen Sie zu Query Streams und teilen Sie uns mit, wo Sie gelandet sind. Falls es einfacher ist, geben Sie an, welchen Bildschirm Sie sich ansehen und was Sie erwartet haben – das reicht uns in der Regel, um das Problem zu erkennen.
Linux
macOSSetup 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