Logo Koyeba

Bezserwerowy Postgres mówi po PostgreSQL

Łączyć Koyeb do Excela, Arkuszy Google, AI i REST

Bezserwerowy Postgres Koyeba na .pg.koyeb.app. Karta wychwytuje jeden błąd, który wszyscy popełniają – wklejanie nazwy hosta aplikacji zamiast nazwy bazy danych.

Zacznij za darmo 13 miejsc docelowych

Jedno połączenie, każda powierzchnia

Gdzie mogą trafić Twoje dane Koyeb

Koyeb stoły na żywo · tylko do odczytu
Zapytania federacyjne + dowolny inny łącznik · jeden SQL między źródłami · każdy plan
Agent sieciowy
  • 1 połączenie wychodzące
  • 0 porty przychodzące
  • tylko do odczytu · dane uwierzytelniające pozostają niezmienione

działa dalej

Query Streams odczytuje dane Koyeb Postgres z Microsoft Excel, Arkuszy Google, Power BI, asystentów AI przez MCP i punkt końcowy REST za pośrednictwem jednego połączenia tylko do odczytu. Koyeb hostuje aplikacje i bazy danych na sąsiadujących nazwach hostów, a tylko jedna z nich jest bazą danych: aplikacje znajdują się pod adresem .koyeb.app, a Postgres pod adresem .pg.koyeb.app. Pomylenie tych dwóch nazw to najczęstszy powód awarii połączenia, dlatego karta sprawdza to i informuje o tym wprost, zamiast pozwolić na awarię jako przekroczenie limitu czasu.

Koyeb jest na etacie PostgreSQL — standardowy sterownik, więc wszystkie poniższe instrukcje obowiązują bez zmian. Jedynym elementem specyficznym dla Koyeba jest ciąg połączenia, omówiony w szczegóły połączenia.

  1. Dla Twojego zespołu, dostawców i partnerów

  2. Koyeb do Excela Microsoft Excel · Dodatek do programu Excel

    Pobierz wyniki Koyeba na żywo bezpośrednio do arkusza kalkulacyjnego i odświeżaj je na żądanie — w programie Excel na komputerze stacjonarnym, w programie Excel Online, w programie Microsoft 365.

    Przewodnik po PostgreSQL

  3. Koyeb do Arkuszy Google Dodatek Arkuszy

    Uruchom zapisane zapytanie Koyeba z paska bocznego i upuść wiersze do arkusza. Współpracownicy korzystający ze wspólnego arkusza mogą je samodzielnie odświeżyć.

    Przewodnik po PostgreSQL

  4. Zapytaj Novę o Koyeba Nova AI · tekst do SQL

    Zadaj pytanie prostym językiem. Nova zna już Twoje tabele Koyeba, pisze i uruchamia SQL, wyjaśnia odpowiedź i tworzy wykres – bez pisania zapytania i podawania danych uwierzytelniających.

    Jak działa Nova

  5. Koyeb do przeglądarki danych udostępnianie wyników · zespół, dostawcy, partnerzy · telefon, tablet, komputer stacjonarny

    Udostępnij wynik Koyeba na żywo każdemu — współpracownikowi, dostawcy, partnerowi — w postaci siatki z zakładkami, która uruchamia się od nowa po otwarciu na telefonie, tablecie lub komputerze. Widzą wyniki, a nie kod SQL ani dane uwierzytelniające.

    Jak działa Przeglądarka danych
  6. Do aplikacji i systemów

  7. Koyeb REST API Punkt końcowy HTTP

    Opublikuj zapytanie Koyeba jako uwierzytelniony punkt końcowy JSON, który może wywołać dowolna aplikacja, ze specyfikacją OpenAPI 3.1 i gotowymi kolekcjami Postman, Insomnia i Hoppscotch. Port bazy danych nie jest otwarty.

    Przewodnik po PostgreSQL

  8. Koyeb do Power BI Power Query M

    Wklej wygenerowany kod Power Query M do edytora zaawansowanego usługi Power BI, a raport odczyta wyniki Koyeb na żywo przesyłane przez protokół HTTPS — bez sterownika ODBC i bez otwartego portu bazy danych.

    Jak działa Power BI

  9. Koyeb do Airtable Platforma automatyzacji

    Synchronizuj wiersze Koyeba z bazą Airtable zgodnie z harmonogramem lub pobieraj je za pomocą skryptu automatyzacji Airtable.

    Przewodnik po PostgreSQL

  10. Koyeb do Baserow Platforma automatyzacji

    Przekaż tabelę Baserow z Koyeb przez punkt końcowy REST — samodzielnie hostowany lub w chmurze Baserow.

    Przewodnik po PostgreSQL

  11. Koyeb do SeaTable Platforma automatyzacji

    Utrzymuj bazę danych SeaTable na bieżąco, korzystając z danych Koyeb, bez konieczności eksportowania pliku lub udostępniania bazy danych.

    Przewodnik po PostgreSQL

  12. Koyeb do Smartsheet Platforma automatyzacji

    Prześlij wyniki Koyeba do siatki Smartsheet, aby plany i raporty były odczytywane z systemu źródłowego, a nie eksportowane z poprzedniego tygodnia.

    Przewodnik po PostgreSQL

  13. Koyeb do Anvil Anvil Works · Platforma aplikacji

    Wspieraj aplikację Anvil Python za pomocą Koyeb przez punkt końcowy REST zamiast osadzać poświadczenia bazy danych w aplikacji.

    Przewodnik po PostgreSQL
  14. Dla narzędzi AI

  15. Serwer MCP Koyeb Klienci Claude, Cursor i MCP

    Udziel asystentowi AI dostępu tylko do odczytu Koyeba wraz ze schematem, którego potrzebuje do pisania prawidłowych instrukcji SQL — bez konieczności podawania danych uwierzytelniających w czacie.

    Przewodnik po PostgreSQL
  16. Dostarczone do ludzi

  17. Koyeb ostrzega i raportuje Slack · Discord · E-mail · Webhook

    Utwórz harmonogram zapytania Koyeb i otrzymuj wiersze dostarczane do Slacka, Discorda, poczty e-mail lub podpisanego webhooka — albo wstrzymaj wiadomość, aż liczba wierszy, próg lub zmiana procentowa przekroczy ustawioną linię.

    Jak działają alerty i raporty

