Zainstaluj Query Streams na macOS
Uruchom agenta sieciowego Query Streams Network Agent obsługującego tylko połączenia wychodzące w systemie macOS 12 Monterey lub nowszym. Jeden skrypt instalacyjny rejestruje go jako agenta systemowego. uruchomiony daemon — natywne kompilacje dla Apple Silicon (M1–M4) i Intel. Użyj lokalnego pulpitu agenta pod adresem http://localhost:1823 aby zarejestrować agenta i zarządzać łącznikami danych, a następnie tworzyć zapisane zapytania w portalu Query Streams dla programów Excel, Google Sheets, automatyzacji, interfejsów API REST, MCP i Nova AI.
Zobacz wszystkie możliwości strumieni zapytań po połączeniu agenta macOS z siecią
Rozpocznij za darmo
Zadaj pytania Nova za pośrednictwem połączonych danych
Poznaj Nova API REST bazy danychPrzekształć zapisane zapytania w bezpieczne punkty końcowe
Zbuduj API AutomatyzacjaZaplanuj synchronizację i przesyłaj wyniki na żywo
Eksploruj API do SQLZapytaj interfejsy API SaaS za pomocą języka SQL
Eksploruj Baza danych AI MCPPozwól narzędziom AI na bezpośrednie zapytania do łączników
Połącz AIQuery Streams to bezpieczna platforma dostępu do danych w czasie rzeczywistym, która umożliwia użytkownikom komputerów Mac i zespołom programistycznym łączenie baz danych na żywo z programami Excel, Arkuszami Google, automatyzacjami, narzędziami AI zgodnymi z MCP i gotowymi do współpracy interfejsami API REST. Więcej informacji można znaleźć na stronie QueryStreams.com. oraz zarejestruj się za darmo aby zainstalować pierwszego agenta macOS.
W tym przewodniku opisano instalację agenta na macOS. Pakiet zawiera: skrypt instalacyjny z jednym poleceniem który kopiuje pliki do /usr/local/querystreams/agent/ i rejestruje demon launchd na poziomie systemu — dostępne jako natywne kompilacje ARM64 (Apple Silicon M1–M4) i natywne kompilacje x64 (Intel). Dodaj złącza danych w lokalnym panelu agenta, a następnie użyj portalu Query Streams, aby utworzyć pierwsze zapisane zapytanie.
Zanim zaczniesz
Obsługiwane wersje systemu macOS
macOS 12 Monterey lub nowsze (Monterey, Ventura, Sonoma, Sequoia). Zarówno Apple Silicon, jak i Intel obsługują natywne pliki binarne.
Dostęp administratora/sudo
Wymagane. Skrypt instalacyjny uruchamia się jako root, aby zainstalować /usr/local/ i zarejestruj system LaunchDaemon.
Wychodzący HTTPS
Agent potrzebuje wychodzącego dostępu HTTPS na porcie 443 do usług chmurowych Query Streams. Nie jest wymagana żadna reguła zapory dla ruchu przychodzącego.
Dostęp do sieci baz danych
Zainstaluj agenta na komputerze Mac, który znajduje się w tej samej sieci, sieci VPN lub środowisku routowalnym, co Twoja baza danych lub źródło interfejsu API.
Krok 1: Pobierz agenta macOS
- Zaloguj się do my.querystreams.com/download.
- Wybierać macOS z opcji pobierania Agenta.
- Wybierać ARM64 (Apple Silicon — sprawdź Menu Apple > O tym Macu:jeśli wyświetla się „Apple M1/M2/M3/M4”, użyj tego) lub x64 (Intel Core) i pobierz .tar.gz archiwum.
- Skopiuj klucz uwierzytelniający swojej organizacji z tej samej strony pobierania. Będziesz go używać po otwarciu lokalnego pulpitu agenta.
Krok 2: Uruchom skrypt instalacyjny
Otwórz Terminal (Aplikacje > Narzędzia > Terminal) i uruchom:
Ten install.sh skrypt wykonuje automatycznie cztery kroki: kopiuje pliki do /usr/local/querystreams/agent/, ustawia prawidłowe uprawnienia, instaluje plik plist launchd /Library/LaunchDaemons/com.querystreams.agent.plist jako demon systemowy i ładuje usługę za pośrednictwem załaduj launchctl — uruchamiając go natychmiast i przy każdym uruchomieniu.
Podpisano i poświadczono notarialnie: Agent Query Streams macOS jest podpisany kodem i poświadczony notarialnie przez Apple, dzięki czemu działa normalnie w systemie Gatekeeper — większość użytkowników nie musi wykonywać żadnych dodatkowych czynności. W rzadkich przypadkach, gdy pojawi się monit o pierwsze uruchomienie (na przykład, jeśli archiwum zostało skopiowane między komputerami po ponownym zastosowaniu flag kwarantanny), wyczyść atrybut kwarantanny za pomocą xattr -dr com.apple.quarantine qs-agent/ i ponownie uruchomić sudo bash install.sh.
Po uruchomieniu usługi lokalny panel będzie dostępny pod adresem http://localhost:1823 na komputerze Mac. Służy do wprowadzania klucza uwierzytelniającego i zarządzania lokalnymi łącznikami danych. Twoje dane uwierzytelniające do bazy danych pozostają na komputerze agenta i nie są wysyłane do chmury Query Streams.
Krok 3: Połącz agenta ze swoim kontem
- W lokalnym panelu agenta w
http://localhost:1823, wklej swój klucz uwierzytelniania Query Streams. - Zapisz klucz i poczekaj, aż Agent zarejestruje się w Twojej organizacji.
- Potwierdź, że usługa jest prawidłowa:
sudo launchctl list | grep querystreams. - Wybierz Dodaj źródła danych aby otworzyć kreatora połączeń lokalnych.
Krok 4: Dodaj pierwsze źródło danych w agencie lokalnym
Nie dodawaj ani nie edytuj łączników z portalu Query Streams. Konfigurację łącznika wykonuje się na pulpicie lokalnego agenta sieciowego. http://localhost:1823Tutaj możesz dodawać, edytować, testować i usuwać łączniki baz danych lub API, takie jak PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation lub iTick.
- Otwórz przeglądarkę na komputerze z systemem macOS Agent i przejdź do
http://localhost:1823. - Kliknij Dodaj źródła danych lub otwórz obszar połączenia Agenta.
- Wybierz typ bazy danych lub łącznika API.
- Wprowadź dane połączenia, które są prawidłowe na komputerze z agentem macOS.
- Jeśli zostaniesz o to poproszony, wybierz obszar danych.
- Przetestuj połączenie i zapisz je.
- W przypadku obsługiwanych łączników bazy danych pozostaw opcję Schema Intelligence włączoną, aby klienci Query Builder, Nova AI i MCP uzyskali bogatszy kontekst tabeli i kolumny.
Krok 5: Utwórz i zapisz swoje pierwsze zapytanie
Po skonfigurowaniu łącznika i bazy danych w agencie otwórz portal Query Streams i użyj Kreatora zapytań, aby utworzyć pierwsze zapisane zapytanie. Zapisane zapytanie to takie, które można uruchomić w programach Excel, Arkuszach Google, automatyzacjach, bezpiecznych punktach końcowych interfejsu REST API oraz współdzielonych użytkownikach bez konieczności wglądu w surowe dane SQL lub poświadczenia bazy danych.
- Otwórz Kreator zapytań w portalu Query Streams.
- Wybierz łącznik danych i bazę danych, które skonfigurowałeś w lokalnym Agencie.
- Napisz lub wygeneruj zapytanie SQL i uruchom podgląd.
- Zapisz zapytanie pod jasną nazwą i wszystkimi filtrami, które użytkownicy mają dostosować.
- Uruchom zapisane zapytanie z poziomu programu Microsoft Excel, Arkuszy Google, automatyzacji, interfejsów API REST lub współdzielonych pulpitów nawigacyjnych.
Agent lokalny
Dodawaj, edytuj, testuj i usuwaj łączniki w localhost:1823.
Kreator zapytań
Wybierz łącznik, wybierz bazę danych, napisz SQL, wyświetl podgląd i zapisz.
Narzędzia użytkownika
Zapisane zapytania będą dostępne w programach Excel, Arkuszach Google, automatyzacjach i interfejsach API.
Dostęp MCP
Klienci MCP mogą również przeglądać dostępne łączniki i wysyłać zapytania do bazy danych bezpośrednio za pośrednictwem agenta.
Odniesienie do zarządzania usługami
Odinstalowywanie agenta
W pakiecie znajduje się: odinstaluj.sh skrypt, który zatrzymuje i rozładowuje usługę launchd, usuwa plik plist z /Biblioteka/Demonów uruchamiania/i usuwa katalog instalacyjny.
Skrypt dezinstalacyjny wyświetli monit: „Zachować konfigurację i logi? (t/N)” - Wchodzić y aby zachować swoje appsettings.json oraz dzienniki/ folder lub N usunąć wszystko.
Rozwiązywanie problemów
macOS wyświetla komunikat „nie można otworzyć, ponieważ nie można zweryfikować programisty” +
xattr -dr com.apple.quarantine qs-agent/, a następnie uruchom ponownie sudo bash install.shAlternatywnie przejdź do Ustawienia systemowe > Prywatność i bezpieczeństwo i kliknij „Pozwól mimo wszystko” po pierwszej zablokowanej próbie.Agent nie pojawia się w sieci +
ogon -50 /usr/local/querystreams/agent/logs/agent-stdout.log. Najczęstsze przyczyny: nieprawidłowy klucz uwierzytelniania wprowadzony w lokalnym interfejsie internetowym http://localhost:1823; port wychodzący 443 zablokowany przez serwer proxy (test z curl -v https://my.querystreams.com); Gatekeeper nadal blokuje (sprawdź, czy atrybut kwarantanny został usunięty przed instalacją).Test połączenia z bazą danych nie powiódł się +
Czy powinienem użyć ARM64 czy x64? +
Czy muszę otwierać porty przychodzące zapory sieciowej? +
Gdzie są przechowywane dane uwierzytelniające bazy danych? +
/usr/local/querystreams/agent/appsettings.json na komputerze agenta. Usługa Query Streams Cloud nie potrzebuje Twojego hasła do bazy danych, aby kierować żądania zapytań przez agenta.Gdzie mogę dodawać, edytować lub usuwać łączniki? +
http://localhost:1823Portal Query Streams to miejsce, w którym można tworzyć zapisane zapytania i udostępniać dostęp po skonfigurowaniu łącznika przez Agenta.Jak działają automatyczne aktualizacje w systemie macOS? +
osx-arm64 lub osx-x64). Gdy jest dostępny, wyładowuje plik plist launchd i tworzy kopię zapasową appsettings.json, wyodrębnia nowy plik binarny, przywraca konfigurację i ponownie ładuje usługę — w pełni automatycznie, bez konieczności podejmowania jakichkolwiek działań przez użytkownika.Rozpocznij
Zainstaluj agenta macOS i podłącz pierwsze źródło danych
Uruchom skrypt instalacyjny składający się z jednego polecenia, skonfiguruj łączniki lokalnie pod adresem localhost:1823, a następnie zapisz wielokrotnego użytku zapytania dla programu Excel, Arkuszy Google, automatyzacji, MCP, interfejsów API REST i Nova AI.
Powiązane przewodniki: Zainstaluj agenta strumieni zapytań w systemie Windows | Zainstaluj agenta strumieni zapytań w systemie Linux | Zainstaluj dodatek Query Streams do Arkuszy Google | Korzystanie ze strumieni zapytań w programie Microsoft Excel
Kategoria: Konfiguracja
Tagi: macOS, agent strumieni zapytań, agent sieciowy, konfiguracja, łącznik bazy danych, launchd
Metaopis: Zainstaluj agenta Query Streams na macOS i bezpiecznie połącz się z bazami danych na żywo jako demon launchd.

