Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De PostgreSQL-extensie voor Visual Studio Code vereenvoudigt het beheer en de ontwikkeling van PostgreSQL-databases. U kunt verbinding maken met PostgreSQL-databases, query's schrijven en uitvoeren en databaseobjecten beheren zonder Visual Studio Code te verlaten.
De extensie kan worden geïntegreerd met door Azure beheerde PostgreSQL-services, waaronder:
- Azure HorizonDB - een cloudeigen PostgreSQL-service die is gebouwd voor werkbelastingen in laag 1. HorizonDB biedt een niet-geaggregeerde opslag-/rekenarchitectuur, doorvoeringen met lage latentie, snelle failover, uitschalen met gelijke taakverdeling voor leesbare HA-replica's en uitgebreide AI-integratie.
Dezelfde extensie werkt tegen beide diensten. Waar gedrag verschilt (bijvoorbeeld verbindingseindpunten of ondersteunde verificatiemethoden), wordt dit beschreven in de volgende secties.
De extensie installeren
U kunt de PostgreSQL-extensie rechtstreeks installeren vanuit de Extensions Marketplace in Visual Studio Code. Volg deze stappen:
- Open de weergave Extensies in Visual Studio Code door het pictogram Extensions te selecteren in de activiteitenbalk of met behulp van de opdracht Weergave: Extensies.
- Zoek naar PostgreSQL in de Extensions Marketplace.
- Selecteer de PostgreSQL-extensie die is gemaakt door Microsoft en selecteer Installeren.
Wanneer u de extensie installeert, wordt er een olifantpictogram weergegeven dat de PostgreSQL-pagina in de zijbalk van Visual Studio Code vertegenwoordigt.
Features
De PostgreSQL-extensie voor Visual Studio Code biedt de volgende functies voor Azure HorizonDB.
Verbindingsbeheer
Verbindingsbeheer vereenvoudigt het maken van verbinding met lokale en in de cloud gehoste PostgreSQL-databases. Tot de belangrijkste functionaliteiten behoren:
- Ondersteuning voor meerdere verbindingsprofielen, zodat u verbinding kunt maken met en meerdere PostgreSQL-exemplaren naast elkaar kunt beheren, waaronder een combinatie van Azure HorizonDB-clusters.
- Verbindingsreeks parseren voor naadloze connectiviteit, ongeacht of u verbinding maakt met een lokale database, een Azure HorizonDB-cluster.
- Integratie met Azure HorizonDB voor direct bladeren en filteren van exemplaren op abonnement, resourcegroep, server/cluster en database.
Azure HorizonDB-verbindingseindpunten
Azure HorizonDB maakt twee eindpunten beschikbaar, die u als afzonderlijke verbindingsprofielen in de extensie kunt toevoegen:
- Eindpunt lezen/schrijven : maakt verbinding met de primaire, die zowel lees- als schrijftransacties accepteert. Gebruik dit eindpunt voor schrijfbewerkingen, schemawijzigingen en eventuele leesworkloads waarvoor de meest recente vastgelegde gegevens zijn vereist. Het eindpunt wordt weergegeven op de pagina Overview en op de pagina Replicas in de Azure-portal.
- Lezer-eindpunt - Verdeelt automatisch alle alleen-lezenverbindingen over alle leesbare HA-replica's in het cluster. Gebruik dit eindpunt voor het lezen van uitschaalworkloads, rapportage en analyses. Er worden momenteel maximaal vier leesbare HA-replica's ondersteund (oplopend tot 8), elke grootte identiek aan de primaire replica.
Een typisch patroon is om twee profielen op te slaan in de Verbindingsbeheer, één die wijst naar het eindpunt voor lezen/schrijven en één die wijst op het eindpunt van de lezer, en schakelen tussen deze profielen in de Objectverkenner op basis van de taak die u bij de hand hebt.
Objectverkenner
De verbeterde objectverkenner biedt een hiërarchische weergave van databaseobjecten, waardoor u eenvoudiger schema's, tabellen, weergaven en functies kunt bladeren en beheren. Belangrijke functies zijn:
- Geavanceerde filteropties om snel specifieke objecten te vinden.
- Mogelijkheden voor het maken, wijzigen en verwijderen van databaseobjecten, zoals tabellen, weergaven en opgeslagen procedures.
- Visualisatie van databaseschema's en relaties voor gestroomlijnde navigatie.
- Voor Azure HorizonDB kunt u de 55+ toegestane extensies die beschikbaar zijn op het cluster controleren via de catalogusweergave
pg_available_extensionsrechtstreeks vanuit de Power Query-editor.
Querybewerker
De queryeditor verbetert het opstellen en uitvoeren van query's met:
- Contextbewuste IntelliSense voor automatisch aanvullen van SQL-trefwoorden, tabelnamen en functies.
- Syntaxismarkering en automatische opmaak voor betere leesbaarheid van query's.
- Bijhouden van querygeschiedenis, zodat u eerder uitgevoerde query's opnieuw kunt gebruiken.
Resultatenviewer
Met de resultatenviewer kunt u communiceren met queryresultaten via functies zoals:
- Resultaten exporteren naar CSV-, JSON- of Excel-indelingen.
- Zoek-, filter- en sorteeropties om gegevens efficiënt te analyseren.
- Permanente gegevensweergaven om context te behouden tijdens het navigeren tussen tabbladen.
Schemavisualisatie
De schema visualiseren biedt u een interactieve, diagramgebaseerde weergave van uw databasestructuur zonder SQL te schrijven. Klik met de rechtermuisknop op een database (of een object eronder) in de Objectverkenner en selecteer Visualize Schema om de visualisatie te starten.
Tot de belangrijkste mogelijkheden behoren:
- Volledige tabelweergave : elke tabel wordt weergegeven als een kaart met de kolommen en gegevenstypen.
- Relatielijnen : relaties tussen tabellen worden getekend als verbindingslijnen, zodat u in één oogopslag kunt zien hoe uw gegevensmodel bij elkaar past.
-
Op schema's gebaseerde organisatie : tabellen worden gegroepeerd op het bovenliggende schema (bijvoorbeeld
public,hr),ecomzodat u eenvoudig door grote databases kunt navigeren. - Weergeven/verbergen per schema - Schakel volledige schema's in of uit zodat u zich alleen richt op de onderdelen van het model die voor u relevant zijn en diagrammen leesbaar blijven bij grote databases.
- Pannen en zoomen - Navigeer door grote diagrammen met standaardbediening voor pannen, zoomen en aanpassen aan scherm.
Schemavisualisatie werkt voor elke verbonden database, waaronder lokale PostgreSQL- en Azure HorizonDB-clusters.
Visualisatie van Apache AGE Graph
Met Apache AGE Graph Visualizer kunt u Apache AGE Cypher-query's uitvoeren en de resultaten verkennen als een interactieve knooppuntrandgrafiek. De extensie detecteert automatisch grafiekqueryresultaten en geeft deze weer in een visual explorer met bijschriften per knooppunt, zoom- en panbesturingselementen, exportondersteuning en themabewuste stijl.
De extensie age wordt standaard vermeld op Azure HorizonDB, zodat grafiekworkloads kunnen worden uitgevoerd op een HorizonDB-cluster zonder extra configuratie. Dezelfde vereisten zijn van toepassing wanneer u Cypher-query's voor HorizonDB ontwerpt:
Volledige objecten retourneren, niet scalaire eigenschappen : de graph visualizer heeft volledige hoekpunt- en randobjecten nodig. Query's waarmee scalaire eigenschappen (
RETURN p.name, p.title) worden geëxtraheerd, retourneren waarden voor tekst zonder opmaak en worden niet weergegeven in de visualisatie. Retourneer in plaats daarvan de volledige objecten en noem de relatievariabele:SELECT * FROM cypher('my_graph', $$ MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product) RETURN a, r, b $$) AS (a agtype, r agtype, b agtype);Instellen
disp_labelvoor zinvolle knooppunttekst - Zonderdisp_label, knooppunten geven interne id's weer. Stel deze eigenschap in zodat de visualisatie nuttige labels weergeeft: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);Stem uitvoerkolommen af op geretourneerde objecten - De wrapper-component
AS (...)moet één kolom per geretourneerd object hebben. Neem voor query's met meerdere hops elk tussenliggend knooppunt en elke edge op: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);
AI-integratie (Azure HorizonDB)
Wanneer de extensie is verbonden met een Azure HorizonDB-cluster, beschikt u over een eersteklas ontwerpoppervlak voor ai-mogelijkheden van HorizonDB, die worden weergegeven als standaard PostgreSQL-extensies en -functies:
pgvector- Operatoren voor vectorgegevenstype en overeenkomsten.
pg_diskann- Hoogpresterende vectorindex met Advanced Filtering, waarbij
WHEREpredicaten worden geëvalueerd tijdens het doorlopen van de vectorgraaf, zodat gefilterde similariteitsquery's sneller en consistenter resultaten opleveren.
- Hoogpresterende vectorindex met Advanced Filtering, waarbij
azure_ai- AI-functies zoals
azure_ai.generate(),azure_ai.is_true(),azure_ai.extract()enazure_openai.create_embeddings().
- AI-functies zoals
-
AI-modelbeheer (beperkte preview)
- Wanneer Dit is ingeschakeld op het cluster, richt HorizonDB automatisch een standaardchatmodel (
gpt-5) en een standaard insluitmodel (text-embedding-3-small) in via Microsoft Foundry, installeert en configureertazure_aien bedradt de AI-functies naar deze beheerde modellen. Er is geen handmatige sleutelafhandeling vereist. U kunt ook uw eigen Microsoft Foundry-implementaties (Bring Your Own Model) registreren en deze aanroepen met een alias van dezelfde AI-functies.
- Wanneer Dit is ingeschakeld op het cluster, richt HorizonDB automatisch een standaardchatmodel (
U kunt deze AI-workloads rechtstreeks vanuit de Power Query-editor ontwerpen en uitvoeren en de resultatenviewer geeft inline vector- en JSONB-uitvoer weer.
Pijplijnen en werkstromen
Wanneer de extensie is verbonden met een Azure HorizonDB-cluster met AI-pijplijnen of
U kunt deze openen door met de rechtermuisknop op uw database te klikken en Pijplijnen en werkstromen te selecteren. U ziet twee tabbladen:
- AI-pijplijnen: pijplijndefinities weergeven, uitvoeringen inspecteren en uitvoeringsgrafieken bijhouden met staptypen met kleurcode (blauw voor bron/sink, groen voor verwerking, roze voor externe aanroepen). Gebruik deze methode om het gedrag van de pijplijn te controleren en de uitvoeringsstatus, uitvoerings-id's, begintijden en duur te controleren.
-
Werkstromen: Inspecteer werkstroomexemplaren
pg_durablemet tabbladen voor grafieken, tijdsanalyse en resultaten. Navigeer vanuit een werkstroomuitvoering naar de bijbehorende pijplijndefinitie voor vergelijking en probleemoplossing.
Deze weergave elimineert de noodzaak om te schakelen tussen SQL-query's en uw editor, zodat u eenvoudig langlopende AI-workloads en pg_durable -indelingen kunt bewaken.
GitHub Copilot-integratie
Deze extensie kan worden geïntegreerd met GitHub Copilot om AI-gestuurde hulp te bieden die is afgestemd op PostgreSQL-ontwikkeling. Met opdrachten zoals @pgsql kunt u een query uitvoeren op uw database, het schema optimaliseren en Copilot aanvragen om specifieke SQL-bewerkingen uit te voeren op een Azure HorizonDB-cluster. Copilot de context van de liveverbinding ophaalt, inclusief extensies die op het doel zijn geïnstalleerd, zodat suggesties voor een HorizonDB-verbinding op de hoogte zijn van pgvector, pg_diskann, azure_ai en age.
Ondersteunde besturingssystemen
De PostgreSQL-extensie werkt met de volgende besturingssystemen:
- Windows
- macOS
- Linux
De extensie ondersteunt verschillende Linux-distributies, waaronder Ubuntu, Fedora en Red Hat Enterprise Linux.
Feedback en ondersteuning
Voor bugs, functieaanvragen en problemen gebruikt u het ingebouwde feedbackhulpprogramma in Visual Studio Code. U kunt deze feedback voltooien via het Menu Help van Visual Studio Code of het PGSQL-opdrachtpalet.
-
Help-menu
- Ga naar Help Probleem Rapporteren>
-
Opdrachtpalet
- Open het opdrachtenpalet met
Ctrl + Shift + Pen voer het volgende uit:PGSQL: Report Issue
- Open het opdrachtenpalet met