Logo di PlanetScale Postgres

PostgreSQL gestito parla PostgreSQL

Collegare PlanetScale Postgres per Excel, Fogli Google, IA e REST

PlanetScale Postgres, direttamente sulla porta 5432 o tramite PSBouncer sulla porta 6432. Si tratta del prodotto Postgres, non di quello Vitess.

Un collegamento, ogni superficie

Dove possono essere archiviati i tuoi dati PlanetScale

Query Streams legge i dati da PlanetScale Postgres provenienti da Microsoft Excel, Fogli Google, Power BI, assistenti AI tramite MCP e un endpoint REST attraverso un'unica connessione di sola lettura. Questa scheda è specifica per PlanetScale Postgres, il prodotto più recente disponibile su .horizon.psdb.cloud, e non per il servizio MySQL basato su Vitess per cui PlanetScale è più conosciuto. La scheda utilizza di default PSBouncer sulla porta 6432, la porta prevista dalla maggior parte dei database PlanetScale Postgres, e l'agente disattiva le istruzioni preparate di conseguenza.

PlanetScale Postgres è PostgreSQL in rete — il driver standard, quindi ogni guida seguente si applica senza modifiche. L'unica parte specifica di PlanetScale è la stringa di connessione, trattata in dettagli di connessione.

  1. Per il tuo team, i fornitori e i partner
  2. PlanetScale to Excel Microsoft Excel · Componente aggiuntivo di Excel

    Importa i risultati in tempo reale di PlanetScale direttamente in un foglio di calcolo e aggiornali a piacimento: su Excel desktop, Excel Online e Microsoft 365.

    Guida a PostgreSQL
  3. PlanetScale su Fogli Google Componente aggiuntivo Fogli

    Esegui una query PlanetScale salvata dalla barra laterale e trascina le righe nel foglio. I collaboratori che condividono il foglio possono aggiornarlo autonomamente.

    Guida a PostgreSQL
  4. Chiedi a Nova informazioni su PlanetScale Nova AI · conversione da testo a SQL

    Poni una domanda in un linguaggio semplice. Nova conosce già le tue tabelle PlanetScale, scrive ed esegue la query SQL, spiega la risposta e la rappresenta graficamente: non è necessario scrivere alcuna query né fornire credenziali.

    Come funziona la rosa
  5. PlanetScale to Data Viewer Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso

    Condividi i risultati di PlanetScale in tempo reale con chiunque – un collega, un fornitore, un partner – sotto forma di griglia salvabile che si aggiorna automaticamente all'apertura, su telefono, tablet o computer. L'interlocutore visualizzerà i risultati, senza mai dover accedere al codice SQL o alle credenziali.

    Come funziona il visualizzatore di dati
  6. Per app e sistemi
  7. API REST di PlanetScale Endpoint dell'HT

    Pubblica una query PlanetScale come endpoint JSON autenticato, accessibile a qualsiasi applicazione, con specifiche OpenAPI 3.1 e raccolte predefinite per Postman, Insomnia e Hoppscotch. Non viene aperta alcuna porta del database.

    Guida a PostgreSQL
  8. PlanetScale a Power BI Power Query M

    Incolla la query Power Query M generata nell'editor avanzato di Power BI e il report visualizzerà i risultati di PlanetScale in tempo reale tramite HTTPS, senza bisogno di driver ODBC o porte di database aperte.

    Come funziona Power BI
  9. PlanetScale su Airtable Piattaforma di automazione

    Sincronizza le righe di PlanetScale con un database Airtable a intervalli regolari, oppure recuperale tramite uno script di automazione di Airtable.

    Guida a PostgreSQL
  10. PlanetScale a Baserow Piattaforma di automazione

    È possibile alimentare una tabella Baserow da PlanetScale tramite l'endpoint REST, sia in locale che nel cloud di Baserow.

    Guida a PostgreSQL
  11. PlanetScale a SeaTable Piattaforma di automazione

    Mantieni aggiornato il database di SeaTable con i dati di PlanetScale senza esportare un file o esporre il database stesso.

    Guida a PostgreSQL
  12. PlanetScale a Smartsheet Piattaforma di automazione

    Trasferisci i risultati di PlanetScale in una griglia di Smartsheet in modo che i piani e i report vengano letti dal sistema di origine e non dall'esportazione della settimana precedente.

    Guida a PostgreSQL
  13. PlanetScale ad Anvil Anvil Works · Piattaforma per app

    Esegui il backup di un'app Anvil Python con PlanetScale tramite l'endpoint REST anziché incorporare le credenziali del database nell'app.

    Guida a PostgreSQL
  14. Per gli strumenti di intelligenza artificiale
  15. Server PlanetScale MCP Clienti di Claude, Cursor e MCP

    Concedi a un assistente IA l'accesso in sola lettura a PlanetScale con lo schema necessario per scrivere codice SQL corretto, senza fornire credenziali nella chat.

    Guida a PostgreSQL
  16. Consegnato alle persone
  17. Avvisi e segnalazioni di PlanetScale Slack · Discord · Email · Webhook

    Imposta una query PlanetScale in modo che venga eseguita a intervalli regolari e i risultati vengano recapitati a Slack, Discord, via email o tramite un webhook firmato, oppure trattieni il messaggio finché il numero di righe, una soglia o una variazione percentuale non superano il valore da te impostato.

    Come funzionano gli avvisi e i report

