Quickstart: PostgreSQL-extensie voor Visual Studio Code voor Azure HorizonDB (preview)

De PostgreSQL-extensie voor Visual Studio Code stroomlijnt de ontwikkeling en het beheer van PostgreSQL-databases. Deze handleiding helpt u bij het maken van verbinding met een PostgreSQL-database en het uitvoeren van query's binnen Visual Studio Code.

Dezelfde werkstroom is van toepassing of u verbinding maakt met:

  • Een lokale PostgreSQL-installatie,
  • Een Azure HorizonDB cluster.

Prerequisites

Controleer voordat u begint of u de juiste hulpprogramma's en resources hebt gedownload en geïnstalleerd.

De PostgreSQL-extensie installeren

De PostgreSQL-extensie installeren:

  1. Open Visual Studio Code en ga naar de weergave Extensies door het pictogram Extensions te selecteren in de activiteitenbalk of met behulp van de opdracht Weergave: Extensies.
  2. Zoek naar PostgreSQL in de Extensions Marketplace.
  3. Selecteer de PostgreSQL-extensie die is gemaakt door Microsoft en selecteer Installeren.

Na de installatie wordt het pictogram van de PostgreSQL-extensie weergegeven in de zijbalk Visual Studio Code.

Een verbinding met PostgreSQL toevoegen

Of u nu lokaal of op een externe server gehost, verbinding maakt met een PostgreSQL-database is een fundamentele stap in het beheren en communiceren met uw gegevens. Dit proces omvat het opgeven van de benodigde verbindingsgegevens, zoals het serveradres, de poort en verificatiereferenties, om een beveiligde koppeling tot stand te brengen tussen uw clienttoepassing en de database.

  1. Selecteer het olifantpictogram op de zijbalk om de PostgreSQL-extensiepagina te openen.
  2. Selecteer de knop Verbinding toevoegen .
  3. Voer de verbindingsgegevens handmatig in of plak een verbindingsreeks.
  4. Als u Azure gebruikt, meldt u zich aan bij uw Azure-account en bladert u naar het database-exemplaar. Filteren op abonnement, resourcegroep, server/cluster en databasenaam. Azure HorizonDB-clusters in de abonnementen waarvoor u toegang hebt, worden vermeld.

Indeling van verbindingstekenreeks

Een Azure HorizonDB-cluster heeft twee eindpunten. Kies degene die overeenkomt met uw werklast:

  • Eindpunt lezen/schrijven : maakt verbinding met het primaire eindpunt, dat zowel lees- als schrijfbewerkingen accepteert. Gebruik dit eindpunt voor schrijfbewerkingen, schemawijzigingen en leesbewerkingen van toepassingen die de meest recente vastgelegde gegevens moeten zien.
  • Eindpunt lezer : hiermee worden verbindingen automatisch verdeeld over alle leesbare HA-replica's in het cluster. Gebruik dit eindpunt voor het opschalen van leesbewerkingen, rapportage en analytische workloads. Er worden momenteel maximaal vier leesbare HA-replica's ondersteund (oplopend tot 8), elke grootte identiek aan de primaire replica.

Beide eindpunthostnamen worden weergegeven op de pagina Overview en op de pagina Replicas in de Azure-portal. De verbindingsreeks-indeling is het standaard libpq-formulier:

# Read/write endpoint (primary)
psql "host=<cluster-name>.<region>.horizondb.azure.com port=5432 dbname=<database> user=<user> sslmode=require"

# Reader endpoint (load-balanced HA replicas)
psql "host=<cluster-name>-reader.<region>.horizondb.azure.com port=5432 dbname=<database> user=<user> sslmode=require"

Een veelvoorkomend patroon is om twee profielen op te slaan in de Verbindingsbeheer: één voor het eindpunt lezen/schrijven en één voor het eindpunt van de lezer, en schakelen tussen deze profielen op basis van de taak.

Authentication

De extensie ondersteunt twee verificatiemethoden:

  • Gebruikersnaam/wachtwoord : voer uw databasereferenties rechtstreeks in de verbindingsvelden in.

Schermopname van de PostgreSQL-extensie voor Visual Studio Code verbindingsdialoogvenster.

