Visual Studio Code için PostgreSQL uzantısı nedir? (Önizleme)

Visual Studio Code için PostgreSQL uzantısı PostgreSQL veritabanı yönetimini ve geliştirmesini basitleştirir. PostgreSQL veritabanlarına bağlanabilir, sorgu yazıp yürütebilir ve Visual Studio Code çıkmadan veritabanı nesnelerini yönetebilirsiniz.

Uzantı, aşağıdakiler dahil olmak üzere Azure yönetilen PostgreSQL hizmetleriyle tümleştirilir:

  • Azure HorizonDB - katman 1 kurumsal iş yükleri için oluşturulmuş buluta özel bir PostgreSQL hizmeti. HorizonDB; ayrılmış bir depolama/işlem mimarisi, düşük gecikmeli işlemeler, hızlı yük devretme, okunabilir HA çoğaltmaları arasında yük dengeli okuma ölçeği genişletme ve derin yapay zeka tümleştirmesi özelliklerine sahiptir.

Aynı uzantı her iki hizmette de çalışır. Davranış farklı olduğunda (örneğin, bağlantı uç noktaları veya desteklenen kimlik doğrulama yöntemleri), aşağıdaki bölümlerde vurgulanmıştır.

Uzantıyı yükleme

PostgreSQL uzantısını doğrudan Visual Studio Code'daki Uzantılar Marketi'nden yükleyebilirsiniz. Aşağıdaki adımları izleyin:

  1. Etkinlik Çubuğu'ndaki Extensions simgesini seçerek veya View: Extensions komutunu kullanarak uzantılar görünümünü Visual Studio Code açın.
  2. Uzantılar Marketi'nde PostgreSQL araması yapın.
  3. Microsoft tarafından yazılan PostgreSQL uzantısını seçin ve Yükle'yi seçin.

Uzantıyı yüklediğinizde, Visual Studio Code kenar çubuğunda PostgreSQL sayfasını temsil eden bir fil simgesi görünür.

Features

Visual Studio Code için PostgreSQL uzantısı, Azure HorizonDB için aşağıdaki özellikleri sağlar.

Bağlantı yöneticisi

Bağlantı Yöneticisi, yerel ve bulutta barındırılan PostgreSQL veritabanlarına bağlanmayı kolaylaştırır. Önemli işlevler şunlardır:

  • Birden çok bağlantı profili desteği, böylece Azure HorizonDB kümelerinin bir karışımı da dahil olmak üzere birden çok PostgreSQL örneğine yan yana bağlanabilir ve bu örnekleri yönetebilirsiniz.
  • İster yerel bir veritabanına ister Azure HorizonDB kümesine bağlanıyor olun, sorunsuz bağlantı için bağlantı dizesinin ayrıştırılması.
  • Örneklerin aboneliğe, kaynak grubuna, sunucuya/kümeye ve veritabanına göre doğrudan göz atılması ve filtrelenmesi için Azure HorizonDB ile tümleştirme.

Azure HorizonDB bağlantı uç noktaları

Azure HorizonDB, uzantıya ayrı bağlantı profilleri olarak ekleyebileceğiniz iki uç noktayı kullanıma sunar:

  • Okuma/yazma uç noktası - Hem okuma hem de yazma işlemlerini kabul eden birincile bağlanır. Uygulama yazma işlemleri, şema değişiklikleri ve en son işlenen verileri gerektiren tüm okuma iş yükleri için bu uç noktayı kullanın. Uç nokta küme Overview sayfasında ve Azure portalındaki Replicas sayfasında listelenir.
  • Okuyucu uç noktası - Kümedeki tüm okunabilir HA çoğaltmalarında salt okunur bağlantıları otomatik olarak yükler. Okuma ölçeği genişletme iş yükleri, raporlama ve analiz için bu uç noktayı kullanın. Şu anda, her biri birincil örnekle aynı boyutta olan en fazla dört okunabilir HA replikası desteklenmektedir (bu sayı 8’e çıkarılacaktır).

Yaygın bir yaklaşım, biri okuma/yazma uç noktasını, diğeri ise okuyucu uç noktasını gösteren iki profili Bağlantı Yöneticisi’a kaydetmek ve ardından yapılacak göreve bağlı olarak Nesne Gezgini’da bunlar arasında geçiş yapmaktır.

Nesne Gezgini

Gelişmiş Nesne Gezgini, veritabanı nesnelerinin hiyerarşik bir görünümünü sağlayarak şemalara, tablolara, görünümlere ve işlevlere göz atıp yönetmeyi kolaylaştırır. Önemli özellikler şunlardır:

  • Belirli nesneleri hızla bulmak için gelişmiş filtreleme seçenekleri.
  • Tablolar, görünümler ve saklı yordamlar gibi veritabanı nesneleri oluşturma, değiştirme ve silme özellikleri.
  • Kolaylaştırılmış gezinti için veritabanı şemalarının ve ilişkilerinin görselleştirmesi.
  • Azure HorizonDB için, kümede kullanılabilen 55'ten fazla izin verilen uzantıyı doğrudan Sorgu Düzenleyicisi'nden pg_available_extensions katalog görünümü aracılığıyla inceleyebilirsiniz.

