Co je rozšíření PostgreSQL pro Visual Studio Code? (Ukázka)

Rozšíření PostgreSQL pro Visual Studio Code zjednodušuje správu a vývoj databází PostgreSQL. Můžete se připojit k databázím PostgreSQL, zapisovat a spouštět dotazy a spravovat databázové objekty bez opuštění Visual Studio Code.

Rozšíření se integruje se službami PostgreSQL spravovanými Azure, včetně:

  • Azure HorizonDB – nativní cloudová služba PostgreSQL vytvořená pro podnikové úlohy vrstvy 1. HorizonDB nabízí oddělenou architekturu úložiště a výpočetní vrstvy, potvrzování transakcí s nízkou latencí, rychlé přepnutí při selhání, škálování čtení s vyrovnáváním zátěže napříč replikami HA určenými pro čtení a pokročilou integraci AI.

Stejné rozšíření funguje pro obě služby. Pokud se chování liší (například koncové body připojení nebo podporované metody ověřování), uvádí se v následujících částech.

Postup instalace rozšíření

Rozšíření PostgreSQL můžete nainstalovat přímo z Marketplace s rozšířeními v editoru Visual Studio Code. Postupujte takto:

  1. Otevřete zobrazení Rozšíření v Visual Studio Code výběrem ikony Extensions na panelu aktivit nebo pomocí příkazu View: Extensions.
  2. Vyhledejte PostgreSQL na trhu rozšíření.
  3. Vyberte rozšíření PostgreSQL vytvořené Microsoftem a vyberte Nainstalovat.

Když rozšíření nainstalujete, zobrazí se ikona slonu, která představuje stránku PostgreSQL na bočním panelu editoru Visual Studio Code.

Features

Rozšíření PostgreSQL pro Visual Studio Code poskytuje následující funkce pro Azure HorizonDB.

Správce připojení

Správce připojení zjednodušuje připojení k místním a cloudovým databázím PostgreSQL. Mezi klíčové funkce patří:

  • Podpora více profilů připojení, takže se můžete připojit k několika instancím PostgreSQL a spravovat je vedle sebe, včetně kombinace clusterů Azure HorizonDB.
  • Analýza připojovacího řetězce pro bezproblémové připojení, ať už se připojujete k místní databázi nebo ke clusteru Azure HorizonDB.
  • Integrace se službou Azure HorizonDB pro přímé procházení a filtrování instancí podle předplatného, skupiny prostředků, serveru nebo clusteru a databáze.

koncové body připojení Azure HorizonDB

Azure HorizonDB zveřejňuje dva koncové body, které můžete přidat jako samostatné profily připojení v rozšíření:

  • Koncový bod pro čtení/zápis – připojuje se k primárnímu, který přijímá transakce čtení i zápisu. Tento koncový bod použijte pro zápisy aplikací, změny schématu a všechny úlohy čtení, které vyžadují nejnovější potvrzená data. Koncový bod je uvedený na stránce clusteru Overview a na stránce Replicas na portálu Azure.
  • Koncový bod čtenáře – Automaticky vyrovnává zatížení připojení jen pro čtení napříč všemi replikami vysoké dostupnosti pro čtení v clusteru. Tento endpoint použijte pro úlohy se škálováním čtení, vytváření sestav a analytiku. Aktuálně jsou podporovány až čtyři repliky HA pro čtení (do budoucna až 8), přičemž každá má stejnou velikost jako primární instance.

Typickým vzorem je uložení dvou profilů v Správce připojení – jeden ukazuje na koncový bod čtení a zápisu a jeden ukazuje na koncový bod čtečky – a přepínat mezi nimi v Průzkumník objektů na základě úkolu.

Průzkumník objektů

Vylepšený Průzkumník objektů poskytuje hierarchické zobrazení databázových objektů, což usnadňuje procházení a správu schémat, tabulek, zobrazení a funkcí. Mezi velmi vhodné funkce patří:

  • Rozšířené možnosti filtrování pro rychlé vyhledání konkrétních objektů
  • Možnosti vytvářet, upravovat a odstraňovat databázové objekty, jako jsou tabulky, zobrazení a uložené procedury.
  • Vizualizace databázových schémat a relací pro zjednodušenou navigaci
  • Pro Azure HorizonDB můžete zkontrolovat 55 a více povolených rozšíření dostupných v clusteru prostřednictvím zobrazení katalogu pg_available_extensions přímo z Editor Power Query.