De verbinding testen en opslaan

  1. Selecteer Verbinding testen om de verbindingsgegevens te controleren.
  2. Bij een geslaagde test wordt in het testvak een vinkje weergegeven.
  3. Selecteer Verbinding maken om de verbinding tot stand te brengen.
  4. De verbinding wordt automatisch opgeslagen en weergegeven in het venster Verbindingen.

Als de test mislukt bij het maken van verbinding met een in de cloud gehoste database, controleert u of uw client-IP-adres is toegestaan door de firewallregels van het cluster (HorizonDB). Beide services ondersteunen momenteel openbare toegang met IP-acceptatielijst; ondersteuning voor privé-eindpunten in HorizonDB staat op de roadmap.

Databaseobjecten verkennen

Objectverkenner biedt een hiërarchische weergave van uw databaseobjecten:

  • Vouw het database-item uit om schema's, tabellen, weergaven, functies en opgeslagen procedures weer te geven.
  • Klik met de rechtermuisknop op de database om opties weer te geven voor:
    • Een nieuwe query starten
    • Chatten met deze database (start de @pgsql chatervaring)
    • Verbinding maken met PSQL om een psql terminalverbinding te starten
  • Klik met de rechtermuisknop op een tabel en selecteer Top 1000 selecteren om de gegevens ervan weer te geven. De query wordt geopend in de queryeditor en de resultaten worden weergegeven op het tabblad Resultatenviewer.

Op een Azure HorizonDB-verbinding kunt u ook de toegestane extensies weergeven die beschikbaar zijn op het cluster met:

SELECT * FROM pg_available_extensions ORDER BY name;

Algemene HorizonDB-extensies die u mogelijk in uw database wilt installeren, zijn onder anderevector, pg_diskannenazure_aiage:

CREATE EXTENSION IF NOT EXISTS azure_ai;
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS pg_diskann;
CREATE EXTENSION IF NOT EXISTS age;

Queries uitvoeren

Gebruik de Query-editor om SQL-query's op te stellen en uit te voeren:

  • Profiteer van contextbewuste IntelliSense voor het automatisch aanvullen van SQL-trefwoorden en objectnamen.
  • Gebruik syntaxismarkering en autoopmaak voor een betere leesbaarheid en nauwkeurigheid.
  • Eerder uitgevoerde query's openen via het deelvenster Querygeschiedenis.

Lees- en schrijfbewerkingen naar HorizonDB routeren

Wanneer u profielen hebt voor zowel de eindpunten lezen/schrijven als de lezer, kiest u de juiste verbinding in de verbindingskiezer van het Power Query-editor voordat u een query uitvoert. Schrijfbewerkingen en DDL moeten worden uitgevoerd op het lees-/schrijfeindpunt; het leeseindpunt accepteert alleen-lezenquery’s en verdeelt deze over HA-replica’s.

Queryresultaten bekijken

De Resultatenviewer biedt geavanceerde functies voor interactie met uw queryresultaten:

  • Exporteer resultaten naar CSV-, JSON- of Excel-indelingen voor verdere analyse.
  • Gebruik zoek-, filter- en sorteeropties om uw gegevens te verfijnen.
  • Permanente gegevensweergaven behouden context terwijl u schakelt tussen tabbladen.

GitHub Copilot gebruiken voor geavanceerde hulp

De GitHub Copilot-integratie verbetert uw PostgreSQL-ontwikkelervaring door ai-codesuggesties, tips voor queryoptimalisatie en hulp bij interactieve databases te bieden. Met deze functie kunt u uw werkstroom stroomlijnen, de ontwikkelingstijd verminderen en meer inzicht krijgen in uw databasebewerkingen.

Zorg ervoor dat de GitHub Copilot- en Copilot Chat-extensies zijn geïnstalleerd. Meld u aan bij uw GitHub-account en schakel de @pgsql Copilot Chat-agent in in de extensie-instellingen.

Interactieve databasevragen

Klik met de rechtermuisknop op een database en selecteer Chat met deze database om te communiceren met Copilot.

Schrijfprompts zoals in het volgende voorbeeld om gedetailleerde inzichten en suggesties te ontvangen.

@pgsql tell me about the tables in the HR schema

