Konfiguracja · Linux

Zainstaluj agenta strumieni zapytań na Linux

Agent to niewielki program, który działa obok Twoich danych i nawiązuje połączenie. Zainstaluj go raz, a następnie skonfiguruj resztę w przeglądarce.

Około 10 minut Nie potrzeba kodowania Twoje dane pozostają na swoim miejscu

Query Streams pozwala na pobieranie danych na żywo z baz danych i aplikacji biznesowych – do Excela, Arkuszy Google, raportów lub asystenta AI – bez konieczności ich wcześniejszego kopiowania. Aby to zrobić, potrzebny jest jeden mały program pomocniczy, który ma już dostęp do Twoich danych. Tym programem pomocniczym jest… Agent.

Czego będziesz potrzebować przed rozpoczęciem

Maszyna lub serwer Linux

Musi być włączony, gdy użytkownicy uruchamiają zapytania. Komputer wyłączony na noc będzie po prostu niedostępny, dopóki nie zostanie ponownie uruchomiony.

Twój klucz logowania

Jednorazowy kod, który łączy tego agenta z Twoją organizacją. Znajdziesz go w strumieniach zapytań na stronie pobierania, tuż obok instalatora.

Twoje dane w bazie danych

Nazwa serwera, nazwa bazy danych oraz nazwa użytkownika i hasło umożliwiające jej odczyt. Jeśli ktoś inny zarządza Twoją bazą danych, warto go o to zapytać.

Zainstaluj w czterech krokach

1. Pobierz i uruchom instalator

   Zaloguj się na my.querystreams.com/download i wybierz pobranie Linuksa. Są dwa pakiety — .deb dla Ubuntu i nowszego Debiana oraz .tar.gz dla wszystkich pozostałych. Pobierz ten, który pasuje, a następnie otwórz terminal na tym komputerze i wykonaj poniższe polecenia. Będziesz potrzebować uprawnień sudo.

   Pobrałeś go na innym komputerze? Skopiuj go najpierw — na przykład scp querystreams-agent_*.deb ty@twój-serwer:~ — a następnie zacznij od płyta ~ zamiast cd ~/Pobieranie.

   Oba są przeznaczone dla 64-bitowych maszyn Intel/AMD (x86_64). Alpine Linux nie jest obsługiwany.

   Ubuntu 18.04 lub nowszy albo Debian 12 lub nowszy — użyj .deb. trafny pobiera wszystko inne, czego potrzebuje:

   Ubuntu / Debian 12+ (.deb)

   cd ~/Pobieranie sudo apt install ./querystreams-agent_*_amd64.deb

   Wszystko inne — RHEL, Rocky, Alma, Fedora, Amazon Linux i Debian 11 lub starsze — użyj .tar.gzNajpierw zainstaluj bibliotekę ICU potrzebną agentowi (większość komputerów stacjonarnych już ją posiada; obrazy serwerów o minimalnej pojemności często jej nie mają). Uruchom tylko jedną linijkę dla swojego systemu:

   Najpierw zainstaluj ICU

   # RHEL, Rocky, Alma, Fedora, Amazon Linux 2023 sudo dnf install -y libicu # Amazon Linux 2, CentOS 7 sudo yum install -y libicu # Debian 11 lub starszy sudo apt install -y libicu-dev

   Następnie zainstaluj agenta:

   Inne dystrybucje (.tar.gz)

   cd ~/Pobieranie mkdir -p querystreams-agent tar -xzf querystreams-agent_*_linux-x64.tar.gz -C querystreams-agent cd querystreams-agent sudo ./install.sh

   Ten * zastępuje numer wersji, więc nie musisz go wpisywać. Jeśli pobrałeś więcej niż jedną wersję do tego folderu, wpisz zamiast tego pełną nazwę pliku.

   Następnie sprawdź, czy działa. Powinieneś zobaczyć aktywny (biegający) na zielono; naciśnij q aby otrzymać odpowiedź zwrotną.

   Sprawdź usługę

   systemctl status querystreams-agent

   W systemach RHEL, Rocky, Alma lub Fedora, jeśli status pokazuje 203/WYKONAWCASELinux nadal traktuje pliki tak, jakby znajdowały się w Twoim folderze domowym. Zmień ich nazwy i uruchom ponownie:

   Rodzina RHEL: poprawka 203/EXEC

   sudo restorecon -R /opt/querystreams/agent sudo systemctl restart querystreams-agent

   Jeśli nadal nie działa, journalctl -u querystreams-agent -n 40 --no-pager pokazuje kilka ostatnich wierszy dziennika — wklej je do prośba o wsparcie i zajmiemy się tym dalej. Jeśli użyłeś pliku .tar.gz, możesz go usunąć agent strumieni zapytań folder w Pobranych po zainstalowaniu.

   Agent rejestruje się jako usługa systemd, co jest eleganckim określeniem, że uruchamia się automatycznie przy każdym uruchomieniu komputera. Nie musisz pamiętać o jego uruchomieniu i jest to jedyny moment, w którym go pobierzesz — od tego momentu aktualizuje się samoczynnie.

