Apa ekstensi PostgreSQL untuk Visual Studio Code? (Pratinjau)

Ekstensi PostgreSQL untuk Visual Studio Code menyederhanakan manajemen dan pengembangan database PostgreSQL. Anda dapat menyambungkan ke database PostgreSQL, menulis dan menjalankan kueri, dan mengelola objek database tanpa meninggalkan Visual Studio Code.

Ekstensi ini terintegrasi dengan layanan PostgreSQL yang dikelola Azure, termasuk:

  • Azure HorizonDB - layanan PostgreSQL asli cloud yang dibangun untuk beban kerja perusahaan tingkat 1. HorizonDB memiliki arsitektur penyimpanan/komputasi terdisagregasi, komit berlatensi rendah, failover cepat, peningkatan skala baca dengan penyeimbangan beban di seluruh replika HA yang dapat dibaca, dan integrasi AI yang mendalam.

Ekstensi yang sama berfungsi terhadap kedua layanan. Jika terdapat perbedaan perilaku (misalnya, endpoint koneksi atau metode autentikasi yang didukung), hal tersebut akan dijelaskan di bagian berikut.

Cara menginstal ekstensi

Anda dapat menginstal ekstensi PostgreSQL langsung dari Extensions Marketplace di Visual Studio Code. Ikuti langkah-langkah berikut:

  1. Buka tampilan Ekstensi di Visual Studio Code dengan memilih ikon Ekstensi di Bilah Aktivitas atau dengan menggunakan perintah View: Ekstensi.
  2. Cari PostgreSQL di Pasar Ekstensi.
  3. Pilih ekstensi PostgreSQL yang ditulis oleh Microsoft dan pilih Instal.

Saat Anda menginstal ekstensi, ikon gajah tampaknya mewakili halaman PostgreSQL di bar samping Visual Studio Code.

Features

Ekstensi PostgreSQL untuk Visual Studio Code menyediakan fitur berikut untuk Azure HorizonDB.

Pengelola Sambungan

Manajer Koneksi mempermudah koneksi ke database PostgreSQL lokal dan yang dihosting di cloud. Fungsionalitas utama meliputi:

  • Dukungan untuk beberapa profil koneksi, sehingga Anda dapat terhubung dan mengelola beberapa instans PostgreSQL secara berdampingan, termasuk campuran kluster HorizonDB Azure.
  • Penguraian string koneksi untuk konektivitas tanpa hambatan, baik saat Anda terhubung ke basis data lokal maupun kluster Azure HorizonDB.
  • Integrasi dengan Azure HorizonDB untuk penjelajahan langsung dan pemfilteran instans berdasarkan langganan, grup sumber daya, server/kluster, dan database.

Titik akhir koneksi Azure HorizonDB

Azure HorizonDB mengekspos dua titik akhir, yang dapat Anda tambahkan sebagai profil koneksi terpisah dalam ekstensi:

  • Titik akhir baca/tulis - Menyambungkan ke primer, yang menerima transaksi baca dan tulis. Gunakan titik akhir ini untuk penulisan aplikasi, perubahan skema, dan beban kerja baca apa pun yang memerlukan data berkomitmen terbaru. Titik akhir tercantum di halaman kluster Overview dan pada halaman Replicas di portal Azure.
  • Titik akhir pembaca - Secara otomatis menyeimbangkan koneksi baca-saja di semua replika HA yang dapat dibaca di kluster. Gunakan titik akhir ini untuk beban kerja baca berskala keluar, pelaporan, dan analitik. Hingga empat replika HA yang dapat dibaca didukung hari ini (meningkat menjadi 8), masing-masing berukuran identik dengan replika utama.

Pola umumnya adalah menyimpan dua profil dalam Pengelola Sambungan - satu menunjuk titik akhir baca/tulis dan satu menunjuk ke titik akhir pembaca - dan beralih di antara mereka di Object Explorer berdasarkan tugas yang ditangani.

Object Explorer

Object Explorer yang disempurnakan menyediakan tampilan hierarkis objek database, sehingga lebih mudah untuk menelusuri dan mengelola skema, tabel, tampilan, dan fungsi. Fitur penting meliputi:

  • Opsi pemfilteran tingkat lanjut untuk menemukan objek tertentu dengan cepat.
  • Kemampuan untuk membuat, memodifikasi, dan menghapus objek database seperti tabel, tampilan, dan prosedur tersimpan.
  • Visualisasi skema database dan hubungan untuk navigasi yang disederhanakan.
  • Untuk Azure HorizonDB, Anda dapat memeriksa 55+ ekstensi yang diizinkan yang tersedia di kluster melalui tampilan katalog pg_available_extensions langsung dari Editor Kueri.