Come funziona

5 passaggi, nessuna modifica al firewall in entrata

01

Installa l'agente di rete dove preferisci. Apre una sola connessione in uscita e non rimane mai in ascolto, quindi PlanetScale lo vede come un normale client e la tua rete non necessita di alcuna regola in entrata.

02

Copia la stringa dal database, quindi connettiti nella console di PlanetScale e incollala. Vengono letti sia il formato postgresql:// che il formato con parola chiave host=.

03

Lascia la modalità su PSBouncer Pool a meno che tu non abbia un motivo per non farlo: la porta 6432 sullo stesso host è quella a cui PlanetScale punta per impostazione predefinita.

04

Verifica che il nome utente abbia mantenuto il punto. I nomi utente di PlanetScale hanno un formato simile a postgres.<database-id>, e la parte dopo il punto è quella che ti indirizza al database corretto.

05

Salva. Microsoft Excel, Fogli Google, Power BI, MCP e REST leggono tutti tramite quella singola connessione oppure possono essere uniti ad altre origini dati in un'unica istruzione di sola lettura.

Analisi approfondita delle funzionalità

Cosa ti offre PlanetScale

Questo è PlanetScale Postgres, non PlanetScale MySQL

PlanetScale è stata per anni l'azienda Vitess, quindi vale la pena essere chiari su a quale prodotto si collega questa scheda.

  • Questo connettore è per PlanetScale Postgres — il servizio Postgres gestito su .horizon.psdb.cloud. Utilizza il protocollo di rete di Postgres e l'agente si connette ad esso tramite Npgsql.
  • Non è compatibile con il servizio MySQL supportato da Vitess. Non esiste un preset per questo, e una stringa di connessione MySQL di PlanetScale non è adatta a questa scheda.
  • La connessione viene salvata come PostgreSQL con PlanetScale come badge. Non esiste un tipo di connessione chiamato PlanetScale. — il che significa anche che una semplice connessione Postgres stabilita in precedenza a un host .horizon.psdb.cloud riconoscerà immediatamente il marchio.
  • Tutto ciò che segue è il normale PostgreSQL: schemi, tipi e "public" come schema predefinito in un riferimento tra diverse fonti.

PSBouncer è l'impostazione predefinita e la porta è ciò che decide