Jak to działa

5 kroków, bez zmiany zapory przychodzącej

01

Zainstaluj agenta sieciowego w dogodnym dla siebie miejscu. Otwiera on jedno połączenie wychodzące i nigdy nie nasłuchuje, więc Koyeb widzi zwykłego klienta, a Twoja sieć nie potrzebuje reguły przychodzącej.

02

Otwórz kartę „Szczegóły połączenia” w bazie danych w konsoli Koyeb i skopiuj ciąg. Pobierz go z bazy danych, a nie z aplikacji.

03

Wklej go. Odczytane zostaną dane dotyczące hosta, portu, użytkownika, hasła i bazy danych, a następnie zostanie sprawdzona obecność pliku .pg. oznaczającego hosta jako punkt końcowy bazy danych.

04

Standardowe ustawienia Koyeb są już wypełnione — koyeb-adm jako użytkownik i koyebdb jako baza danych — więc nowa usługa zazwyczaj potrzebuje tylko hasła.

05

Zapisz. Microsoft Excel, Arkusze Google, Power BI, MCP i REST odczytują dane przez jedno połączenie lub łączą je z innymi źródłami za pomocą jednego polecenia tylko do odczytu.

Funkcja dogłębna

Co Koyeb ci daje

Nazwa hosta aplikacji nie jest nazwą hosta bazy danych

Koyeb to platforma aplikacji, która obsługuje również Postgres, a obie działają w odstępie jednej etykiety. To naprawdę łatwy błąd, który kończy się poważną pomyłką, więc karta go przechwytuje.

  • Aplikacje są obsługiwane z poziomu .koyeb.app. Dostęp do baz danych odbywa się przez .pg.koyeb.app. Różnica polega na środkowym .pg.
  • Wklej nazwę hosta kończącą się na .koyeb.app bez niej, a karta zatrzyma Cię z tym wyjaśnieniem, zamiast pozwolić Ci zapisać połączenie, które zawsze wygaśnie po upływie limitu czasu.
  • Przekroczenie limitu czasu to najgorszy możliwy objaw, ponieważ wygląda to na problem z zaporą sieciową. Ludzie sprawdzają reguły sieciowe, które nigdy nie stanowiły problemu.
  • Nazwy hostów baz danych są zgodne ze schematem ep-<name>-<id>. Postgres Koyeba jest oparty na Neon, skąd pochodzi ten wzorzec.