Editor Power Query

Editor dotazů vylepšuje možnosti vytváření a spouštění dotazů pomocí následujících možností:

  • IntelliSense pracující s kontextem pro automatické dokončování klíčových slov SQL, názvů tabulek a funkcí
  • Zvýrazňování syntaxe a automatické formátování pro lepší čitelnost dotazů
  • Sledování historie dotazů, abyste mohli opakovaně používat dříve spuštěné dotazy.

Prohlížeč výsledků

Prohlížeč výsledků umožňuje interakci s výsledky dotazů prostřednictvím funkcí, jako jsou:

  • Export výsledků do formátů CSV, JSON nebo Excelu
  • Možnosti hledání, filtrování a řazení pro efektivní analýzu dat
  • Trvalá zobrazení dat pro zachování kontextu při procházení mezi kartami.

Vizualizace schématu

Vizualizér schématu poskytuje interaktivní zobrazení struktury databáze založené na diagramech, aniž byste museli psát SQL. V Průzkumník objektů klikněte pravým tlačítkem na databázi (nebo na libovolný objekt) a vyberte Visualize Schema a spusťte vizualizér.

Mezi klíčové funkce patří:

  • Zobrazení celé tabulky – Každá tabulka se vykreslí jako karta se sloupci a datovými typy.
  • Čáry relací – Relace cizího klíče mezi tabulkami jsou nakresleny jako spojovací čáry, abyste viděli, jak datový model zapadá dohromady.
  • Organizace založená na schématu – Tabulky jsou seskupené podle nadřazeného schématu (například public, hr, ecom), což usnadňuje navigaci ve velkých databázích.
  • Zobrazit nebo skrýt podle schématu – Zapněte nebo vypněte celá schémata a zaměřte se jenom na části modelu, které vás zajímají, a aby byly diagramy čitelné pro velké databáze.
  • Posouvání a přiblížení – Procházejte velké diagramy pomocí standardních ovládacích prvků pro posouvání, přiblížení a přizpůsobení obrazovce.

Vizualizace schématu funguje s jakoukoli připojenou databází, včetně místních clusterů PostgreSQL a Azure HorizonDB.

Vizualizace Apache AGE Graphu

Vizualizér Apache AGE Graph umožňuje spouštět dotazy Apache AGE Cypher a zkoumat výsledky jako interaktivní graf hraničních uzlů. Rozšíření automaticky rozpozná výsledky dotazu na graf a vykreslí je v Průzkumníku vizuálů s popisky jednotlivých uzlů, ovládacími prvky lupy a posouvání, podporou exportu a styly s podporou motivu.

Rozšíření age je ve výchozím nastavení povolené v Azure HorizonDB, takže úlohy grafů se můžou spouštět v clusteru HorizonDB bez další konfigurace. Stejné požadavky platí při vytváření dotazů Cypher vůči HorizonDB:

  • Vrácení celých objektů, nikoli skalárních vlastností – vizualizér grafu potřebuje kompletní vrchol a hraniční objekty. Dotazy, které extrahují skalární vlastnosti (RETURN p.name, p.title) vrací hodnoty prostého textu a nevykreslí se ve vizualizéru. Místo toho vraťte úplné objekty a pojmenujte proměnnou relace:

    SELECT * FROM cypher('my_graph', $$
        MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
        RETURN a, r, b
    $$) AS (a agtype, r agtype, b agtype);
    
  • Nastavte disp_label smysluplný text pro uzly – Bez disp_label uzly zobrazují interní ID. Nastavte tuto vlastnost tak, aby vizualizér zobrazoval užitečné popisky:

    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);
    
  • Přiřaďte výstupní sloupce vráceným objektům – Wrapper AS (...) klauzule musí mít jeden sloupec na každý vrácený objekt. U víceskokových dotazů zahrňte každý mezilehlý uzel a hranu:

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

Integrace AI (Azure HorizonDB)

