Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Ekstensi PostgreSQL untuk Visual Studio Code (ms-ossdata.vscode-pgsql) membawa alat pengembangan database langsung ke editor Anda. Anda dapat terhubung ke server PostgreSQL lokal, lokal, atau yang disediakan cloud, menulis kueri dengan IntelliSense, menjelajahi objek database, memvisualisasikan rencana dan skema kueri, dan mengelola sumber daya server Azure Database for PostgreSQL fleksibel, semuanya tanpa meninggalkan Visual Studio Code. Ekstensi ini juga terintegrasi dengan asisten AI untuk penulisan kueri yang dibantu AI, analisis, dan alur kerja berbasis agen.
Note
Ekstensi juga berjalan di Kursor. Fitur AI PostgreSQL didukung di kedua editor dan mengikuti pengalaman AI bawaan masing-masing editor: Visual Studio Code menyertakan partisipan chat @pgsql bersama mode Agen dan pendaftaran server MCP, sedangkan Cursor menggunakan Connect AI (mode Agen) atau pendaftaran server MCP.
Get started
Jika Anda baru menggunakan ekstensi, mulailah dengan salah satu panduan berikut:
| Maksud | Guide |
|---|---|
| Jalankan kueri pertama Anda | Mulai cepat: Menyambungkan dan mengkueri PostgreSQL |
| Temukan artikel yang tepat untuk tugas Anda | Alur kerja umum |
| Mengonfigurasi identitas, TLS, atau profil yang disimpan | Koneksi dan identitas |
Menginstal ekstensi
- Buka Kode Visual Studio.
- Buka tampilan Ekstensi (
Ctrl+Shift+X, atauCmd+Shift+Xdi macOS). - Cari postgresql.
- Pilih PostgreSQL menurut Microsoft lalu pilih Instal.
Tip
Setelah penginstalan, ikon PostgreSQL muncul di Bilah Aktivitas. Pilih untuk membuka tampilan PostgreSQL, tempat Anda mengelola koneksi dan menjelajahi objek database.
Fitur utama
Bagian berikut ini meringkas setiap area fitur utama. Pilih tautan di akhir setiap bagian untuk artikel lengkap.
Dialog koneksi
Dialog koneksi menghubungkan Anda ke server PostgreSQL lokal, on-premises, dan yang disediakan oleh cloud, dengan dukungan autentikasi terintegrasi untuk Microsoft Entra ID dan AWS IAM (RDS/Aurora). Masukkan parameter koneksi satu per satu, tempelkan string koneksi, atau telusuri langganan Azure Anda untuk menemukan server fleksibel Azure Database for PostgreSQL dan kluster Azure HorizonDB (Pratinjau).
- Tiga mode input: Parameter untuk nilai individual seperti host, port, database, dan nama pengguna; Connection String untuk string koneksi lengkap; atau Telusuri Azure untuk menavigasi aset Azure Anda dan memilih sumber daya dengan titik akhir PostgreSQL.
- Koneksi tersimpan dan terbaru: profil tersimpan muncul di daftar Koneksi untuk digunakan kembali dengan cepat; Koneksi yang baru-baru ini digunakan selalu tersedia.
- Grup server: atur koneksi ke dalam grup bernama dengan pengkodian warna untuk mengidentifikasi koneksi dengan cepat di pohon Koneksi .
Untuk detailnya, lihat Koneksi dan identitas serta Opsi koneksi tingkat lanjut.
Penjelajah objek
Penjelajah objek menyediakan tampilan pohon yang dapat dinavigasi dari server PostgreSQL yang terhubung. Perluas server, database, dan skema untuk memeriksa tabel, tampilan, fungsi, urutan, jenis, ekstensi, peran, ruang tabel, dan pemicu peristiwa.
- Pencarian: temukan objek berdasarkan nama di semua jenis objek yang didukung dengan pencarian bawaan.
-
Pembuatan skrip: klik kanan objek apa pun untuk menghasilkan
SELECT, ,CREATE,ALTERDROP, atauEXECUTEskrip yang terbuka di editor kueri. - Penyegaran mendalam: segarkan simpul apa pun untuk memperbarui secara rekursif semua turunan yang sedang diperluas, sehingga mencerminkan perubahan skema tanpa memutus koneksi.
Untuk detailnya, lihat Penjelajah objek.
Editor Kueri dan IntelliSense
Editor kueri menyediakan permukaan pengeditan yang kaya untuk PostgreSQL SQL. IntelliSense menawarkan penyelesaian sadar konteks untuk nama tabel, nama kolom, fungsi, skema, kata kunci, dan klausa gabungan.
- Jalankan Kueri dan Jalankan Pernyataan Saat Ini: jalankan konten editor lengkap atau hanya pernyataan di kursor.
-
Cuplikan kode: sisipkan pola SQL umum seperti
CREATE TABLE, ,INSERTdanSELECT. - Riwayat kueri: akses kueri yang sebelumnya dijalankan dari Palet Perintah untuk menjalankan ulang atau memodifikasinya.
Untuk detailnya, lihat Editor kueri dan IntelliSense.
Hasil kueri
Hasil muncul di panel Hasil Kueri PostgreSQL di bawah editor. Kisi hasil mendukung pengurutan, pemfilteran, dan mengubah ukuran kolom.
- Ekspor: simpan hasil ke CSV, JSON, atau Excel.
- Visualisasi bagan: memvisualisasikan hasil sebagai bagan garis, batang, pai, atau sebar.
- Tampilan grafik: Hasil kueri grafik Apache AGE beralih secara otomatis ke tampilan simpul dan tepi.
- Tab Pesan: tinjau jumlah baris, waktu eksekusi, dan pesan server.
Untuk detailnya, lihat Editor kueri dan IntelliSense.
Visualisasi rencana kueri
Visualizer rencana kueri menampilkan hasil EXPLAIN dalam berbagai format interaktif sehingga Anda dapat mengidentifikasi hambatan kinerja.
- Empat tampilan: Tampilan Pohon, Tampilan Icicle, Tampilan Tabel, dan Tampilan Sumber.
- Metrik: memeriksa perkiraan biaya, jumlah baris aktual, waktu eksekusi, dan penggunaan buffer per simpul.
- Impor rencana: visualisasikan file rencana yang disimpan atau konten editor tanpa koneksi langsung ke database.
- analisis Copilot: pilih Analisis dengan Copilot (atau Analisis dengan AI di Kursor) untuk penjelasan rencana yang dihasilkan AI.
Untuk detail selengkapnya, lihat visualizer rencana kueri.
Visualisasi skema
Visualisasi skema menghasilkan diagram entitas-relasi interaktif. Tabel muncul sebagai simpul yang dapat diseret dengan kolom yang tercantum di dalamnya, dan hubungan kunci asing ditampilkan sebagai tepi penghubung.
- Skema berkode warna: setiap skema menerima warna yang berbeda untuk identifikasi cepat.
- Tombol legenda: tampilkan atau sembunyikan legenda skema untuk memaksimalkan ruang diagram.
Untuk detailnya, lihat Visualizer skema.
Dasbor Server
Dasbor server menunjukkan properti koneksi, versi server, dan status SSL untuk server yang terhubung. Untuk server fleksibel Azure Database for PostgreSQL, server juga menampilkan metrik Azure Monitor. Tab investigasi memungkinkan Anda menelusuri area aktivitas server tertentu.
- Gambaran umum: memantau CPU, memori, penyimpanan, koneksi, IOPS, dan metrik lainnya yang dikelompokkan menurut kategori.
- Kueri: menampilkan pernyataan SQL teratas yang diberi peringkat berdasarkan waktu eksekusi, jumlah panggilan, atau metrik lainnya, dengan telusuri paling detail kueri individual.
- Waktu Tunggu: analisis peristiwa waktu tunggu dengan tabel berperingkat dan grafik dari waktu ke waktu.
- Sesi: memeriksa sesi aktif, memblokir pohon, dan mengunci aktivitas.
- Aksi toolbar: sambungkan, putuskan sambungan, buka editor kueri baru, luncurkan visualisasi skema, buka obrolan AI, atau mulai tindakan pengelolaan Azure melalui toolbar dasbor.
Untuk detailnya, lihat Dasbor server.
manajemen server Azure
Kelola Azure Database for PostgreSQL sumber daya server fleksibel tanpa meninggalkan Visual Studio Code.
- Mulai, hentikan, dan mulai ulang: kontrol siklus hidup server dari pohon Koneksi atau dasbor .
- Aturan firewall: melihat dan memperbarui aturan akses jaringan.
- Parameter: telusuri dan ubah parameter.
- Mengkloning server: menduplikasi konfigurasi server yang ada.
Untuk detailnya, lihat manajemen server Azure.
Pembuatan server
Provisikan server PostgreSQL baru langsung dari Visual Studio Code.
- Docker: buat server PostgreSQL lokal dalam kontainer Docker untuk pengembangan dan pengujian.
- Azure Database for PostgreSQL server fleksibel: ikuti penyiapan terpandu untuk mengonfigurasi wilayah, tingkat komputasi, penyimpanan, dan autentikasi.
- Azure HorizonDB (Pratinjau): menyediakan kluster PostgreSQL cloud-native dan sangat dapat diskalakan dengan vCore yang dapat dikonfigurasi dan kemampuan AI opsional.
Untuk detailnya, lihat Membuat server PostgreSQL.
integrasi Copilot
Ekstensi ini terintegrasi dengan asisten AI dalam obrolan, aksi editor, dan alur kerja alat multilangkah.
- @pgsql peserta chat: ajukan pertanyaan dalam bahasa alami tentang basis data Anda, buat kueri, atau dapatkan bantuan mengenai konsep PostgreSQL di panel GitHub Copilot Chat. Visual Studio Code saja. Untuk detail selengkapnya, lihat @pgsql chat participant.
- Tindakan editor: klik kanan SQL di editor untuk menjelaskan kueri, menulis ulang untuk pengoptimalan, atau menganalisis rencana eksekusinya dari submenu Tindakan Kueri AI . Tersedia baik di Visual Studio Code maupun di Cursor.
- Mode agen: agen AI memanggil alat PostgreSQL secara langsung, menggabungkan penalaran AI dengan operasi database langsung. Tersedia baik di Visual Studio Code maupun Cursor. Untuk detailnya, lihat Mode agen.
Untuk gambaran umum semua kemampuan AI, lihat integrasi Copilot.
Server MCP
Ekstensi ini mendaftarkan server Model Context Protocol (MCP) yang mengekspos alat PostgreSQL, termasuk manajemen koneksi, eksplorasi skema, eksekusi kueri, dan visualisasi rencana kueri, ke host yang mendukung AI. Alat AI eksternal dapat berinteraksi dengan koneksi PostgreSQL Anda secara terprogram melalui pendaftaran ini.
Untuk detailnya, lihat Server MCP.
Menggunakan psql di terminal
Buka sesi terminal psql yang terhubung ke basis data mana pun di pohon Koneksi, atau jalankan berkas .sql melalui psql langsung dari menu konteks editor. Ini memberi Anda akses penuh ke fitur bawaan psql seperti meta-perintah \, COPY, dan skrip interaktif.
Untuk detailnya, lihat Menggunakan psql di terminal.
Migrasi Oracle ke PostgreSQL
Alur kerja migrasi yang dibantu AI membantu Anda mengonversi skema database Oracle dan objek ke SQL yang kompatibel dengan PostgreSQL.
- Migrasi terpandu: sambungkan ke sumber Oracle, pilih objek untuk dimigrasikan, dan tinjau output yang dikonversi.
- Konversi yang dibantu AI: Model Microsoft Foundry menerjemahkan sintaks khusus Oracle, jenis data, dan kode prosedural ke setara PostgreSQL.
Untuk detailnya, lihat Migrasi Oracle ke PostgreSQL.
Sistem operasi yang didukung
| Sistem operasi | Architecture | Notes |
|---|---|---|
| Windows | x64, Arm64 | Arm64 membutuhkan Windows 11. |
| macOS | x64, Arm64 | - |
| Linux | x64, Arm64 | Memerlukan glibc 2.35 atau versi lebih baru. |
Tanggapan dan dukungan
Untuk melaporkan bug atau meminta fitur, ajukan masalah pada repositori GitHub vscode-pgsql.