PlanetScale esegue il suo pooler sullo stesso hostname dell'endpoint diretto, su una porta diversa. La scheda ti indirizza automaticamente al pooler perché è a quello che PlanetScale ti indirizza.

  • La porta diretta è la 5432. PSBouncer Il transaction pooler di PlanetScale utilizza la porta 6432 sullo stesso host. Non cambia nient'altro tra i due.
  • Sulla porta 6432 l'agente disattiva le istruzioni preparate e smette di reimpostare la sessione alla chiusura. Un gestore di transazioni può passare un backend diverso tra le istruzioni e un driver che presuppone il contrario fallisce in modi che sembrano casuali.
  • È la porta che innesca questo problema, non il menu a tendina. Il menu a tendina esiste affinché la scheda possa impedire che le due impostazioni siano in conflitto: ad esempio, se si sceglie la connessione in pool con la porta sbagliata o la connessione diretta a 6432, e lo segnala prima del salvataggio, anziché dopo il primo errore anomalo.
  • Non c'è un nome host condiviso da ricordare e non è necessario un secondo set di credenziali. Basta cambiare la porta, e il gioco è fatto.

Il nome utente contiene un punto, ed è importante

Due dei quattro campi sono facili da sbagliare anche solo di poco, quindi la scheda li controlla entrambi.

  • I nomi utente di PlanetScale hanno il formato postgres.<database-id>. Se si incolla un nome utente senza il punto, la scheda blocca l'accesso, perché la parte successiva al punto è quella che seleziona il database.
  • Una password con spazi bianchi all'inizio o alla fine viene segnalata. Si tratta di un artefatto degli appunti e viene interpretata come un normale errore di autenticazione, il che porta gli utenti a cercare il problema sbagliato.
  • Qualsiasi elemento che non sia una stringa di connessione a PostgreSQL viene rifiutato con un messaggio che indica dove si trova quella corretta, anziché essere parzialmente analizzato e inserito in campi errati.
  • La stringa incollata non viene mai memorizzata. Viene letta una sola volta per compilare il modulo e poi eliminata, quindi la password risiede in un unico posto anziché in due.
-- Postgres ordinario, sola lettura, tramite PSBouncer o direttamente SELECT c.name, COUNT(o.id) AS orders, SUM(o.amount) AS revenue FROM public.customers AS c JOIN public.orders AS o ON o.customer_id = c.id WHERE o.placed_at >= now() - interval '30 days' GROUP BY c.name ORDER BY revenue DESC;

Condiviso da ogni connettore di database

Vero per ogni connettore di database

  • Solo in uscita — l'agente apre una connessione crittografata verso Query Streams. Nessuna porta in entrata da inoltrare, nessuna VPN, nessuna lista IP consentita, nessuna informazione sul database esposta a Internet.
  • Le credenziali restano al loro posto — Il nome utente e la password del database risiedono sul computer su cui è installato l'agente. Query Streams non li riceve mai e non può accedere al database autonomamente.
  • Sola lettura, forzata — un'istruzione alla volta, solo SELECT e simili. Una scrittura viene rifiutata sulla propria macchina prima ancora di essere inviata al server, anziché fare affidamento su un permesso che qualcuno si è ricordato di impostare.
  • Distribuisci tutti gli agenti che desideri — uno per sito, regione o cloud. Tutte le fonti di dati che possono visualizzare vengono visualizzate in un unico menu a tendina, quindi nessuno deve sapere quale agente ospita cosa.

Ecco cosa si ottiene una volta salvata una query.

  • Condividi la funzionalità, non l'SQL — un collega o un partner esterno può eseguire la tua query e modificarne i filtri senza mai visualizzare l'istruzione sottostante.
  • Filtri da entrambe le direzioni — dichiarali tu stesso come @variabili, oppure lascia che il connettore rilevi i valori letterali già presenti nella clausola WHERE e li offra come menu a tendina.
  • Leggilo ovunque Microsoft Excel, Fogli Google, Power BI, l'API REST, gli assistenti AI tramite MCP, Query Builder e Nova leggono tutti la stessa query salvata.
  • Eseguine diversi contemporaneamente — cinque query salvate in cinque schede di fogli di lavoro, eseguite simultaneamente, indipendentemente dalle dimensioni dei risultati.
  • Collegalo a qualsiasi altro dispositivo che hai già connesso. — un altro database, un'API aziendale o una cartella di file, in un'unica istruzione di sola lettura.

