Logo PlanetScale Postgres

Zarządzany Postgres mówi po PostgreSQL

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

PlanetScale Postgres, bezpośrednio na 5432 lub przez PSBouncer na 6432. Jest to produkt Postgres, nie Vitess.

Jedno połączenie, każda powierzchnia

Gdzie mogą trafić Twoje dane PlanetScale

Query Streams odczytuje dane z PlanetScale 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. Ta karta jest przeznaczona specjalnie dla PlanetScale Postgres — nowszego produktu w .horizon.psdb.cloud — a nie dla usługi MySQL opartej na platformie Vitess, z której PlanetScale jest bardziej znane. Karta domyślnie obsługuje port PSBouncer na porcie 6432, gdzie oczekuje większość baz danych PlanetScale Postgres, a agent wyłącza przygotowane instrukcje, aby to dostosować.

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

  1. Dla Twojego zespołu, dostawców i partnerów
  2. PlanetScale do Excela Microsoft Excel · Dodatek do programu Excel

    Pobierz wyniki PlanetScale 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. PlanetScale do Arkuszy Google Dodatek Arkuszy

    Uruchom zapisane zapytanie PlanetScale 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 PlanetScale Nova AI · tekst do SQL

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

    Jak działa Nova
  5. PlanetScale do przeglądarki danych udostępnianie wyników · zespół, dostawcy, partnerzy · telefon, tablet, komputer stacjonarny

    Udostępnij wynik PlanetScale 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 stacjonarnym. Widzą wyniki, a nie kod SQL ani dane uwierzytelniające.

    Jak działa Przeglądarka danych
  6. Do aplikacji i systemów
  7. Interfejs API REST PlanetScale Punkt końcowy HTTP

    Opublikuj zapytanie PlanetScale 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. PlanetScale do Power BI Power Query M

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

    Jak działa Power BI
  9. PlanetScale do Airtable Platforma automatyzacji

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

    Przewodnik po PostgreSQL
  10. PlanetScale do Baserow Platforma automatyzacji

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

    Przewodnik po PostgreSQL
  11. PlanetScale do SeaTable Platforma automatyzacji

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

    Przewodnik po PostgreSQL
  12. PlanetScale do Smartsheet Platforma automatyzacji

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

    Przewodnik po PostgreSQL
  13. PlanetScale do Anvil Anvil Works · Platforma aplikacji

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

    Przewodnik po PostgreSQL
  14. Dla narzędzi AI
  15. Serwer PlanetScale MCP Klienci Claude, Cursor i MCP

    Udziel asystentowi AI dostępu tylko do odczytu w PlanetScale, podając schemat, którego potrzebuje do poprawnego pisania kodu SQL — bez konieczności podawania danych uwierzytelniających w czacie.

    Przewodnik po PostgreSQL
  16. Dostarczone do ludzi
  17. Alerty i raporty PlanetScale Slack · Discord · E-mail · Webhook

    Utwórz harmonogram zapytania PlanetScale 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, dzięki czemu PlanetScale widzi zwykłego klienta, a Twoja sieć nie potrzebuje reguły przychodzącej.

02

Skopiuj ciąg z bazy danych, następnie połącz się z konsolą PlanetScale i wklej go. Odczytany zostanie zarówno formularz postgresql://, jak i formularz ze słowem kluczowym host=.

03

Pozostaw tryb w puli PSBouncer, chyba że masz ku temu powód — port 6432 na tym samym hoście, do którego PlanetScale kieruje Cię domyślnie.

04

Sprawdź, czy nazwa użytkownika zawiera kropkę. Nazwy użytkowników PlanetScale wyglądają tak: postgres.<database-id>, a część po kropce kieruje do właściwej bazy danych.

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 daje Ci PlanetScale

To jest PlanetScale Postgres, nie PlanetScale MySQL