Poza tym, celowo zwyczajne

Nie ma tu żadnej sprytnej machiny, a udawanie, że jest inaczej, tylko wprowadzałoby w błąd. Karta po prostu dobrze odwzorowuje szczegóły i nie przeszkadza.

  • Protokół TLS jest wymuszany dla każdego hosta .pg.koyeb.app, niezależnie od tego, co zaznaczono w polu wyboru, więc ciąg, który utracił swój parametr sslmode w schowku, nadal jest przesyłany w postaci zaszyfrowanej. Ruch jest szyfrowany; łańcuch certyfikatów nie jest weryfikowany.
  • W ścieżce nie ma poolera. Niektóre bezserwerowe usługi Postgres umieszczają pooler w trybie transakcji na początku i wymagają przypięcia przygotowanych instrukcji, aby sobie z tym poradzić; Koyeb tego nie robi, więc agent łączy się bezpośrednio i pomija to wszystko.
  • Bazy danych koyeb-adm i koyebdb są wstępnie wypełnione, ponieważ właśnie z nimi startuje nowa baza danych Koyeb. Nowa usługa często potrzebuje tylko hasła.
  • Połączenie jest zapisywane jako PostgreSQL z Koyeb jako odznaką. Nie ma typu połączenia o nazwie Koyeb. — co oznacza również, że zwykłe połączenie Postgres, które wcześniej nawiązałeś z hostem .pg.koyeb.app, od razu przejmie branding.
-- Zwykły Postgres, tylko do odczytu SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS income FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interwał '30 dni' GROUP BY c.name ORDER BY revenue DESC;

Współdzielone przez każdy łącznik bazy danych

Dotyczy każdego łącznika bazy danych

  • Tylko wysyłka — agent otwiera jedno szyfrowane połączenie do strumieni zapytań. Bez przekierowania portu przychodzącego, bez VPN, bez listy dozwolonych adresów IP, bez żadnych informacji o Twojej bazie danych w internecie.
  • Poświadczenia pozostają na swoim miejscu — nazwa użytkownika i hasło do bazy danych są dostępne na komputerze, na którym zainstalowano agenta. Query Streams nigdy ich nie otrzymuje i nie może samodzielnie nawiązać połączenia z bazą danych.
  • Tylko do odczytu, wymuszone — po jednym poleceniu na raz, tylko SELECT i polecenia powiązane. Polecenie zapisu jest odrzucane na Twoim komputerze, zanim zostanie wysłane na serwer, zamiast polegać na uprawnieniu, o którym ktoś pamiętał.
  • Wdrażaj dowolną liczbę agentów — po jednym na lokalizację, region lub chmurę. Każde źródło danych, jakie widzą, pojawia się w jednym menu rozwijanym, więc nikt nie musi wiedzieć, który agent co hostuje.

Co otrzymasz po zapisaniu zapytania

  • Udostępniaj możliwości, a nie SQL — współpracownik lub zewnętrzny partner może uruchomić Twoje zapytanie i zmienić jego filtry, nie widząc nigdy oświadczenia, które za nim stoi.
  • Filtry z obu kierunków — zadeklaruj je samodzielnie jako @variables lub pozwól, aby łącznik wykrył wartości dosłowne już znajdujące się w klauzuli WHERE i zaoferował je jako listy rozwijane.
  • Przeczytaj to z dowolnego miejsca — Microsoft Excel, Arkusze Google, Power BI, API REST, asystenci AI w MCP, Kreator zapytań i Nova — wszystkie te narzędzia odczytują to samo zapisane zapytanie.
  • Uruchom kilka naraz — pięć zapisanych zapytań w pięciu kartach arkusza kalkulacyjnego, przesyłanych strumieniowo jednocześnie, bez względu na wielkość wyników.
  • Połącz to z czymkolwiek innym, co podłączyłeś — inną bazę danych, API biznesowe lub folder plików w jednym poleceniu tylko do odczytu.

Międzyźródłowy SQL