SQL tra sorgenti diverse

Integra PlanetScale con il resto dei tuoi dati.

Una singola istruzione può estendersi contemporaneamente a PlanetScale e alle altre connessioni. Ogni sorgente esegue solo la parte che può, trasmette il risultato e l'unione avviene centralmente: le sorgenti non comunicano mai tra loro e nulla viene copiato da nessuna parte.

3 connessioni · 3 agenti

PlanetScale Postgres PostgreSQL gestito
Microsoft SQL Server Motore relazionale
Striscia Pagamenti e fatturazione

Una dichiarazione

-- niente copiato, niente unito, niente programmato
SELEZIONARE   c.region, COUNT(*) AS ordini, SUM(i.amount_due) AS fatturati
DA     ps_app.ordini pubblici1    f
CONGIUNGERE     erp_sql.dbo.clienti2   c ON c.id = f.customer_id
CONGIUNGERE     fatturazione.stripe.invoices3 i ON i.customer = c.stripe_id
GRUPPO PER c.regione
ORDINATO DA fatturata DESCRIZIONE;

Le tre parti sono connessione, schema e tabella, e il nome della connessione è quello che le hai assegnato. Le colonne sono a scopo illustrativo; le tue tabelle saranno le tue tabelle. La modalità di sola lettura si applica a ogni elemento: solo SELECT, WITH ed EXPLAIN, con un limite massimo alla quantità di dati che una singola fonte può fornire per una singola query. Come funzionano le query federate

Dettagli di connessione

Di cosa ha bisogno PlanetScale

Ospite
<nome>.<regione>.horizon.psdb.cloud
Porto
6432 per PSBouncer, 5432 direttamente. Stesso host in entrambi i casi: la scheda utilizza di default la porta 6432.
Autista
Npgsql, gestito dall'agente: non è necessario installare nulla sul lato PlanetScale.
Nome utente
Puntato, come postgres.<database-id>. La scheda controlla che il punto sia presente
TLS
Obbligatorio e imposto dall'agente per ogni host .horizon.psdb.cloud. Crittografato; la catena di certificati non è verificata.
Pooling
Sulla porta 6432 l'agente disabilita le istruzioni preparate e salta il ripristino della sessione, che è ciò di cui ha bisogno un pool di transazioni.
Salvato come
PostgreSQL, con PlanetScale mantenuto come badge: non esiste un tipo di connessione chiamato PlanetScale
Non questa carta
Servizio MySQL di PlanetScale basato su Vitess. Questo preset è solo per il prodotto Postgres.
Schema predefinito
pubblico, che è ciò che un riferimento federato comporta

Il dettaglio del pooler è quello che merita di essere menzionato. PlanetScale imposta PSBouncer in modalità transazionale, il che significa che la connessione che mantieni non è vincolata a un singolo backend: puoi essere spostato tra due istruzioni. Un driver Postgres lasciato con le impostazioni predefinite presuppone l'opposto: prepara le istruzioni una sola volta e si aspetta che siano ancora disponibili la volta successiva, e reimposta la sessione alla chiusura. Con un pooler transazionale, entrambi i presupposti vengono meno, e in modo intermittente, che è il peggior modo possibile per un sistema di non funzionare. L'agente disattiva entrambi i presupposti quando rileva la porta 6432, quindi non è necessario che tu ne sia a conoscenza.

Specificare chiaramente il confine tra i prodotti non è pedanteria. PlanetScale è famosa per Vitess, quindi chi arriva qui con una stringa di connessione PlanetScale potrebbe benissimo averne una per MySQL. Dire chiaramente che questa scheda si riferisce al servizio PostgreSQL e che il prodotto Vitess non ha impostazioni predefinite costa una frase e risparmia una conversazione con l'assistenza.