PlanetScale przez lata działało pod nazwą Vitess, warto więc jasno określić, z którym produktem łączy się ta karta.

  • To złącze jest przeznaczone dla PlanetScale Postgres — zarządzana usługa Postgres na .horizon.psdb.cloud. Obsługuje protokół Postgres Wire Protocol, a agent łączy się z nią za pomocą Npgsql.
  • Karta nie jest przeznaczona do obsługi usługi MySQL obsługiwanej przez Vitess. Nie ma do tego żadnych ustawień wstępnych, a ciąg połączenia MySQL z PlanetScale nie będzie pasował do tej karty.
  • Połączenie jest zapisywane jako PostgreSQL z PlanetScale jako odznaką. Nie ma typu połączenia o nazwie PlanetScale. — co oznacza również, że zwykłe połączenie Postgres, które wcześniej nawiązałeś z hostem .horizon.psdb.cloud, od razu przejmie branding.
  • Wszystko, co następuje dalej, to zwykły Postgres: schematy, typy i publiczny schemat domyślny w referencjach międzyźródłowych.

PSBouncer jest domyślny, a port decyduje

PlanetScale uruchamia swój pooler na tej samej nazwie hosta co bezpośredni punkt końcowy, jeden port dalej. Karta domyślnie przekierowuje do poolera, ponieważ PlanetScale kieruje Cię właśnie tam.

  • Bezpośrednio jest port 5432. PSBouncer — Pula transakcji PlanetScale — znajduje się na porcie 6432 na tym samym hoście. Nic innego się między nimi nie zmienia.
  • Na 6432 agent wyłącza przygotowane instrukcje i przestaje resetować sesję po jej zamknięciu. Pula transakcji może przekazać Ci inny back-end między instrukcjami, a sterownik, który zakłada inaczej, zawodzi w sposób, który wygląda na losowy.
  • To port, a nie lista rozwijana, uruchamia tę opcję. Lista rozwijana istnieje po to, aby karta mogła uniemożliwić dwóm osobom wybór: wybór puli z niewłaściwym portem lub bezpośrednie połączenie z 6432, i informuje o tym przed zapisaniem, a nie po pierwszej dziwnej awarii.
  • Nie ma oddzielnej, wspólnej nazwy hosta do zapamiętania ani drugiego zestawu danych uwierzytelniających. Wystarczy zmienić port i przełącznik będzie działał.

Nazwa użytkownika ma kropkę i to ma znaczenie

W dwóch z czterech pól łatwo popełnić subtelny błąd, dlatego karta sprawdza oba.

  • Nazwy użytkowników PlanetScale mają format postgres.<id-bazy-danych>. Wklej nazwę bez kropki, a karta się zatrzyma, ponieważ część po kropce wybiera bazę danych.
  • Hasło ze spacją na początku lub na końcu jest oznaczane. Jest to artefakt schowka i jest traktowane jako zwykły błąd uwierzytelniania, co powoduje, że użytkownicy szukają niewłaściwego problemu.
  • Wszystko, co nie jest ciągiem połączenia Postgres, jest odrzucane z komunikatem wskazującym miejsce, w którym znajduje się właściwy ciąg, zamiast być analizowane w niewłaściwych polach.
  • Wklejony ciąg znaków nigdy nie jest przechowywany. Jest odczytywany raz, aby wypełnić formularz, a następnie usuwany, więc hasło znajduje się w jednym miejscu, a nie w dwóch.
-- Zwykły Postgres, tylko do odczytu, przez PSBouncer lub bezpośrednio 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

Połącz PlanetScale z resztą swoich danych

Jedno polecenie może obejmować jednocześnie PlanetScale i inne połączenia. 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

PlanetScale Postgres Zarządzany 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     ps_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 PlanetScale

