Postgres tanpa server berbicara PostgreSQL
Menghubungkan Xata ke Excel, Google Sheets, AI, dan REST
Protokol komunikasi Xata Postgres melalui jaringan, diidentifikasi berdasarkan basis data dan cabang. Tempelkan string dari konsol Xata dan cabang yang Anda ketik adalah cabang yang Anda dapatkan.
Satu koneksi, setiap permukaan
Ke mana data Xata Anda dapat pergi?
- 1 koneksi keluar
- 0 port masuk
- hanya baca · kredensial tetap di tempatnya
berjalan pada
- Untuk tim, vendor, dan mitra Anda
-
Excel add-in · refresh on demand
-
Lembar Kerja Google tambahan · penyegaran sesuai permintaan
-
Nova AI bertanya dengan bahasa Inggris sederhana · teks ke SQL
-
Penampil Data Bagikan hasil langsung · tim, vendor, mitra · perangkat apa pun
- Untuk aplikasi dan sistem
-
API REST Endpoint JSON · OpenAPI 3.1
-
Power BI Power Query M
-
Sinkronisasi terjadwal Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- Untuk alat AI
-
Asisten AI Claude · Kursor · Server MCP
- Dikirimkan kepada orang-orang
-
Peringatan & laporan Slack · Discord · Email · Webhook
Query Streams membaca Xata dari Microsoft Excel, Google Sheets, Power BI, asisten AI melalui MCP dan endpoint REST melalui satu koneksi baca saja. Xata menggunakan protokol wire Postgres, sehingga agen terhubung ke sana dengan Npgsql persis seperti halnya ke Postgres lainnya. Satu hal yang benar-benar berbeda: kolom Database adalah rute database:branch dan bukan nama biasa, dan Xata adalah satu-satunya konektor di platform yang nama databasenya diteruskan dengan kapitalisasi yang utuh. TLS diberlakukan untuk setiap host .sql.xata.sh terlepas dari apa pun yang tertulis di kotak centang.
Xata adalah PostgreSQL yang dikirim melalui jaringan. — driver standar, jadi setiap panduan di bawah ini berlaku tanpa perubahan. Satu-satunya bagian khusus Xata adalah string koneksi, yang dibahas di bawah ini. detail koneksi.
- Untuk tim, vendor, dan mitra Anda
-
Xata ke Excel Microsoft Excel · Add-in Excel
Ambil hasil Xata secara langsung ke dalam lembar kerja dan perbarui sesuai kebutuhan — Excel desktop, Excel Online, Microsoft 365.
Panduan PostgreSQL -
Xata ke Google Sheets Tambahan lembar
Jalankan kueri Xata yang tersimpan dari bilah sisi dan seret baris ke dalam lembar kerja. Kolaborator yang berbagi dapat memperbaruinya sendiri.
Panduan PostgreSQL -
Tanyakan pada Nova tentang Xata Nova AI · teks ke SQL
Ajukan pertanyaan dalam bahasa Inggris yang mudah dipahami. Nova sudah mengetahui tabel Xata Anda, menulis dan menjalankan SQL, menjelaskan jawabannya, dan membuat grafiknya — tidak perlu menulis kueri, tidak perlu memberikan kredensial.
Cara kerja Nova -
Xata ke Penampil Data Berbagi hasil · tim, vendor, mitra · telepon, tablet, desktop
Bagikan hasil Xata secara langsung dengan siapa pun — kolega, vendor, mitra — sebagai tabel yang dapat di-bookmark dan akan berjalan ulang saat dibuka, di ponsel, tablet, atau desktop. Mereka hanya melihat hasilnya, bukan kode SQL atau kredensialnya.
Cara kerja Penampil Data - Untuk aplikasi dan sistem
-
API REST Xata Titik akhir HTTP
Publikasikan kueri Xata sebagai titik akhir JSON terautentikasi yang dapat dipanggil oleh aplikasi apa pun, dengan spesifikasi OpenAPI 3.1 dan koleksi siap pakai untuk Postman, Insomnia, dan Hoppscotch. Tidak ada port basis data yang dibuka.
Panduan PostgreSQL -
Xata ke Power BI Power Query M
Tempelkan Power Query M yang dihasilkan ke dalam Power BI Advanced Editor dan laporan akan membaca hasil Xata secara langsung melalui HTTPS — tanpa driver ODBC, tanpa port basis data yang dibuka.
Cara kerja Power BI -
Xata ke Airtable Platform otomatisasi
Sinkronkan baris Xata ke dalam basis data Airtable sesuai jadwal, atau ambil data tersebut di dalam skrip otomatisasi Airtable.
Panduan PostgreSQL -
Xata ke Baserow Platform otomatisasi
Mengunggah data ke tabel Baserow dari Xata melalui endpoint REST — baik yang dihosting sendiri maupun di cloud Baserow.
Panduan PostgreSQL -
Xata ke SeaTable Platform otomatisasi
Jaga agar basis data SeaTable selalu mutakhir dengan data Xata tanpa mengekspor file atau mengekspos basis data.
Panduan PostgreSQL -
Xata ke Smartsheet Platform otomatisasi
Masukkan hasil Xata ke dalam tabel Smartsheet sehingga rencana dan laporan dibaca dari sistem sumber, bukan dari ekspor minggu lalu.
Panduan PostgreSQL -
Xata ke Anvil Anvil Works · Platform aplikasi
Dukung aplikasi Python Anvil dengan Xata melalui endpoint REST, alih-alih menyematkan kredensial basis data di dalam aplikasi.
Panduan PostgreSQL - Untuk alat AI
-
Server Xata MCP Klien Claude, Cursor, dan MCP
Berikan akses baca saja kepada asisten AI ke Xata beserta skema yang dibutuhkannya untuk menulis SQL yang benar — tanpa kredensial di dalam obrolan.
Panduan PostgreSQL - Dikirimkan kepada orang-orang
-
Peringatan dan laporan Xata Slack · Discord · Email · Webhook
Atur jadwal untuk kueri Xata dan kirimkan baris data ke Slack, Discord, email, atau webhook yang ditandatangani — atau tahan pesan hingga jumlah baris, ambang batas, atau perubahan persentase melampaui batas yang Anda tetapkan.
Cara kerja peringatan dan laporan
Cara kerjanya
5 langkah, tanpa perubahan firewall masuk.
Instal Network Agent di lokasi yang sesuai untuk Anda. Network Agent hanya membuka satu koneksi keluar dan tidak pernah mendengarkan, sehingga tidak ada aturan masuk dan tidak ada informasi tentang basis data yang terekspos.
Salin string koneksi dari konsol Xata. Host, port, ID ruang kerja, kunci API, dan rute database:branch semuanya dibaca dari string tersebut.
Periksa apakah kolom Database bertuliskan database:branch — misalnya mydb:main. Nama tanpa tanda titik dua diterima, dan itu berarti cabang default.
Ingat kredensial mana yang mana: nama pengguna adalah ID ruang kerja Anda dan kata sandi adalah kunci API, bukan kata sandi akun Anda.
Simpan. Microsoft Excel, Google Sheets, Power BI, MCP, dan REST semuanya membaca cabang melalui satu koneksi tersebut, atau menggabungkannya dengan sumber lain Anda dalam satu pernyataan baca-saja.
Analisis mendalam fitur
Apa yang Xata berikan kepada Anda
Kolom Database adalah rute, bukan nama.
Pada setiap konektor Postgres lainnya, kolom Database berisi pengidentifikasi, dan Query Streams mengubahnya menjadi huruf kecil saat diteruskan karena itulah yang dilakukan Postgres dengan nama yang tidak diberi tanda kutip. Pada Xata, hal itu akan salah, jadi hanya di situ aturan tersebut dimatikan.
- Nilainya adalah pasangan basis data:cabang. — mydb:main — yang diresolusi oleh Xata sebagai sebuah rute. Ini bukan pengidentifikasi Postgres dan tidak mengikuti aturan pelipatan pengidentifikasi.
- Cabang yang disebut Feature-X mempertahankan huruf F kapital dan huruf X kapitalnya. Jika diubah menjadi huruf kecil menjadi feature-x, maka cabang tersebut berhenti berfungsi, itulah sebabnya Xata adalah satu-satunya konektor yang dikecualikan dari normalisasi.
- Hilangkan tanda titik dua dan koneksi tetap berfungsi. — kode tersebut akan masuk ke cabang default. Kartu tersebut menunjukkan hal ini daripada membiarkannya berlalu begitu saja, karena masuk ke cabang utama padahal yang dimaksud adalah cabang fitur akan menghasilkan angka yang tampak benar dari data yang salah.
- Tidak ada hal lain tentang nama tersebut yang diperiksa. Query Streams meneruskan rute seperti yang Anda ketik dan membiarkan Xata memutuskan apakah rute tersebut dapat diselesaikan.
Apa yang dilakukan agen dengan host Xata
Dua perilaku dikaitkan dengan akhiran .sql.xata.sh, dan Anda tidak dapat mengkonfigurasi salah satunya.
- TLS diperlukan, bukan diminta. Setiap host .sql.xata.sh terhubung dengan enkripsi aktif terlepas dari kotak Gunakan SSL, sehingga string yang kehilangan sslmode-nya di clipboard tetap dikirim dalam keadaan terenkripsi.
- Koneksi dienkripsi tetapi rantai sertifikat tidak diverifikasi. Itulah deskripsi jujurnya, dan sama di setiap penyedia hosting yang diakui oleh Query Streams.
- Tidak ada pooler di jalur tersebut. Beberapa layanan Postgres tanpa server menempatkan pooler mode transaksi di depan dan membutuhkan prepared statement yang di-pin untuk mengatasinya; Xata tidak melakukannya, sehingga agen terhubung langsung dan melewati semua itu.
- Koneksi disimpan sebagai PostgreSQL dengan Xata sebagai nama koneksi. Tidak ada tipe koneksi yang bernama Xata. — yang juga berarti koneksi Postgres biasa yang Anda buat sebelumnya ke host yang sama akan langsung menampilkan logo Xata.
Tempelkan saja daripada mengetiknya ulang
Empat kredensial, dua di antaranya mudah membingungkan dan satu di antaranya cukup panjang untuk salah ketik. Kartu ini dirancang untuk menempelkan rangkaian kredensial dan menangani sisanya.
- URI postgresql:// dari konsol adalah format yang diharapkan. Format kata kunci libpq host= juga dapat diuraikan.
- Apa pun yang bukan string koneksi Postgres akan ditolak dengan pesan yang memberi tahu Anda di mana string koneksi yang benar berada, alih-alih diuraikan sebagian ke dalam kolom yang salah.
- Kunci API dengan spasi di awal atau akhir akan ditandai. Ini adalah artefak clipboard dan akan gagal sebagai kesalahan autentikasi biasa, yang membuat orang mencari masalah yang salah.
- ID Ruang Kerja dimasukkan ke kolom nama pengguna dan kunci API dimasukkan ke kolom kata sandi. Kartu tersebut memberi label seperti itu daripada hanya mengatakan Nama Pengguna dan Kata Sandi dan membiarkan Anda menebaknya.
-- Postgres biasa, hanya baca, terhadap cabang mana pun yang Anda tunjuk 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;
Digunakan bersama oleh setiap konektor basis data.
Hal ini berlaku untuk setiap konektor basis data.
- Hanya untuk keberangkatan — agen membuka satu koneksi terenkripsi ke Query Streams. Tidak ada port masuk yang perlu diteruskan, tidak ada VPN, tidak ada daftar IP yang diizinkan, tidak ada informasi tentang basis data Anda yang terekspos ke internet.
- Kredensial tetap tersimpan. — Nama pengguna dan kata sandi basis data tersimpan di mesin tempat Anda menginstal agen. Query Streams tidak pernah menerimanya dan tidak dapat mengakses basis data Anda sendiri.
- Hanya baca, diberlakukan — satu pernyataan dalam satu waktu, hanya SELECT dan sejenisnya. Permintaan penulisan ditolak di mesin Anda sendiri sebelum dikirim ke server, alih-alih bergantung pada izin yang telah diatur oleh seseorang.
- Sebarkan agen sebanyak yang Anda inginkan. — satu per situs, wilayah, atau cloud. Setiap sumber data yang dapat mereka lihat muncul dalam satu menu tarik-turun, sehingga tidak ada yang perlu tahu agen mana yang menghosting apa.
Yang Anda dapatkan setelah kueri disimpan
- Bagikan kemampuannya, bukan kode SQL-nya. — seorang kolega atau mitra eksternal dapat menjalankan kueri Anda dan mengubah filternya tanpa pernah melihat pernyataan di baliknya.
- Filter dari kedua arah — deklarasikan sendiri sebagai @variabel, atau biarkan konektor menemukan nilai literal yang sudah ada di klausa WHERE Anda dan menawarkannya sebagai menu tarik-turun.
- Bacalah dari mana saja — Microsoft Excel, Google Sheets, Power BI, REST API, asisten AI melalui MCP, Query Builder, dan Nova semuanya membaca kueri tersimpan yang sama.
- Jalankan beberapa sekaligus — lima kueri tersimpan ke dalam lima tab lembar kerja, dialirkan secara bersamaan, sebesar apa pun hasilnya.
- Hubungkan dengan hal lain yang sudah Anda hubungkan. — basis data lain, API bisnis, atau folder file, dalam satu pernyataan baca saja.
SQL lintas sumber
Gabungkan Xata dengan data Anda yang lain.
Satu pernyataan dapat mencakup Xata dan koneksi Anda lainnya sekaligus. Setiap sumber hanya menjalankan bagian yang dapat dijalankannya, mengirimkan hasilnya kembali, dan penggabungan terjadi secara terpusat — sumber-sumber tersebut tidak pernah berkomunikasi satu sama lain dan tidak ada yang disalin ke mana pun.
3 koneksi · 3 agen
Satu pernyataan
-- tidak ada yang disalin, tidak ada yang digabungkan, tidak ada yang dijadwalkan
PILIH c.region, COUNT(*) AS orders, SUM(i.amount_due) AS invoiced
DARI aplikasi xataketertiban umum1 f
GABUNG erp_sql.dbo.pelanggan2 c ON c.id = f.customer_id
GABUNG penagihan.stripe.faktur3 i ON i.customer = c.stripe_id
KELOMPOKKAN BERDASARKAN c.wilayah
PESAN OLEH ditagih DESC;
Tiga bagian tersebut adalah koneksi, skema, dan tabel — dan nama koneksi adalah apa pun yang Anda sebutkan. Kolom ilustratif; tabel Anda akan menjadi tabel Anda. Hanya baca berlaku untuk setiap bagian: SELECT, WITH, dan EXPLAIN saja, dengan batasan seberapa banyak data yang dapat diberikan oleh satu sumber untuk satu kueri. Cara kerja kueri terfederasi
Detail koneksi
Apa yang dibutuhkan Xata
- Tuan rumah
- <region>.sql.xata.sh
- Pelabuhan
- 5432
- Pengemudi
- Npgsql, dibawa oleh agen — tidak perlu diinstal di sisi Xata.
- Basis data
- Rute database:cabang seperti mydb:main. Diteruskan dengan kapitalisasi yang utuh — satu-satunya konektor di mana hal itu benar.
- Nama pengguna
- ID ruang kerja Anda, bukan nama akun.
- Kata sandi
- Kunci API, bukan kata sandi akun Anda.
- TLS
- Diperlukan, dan dipaksakan oleh agen untuk setiap host .sql.xata.sh. Terenkripsi; rantai sertifikat tidak diverifikasi.
- Pengumpulan
- Tidak ada — Xata tidak memerlukan endpoint bersama, jadi agen terhubung langsung.
- Disimpan sebagai
- PostgreSQL, dengan Xata tetap sebagai lencana — tidak ada tipe koneksi yang disebut Xata.
- Skema default
- publik, yang merupakan makna dari referensi terfederasi.
Aturan kapitalisasi adalah alasan utama kartu ini ada, alih-alih mengarahkan orang ke kartu PostgreSQL biasa. Query Streams mengubah nama basis data Postgres menjadi huruf kecil saat diproses, yang benar di mana pun — pengidentifikasi tanpa tanda kutip akan diubah menjadi huruf kecil di Postgres, jadi mempertahankan apa yang diketik seseorang hanya akan menimbulkan kebingungan. Bidang Database Xata sama sekali bukan pengidentifikasi. Ini adalah rute yang terdiri dari basis data dan cabang yang dihubungkan oleh titik dua, dan Xata membaca bagian cabang secara harfiah. Ubah huruf kecilnya dan cabang bernama Feature-X menjadi feature-x dan berhenti diproses. Jadi Xata dikecualikan, dan ini adalah satu-satunya konektor di platform yang dikecualikan.
Kegagalan yang dicegah oleh pengecualian adalah kegagalan yang buruk, karena tidak terlihat seperti kegagalan. Perutean cabang yang salah biasanya tidak menimbulkan kesalahan — melainkan mengarahkan Anda ke suatu tempat. Kueri terhadap cabang yang salah mengembalikan baris, dan baris tersebut terlihat seperti data, dan tidak ada yang menunjukkan bahwa Anda membaca skema bulan lalu alih-alih skema minggu ini. Alasan yang sama adalah mengapa nama basis data tanpa tanda titik dua ditandai: itu berfungsi, secara diam-diam berarti cabang default, dan spreadsheet yang penuh dengan "main" padahal yang Anda maksud adalah cabang fitur lebih buruk daripada pesan kesalahan.
Untuk kueri lintas sumber, Xata adalah Postgres biasa. Koneksi yang Anda beri nama xata_app ditulis sebagai xata_app.public.orders, dan koneksi tersebut bergabung ke folder CSV, sistem pencatatan lokal, atau API penagihan dalam satu pernyataan baca saja — tanpa ada yang disalin dan tanpa ada yang dijadwalkan. Cabang yang Anda pilih dalam koneksi adalah cabang yang dibaca oleh operasi join.
Dokumentasi vendor: xata.io
Pertanyaan yang Sering Diajukan (FAQ)
Pertanyaan tentang Xata
Alat apa saja yang dapat membaca data Xata melalui Query Streams?
Semuanya, dari satu koneksi: Excel, Google Sheets, MCP, REST API, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, peringatan dan laporan terjadwal. Hubungkan basis data sekali dan setiap antarmuka akan membaca koneksi baca-saja yang sama — tidak ada pengaturan per alat dan tidak ada salinan data kedua.
Apakah saya perlu membuka port firewall ke database Xata saya?
Tidak. Query Streams Network Agent berjalan di dalam jaringan Anda dan membuka satu koneksi keluar terenkripsi. Tidak ada yang mendengarkan lalu lintas masuk, tidak diperlukan VPN, dan basis data mempertahankan aturan firewall yang ada.
Bisakah Query Streams mengubah data di Xata?
Tidak. Agen tersebut memberlakukan mode baca saja pada saat eksekusi — satu pernyataan dalam satu waktu, hanya SELECT dan sejenisnya. Kredensial tetap berada di agen dan tidak pernah dikirim ke Query Streams.
Apa yang dibutuhkan Query Streams untuk terhubung ke Xata?
Host yang dapat dijangkau, peran dan kata sandinya — agen membawa driver, jadi tidak ada yang diinstal pada basis data. Host: <region>.sql.xata.sh. Port: 5432. Driver: Npgsql, dibawa oleh agen — tidak ada yang perlu diinstal di sisi Xata. Basis data: Rute basis data:cabang seperti mydb:main. Diteruskan dengan kapitalisasi yang utuh — satu-satunya konektor di mana hal itu benar.
Bisakah saya menggabungkan Xata dengan basis data lain dalam kueri yang sama?
Ya — itu adalah kueri terfederasi. Satu pernyataan dapat merujuk ke Xata dan koneksi Anda lainnya sekaligus, ditulis sebagai connection.schema.table. Setiap sumber hanya menjalankan bagian yang dapat dijalankannya dan mengalirkan hasilnya kembali; penggabungan terjadi secara terpusat, sehingga sumber-sumber tersebut tidak pernah terhubung satu sama lain dan tidak ada yang disalin atau dijadwalkan. Hanya baca berlaku untuk setiap bagian — hanya SELECT, WITH, dan EXPLAIN — dan ada batasan seberapa banyak data yang dapat diserahkan oleh satu sumber untuk satu kueri. Kueri terfederasi adalah fitur rencana; halaman kueri terfederasi memuat batasan sumber dan ukuran saat ini.
Apakah menghubungkan Xata berbeda dengan menghubungkan PostgreSQL?
Hanya string koneksi saja. Xata menggunakan protokol wire PostgreSQL, sehingga filter, penjadwalan, berbagi, add-on Excel dan Google Sheets, serta server MCP semuanya berfungsi identik. Kartu Xata secara otomatis mengisi host, port, dan pengaturan SSL yang diharapkan oleh penyedia layanan.
Apakah ada panduan konversi Xata ke Excel?
Ya — ini adalah panduan PostgreSQL, dan panduan ini benar untuk Xata seperti yang tertulis. Xata menggunakan protokol komunikasi PostgreSQL, jadi koneksi Xata ke Excel, Xata ke Google Sheets, dan semua tujuan lainnya mengikuti langkah-langkah yang sama. Satu-satunya bagian khusus Xata adalah string koneksi, dan kartu Xata akan mengisinya untuk Anda.
Tempatkan Xata di tempat pekerjaan berlangsung.
Instal agen, arahkan ke basis data Anda, dan pilih tujuan.
Hanya baca Hanya untuk keberangkatan Informasi kredensial tetap tersimpan pada agen.