Sorgu Düzenleyici

Sorgu Düzenleyicisi, aşağıdakilerle sorgu taslağı oluşturma ve yürütme deneyimini geliştirir:

  • SQL anahtar sözcüklerini, tablo adlarını ve işlevleri otomatik olarak tamamlamaya yönelik bağlama duyarlı IntelliSense.
  • Daha iyi sorgu okunabilirliği için söz dizimi vurgulama ve otomatik biçimlendirme.
  • Daha önce yürütülen sorguları yeniden kullanabilmek için sorgu geçmişi izleme.

Sonuç Görüntüleyicisi

Sonuç Görüntüleyicisi, aşağıdaki gibi özellikler aracılığıyla sorgu sonuçlarıyla etkileşim kurmanızı sağlar:

  • Sonuçları CSV, JSON veya Excel biçimlerine aktarma.
  • Verileri verimli bir şekilde analiz etmek için arama, filtreleme ve sıralama seçenekleri.
  • Sekmeler arasında gezinirken bağlamı korumak için kalıcı veri görünümleri.

Şema Görselleştirmesi

Şema Görselleştiricisi, herhangi bir SQL yazmadan veritabanı yapınızın etkileşimli, diyagram tabanlı bir görünümünü sağlar. Nesne Gezgini bir veritabanına (veya altındaki herhangi bir nesneye) sağ tıklayın ve Visualize Schema öğesini seçerek görselleştiriciyi başlatın.

Önemli özellikler şunlardır:

  • Tam tablo görünümü - Her tablo, sütunlarını ve veri türlerini gösteren bir kart olarak işlenir.
  • İlişki çizgileri - Tablolar arasındaki yabancı anahtar ilişkileri, bağlantı çizgileri olarak çizilir, böylece veri modelinizin birbirine nasıl uyduğunu bir bakışta görebilirsiniz.
  • Şema tabanlı kuruluş - Tablolar üst şemalarına göre gruplandırılır (örneğin, public, hr), ecombüyük veritabanlarında gezinmeyi kolaylaştırır.
  • Şemaya göre göster/gizle - Yalnızca modelin önem verdiği bölümlerine odaklanmak ve diyagramları büyük veritabanlarında okunabilir durumda tutmak için tüm şemaları açın veya kapatın.
  • Kaydırma ve yakınlaştırma - Standart kaydırma, yakınlaştırma ve ekrana sığdır denetimleriyle büyük diyagramlarda gezinin.

Şema Görselleştirmesi, yerel PostgreSQL ve Azure HorizonDB kümeleri de dahil olmak üzere tüm bağlı veritabanlarında çalışır.

Apache AGE Graf Görselleştirmesi

Apache AGE Graph Görselleştiricisi, Apache AGE Cypher sorgularını çalıştırmanıza ve sonuçları etkileşimli bir düğüm uç grafiği olarak keşfetmenize olanak tanır. Uzantı, grafik sorgu sonuçlarını otomatik olarak algılar ve düğüm başına açıklama kutuları, yakınlaştırma ve kaydırma denetimleri, dışarı aktarma desteği ve tema duyarlı stil ile görsel bir gezginde görselleştirir.

age uzantısı varsayılan olarak Azure HorizonDB'de listelenir, bu nedenle grafik iş yükleri ek yapılandırma olmadan bir HorizonDB kümesinde çalıştırılabilir. HorizonDB'de Cypher sorguları yazarken de aynı gereksinimler geçerlidir:

  • Skaler özellikleri değil tam nesneleri döndürme - Grafik görselleştiricisinin tam köşe ve kenar nesneleri olması gerekir. Skaler özellikleri (RETURN p.name, p.title) ayıklayan sorgular düz metin değerleri döndürür ve görselleştiricide işlenmez. Bunun yerine, tam nesneleri döndürerek ilişki değişkenini adlandırın:

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

  • Anlamlı düğüm metni ayarla disp_label - disp_label olmadan, düğümler iç kimlikleri görüntüler. Görselleştiricinin yararlı etiketler göstermesi için bu özelliği ayarlayın:

    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);

  • Çıkış sütunlarını döndürülen nesnelerle eşleştir - Sarmalayıcı AS (...) yan tümcesinin döndürülen nesne başına bir sütunu olmalıdır. Çok atlamalı sorgular için her ara düğümü ve kenarı ekleyin:

    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);

Yapay zeka tümleştirmesi (Azure HorizonDB)