Když se připojíte ke clusteru Azure HorizonDB, rozšíření vám poskytne prvotřídní prostředí pro vytváření funkcí AI horizonDB, které jsou zpřístupněné jako standardní rozšíření a funkce PostgreSQL:

  • pgvector
    • Vektorový datový typ a operátory podobnosti
  • pg_diskann
    • Index vektorů s vysokým výkonem s pokročilým filtrováním, který vyhodnocuje WHERE predikáty během procházení vektorového grafu, takže filtrované dotazy podobnosti vrací rychleji a konzistentněji.
  • azure_ai
    • Funkce umělé inteligence, jako jsou azure_ai.generate(), azure_ai.is_true(), azure_ai.extract() a azure_openai.create_embeddings().
  • Správa modelů AI (omezená verze Preview)
    • Pokud je v clusteru povolený, HorizonDB automaticky zřídí výchozí chatovací model (gpt-5) a výchozí model vkládání (text-embedding-3-small) prostřednictvím Microsoft Foundry, nainstaluje a nakonfiguruje azure_ai a připojí funkce AI k těmto spravovaným modelům – nevyžaduje se žádná ruční manipulace s klíči. Můžete také zaregistrovat vlastní nasazení Microsoft Foundry (Přineste si vlastní model) a volat je aliasem ze stejných funkcí AI.

Tyto AI úlohy můžete vytvářet a spouštět přímo v editoru dotazů a prohlížeč výsledků zobrazuje vektorový a JSONB výstup přímo v řádku.

Kanály a pracovní postupy

Při připojení ke clusteru Azure HorizonDB s AI pipelines nebo pg_durable workflows poskytuje rozšíření zobrazení Pipelines & Workflows k zobrazení historie spuštění a sledování stavu běhu.

Přístup k databázi získáte tak, že kliknete pravým tlačítkem myši na databázi a vyberete Kanály a pracovní postupy. Zobrazí se dvě karty:

  • Kanály AI: Zobrazení definic kanálů, kontrola spuštění a sledování grafů provádění s barevně kódovanými typy kroků (modrá pro zdroj/jímku, zelená pro zpracování, růžová pro externí volání). Pomocí tohoto postupu můžete ověřit chování kanálu a zkontrolovat stav spuštění, ID spuštění, časy spuštění a dobu trvání.
  • Pracovní postupy: Kontrola pg_durable instancí pracovního postupu pomocí karet pro grafy, analýzu časování a výsledky Přejděte z běhu pracovního postupu na související definici pipeline kvůli porovnání a řešení potíží.

Toto zobrazení eliminuje nutnost přepínat mezi dotazy SQL a editorem, což usnadňuje monitorování dlouhotrvajících úloh a pg_durable orchestrací AI.

Integrace GitHub Copilotu

Toto rozšíření se integruje s GitHub Copilotem a nabízí pomoc řízenou AI přizpůsobenou vývoji PostgreSQL. Pomocí příkazů, jako je @pgsql, můžete dotazovat databázi, optimalizovat schéma a požádat Copilot o provedení konkrétních operací SQL v clusteru Azure HorizonDB. Copilot zachytí kontext živého připojení – včetně rozšíření nainstalovaných v cílovém prostředí – takže návrhy pro připojení k HorizonDB zohledňují pgvector, pg_diskann, azure_ai a age.

Podporované operační systémy

Rozšíření PostgreSQL funguje s následujícími operačními systémy:

  • Windows
  • macOS
  • Linux

Rozšíření podporuje různé distribuce Linuxu, včetně Ubuntu, Fedora a Red Hat Enterprise Linuxu.

Názory a podpora

V případě chyb, žádostí o funkce a problémů použijte integrovaný nástroj pro zpětnou vazbu v editoru Visual Studio Code. Tuto zpětnou vazbu můžete dokončit pomocí nabídky nápovědy editoru Visual Studio Code nebo palety příkazů PGSQL.

  • Nabídka Nápověda
    • Přejít na Nápověda > Nahlásit problém
  • Paleta příkazů
    • Otevřete paletu příkazů pomocí Ctrl + Shift + P a spusťte: PGSQL: Report Issue