Logo Xata

PostgreSQL senza server parla PostgreSQL

Collegare Xata per Excel, Fogli Google, IA e REST

Protocollo Xata Postgres over the wire, indirizzato per database e branch. Incolla la stringa dalla console Xata e il branch che hai digitato sarà quello che otterrai.

Un collegamento, ogni superficie

Dove possono essere archiviati i tuoi dati Xata

Query Streams legge i dati Xata da Microsoft Excel, Fogli Google, Power BI, assistenti AI tramite MCP e un endpoint REST attraverso un'unica connessione di sola lettura. Xata utilizza il protocollo di rete di PostgreSQL, quindi l'agente si connette ad esso con Npgsql esattamente come farebbe con qualsiasi altro server PostgreSQL. Una differenza sostanziale: il campo Database è un percorso database:branch anziché un semplice nome, e Xata è l'unico connettore sulla piattaforma il cui nome del database viene trasmesso mantenendo inalterate le maiuscole e le minuscole. Il protocollo TLS è obbligatorio per ogni host .sql.xata.sh, indipendentemente dall'impostazione della casella di controllo.

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

  1. Per il tuo team, i fornitori e i partner
  2. Da Xata a Excel Microsoft Excel · Componente aggiuntivo di Excel

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

    Guida a PostgreSQL
  3. Xata a Fogli Google Componente aggiuntivo Fogli

    Esegui una query Xata 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 Xata Nova AI · conversione da testo a SQL

    Poni una domanda in un linguaggio semplice. Nova conosce già le tue tabelle Xata, 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. Xata to Data Viewer Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso

    Condividi i risultati di una query Xata in tempo reale con chiunque – un collega, un fornitore, un partner – sotto forma di griglia salvabile che si aggiorna automaticamente all'apertura, su smartphone, tablet o computer. L'interlocutore visualizzerà i risultati, senza mai dover scrivere query SQL o richiedere le credenziali.

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

    Pubblica una query Xata come endpoint JSON autenticato che qualsiasi applicazione può richiamare, con una specifica OpenAPI 3.1 e raccolte predefinite per Postman, Insomnia e Hoppscotch. Non viene aperta alcuna porta del database.

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

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

    Come funziona Power BI
  9. Xata ad Airtable Piattaforma di automazione

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

    Guida a PostgreSQL
  10. Xata a Baserow Piattaforma di automazione

    Alimenta una tabella Baserow da Xata tramite l'endpoint REST, sia in locale che nel cloud di Baserow.

    Guida a PostgreSQL
  11. Xata a SeaTable Piattaforma di automazione

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

    Guida a PostgreSQL
  12. Xata a Smartsheet Piattaforma di automazione

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

    Guida a PostgreSQL
  13. Xata all'incudine Anvil Works · Piattaforma per app

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

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

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

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

    Imposta una query Xata su una pianificazione e fai in modo che le righe vengano recapitate a Slack, Discord, via e-mail 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 non ci sono regole in entrata e nessuna informazione sul database viene esposta.

02

Incolla la stringa di connessione dalla console Xata. Da essa vengono letti host, porta, ID dello spazio di lavoro, chiave API e percorso database:branch.

03

Verifica che il campo Database sia impostato su database:branch, ad esempio mydb:main. È accettato anche un nome senza i due punti, che indica implicitamente il ramo predefinito.

04

Ricorda di distinguere le credenziali: il nome utente è l'ID del tuo spazio di lavoro e la password è una chiave API, non la password del tuo account.

05

Salva. Microsoft Excel, Fogli Google, Power BI, MCP e REST leggono tutti il ramo tramite quella singola connessione oppure lo uniscono alle altre origini dati in un'unica istruzione di sola lettura.

Analisi approfondita delle funzionalità

Ciò che Xata ti offre

Il campo Database è un percorso, non un nome

Su tutti gli altri connettori Postgres, il campo Database contiene un identificatore e Query Streams lo converte in minuscolo durante l'elaborazione, perché è così che Postgres gestisce i nomi non racchiusi tra virgolette. Su Xata, questo comportamento sarebbe errato, quindi è l'unico caso in cui la regola è disattivata.

  • Il valore è una coppia database:filiale — mydb:main — che Xata risolve come percorso. Non è un identificatore di Postgres e non segue le regole di ripiegamento degli identificatori.
  • Un ramo chiamato Feature-X mantiene la F maiuscola e la X maiuscola. Convertito in minuscolo in feature-x, smette di essere risolvibile, ed è per questo che Xata è l'unico connettore esentato dalla normalizzazione.
  • Se si omettono i due punti, la connessione funziona comunque. — atterra sul ramo predefinito. La scheda lo segnala invece di lasciarlo passare silenziosamente, perché atterrare sul ramo principale quando si intendeva un ramo secondario produce numeri apparentemente corretti a partire da dati errati.
  • Non viene controllato nient'altro del nome. Query Streams trasmette il percorso così come è stato digitato e lascia che Xata decida se viene risolto.

Cosa fa l'agente con un host Xata