Dołącz Koyeb do reszty swoich danych

Jedno polecenie może obejmować Koyeba i inne połączenia jednocześnie. Każde źródło uruchamia tylko możliwą część, przesyła wynik strumieniowo, a łączenie odbywa się centralnie — źródła nigdy się ze sobą nie komunikują i nic nie jest nigdzie kopiowane.

3 połączenia · 3 agentów

Koyeb Bezserwerowy Postgres
Microsoft SQL Server Silnik relacyjny
Pasek Płatności i fakturowanie

Jedno stwierdzenie

-- nic nie zostało skopiowane, nic nie zostało połączone, nic nie zostało zaplanowane
SELECT   c.region, COUNT(*) AS zamówienia, SUM(i.amount_due) AS fakturowane
Z     koyeb_app.zamówienia.publiczne1 f
JOIN     erp_sql.dbo.klienci2   c WŁĄCZONY c.id = f.customer_id
JOIN     rozliczenia.stripe.invoices3 i WŁĄCZONY i.customer = c.stripe_id
GROUP BY c.region
ORDER BY fakturowany DESC;

Trzy części to połączenie, schemat i tabela — a nazwa połączenia to dowolna nazwa. Kolumny ilustracyjne; Twoje tabele będą Twoimi tabelami. Tylko do odczytu dotyczy każdego elementu: tylko SELECT, WITH i EXPLAIN, z ograniczeniem ilości danych, jakie jedno źródło może przekazać w ramach jednego zapytania. Jak działają zapytania federacyjne

Szczegóły połączenia

Czego potrzebuje Koyeb

Gospodarz
ep-<name>-<id>.<region>.pg.koyeb.app — zwróć uwagę na rozszerzenie .pg., które sprawia, że jest to baza danych, a nie aplikacja
Port
5432
Kierowca
Npgsql, przenoszony przez agenta — nic do zainstalowania po stronie Koyeb
Baza danych
koyebdb na nowej usłudze i wstępnie wypełniony jako taki
Nazwa użytkownika
koyeb-adm na nowej usłudze i wstępnie wypełniony jako taki
TLS
Wymagane i wymuszane przez agenta dla każdego hosta .pg.koyeb.app. Szyfrowane; łańcuch certyfikatów nie jest zweryfikowany.
Łączenie
Brak — Koyeb nie potrzebuje żadnego wspólnego punktu końcowego, więc agent łączy się bezpośrednio
Przekroczono limit czasu połączenia
30 sekund, jedna próba
Zapisano jako
PostgreSQL, z Koyebem zachowanym jako odznaka — nie ma typu połączenia o nazwie Koyeb
Schemat domyślny
publiczny, czyli taki, jaki niesie ze sobą odniesienie federacyjne

Jeden z walidatorów nosi tę kartę i warto wyjaśnić, dlaczego warto poświęcić jej osobny rozdział, a nie przypis. Większość błędów połączenia sygnalizuje się sama: nieprawidłowe hasło to błąd uwierzytelniania, nieprawidłowa nazwa bazy danych oznacza, że baza danych nie istnieje. Skierowanie klienta Postgres na nazwę hosta aplikacji nie powoduje żadnych efektów. Powoduje jedynie przekroczenie limitu czasu, ponieważ po drugiej stronie znajduje się prawdziwy host, który po prostu nie nasłuchuje Postgres. Przekroczenie limitu czasu jest traktowane jako problem z siecią, więc ludzie sprawdzają reguły zapory sieciowej, pytają zespół platformy o ruch wychodzący i tracą popołudnie z powodu brakującego pliku .pg. w nazwie hosta. Wykrycie problemu w momencie wklejania jest warte o wiele więcej niż dwie linijki kodu, które to kosztuje.

Wszystko inne w tym łączniku jest szczerze mówiąc nijakie, a strona to mówi, zamiast wymyślać jakieś szczegóły. Koyeb Postgres jest oparty na Neon, agent komunikuje się z nim za pomocą Npgsql przez wymuszony TLS i nie ma żadnego poolera, który by to uwzględniał. To cała historia, a krótsza, prawdziwa historia jest lepsza od dłuższej, pochlebnej.