Editor Kueri

Editor Kueri meningkatkan pengalaman penyusunan dan eksekusi kueri dengan:

  • IntelliSense yang sadar konteks untuk pelengkapan otomatis kata kunci SQL, nama tabel, dan fungsi.
  • Penyorotan sintaks dan pemformatan otomatis untuk keterbacaan kueri yang lebih baik.
  • Pelacakan riwayat kueri, sehingga Anda dapat menggunakan kembali kueri yang dijalankan sebelumnya.

Penampil Hasil

Penampil Hasil memungkinkan Anda berinteraksi dengan hasil kueri melalui fitur seperti:

  • Mengekspor hasil ke format CSV, JSON, atau Excel.
  • Opsi pencarian, filter, dan pengurutan untuk menganalisis data secara efisien.
  • Tampilan data persisten untuk mempertahankan konteks saat menavigasi antar tab.

Visualisasi Skema

Schema Visualizer memberi Anda tampilan interaktif berbasis diagram struktur database Anda tanpa menulis SQL apa pun. Klik kanan database (atau objek apa pun di bawahnya) di Object Explorer dan pilih Visualisasi Skema untuk meluncurkan visualizer.

Kemampuan utama meliputi:

  • Tampilan tabel penuh - Setiap tabel dirender sebagai kartu yang memperlihatkan kolom dan jenis datanya.
  • Garis hubungan - Hubungan kunci asing antar tabel digambar sebagai garis penghubung, sehingga Anda dapat melihat sekilas bagaimana model data Anda cocok bersama-sama.
  • Organisasi berbasis skema - Tabel dikelompokkan menurut skema induknya (misalnya, , public, hrecom), sehingga mudah untuk menavigasi database besar.
  • Tampilkan /sembunyikan menurut skema - Alihkan seluruh skema aktif atau nonaktif untuk fokus hanya pada bagian model yang Anda pedulikan, dan agar diagram tetap dapat dibaca pada database besar.
  • Geser dan perbesar - Navigasikan diagram besar dengan kontrol pan, zoom, dan pas ke layar standar.

Visualisasi Skema dapat digunakan dengan basis data apa pun yang terhubung, termasuk PostgreSQL lokal dan kluster Azure HorizonDB.

Visualisasi Grafik Apache AGE

Apache AGE Graph Visualizer memungkinkan Anda menjalankan kueri Apache AGE Cypher dan menjelajahi hasilnya sebagai grafik tepi simpul interaktif. Ekstensi secara otomatis mendeteksi hasil kueri grafik dan merendernya di penjelajah tampilan grafik dengan penjelasan per simpul, kontrol zoom dan pan, dukungan ekspor, dan gaya yang sesuai tema.

Ekstensi age diizinkan terdaftar secara default pada Azure HorizonDB, sehingga beban kerja grafik dapat berjalan pada kluster HorizonDB tanpa konfigurasi tambahan. Persyaratan yang sama berlaku saat Anda menulis kueri Cypher terhadap HorizonDB:

  • Mengembalikan objek penuh, bukan properti skalar - Visualizer grafik membutuhkan objek vertex dan edge lengkap. Kueri yang mengekstrak properti skalar (RETURN p.name, p.title) mengembalikan nilai teks biasa dan tidak akan dirender di visualizer. Sebagai gantinya, kembalikan objek lengkap dan beri nama variabel hubungan:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Atur disp_label untuk teks simpul yang bermakna - Tanpa disp_label, simpul menampilkan ID internal. Atur properti ini sehingga visualizer memperlihatkan label yang berguna:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    SET a.disp_label = a.title
    SET b.disp_label = b.title
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Cocokkan kolom output dengan objek yang dikembalikan - Klausa pembungkusAS (...) harus memiliki satu kolom per objek yang dikembalikan. Untuk kueri multi-hop, sertakan setiap simpul perantara dan tepi:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r1:BOUGHT_TOGETHER]->(mid:Product)-[r2:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r1, mid, r2, b
$$) AS (a agtype, r1 agtype, mid agtype, r2 agtype, b agtype);

