Logo Koyeb

Postgres tanpa server berbicara PostgreSQL

Menghubungkan Koyeb ke Excel, Google Sheets, AI, dan REST

Koyeb serverless Postgres di .pg.koyeb.app. Kartu ini menangkap satu kesalahan yang sering dilakukan semua orang — menempelkan nama host aplikasi alih-alih nama host basis data.

Mulai gratis 13 destinasi

Satu koneksi, setiap permukaan

Ke mana data Koyeb Anda dapat dikirim

Koyeb meja langsung · hanya baca
Kueri terfederasi + konektor lainnya · satu SQL lintas sumber · setiap rencana
Agen Jaringan
  • 1 koneksi keluar
  • 0 port masuk
  • hanya baca · kredensial tetap di tempatnya

berjalan pada

Query Streams membaca Koyeb Postgres dari Microsoft Excel, Google Sheets, Power BI, asisten AI melalui MCP dan endpoint REST melalui satu koneksi baca saja. Koyeb menghosting aplikasi dan basis data pada nama host yang berdekatan, dan hanya satu di antaranya yang merupakan basis data: aplikasi berada di .koyeb.app dan Postgres berada di .pg.koyeb.app. Kesalahan dalam mengidentifikasi keduanya adalah penyebab paling umum kegagalan koneksi ini, sehingga kartu tersebut memeriksanya dan menyatakannya secara jelas daripada membiarkannya gagal karena waktu habis (timeout).

Koyeb adalah pakar PostgreSQL yang sedang dalam perjalanan. — driver standar, jadi setiap panduan di bawah ini berlaku tanpa perubahan. Satu-satunya bagian khusus Koyeb adalah string koneksi, yang dibahas di bawah ini. detail koneksi.

  1. Untuk tim, vendor, dan mitra Anda

  2. Koyeb untuk Unggul Microsoft Excel · Add-in Excel

    Ambil hasil Koyeb secara langsung ke dalam lembar kerja dan perbarui sesuai kebutuhan — Excel desktop, Excel Online, Microsoft 365.

    Panduan PostgreSQL

  3. Koyeb ke Google Sheets Tambahan lembar

    Jalankan kueri Koyeb yang tersimpan dari bilah sisi dan seret baris ke dalam lembar kerja. Kolaborator yang berbagi dapat memperbaruinya sendiri.

    Panduan PostgreSQL

  4. Tanyakan pada Nova tentang Koyeb Nova AI · teks ke SQL

    Ajukan pertanyaan dalam bahasa Inggris yang mudah dipahami. Nova sudah mengetahui tabel Koyeb Anda, menulis dan menjalankan SQL, menjelaskan jawabannya, dan membuat grafiknya — tidak perlu menulis kueri, tidak perlu memberikan kredensial.

    Cara kerja Nova

  5. Koyeb ke Penampil Data Berbagi hasil · tim, vendor, mitra · telepon, tablet, desktop

    Bagikan hasil Koyeb secara langsung kepada 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
  6. Untuk aplikasi dan sistem

  7. API REST Koyeb Titik akhir HTTP

    Publikasikan kueri Koyeb 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

  8. Koyeb ke Power BI Power Query M

    Tempelkan Power Query M yang dihasilkan ke dalam Power BI Advanced Editor dan laporan akan membaca hasil Koyeb secara langsung melalui HTTPS — tanpa driver ODBC, tanpa port basis data yang dibuka.

    Cara kerja Power BI

  9. Koyeb ke Airtable Platform otomatisasi

    Sinkronkan baris Koyeb ke dalam basis data Airtable sesuai jadwal, atau ambil data tersebut di dalam skrip otomatisasi Airtable.

    Panduan PostgreSQL

  10. Koyeb ke Baserow Platform otomatisasi

    Mengunggah data ke tabel Baserow dari Koyeb melalui endpoint REST — baik yang dihosting sendiri maupun di cloud Baserow.

    Panduan PostgreSQL

  11. Koyeb ke SeaTable Platform otomatisasi

    Jaga agar basis data SeaTable selalu mutakhir dengan data Koyeb tanpa mengekspor file atau mengekspos basis data.

    Panduan PostgreSQL

  12. Koyeb ke Smartsheet Platform otomatisasi

    Masukkan hasil Koyeb ke dalam tabel Smartsheet agar rencana dan laporan dibaca dari sistem sumber, bukan dari ekspor minggu lalu.

    Panduan PostgreSQL

  13. Koyeb ke Anvil Anvil Works · Platform aplikasi

    Dukung aplikasi Python Anvil dengan Koyeb melalui endpoint REST, alih-alih menyematkan kredensial basis data di dalam aplikasi.

    Panduan PostgreSQL
  14. Untuk alat AI

  15. Server MCP Koyeb Klien Claude, Cursor, dan MCP

    Berikan akses baca saja kepada asisten AI ke Koyeb beserta skema yang dibutuhkannya untuk menulis SQL yang benar — tanpa kredensial di dalam obrolan.

    Panduan PostgreSQL
  16. Dikirimkan kepada orang-orang

  17. Koyeb memberikan peringatan dan laporan. Slack · Discord · Email · Webhook

    Atur jadwal untuk kueri Koyeb 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.