Per una query cross-source, PlanetScale si comporta come un normale PostgreSQL. Una connessione chiamata ps_app viene scritta come ps_app.public.orders e si connette a una cartella di file CSV, a un sistema di registrazione locale o a un'API di fatturazione con un'unica istruzione di sola lettura, senza copiare nulla e senza alcuna pianificazione.

Documentazione del fornitore: planetscale.com

FAQ

Domande su PlanetScale Postgres

Quali strumenti sono in grado di leggere i dati di PlanetScale Postgres tramite Query Streams?

Tutto questo, da un'unica connessione: Excel, Fogli Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, avvisi e report programmati. Collega il database una sola volta e ogni strumento leggerà la stessa connessione di sola lettura: non è necessaria alcuna configurazione per ogni strumento e non ci sono seconde copie dei dati.

Devo aprire una porta del firewall per il mio database PlanetScale Postgres?

No. L'agente di rete di Query Streams viene eseguito all'interno della rete locale e apre una singola connessione crittografata in uscita. Nessun sistema intercetta il traffico in entrata, non è necessaria una VPN e il database mantiene le regole del firewall esistenti.

È possibile modificare i dati in PlanetScale Postgres tramite Query Streams?

No. L'agente impone la sola lettura nel punto di esecuzione: un'istruzione alla volta, solo SELECT e simili. Le credenziali rimangono sull'agente e non vengono mai inviate a Query Streams.

Di cosa ha bisogno Query Streams per connettersi a PlanetScale Postgres?

Un host raggiungibile, un ruolo e la relativa password: l'agente include il driver, quindi non viene installato nulla sul database. Host: <nome>.<regione>.horizon.psdb.cloud. Porta: 6432 per PSBouncer, 5432 diretta. Lo stesso host in entrambi i casi: la scheda utilizza di default la porta 6432. Driver: Npgsql, incluso nell'agente: non è necessario installare nulla sul lato PlanetScale. Nome utente: con il punto, come postgres.<database-id>. La scheda verifica la presenza del punto.

Posso unire PlanetScale Postgres a un altro database nella stessa query?

Sì, si tratta di una query federata. Un'unica istruzione può fare riferimento a PlanetScale Postgres e alle altre connessioni contemporaneamente, come indicato in connection.schema.table. Ogni origine esegue solo la parte di cui è competente e restituisce il risultato; l'unione avviene centralmente, quindi le origini non si connettono mai tra loro e nulla viene copiato o pianificato. La modalità di sola lettura si applica a ogni parte (solo SELECT, WITH ed EXPLAIN) e esiste un limite massimo alla quantità di dati che una singola origine può cedere per una singola query. Le query federate sono una funzionalità del piano; la pagina delle query federate riporta i limiti attuali relativi alle origini e alle dimensioni.

La connessione a PlanetScale Postgres è diversa dalla connessione a PostgreSQL?

Solo la stringa di connessione. PlanetScale Postgres utilizza il protocollo di rete di PostgreSQL, quindi filtri, pianificazione, condivisione, i componenti aggiuntivi per Excel e Fogli Google e il server MCP si comportano tutti allo stesso modo. La scheda PlanetScale precompila le impostazioni di host, porta e SSL previste dal provider.

Esiste una guida per convertire PlanetScale in Excel?

Sì, si tratta della guida per PostgreSQL, ed è corretta per PlanetScale Postgres così come è scritta. PlanetScale utilizza il protocollo di rete di PostgreSQL, quindi la connessione da PlanetScale a Excel, da PlanetScale a Fogli Google e a qualsiasi altra destinazione segue gli stessi passaggi. L'unica parte specifica di PlanetScale è la stringa di connessione, che viene compilata automaticamente nella scheda di PlanetScale.

Posiziona PlanetScale dove si lavora

Installa l'agente, configuralo per connettersi al tuo database e scegli una destinazione.

Sola lettura Solo in uscita Le credenziali rimangono sull'agente