2. Zaloguj się za pomocą klucza

   Po zainstalowaniu Agenta otwórz jego stronę na tym komputerze:

   Na komputerze, na którym właśnie go zainstalowałeś

   http://localhost:1823

   Wklej swój klucz logowania. Spójrz na odznakę w lewy górny róg:gdy to przeczytasz „Połączone ze strumieniami zapytań” Zielona kropka oznacza, że wszystko gotowe. To agent przedstawiający się Twojemu kontu — i to ostatnia rzecz, którą musisz zrobić na tym komputerze.

   Jeśli na tym serwerze nie ma pulpitu, na którym można otworzyć przeglądarkę, nadal możesz uzyskać dostęp do strony z własnego komputera przez tunel SSH. Uruchom to na twój komputer, podmieniając swój login i nazwę serwera, a następnie otwórz http://localhost:1823 w swojej przeglądarce. To jednorazowa czynność — zamknij terminal po zakończeniu.

   Na własnym komputerze

   ssh -L 1823:localhost:1823 ty@twój-serwer

   Strona sama w sobie powie Ci to samo: „Ten agent zarządza połączeniami lokalnie — codzienne zarządzanie odbywa się w portalu Query Streams”. To sygnał, żeby zamknąć przeglądarkę i kontynuować przeglądanie.

3. Dodaj swoje pierwsze połączenie — z przeglądarki

   Teraz wróć do sekcji Query Streams w przeglądarce i otwórz ją Agenci danych (to jest pod Dane (w górnym menu). Twój nowy agent będzie tam wymieniony. Kliknij Dodaj złącze i wykonaj poniższe pytania: wybierz rodzaj bazy danych lub aplikacji, a następnie uzupełnij szczegóły, które zebrałeś wcześniej.

   Otwarte Agenci Danych

   Możesz przetestować połączenie przed jego zapisaniem, dzięki czemu od razu będziesz wiedzieć, czy dane są poprawne, zamiast dowiadywać się o tym później. Query Streams sugeruje również rozsądne ustawienia dla typowych baz danych i dodaje niewielki zestaw gotowych przykładowych zapytań, dzięki czemu masz coś do natychmiastowego uruchomienia.

   Po zapisaniu, Query Streams rozgląda się po bazie danych i notuje jej zawartość – tabele, kolumny i ich wzajemne powiązania. To właśnie te informacje wypełniają listę, z której wybierasz dane w Query Builder, i dzięki temu Nova może odpowiedzieć na pytanie „ile zamówień wysłaliśmy w zeszłym miesiącu?” bez konieczności podawania nazwy żadnej tabeli. Nie włącza się go i nie ma potrzeby konfigurowania; odświeża się on automatycznie, aby nadążać za zmianami w bazie danych.

   Odczytuje kształt, nie zawartość. Ten krok dotyczy nazw tabel i kolumn, a nie wierszy. W przypadku dużej bazy danych może to zająć kilka minut — nie musisz czekać, a po zakończeniu zobaczysz to w łączniku. Agenci danych.

   Twoje hasło nigdy nie opuszcza tego komputera. Po zapisaniu połączenia jego szczegóły są przesyłane do Twojego Agenta za pomocą szyfrowanego łącza, a dane uwierzytelniające są tam przechowywane, na Twoim komputerze — a nie u nas.

4. Uruchom swoje pierwsze zapytanie

   Najszybsza trasa: naciśnij „Rozpocznij zapytanie” na ostatnim ekranie konfiguracji łącznika. To otwiera Kreator zapytań Z nowym połączeniem już wybranym, więc nie musisz niczego szukać. Możesz też przejść tam w dowolnym momencie z górnego menu.

   Następnie uruchom jedno z gotowych przykładowych zapytań, napisz swoje własne lub po prostu zadaj Novie — naszemu asystentowi — pytanie w prostym języku angielskim, a on napisze zapytanie za Ciebie.

   Po zapisaniu zapytania można je ponownie wykorzystać w dowolnym miejscu: odświeżyć w programie Excel lub Arkuszach Google, zaplanować jego wykonanie, udostępnić współpracownikowi, przekazać asystentowi AI lub przekształcić w łącze internetowe, które może zostać wywołane przez inny system.

   Otwórz Kreator zapytań Pobierz dodatek Excel i Arkusze

Jak elementy do siebie pasują

Wszystkim zarządzasz z poziomu przeglądarki

Po zainstalowaniu agenta i zalogowaniu się, nie powinieneś wracać do tej maszyny. Wszystko — połączenia, bazy danych do uwzględnienia, częstotliwość odświeżania danych, wszystkie własne ustawienia agenta — jest zarządzane z poziomu Agenci danych w Twojej przeglądarce, niezależnie od tego, gdzie się znajdujesz.

Czy agent komunikuje się ze strumieniami zapytań?

Ta odznaka w lewym górnym rogu strony Agenta to odpowiedź na niemal każde pytanie „dlaczego to nie działa?”. Zawsze wskazuje jedną z czterech rzeczy, a sformułowanie dokładnie wskazuje, na czym stoisz. Oto, czego szukasz:

Samo się aktualizuje

Instalujesz Agenta tylko raz. Nie będziesz proszony o ponowne pobranie i nie będziesz musiał się martwić o dostępność aktualizacji — gdy udostępnimy nową wersję, Twój Agent sam się tym zajmie, zazwyczaj w ciągu kilku chwil.

Istnieją trzy sposoby sprawdzenia dostępności aktualizacji, dzięki czemu nie przegapisz żadnej aktualizacji:

Kiedy zacznie działać nowe połączenie?

Prawie zawsze w ciągu kilku sekund. Dokładna odpowiedź zależy od Twojego agenta:

Reading files on a network share

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 lub /głoska bezdźwięczna, because the Agent’s service can’t see /home lub /run/user. Share logins stored in the Portal are used by Windows Agents only. In the connector you can keep the \\serwer\udział path, which the Agent maps onto the mount, or type the mount path directly. If the share isn’t mounted, Połączenie testowe says it is not mounted and shows the exact command to run.

How to mount a share for the Agent on Linux

Często zadawane pytania

Czy chcesz zainstalować gdzie indziej? Okna macOS