01

Instal Network Agent di mana pun yang sesuai untuk Anda. Agen ini membuka satu koneksi keluar dan tidak pernah mendengarkan, sehingga Koyeb melihat klien biasa dan jaringan Anda tidak memerlukan aturan masuk.

02

Buka tab Detail Koneksi pada basis data di konsol Koyeb dan salin string tersebut. Ambil dari basis data, bukan dari aplikasi.

03

Tempelkan saja. Host, port, pengguna, kata sandi, dan basis data semuanya akan dibaca dari situ, dan host akan diperiksa apakah ada akhiran .pg. yang menandainya sebagai titik akhir basis data.

04

Pengaturan default Koyeb yang biasa sudah terisi — koyeb-adm sebagai pengguna dan koyebdb sebagai basis data — sehingga layanan baru biasanya hanya membutuhkan kata sandi.

05

Simpan. Microsoft Excel, Google Sheets, Power BI, MCP, dan REST semuanya membaca melalui satu koneksi tersebut, atau menggabungkannya dengan sumber lain Anda dalam satu pernyataan baca-saja.

Analisis mendalam fitur

Apa yang Koyeb berikan kepadamu

Nama host aplikasi bukanlah nama host basis data.

Koyeb adalah platform aplikasi yang juga menjalankan Postgres, dan keduanya berada pada label yang berbeda. Itu adalah kesalahan yang sangat mudah dan berakibat fatal, jadi kartu tersebut mencegahnya.

  • Aplikasi diakses dari .koyeb.app. Basis data diakses di .pg.koyeb.app. Perbedaannya terletak pada .pg. di tengahnya.
  • Jika Anda menempelkan host yang berakhiran .koyeb.app tanpa itu, kartu tersebut akan menghentikan Anda dengan penjelasan tersebut, alih-alih membiarkan Anda menyimpan koneksi yang hanya akan habis waktu (timeout).
  • Timeout adalah gejala terburuk yang mungkin terjadi di sini, karena terlihat seperti masalah firewall. Orang-orang kemudian memeriksa aturan jaringan yang sebenarnya bukan masalahnya.
  • Nama host basis data mengikuti format ep-<nama>-<id>. Postgres milik Koyeb berbasis Neon, dari situlah pola tersebut berasal.

Selain itu, sengaja dibuat biasa saja.

Tidak ada mekanisme canggih di sini, dan berpura-pura sebaliknya hanya akan menyesatkan. Yang dilakukan kartu ini adalah memberikan detail yang tepat dan tidak mengganggu.

  • TLS diberlakukan untuk setiap host .pg.koyeb.app terlepas dari apa yang tertera pada kotak centang, sehingga string yang kehilangan sslmode-nya di clipboard tetap dikirim dalam keadaan terenkripsi. Lalu lintas dienkripsi; rantai sertifikat tidak diverifikasi.
  • Tidak ada pooler di jalur tersebut. Beberapa layanan Postgres tanpa server menempatkan pooler mode transaksi di depannya dan membutuhkan prepared statement yang di-pin untuk mengatasinya; Koyeb tidak melakukannya, sehingga agen terhubung langsung dan melewati semua itu.
  • koyeb-adm dan koyebdb sudah terisi karena itulah yang dimiliki oleh basis data Koyeb yang baru. Layanan yang benar-benar baru seringkali hanya membutuhkan kata sandi.
  • Koneksi disimpan sebagai PostgreSQL dengan Koyeb sebagai lencana. Tidak ada tipe koneksi yang bernama Koyeb. — yang juga berarti koneksi Postgres biasa yang Anda buat sebelumnya ke host .pg.koyeb.app akan langsung menampilkan branding tersebut.
-- Postgres biasa, hanya baca 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 Koyeb dengan data Anda yang lain.

Satu pernyataan dapat mencakup Koyeb 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

Koyeb Postgres tanpa server
Microsoft SQL Server Mesin relasional
Stripe Pembayaran & penagihan

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     koyeb_appketertiban 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 Koyeb