W przypadku zapytania międzyźródłowego Koyeb to zwykły Postgres. Połączenie o nazwie koyeb_app jest zapisane jako koyeb_app.public.orders i łączy się z folderem plików CSV, lokalnym systemem rekordów lub API rozliczeniowym jednym poleceniem tylko do odczytu — bez kopiowania i planowania.

Dokumentacja dostawcy: www.koyeb.com

Często zadawane pytania

Pytania o Koyeba

Które narzędzia mogą odczytywać dane Koyeba przez strumienie zapytań?

Wszystko z jednego połączenia: Excel, Arkusze Google, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, zaplanowane alerty i raporty. Wystarczy połączyć się z bazą danych raz, a każda powierzchnia odczyta to samo połączenie tylko do odczytu — nie ma potrzeby konfigurowania poszczególnych narzędzi ani tworzenia drugiej kopii danych.

Czy muszę otworzyć port zapory sieciowej dla mojej bazy danych Koyeb?

Nie. Agent sieciowy Query Streams działa w Twojej sieci i otwiera pojedyncze szyfrowane połączenie wychodzące. Nic nie nasłuchuje ruchu przychodzącego, nie jest wymagana sieć VPN, a baza danych zachowuje istniejące reguły zapory sieciowej.

Czy strumienie zapytań mogą zmieniać dane w Koyeb?

Nie. Agent wymusza tryb tylko do odczytu w momencie wykonania — po jednym poleceniu na raz, tylko dla instrukcji SELECT i poleceń znajomych. Dane uwierzytelniające pozostają w agencie i nigdy nie są wysyłane do strumieni zapytań.

Czego potrzebuje Query Streams, aby połączyć się z Koyeb?

Dostępny host, rola i jej hasło — agent przenosi sterownik, więc nic nie jest instalowane w bazie danych. Host: ep-<nazwa>-<id>.<region>.pg.koyeb.app — zwróć uwagę na rozszerzenie .pg., które odróżnia bazę danych od aplikacji. Port: 5432. Sterownik: Npgsql, przenoszony przez agenta — nic nie jest instalowane po stronie Koyeb. Baza danych: koyebdb na nowej usłudze i wstępnie wypełniona.

Czy mogę połączyć bazę danych Koyeb z inną bazą danych w tym samym zapytaniu?

Tak — to jest zapytanie federacyjne. Jedno polecenie może odwoływać się do Koyeba i innych połączeń jednocześnie, zapisane jako connection.schema.table. Każde źródło uruchamia tylko tę część, którą może, i przesyła wynik z powrotem; łączenie odbywa się centralnie, więc źródła nigdy się ze sobą nie łączą i nic nie jest kopiowane ani planowane. Tryb tylko do odczytu dotyczy każdego fragmentu — tylko SELECT, WITH i EXPLAIN — i istnieje limit na to, ile jedno źródło może przekazać w ramach jednego zapytania. Zapytania federacyjne to funkcja planu; strona zapytań federacyjnych zawiera bieżące źródło i limity rozmiaru.

Czy łączenie Koyeba różni się od łączenia PostgreSQL?

Tylko ciąg połączenia. Koyeb obsługuje protokół PostgreSQL Wire Protocol, więc filtry, harmonogramowanie, udostępnianie, dodatki do Excela i Arkuszy Google oraz serwer MCP działają identycznie. Karta Koyeb wstępnie wypełnia ustawienia hosta, portu i SSL, których oczekuje dostawca.

Czy istnieje przewodnik po konwersji Koyeba na Excela?

Tak — to jest przewodnik po PostgreSQL i jest on poprawny dla Koyeba w takiej formie, w jakiej został napisany. Koyeb obsługuje protokół PostgreSQL Wire Protocol, więc połączenie Koyeba z Excelem, Koyeba z Arkuszami Google i każdym innym miejscem docelowym przebiega w ten sam sposób. Jedyną częścią specyficzną dla Koyeba jest ciąg połączenia, a karta Koyeba wypełnia go za Ciebie.

Umieść Koyeba tam, gdzie praca jest wykonywana

Zainstaluj agenta, skieruj go do swojej bazy danych i wybierz miejsce docelowe.

Zacznij za darmo Wszystkie złącza

Tylko do odczytu Tylko wysyłka Dane uwierzytelniające pozostają przy agencie