Gospodarz
<nazwa>.<region>.horizon.psdb.cloud
Port
6432 dla PSBouncer, 5432 bezpośrednio. Ten sam host w obu przypadkach — karta domyślnie ma 6432
Kierowca
Npgsql, przenoszony przez agenta — nic do zainstalowania po stronie PlanetScale
Nazwa użytkownika
Kropkowane, jak postgres.<database-id>. Karta sprawdza, czy kropka jest obecna.
TLS
Wymagane i wymuszane przez agenta dla każdego hosta .horizon.psdb.cloud. Szyfrowane; łańcuch certyfikatów nie jest zweryfikowany.
Łączenie
W przypadku 6432 agent wyłącza przygotowane instrukcje i pomija resetowanie sesji, co jest niezbędne dla puli transakcji
Zapisano jako
PostgreSQL z PlanetScale zachowanym jako odznaka — nie ma typu połączenia o nazwie PlanetScale
Nie ta karta
Usługa MySQL firmy PlanetScale oparta na systemie Vitess. Ten preset jest dostępny tylko w produkcie Postgres.
Schemat domyślny
publiczny, czyli taki, jaki niesie ze sobą odniesienie federacyjne

Szczegóły dotyczące poolera zasługują na swoje miejsce. PlanetScale przełącza PSBouncer w tryb transakcji, co oznacza, że utrzymywane połączenie nie jest przypięte do jednego zaplecza — między dwoma poleceniami można je przenieść. Sterownik Postgres pozostawiony przy domyślnych ustawieniach zakłada coś przeciwnego: przygotowuje polecenia raz i oczekuje, że będą one nadal dostępne następnym razem, a sesja resetuje się przy zamknięciu. W przypadku poolera transakcji oba założenia ulegają awarii, i to okresowo, co jest najgorszym sposobem na awarię czegokolwiek. Agent wyłącza oba, gdy widzi port 6432, więc nie musisz o tym wiedzieć.

Podanie granicy produktu również nie jest pedanterią. PlanetScale słynie z Vitess, więc ktoś, kto przychodzi tutaj z ciągiem połączenia PlanetScale w ręku, może mieć w ręku ciąg MySQL. Otwarte stwierdzenie, że ta karta to usługa Postgres — a produkt Vitess nie ma żadnych ustawień wstępnych — kosztuje zdanie i oszczędza czas na rozmowę z pomocą techniczną.

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

Dokumentacja dostawcy: planetscale.com

Często zadawane pytania

Pytania dotyczące PlanetScale Postgres

Które narzędzia mogą odczytywać dane PlanetScale Postgres przez Query Streams?

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 PlanetScale Postgres?

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 PlanetScale Postgres?

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 PlanetScale Postgres?

Dostępny host, rola i jej hasło — agent przenosi sterownik, więc nic nie jest instalowane w bazie danych. Host: <nazwa>.<region>.horizon.psdb.cloud. Port: 6432 dla PSBouncer, 5432 bezpośrednio. Ten sam host w obu przypadkach — karta domyślnie ma port 6432. Sterownik: Npgsql, przenoszony przez agenta — nic do zainstalowania po stronie PlanetScale. Nazwa użytkownika: kropkowana, jako postgres.<identyfikator-bazy-danych>. Karta sprawdza, czy kropka jest obecna.

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

Tak — to jest zapytanie federacyjne. Jedno polecenie może odwoływać się do PlanetScale Postgres 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 PlanetScale Postgres różni się od łączenia PostgreSQL?

Tylko ciąg połączenia. PlanetScale Postgres 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 PlanetScale wstępnie wypełnia ustawienia hosta, portu i SSL, których oczekuje dostawca.

Czy istnieje przewodnik po konwersji PlanetScale na Excel?

Tak — to przewodnik po PostgreSQL i jest on poprawny dla PlanetScale Postgres w obecnej formie. PlanetScale obsługuje protokół PostgreSQL Wire Protocol, więc połączenia z PlanetScale do Excela, z PlanetScale do Arkuszy Google i z każdego innego miejsca docelowego przebiegają w ten sam sposób. Jedyną częścią specyficzną dla PlanetScale jest ciąg połączenia, który wypełnia karta PlanetScale.

Umieść PlanetScale tam, gdzie wykonywana jest praca

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

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