Bir Azure HorizonDB kümesine bağlanıldığında uzantı, standart PostgreSQL uzantıları ve işlevleri olarak kullanıma sunulan HorizonDB'nin yapay zeka özellikleri için birinci sınıf bir yazma yüzeyi sağlar:

  • pgvector
    • Vektör veri türü ve benzerlik işleçleri.
  • pg_diskann
    • Filtrelenmiş benzerlik sorgularının daha hızlı ve daha tutarlı bir şekilde döndürülmesi için vektör grafı geçişi sırasındaki önkoşulları WHERE değerlendiren Gelişmiş Filtreleme ile yüksek performanslı vektör dizini.
  • azure_ai
    • azure_ai.generate(), azure_ai.is_true(), azure_ai.extract() ve azure_openai.create_embeddings() gibi yapay zeka işlevleri.
  • Yapay Zeka Modeli Yönetimi (sınırlı önizleme)
    • Kümede etkinleştirildiğinde HorizonDB, Microsoft Foundry aracılığıyla otomatik olarak bir varsayılan sohbet modeli (gpt-5) ve varsayılan bir ekleme modeli (text-embedding-3-small) sağlar, azure_ai yükler ve yapılandırılır ve yapay zeka İşlevlerini bu yönetilen modellere aktarır; el ile anahtar işleme gerekmez. Ayrıca kendi Microsoft Dökümhane dağıtımlarınızı kaydedebilir (Kendi Modelinizi Getir) ve bunları aynı yapay zeka İşlevleri'nden diğer adla çağırabilirsiniz.

Bu yapay zeka iş yüklerini doğrudan Sorgu Düzenleyicisi yazabilir ve çalıştırabilirsiniz; Sonuç Görüntüleyicisi vektör ve JSONB çıkışını satır içinde işler.

İşlem Hatları ve İş Akışları

Azure HorizonDB kümesine yapay zeka işlem hatları veya pg_durable iş akışlarıyla bağlanıldığında, uzantı yürütme geçmişini incelemek ve çalıştırma durumunu izlemek için İşlem Hatları ve İş Akışları görünümü sunar.

Veritabanınıza sağ tıklayıp İşlem Hatları ve İş Akışları'ı seçerek bu veritabanına erişin. İki sekme görürsünüz:

  • AI Pipelines: İşlem hattı tanımlarını görüntüleyin, çalıştırmaları inceleyin ve yürütme graflarını renk kodlu adım türleriyle izleyin (kaynak/havuz için mavi, işleme için yeşil, dış çağrılar için pembe). Bunu, işlem hattının davranışını doğrulamak ve çalıştırma durumunu, çalıştırma kimliklerini, başlangıç zamanlarını ve süreyi denetlemek için kullanın.
  • İş akışları: Grafikler, zamanlama analizi ve sonuçlar için sekmelerle iş akışı örneklerini inceleyin pg_durable . Karşılaştırma ve sorun giderme için bir iş akışı çalıştırmasından ilgili işlem hattı tanımına gidin.

Bu görünüm, SQL sorguları ile düzenleyiciniz arasında geçiş yapma gereksinimini ortadan kaldırarak uzun süre çalışan yapay zeka iş yüklerini ve pg_durable düzenlemelerini izlemeyi kolaylaştırır.

GitHub Copilot tümleştirmesi

Bu uzantı, PostgreSQL geliştirmeye özel yapay zeka destekli yardım sunmak için GitHub Copilot ile tümleştirilir. @pgsql gibi komutlarla veritabanınızı sorgulayabilir, şemanızı iyileştirebilir ve Azure HorizonDB kümesinde belirli SQL işlemlerini yürütmek için Copilot isteyebilirsiniz. Copilot, hedefte yüklü uzantılar da dahil olmak üzere canlı bağlantı bağlamını alır; bu nedenle HorizonDB bağlantısındaki öneriler pgvector, pg_diskann, azure_ai ve age hakkında bilgi alır.

Desteklenen işletim sistemleri

PostgreSQL uzantısı aşağıdaki işletim sistemleriyle çalışır:

  • Windows
  • macOS
  • Linux

Uzantı Ubuntu, Fedora ve Red Hat Enterprise Linux gibi çeşitli Linux dağıtımlarını destekler.

Geri bildirim ve destek

Hatalar, özellik istekleri ve sorunlar için Visual Studio Code'daki yerleşik geri bildirim aracını kullanın. Bu geri bildirimi Visual Studio Code Yardım menüsü veya PGSQL komut paleti aracılığıyla tamamlayabilirsiniz.

  • Yardım menüsü
    • Yardım > Sorun Bildir'e gidin
  • Komut paleti
    • Komut Paleti'ni şu şekilde Ctrl + Shift + P açın ve çalıştırın: PGSQL: Report Issue

İlgili içerik

  • Last updated on