Due comportamenti sono associati al suffisso .sql.xata.sh, e nessuno dei due è configurabile dall'utente.

  • TLS è obbligatorio, non richiesto. Qualsiasi host .sql.xata.sh viene connesso con la crittografia attiva, indipendentemente dall'opzione "Usa SSL", quindi una stringa che ha perso la modalità SSL negli appunti viene comunque trasmessa crittografata.
  • La connessione è crittografata, ma la catena di certificati non è verificata. Questa è la descrizione onesta, ed è la stessa per ogni provider di hosting riconosciuto da Query Streams.
  • Non è presente alcun pooler nel percorso. Alcuni servizi Postgres serverless inseriscono un pooler in modalità transazionale a monte e necessitano di istruzioni preparate bloccate per funzionare; Xata non lo richiede, quindi l'agente si connette direttamente e salta tutto questo passaggio.
  • La connessione viene salvata come PostgreSQL con Xata mantenuto come badge. Non esiste un tipo di connessione chiamato Xata. — il che significa anche che una semplice connessione Postgres stabilita in precedenza con lo stesso host riconoscerà immediatamente il marchio Xata.

Incollalo invece di riscriverlo

Quattro credenziali, due delle quali facili da confondere e una abbastanza lunga da poter essere digitata in modo errato. La carta è progettata per incollare la stringa e intercettare il resto.

  • L'URI postgresql:// dalla console è nel formato previsto. Anche il formato con la parola chiave host= di libpq viene analizzato correttamente.
  • 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.
  • Una chiave API 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.
  • L'ID dell'area di lavoro va nel campo del nome utente e la chiave API nel campo della password. La scheda li etichetta in questo modo anziché indicare semplicemente "Nome utente" e "Password" e lasciare che tu debba indovinare.
-- Postgres ordinario, sola lettura, rispetto al ramo specificato 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 Xata con il resto dei tuoi dati.

Una singola istruzione può estendersi contemporaneamente a Xata 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

Xata PostgreSQL senza server
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     xata_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 Xata

Ospite
<region>.sql.xata.sh
Porto
5432
Autista
Npgsql, trasportato dall'agente: non è necessario installare nulla sul lato Xata.
Database
Un percorso database:branch come mydb:main. Passato mantenendo intatta la capitalizzazione: l'unico connettore in cui ciò è vero
Nome utente
Il tuo ID di spazio di lavoro, non il nome dell'account.
Password
Una chiave API, non la password del tuo account.
TLS
Obbligatorio e imposto dall'agente per ogni host .sql.xata.sh. Crittografato; la catena di certificati non viene verificata.
Pooling
Nessuno — Xata non necessita di endpoint condivisi, quindi l'agente si connette direttamente
Salvato come
PostgreSQL, con Xata mantenuto come badge: non esiste un tipo di connessione chiamato Xata
Schema predefinito
pubblico, che è ciò che un riferimento federato comporta

La regola di capitalizzazione è il motivo principale per cui esiste questa scheda, invece di rimandare gli utenti alla semplice scheda PostgreSQL. Query Streams converte in minuscolo i nomi dei database Postgres durante l'elaborazione, il che è corretto ovunque: un identificatore non racchiuso tra virgolette viene convertito in minuscolo in Postgres, quindi preservare ciò che è stato digitato creerebbe solo confusione. Il campo Database di Xata non è affatto un identificatore. È un percorso composto da un database e un ramo uniti da due punti, e Xata legge letteralmente la parte del ramo. Se la si converte, un ramo chiamato Feature-X diventa feature-x e smette di essere risolto. Quindi Xata è esentato, ed è l'unico connettore sulla piattaforma ad esserlo.

L'errore che l'esenzione previene è insidioso, perché non si presenta come tale. Un percorso di diramazione errato di solito non genera un errore: ti porta comunque da qualche parte. Una query sul ramo sbagliato restituisce delle righe, che sembrano dati, e nulla nel risultato indica che stai leggendo lo schema del mese scorso invece di quello di questa settimana. Lo stesso ragionamento spiega perché un nome di database senza due punti viene segnalato: funziona, indica silenziosamente il ramo predefinito, e un foglio di calcolo pieno di "main" quando intendevi un ramo di funzionalità è peggio di un messaggio di errore.

Per una query cross-source, Xata è un normale database PostgreSQL. Una connessione chiamata xata_app viene scritta come xata_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 pianificare alcuna operazione. Il ramo scelto nella connessione è quello che viene letto durante la connessione.

Documentazione del fornitore: xata.io

FAQ

Domande su Xata

Quali strumenti sono in grado di leggere i dati Xata 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 Xata?

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 Xata 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 Xata?

Un host raggiungibile, un ruolo e la relativa password: l'agente trasporta il driver, quindi non viene installato nulla sul database. Host: <region>.sql.xata.sh. Porta: 5432. Driver: Npgsql, trasportato dall'agente: non c'è nulla da installare sul lato Xata. Database: una rotta database:branch come mydb:main. Passata con la sua capitalizzazione intatta: l'unico connettore in cui ciò è vero.

Posso unire Xata a un altro database nella stessa query?

Sì, si tratta di una query federata. Un'unica istruzione può fare riferimento a Xata 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 Xata è diversa dalla connessione a PostgreSQL?

Solo la stringa di connessione. Xata 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 Xata precompila le impostazioni di host, porta e SSL previste dal provider.

Esiste una guida per convertire Xata in Excel?

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

Metti Xata 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