Tuan rumah
ep-<name>-<id>.<region>.pg.koyeb.app — perhatikan .pg., yang menunjukkan bahwa ini adalah basis data dan bukan aplikasi.
Pelabuhan
5432
Pengemudi
Npgsql, dibawa oleh agen — tidak perlu diinstal di sisi Koyeb.
Basis data
koyebdb pada layanan baru, dan sudah diisi sebelumnya seperti itu.
Nama pengguna
koyeb-adm pada layanan baru, dan sudah diisi sebelumnya seperti itu.
TLS
Diperlukan, dan dipaksakan oleh agen untuk setiap host .pg.koyeb.app. Terenkripsi; rantai sertifikat tidak diverifikasi.
Pengumpulan
Tidak ada — Koyeb tidak memerlukan endpoint bersama, jadi agen terhubung langsung.
Waktu habis koneksi
30 detik, satu kali percobaan
Disimpan sebagai
PostgreSQL, dengan Koyeb tetap sebagai lencana — tidak ada tipe koneksi yang disebut Koyeb.
Skema default
publik, yang merupakan makna dari referensi terfederasi.

Salah satu validator memiliki kartu ini, dan perlu dijelaskan mengapa hal ini layak mendapat bagian tersendiri daripada sekadar catatan kaki. Sebagian besar kesalahan koneksi akan muncul dengan sendirinya: kata sandi yang salah adalah kesalahan otentikasi, nama basis data yang salah menunjukkan bahwa basis data tidak ada. Mengarahkan klien Postgres ke nama host aplikasi tidak menghasilkan hal tersebut. Yang terjadi adalah timeout, karena ada host sungguhan di ujung lain dan host tersebut tidak mendengarkan Postgres. Timeout dianggap sebagai masalah jaringan, sehingga orang-orang memeriksa aturan firewall, bertanya kepada tim platform mereka tentang egress, dan menghabiskan waktu seharian hanya karena kesalahan ".pg." pada nama host. Menangkap kesalahan tersebut pada saat penyalinan jauh lebih berharga daripada dua baris kode yang dibutuhkan.

Segala hal lain tentang konektor ini jujur saja tidak ada yang istimewa, dan halaman tersebut menyatakan demikian daripada mengarang cerita yang mendalam. Koyeb Postgres berbasis Neon, agen berkomunikasi dengannya menggunakan Npgsql melalui TLS yang diberlakukan, dan tidak ada pooler untuk mengakomodasinya. Itulah keseluruhan ceritanya, dan cerita yang lebih singkat dan jujur lebih baik daripada cerita yang lebih panjang dan menyanjung.

Untuk kueri lintas sumber, Koyeb adalah Postgres biasa. Koneksi yang Anda beri nama koyeb_app ditulis sebagai koyeb_app.public.orders, dan terhubung ke folder CSV, sistem pencatatan lokal, atau API penagihan dalam satu pernyataan baca saja — tanpa ada yang disalin dan tanpa ada yang dijadwalkan.

Dokumentasi vendor: www.koyeb.com

Pertanyaan yang Sering Diajukan (FAQ)

Pertanyaan tentang Koyeb

Alat apa saja yang dapat membaca data Koyeb 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 Koyeb 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 Koyeb?

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

Host yang dapat dijangkau, peran dan kata sandinya — agen membawa driver, jadi tidak ada yang diinstal pada basis data. Host: ep-<nama>-<id>.<wilayah>.pg.koyeb.app — perhatikan .pg., yang menjadikannya basis data dan bukan aplikasi. Port: 5432. Driver: Npgsql, dibawa oleh agen — tidak ada yang perlu diinstal di sisi Koyeb. Basis data: koyebdb pada layanan baru, dan sudah terisi sebelumnya.

Bisakah saya menggabungkan Koyeb dengan basis data lain dalam kueri yang sama?

Ya — itu adalah kueri terfederasi. Satu pernyataan dapat merujuk ke Koyeb 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 Koyeb berbeda dengan menghubungkan PostgreSQL?

Hanya string koneksi saja. Koyeb menggunakan protokol wire PostgreSQL, sehingga filter, penjadwalan, berbagi, add-on Excel dan Google Sheets, serta server MCP semuanya berfungsi identik. Kartu Koyeb secara otomatis mengisi host, port, dan pengaturan SSL yang diharapkan oleh penyedia layanan.

Apakah ada panduan Koyeb ke Excel?

Ya — ini adalah panduan PostgreSQL, dan panduan ini benar untuk Koyeb seperti yang tertulis. Koyeb menggunakan protokol komunikasi PostgreSQL, jadi transfer data dari Koyeb ke Excel, Koyeb ke Google Sheets, dan semua tujuan lainnya mengikuti langkah-langkah yang sama. Satu-satunya bagian khusus Koyeb adalah string koneksi, dan kartu Koyeb akan mengisinya untuk Anda.

Tempatkan Koyeb di tempat pekerjaan itu dilakukan.

Instal agen, arahkan ke basis data Anda, dan pilih tujuan.

Mulai gratis Semua konektor

Hanya baca Hanya untuk keberangkatan Informasi kredensial tetap tersimpan pada agen.