Wanneer Copilot verbonden is met een Azure HorizonDB-cluster, neemt Copilot de context van de liveverbinding over, waaronder informatie over welke extensies zijn geïnstalleerd, zodat prompts gebruik kunnen maken van HorizonDB-mogelijkheden zoals pgvector, pg_diskann Geavanceerd filteren en de azure_ai AI-functies.

Zie Quickstart: GitHub Copilot configureren voor postgreSQL-extensie in Visual Studio Code voor meer informatie.

Verbinding maken met Visual Studio Code

De optie Aanvoegingsverbinding in de PostgreSQL-extensie voor Visual Studio Code vereenvoudigt het maken van verbinding met uw Azure HorizonDB-cluster. Deze functie stroomlijnt de installatie door u te begeleiden bij de benodigde verbindingsgegevens.

Gebruik de knop Verbinding toevoegen om een nieuwe verbinding met uw HorizonDB-cluster te maken. U kunt ervoor kiezen om de verbinding vooraf te vullen met het eindpunt lezen/schrijven of het eindpunt van de lezer.

Vereisten bevestigen

  • Controleer in het zijvenster of aan alle vereisten (Visual Studio Code en de PostgreSQL-extensie) is voldaan door de juiste selectievakjes in te schakelen.
  • Download, indien nodig, Visual Studio Code en de extensie met behulp van de koppelingen in het zijvenster.
  • U kunt eventueel verbindingsparameters invullen, zoals de standaarddatabasenaam, verificatiemethode en groepsgewijze verbindingen.

Schermopname van de Azure-portal met het deelvenster Verbinding maken met Visual Studio Code met de knop Openen in Visual Studio Code gemarkeerd.

Openen in Visual Studio Code

  • Selecteer de knop Openen in Visual Studio Code in het zijvenster.
  • Als het meer dan 40 seconden duurt voordat Visual Studio Code en de extensie zijn geopend, wordt de knop Opnieuw openen in Visual Studio Code weergegeven in het zijvenster.

Visual Studio Code starten

  • Als Visual Studio Code is geïnstalleerd en wordt uitgevoerd, wordt het verbindingsdialoogvenster van de PostgreSQL-extensie automatisch gestart.
  • Als Visual Studio Code is geïnstalleerd maar niet is geopend, wordt deze binnen ongeveer 40 seconden gestart, gevolgd door het verbindingsdialoogvenster.

Geef authenticatiegegevens

Selecteer de gewenste verificatiemethode:

  • Wachtwoordverificatie : voer uw gebruikersnaam en wachtwoord handmatig in.

Geef andere verbindingsgegevens op, zoals profielnaam, databasenaam (optioneel), servergroep en poortnummer.

Opslaan en verbinding maken

Selecteer de knop Opslaan en verbinden om de verbinding tot stand te brengen. Nadat u verbinding hebt gemaakt, vouwt u de server uit in de objectverkennerstructuur om databases, schema's en tabellen weer te geven of gebruikt u het ingebouwde queryhulpprogramma om uw databaseobjecten te beheren.

Troubleshoot

Als u problemen ondervindt tijdens het verbindingsproces:

  • Controleer of Visual Studio Code en de PostgreSQL-extensie zijn geïnstalleerd en ingeschakeld.
  • Zorg ervoor dat uw client-IP-adres is toegestaan in het Azure HorizonDB-cluster.
  • Controleer voor HorizonDB of u verbinding maakt met het juiste eindpunt voor uw werkbelasting. Schrijfbewerkingen moeten het eindpunt lezen/schrijven richten, niet op het eindpunt van de lezer.
  • Als u niet aan de vereisten voldoet, geeft het zijvenster feedback en stappen om het probleem op te lossen, inclusief het opnieuw proberen van de verbinding.
  • Controleer of uw gebruikersnaam en referenties juist zijn voor de database.

Feedback en ondersteuning

Voor bugs, functieaanvragen en problemen gebruikt u het ingebouwde feedbackhulpprogramma in Visual Studio Code. U kunt dit feedbackproces voltooien via het menu Help van Visual Studio Code of het PGSQL-opdrachtenpalet.

  • Help-menu
    • Ga naar Help Probleem Rapporteren>
  • Opdrachtpalet
    • Open het opdrachtenpalet met Ctrl + Shift + P en voer het volgende uit: PGSQL: Report Issue

Verwante inhoud

  • Last updated on