Integrasi AI (Azure HorizonDB)

Saat terhubung ke kluster Azure HorizonDB, ekstensi ini menyediakan antarmuka penulisan utama untuk kemampuan AI HorizonDB, yang disajikan sebagai ekstensi dan fungsi PostgreSQL standar:

  • pgvector
    • Jenis data vektor dan operator kesamaan.
  • pg_diskann
    • Indeks vektor berkinerja tinggi dengan Pemfilteran Tingkat Lanjut, yang mengevaluasi WHERE predikat selama traversal grafik vektor sehingga kueri kesamaan yang difilter kembali lebih cepat dan lebih konsisten.
  • azure_ai
    • Fungsi AI seperti azure_ai.generate(), , azure_ai.is_true()azure_ai.extract(), dan azure_openai.create_embeddings().
  • Manajemen Model AI (pratinjau terbatas)
    • Ketika diaktifkan pada kluster, HorizonDB secara otomatis menyediakan model obrolan default (gpt-5) dan model penyematan default (text-embedding-3-small) melalui Microsoft Foundry, menginstal dan mengonfigurasi azure_ai, dan menghubungkan Fungsi AI ke model terkelola tersebut - tidak diperlukan penanganan kunci manual. Anda juga dapat mendaftarkan deployment Microsoft Foundry milik Anda sendiri (Bring Your Own Model) dan memanggilnya menggunakan alias dari AI Functions yang sama.

Anda dapat membuat dan menjalankan beban kerja AI ini langsung dari Editor Kueri, dan Results Viewer menampilkan output vektor dan JSONB secara langsung.

Pipeline dan Alur Kerja

Saat terhubung ke kluster Azure HorizonDB dengan pipeline AI atau pg_durable alur kerja, ekstensi menyediakan tampilan Pipeline & Alur Kerja untuk memeriksa riwayat eksekusi dan memantau status proses berjalan.

Akses ini dengan mengeklik kanan database Anda dan memilih Pipelines & Workflows. Anda akan melihat dua tab:

  • Alur AI: Melihat definisi alur, memeriksa eksekusi, dan melacak grafik eksekusi dengan jenis langkah berkode warna (biru untuk sumber/sink, hijau untuk pemrosesan, merah muda untuk panggilan eksternal). Gunakan ini untuk memverifikasi perilaku pipeline dan memeriksa status eksekusi, ID eksekusi, waktu mulai, dan durasi.
  • Alur kerja: Memeriksa pg_durable instans alur kerja dengan tab untuk grafik, analisis waktu, dan hasil. Navigasikan dari alur kerja yang dijalankan ke definisi alur terkait untuk perbandingan dan pemecahan masalah.

Tampilan ini menghilangkan kebutuhan untuk beralih antara kueri SQL dan editor Anda, sehingga mudah untuk memantau beban kerja dan pg_durable orkestrasi AI yang berjalan lama.

Integrasi GitHub Copilot

Ekstensi ini terintegrasi dengan GitHub Copilot untuk menawarkan bantuan berbasis AI yang disesuaikan dengan pengembangan PostgreSQL. Dengan perintah seperti @pgsql, Anda dapat mengkueri database, mengoptimalkan skema, dan meminta Copilot untuk menjalankan operasi SQL tertentu terhadap kluster horizonDB Azure. Copilot mendeteksi konteks koneksi aktif—termasuk ekstensi yang terpasang pada target—sehingga saran untuk koneksi HorizonDB mempertimbangkan pgvector, pg_diskann, azure_ai, dan age.

Sistem operasi yang didukung

Ekstensi PostgreSQL berfungsi dengan sistem operasi berikut:

  • Windows
  • macOS
  • Linux

Ekstensi ini mendukung berbagai distribusi Linux, termasuk Ubuntu, Fedora, dan Red Hat Enterprise Linux.

Tanggapan dan dukungan

Untuk bug, permintaan fitur, dan masalah, gunakan alat umpan balik bawaan di Visual Studio Code. Anda dapat menyelesaikan umpan balik ini melalui menu Bantuan Visual Studio Code atau palet perintah PGSQL.

  • Menu Bantuan
    • Pergi ke Bantuan > Laporkan Masalah
  • Palet perintah
    • Buka Palet Perintah dengan Ctrl + Shift + P dan jalankan: PGSQL: Report Issue

Konten terkait

  • Terakhir diperbarui pada