Een PostgreSQL-server maken

Met de PostgreSQL-extensie voor Visual Studio Code kunt u nieuwe PostgreSQL-servers maken zonder de editor te verlaten. U kunt een lokale PostgreSQL-container maken met Docker of Podman voor ontwikkeling en testen, een volledig beheerde Azure Database for PostgreSQL flexibele server inrichten voor productieworkloads of een Azure HorizonDB-cluster (preview) maken voor scenario's op grote schaal.

Prerequisites

  • Visual Studio Code waarop de extensie is geïnstalleerd.
  • Voor een lokale containerserver: Docker of Podman is geïnstalleerd en beschikbaar voor de extensiehost. Als u afhankelijk bent van de instellingen van Container Tools, controleer containers.containerClient of containers.containerCommand. Anders detecteert de extensie Eerst Docker en vervolgens Podman.
  • Voor een Azure-server: een Azure-account met een actief abonnement. Als u nog geen account hebt, maakt u gratis een account.
  • Voor een Azure HorizonDB-cluster (preview): een Azure-account met een actief abonnement en toegang tot Azure HorizonDB (preview).

Open de hub Nieuwe server maken

  1. Zoek in de container van de Activity Bar van PostgreSQL de Verbindingen-boomstructuur.

  2. Selecteer de knop Nieuwe server maken boven aan de structuur Verbindingen of voer deze uit pgsql.createNewServer vanuit het opdrachtpalet.

    U kunt ook met de rechtermuisknop op een servergroep klikken in de structuur Verbindingen en Nieuwe server maken selecteren.

De hub Nieuwe PostgreSQL-server maken wordt geopend op een nieuw tabblad editor. Er worden drie opties weergegeven:

Option Beschrijving
Een lokale Docker PostgreSQL-server maken Hiermee maakt u een PostgreSQL-server in een lokale container. Ideaal voor ontwikkeling, testen en leren.
Een Azure Database for PostgreSQL Flexible Server-exemplaar maken Implementeert een volledig beheerde PostgreSQL-server in Azure. Geschikt voor productieworkloads en teamomgevingen.
Een Azure HorizonDB-exemplaar maken (Preview) Richt een cloud-native, een zeer schaalbaar PostgreSQL-cluster in Azure in.

Selecteer de kaart die overeenkomt met uw scenario.

Een lokale server maken met Docker of Podman

Docker en Podman bieden u een lichtgewicht, geïsoleerde PostgreSQL-container die op uw computer wordt uitgevoerd. Gebruik deze optie voor lokale ontwikkeling, prototypen of wanneer u een wegwerpdatabaseomgeving nodig hebt. De kaart- en landingspaginalabels vermelden Docker, maar de controle op vereisten kan ook Podman selecteren.

Stap 1: De inleiding bekijken

Nadat u de kaart Een lokale Docker PostgreSQL-server maken hebt geselecteerd, toont de extensie een welkomstpagina met de titel Moeiteloos een PostgreSQL-server op Docker, rechtstreeks in VS Code!. De pagina markeert belangrijke mogelijkheden:

  • Servercreatie met één klik: maak binnen enkele seconden een PostgreSQL-server zonder handmatige installatie.
  • Volledig geautomatiseerde installatie: de extensie haalt PostgreSQL op, configureert het en voert het uit in een geïsoleerde omgeving.
  • Eenvoudig beheer: u kunt uw PostgreSQL-container op elk gewenst moment starten, stoppen of verwijderen.

Selecteer Aan de slag om door te gaan.

Stap 2: Doorloop de controle van vereisten

De extensie opent Controleer uw containeromgeving en detecteert de runtime die deze kan gebruiken op de extensiehost. Als de instellingen van Container Tools al een client of opdracht selecteren, wordt die runtime op de pagina weergegeven als geselecteerd op basis van uw instellingen. Zo niet, controleert de extensie geïnstalleerde runtimes en gebruikt de extensie de eerste beschikbare optie, waarbij Docker vóór Podman wordt geprobeerd.

De lijst met vereisten begint altijd met runtimeselectie en controleert vervolgens of de gekozen runtime-CLI beschikbaar is en of de engine kan reageren. Op macOS of Windows met Podman kunnen mislukte enginecontroles richtlijnen bevatten voor het opstarten van Podman-machines. Als een controle mislukt, gebruikt u de help op het scherm, herstelt u de runtime en selecteert u Opnieuw om de controles opnieuw uit te voeren.

Stap 3: De verbinding configureren

Nadat aan de vereisten is voldaan, wordt het Je verbinding instellen-formulier weergegeven. De geselecteerde runtime wordt direct onder de paginakop weergegeven, zodat u kunt controleren of deze automatisch is gedetecteerd of gekozen uit uw instellingen. Vul de volgende velden in:

Configuratie Required Beschrijving
Verbindingsnaam No Een gebruiksvriendelijke weergavenaam voor het verbindingsprofiel. Fungeert ook als de standaardcontainernaam (spaties worden vervangen door onderstrepingstekens).
Containernaam Yes Naam van de container. Toegestane tekens: a-zA-Z0-9_.-.
Gebruikersnaam Yes Naam van supergebruiker voor het PostgreSQL-exemplaar. Wordt standaard ingesteld op postgres.
Wachtwoord Yes Wachtwoord voor het supergebruikersaccount.
Wachtwoord opslaan No Als dit is geselecteerd, slaat u het wachtwoord op, zodat u het niet hoeft in te voeren voor elke verbinding.
Databasenaam No Naam van de oorspronkelijke database. Wordt standaard ingesteld op postgres.

Selecteer Geavanceerde opties om extra instellingen uit te vouwen:

Configuratie Beschrijving
Gebonden poort Hostpoort gekoppeld aan de PostgreSQL-poort van de container (containerpoort 5432). Als dit veld leeg blijft, probeert de extensie maximaal 10 vrije poorten in het bereik 54500-55000. Geldig bereik: 1-65535. Nieuwe containers worden gepubliceerd op 127.0.0.1 zodat de opgeslagen verbinding hetzelfde IPv4-loopback-adres gebruikt.
Imageversie Container-image-tag die moet worden opgehaald. Wordt standaard ingesteld op latest.
Imageregister URL van containerregister (bijvoorbeeld myregistry.azurecr.io). De standaardinstelling is Docker Hub.
Imagenaam Naam van de containerimage. Wordt standaard ingesteld op postgres.
Imageplatform Platformdoel voor omgevingen met meerdere architectuur (bijvoorbeeld linux/amd64).

Stap 4: Maken en verbinding maken

Selecteer Maken om te beginnen met inrichten. De extensie toont inline voortgang voor het voorbereiden van containerinstellingen, het maken en starten van de container, wachten tot PostgreSQL gereed is en opslaan en verbinding maken.

De voettekst houdt Show task output links en de paginaacties rechts. Containertaken openen of focussen niet automatisch een terminal, dus gebruik Show task output alleen wanneer u de onderliggende runtimeopdrachten wilt controleren.

Als automatische poortselectie na 10 pogingen geen gratis poort kan vinden, geeft de pagina aan dat u handmatig een poort moet opgeven. Als de inrichting of gereedheid mislukt, bewaart de pagina de details van de poging en biedt het Retry of Close. Opnieuw proberen gebruikt de geaccepteerde instellingen van de mislukte poging.

Als u Annuleren selecteert terwijl de extensie nog steeds lokaal wacht, wordt de resterende wachttijd gestopt en wordt de verbinding verbroken die door die geannuleerde poging is geopend. Als u annuleert of sluiten, wordt een reeds gemaakte container niet verwijderd en wordt er geen profiel teruggedraaid dat al is opgeslagen.

Wanneer de laatste stap Opslaan en verbinden slaagt, wordt de server weergegeven in de structuur Verbindingen en kunt u direct beginnen met het uitvoeren van query's.

Tip

De lokale container blijft behouden na het opnieuw opstarten van Visual Studio Code. Als u het buiten de extensie wilt stoppen, starten, verwijderen of inspecteren, gebruikt u de Docker- of Podman-hulpprogramma's waarmee u normaal gesproken containers beheert.

Een flexibele Azure Database for PostgreSQL-server maken

Azure Database for PostgreSQL flexibele server is een volledig beheerde databaseservice die hoge beschikbaarheid, geautomatiseerde back-ups en intelligente afstemming van prestaties biedt. De extensie begeleidt u door een wizard met meerdere stappen om rechtstreeks vanuit Visual Studio Code een nieuwe server in te richten.

Stap 1: De inleiding bekijken

Nadat u de kaart Een exemplaar van Azure Database for PostgreSQL Flexible Server maken hebt geselecteerd, worden op een landingspagina de servicemogelijkheden beschreven:

  • Naadloze integratie van Azure: servers rechtstreeks inrichten in Visual Studio Code met ondersteuning voor Entra ID-verificatie.
  • Flexibele rekenkracht en opslag: kies uit vooraf geconfigureerde rekenlagen en opslagopties.
  • Easy Server Management: Beheer levenscyclus, prestaties en configuratie zonder de editor te verlaten.
  • Gebouwd voor ontwikkelaars: richt u op uw toepassing terwijl Azure infrastructuur afhandelt.

Selecteer Aan de slag om door te gaan. Selecteer desgewenst Niet meer weergeven om deze pagina voortaan over te slaan.

Stap 2: Aanmelden bij Azure

Met de extensie wordt een aanmeldingspagina geopend met het volgende bericht: 'Meld u aan bij uw Azure account met Entra ID om een Azure Database for PostgreSQL flexibele serverinstantie te maken'.

  • Als u al een Azure-account hebt aangemeld bij Visual Studio Code, gebruikt de extensie deze referenties automatisch.
  • Als u meerdere Azure accounts of tenants hebt, gebruikt u de accountwisselaar en tenantselector om de juiste identiteit te kiezen.

Stap 3: Serverinstellingen configureren

Na verificatie geeft de extensie een configuratieformulier weer dat is ingedeeld in secties. Een paneel met een kostenraming aan de rechterkant wordt bijgewerkt naarmate u selecties maakt.

Projectgegevens

Configuratie Beschrijving
Abonnement Selecteer het Azure-abonnement waarmee facturering en toegang worden beheerd. Alle abonnementen voor uw aangemelde account en tenant worden vermeld.
Resource Group Selecteer een bestaande resourcegroep of selecteer Nieuwe maken om er een te maken. De nieuwe resourcegroep wordt geïmplementeerd in dezelfde regio als de server.

Basics

Configuratie Beschrijving
Servernaam Een wereldwijd unieke naam voor de server. De extensie controleert de beschikbaarheid asynchroon en geeft een fout weer als de naam wordt gebruikt. De servernaam wordt onderdeel van de hostnaam van de verbinding (<server-name>.postgres.database.azure.com).
Regio De Azure regio waar de server is geïmplementeerd. De extensie valideert dat uw abonnement in de geselecteerde regio kan worden ingericht.
Clusteropties Kies Flexibele server - één knooppunt voor een server met één knooppunt of elastisch cluster - shardgegevens over meerdere knooppunten voor een gedistribueerde Database met meerdere knooppunten (Citus). Als u Elastisch cluster kiest, worden aanvullende instellingen weergegeven.
Aantal knooppunten (Alleen elastisch cluster) Gebruik de schuifregelaar Aantal knooppunten om het aantal knooppunten in het cluster te kiezen, van 1 tot 20.
Compute + opslag Selecteer een vooraf geconfigureerde reken- en opslaglaag. De beschikbare bundels zijn:
Bundle virtuele cores Storage Artikelnummer (SKU)
Dev/Test (standaard) 2 128 GB Standard_D2ds_v4
Standaard 4 256 GB Standard_D4ds_v4
prestatie 8 512 GB Standard_D8ds_v4

Tip

U kunt de berekening en opslag verder aanpassen met behulp van de knop Maken in Azure Portal onderaan het formulier, waarmee de volledige ervaring voor het maken van Azure portal wordt geopend.

Configuratie Beschrijving
PostgreSQL-versie De primaire PostgreSQL-versie die moet worden geïmplementeerd. Beschikbare versies: 18, 17, 16, 15 en 14. De standaardwaarde is 18. De beschikbare versies kunnen per regio verschillen. Als Elastic Cluster is geselecteerd, komen alleen 17 en 18 door de validatie. Overschakelen naar Elastic Cluster betekent dat het 17 of 18 blijft; een niet-ondersteunde selectie verandert in 17.

Authentication

In het formulier wordt een sectie ADMINISTRATOR ACCESS weergegeven. U moet ten minste één verificatiemethode inschakelen.

Configuratie Beschrijving
Mijn Entra ID gebruiken: <e-mail> Schakel het selectievakje in waarmee uw aangemelde Entra ID identiteit wordt ingesteld als serverbeheerder. Het e-mailbericht wordt automatisch ingevuld vanuit uw Azure aanmelding.
PostgreSQL-gebruiker en -wachtwoord maken Selectievakje waarmee traditionele PostgreSQL-verificatie is ingeschakeld. Als deze optie is geselecteerd, worden er drie extra velden weergegeven.

Wanneer u PostgreSQL-gebruiker en -wachtwoord maken selecteert, geeft u het volgende op:

Configuratie Beschrijving
Gebruikersnaam van de beheerder Aanmeldingsnaam voor het PostgreSQL-beheerdersaccount (bijvoorbeeld pgadmin). Moet beginnen met een letter en alleen letters, cijfers en onderstrepingstekens bevatten. Kan geen gereserveerde namen gebruiken, zoals admin, rootof guestnamen die beginnen met pg_.
Beheerderswachtwoord Wachtwoord voor het beheerdersaccount. Moet 8-128 tekens zijn en moet ten minste drie tekens bevatten: hoofdletters, kleine letters, cijfers en symbolen.
Beheerderswachtwoord bevestigen Voer het beheerderswachtwoord opnieuw in.

Note

U kunt beide verificatiemethoden tegelijk inschakelen. Bijvoorbeeld Entra ID voor teamleden en PostgreSQL-verificatie voor toepassingsverbindingsreeksen.

Kostenraming

In het deelvenster Geschatte kosten aan de rechterkant van het formulier worden de maandelijkse prijzen onderverdeeld:

  • Compute: Op basis van de geselecteerde SKU en het aantal vCores.
  • Opslag: Op basis van de geselecteerde opslaglaag.
  • Back-up: inbegrepen kosten voor back-ups.
  • Bandbreedte: uitgaande gegevensoverdracht tussen regio's brengt extra kosten in rekening; inkomende overdracht is gratis.

In het deelvenster ziet u een geschat totaal en koppelingen naar de Azure Prijscalculator voor gedetailleerde prijzen.

Stap 4: Voorwaarden accepteren en implementeren

Onderaan het formulier:

  1. Selecteer het selectievakje Ik bevestig dat het maken van deze server mogelijk kosten in rekening brengt.
  2. Bekijk de gekoppelde gebruiksvoorwaarden en het privacybeleid.
  3. Selecteer Maken om te beginnen met inrichten.

De extensie navigeert naar een voortgangspagina die elke fase van de implementatie bijhoudt:

Stage Statuswaarden
Serverinrichting In afwachting, wordt uitgevoerd, voltooid, mislukt
Toewijzing van firewallregels In behandeling, wordt uitgevoerd, voltooid, overgeslagen
Entra-beheerderstoewijzing In behandeling, Bezig, Voltooid, Overgeslagen

In een implementatieoverzicht ziet u de servernaam, het abonnement, de resourcegroep, de regio en de configuratie die u hebt geselecteerd.

Tijdens de implementatie kunt u blijven werken in Visual Studio Code. De implementatie wordt ook op de achtergrond uitgevoerd als u de voortgangspagina sluit.

Wanneer alle fasen zijn voltooid, wordt de header bijgewerkt naar Server is gemaakt! en wordt het volgende bericht weergegeven: "Uw PostgreSQL Flexible Server is gereed." De extensie maakt automatisch een verbindingsprofiel voor de nieuwe server. Selecteer Gereed om de voortgangspagina te sluiten.

Note

Als een fase is voltooid met waarschuwingen, wordt de status Voltooid met waarschuwingen weergegeven. Bekijk de details voordat u verbinding maakt.

Implementaties van Azure bijhouden

In de weergave Azure Implementaties in de PostgreSQL-activiteitenbalk worden alle actieve en voltooide Azure serverimplementaties weergegeven. Elke vermelding geeft de servernaam, de implementatiestatus en de tijdstempel weer.

Klik met de rechtermuisknop op een implementatie om toegang te krijgen tot deze acties:

Handeling Beschrijving
Open in Azure Portal Hiermee opent u de resourcepagina van de server in de Azure-portal.
Implementatie verwijderen Hiermee verwijdert u de implementatievermelding uit de tracker. Met deze actie wordt de Azure resource niet verwijderd.

Gebruik de knop Voltooid verwijderen in de weergavewerkbalk om alle voltooide implementaties uit de lijst te wissen.

Tip

Als een Azure implementatie mislukt, selecteert u Opnieuw proberen op de voortgangspagina om het inrichten opnieuw te starten of selecteert u Terug naar formulier om uw instellingen aan te passen.

Een Azure HorizonDB-cluster (preview) maken

Azure HorizonDB (preview) is een cloudeigen, zeer schaalbaar PostgreSQL-cluster in Azure. De extensie begeleidt u door een wizard met meerdere stappen om een nieuw cluster in te richten.

Note

Azure beschikbaarheid van HorizonDB (preview) is afhankelijk van uw Azure abonnement en regio.

Stap 1: De inleiding bekijken

Nadat u de kaart Een Azure HorizonDB-exemplaar maken hebt geselecteerd, beschrijft een landingspagina de servicemogelijkheden:

  • Cloud-Native Architectuur: een cloudeigen PostgreSQL-cluster dat is geoptimaliseerd voor hoge doorvoer.
  • Elastisch schalen: rekenkracht schalen van 2 tot 128 vCores.
  • Ingebouwd beheer: Beheer de levenscyclus en configuratie vanuit Visual Studio Code.
  • Klaar voor ontwikkelaars: richt u op uw toepassing terwijl Azure de infrastructuur beheert.

Selecteer Aan de slag om door te gaan. Selecteer desgewenst Niet meer weergeven om deze pagina voortaan over te slaan.

Stap 2: Aanmelden bij Azure

Met de extensie wordt een aanmeldingspagina geopend. Als u al een Azure-account hebt aangemeld bij Visual Studio Code, gebruikt de extensie deze referenties automatisch. Als u meerdere Azure accounts of tenants hebt, gebruikt u de accountwisselaar en tenantselector om de juiste identiteit te kiezen.

Stap 3: Clusterinstellingen configureren

Na verificatie geeft de extensie een configuratieformulier weer dat is ingedeeld in secties.

Projectgegevens

Configuratie Beschrijving
Abonnement Selecteer het Azure-abonnement waarmee facturering en toegang worden beheerd.
Resource Group Selecteer een bestaande resourcegroep of selecteer Nieuwe maken om er een te maken.

Details van het cluster

Configuratie Beschrijving
Clusternaam Een wereldwijd unieke naam voor het cluster. De extensie controleert de beschikbaarheid en geeft een fout weer als de naam wordt gebruikt.
Regio De Azure regio waar het cluster is geïmplementeerd.
PostgreSQL-versie De primaire PostgreSQL-versie die moet worden geïmplementeerd.

Computatieconfiguratie

Gebruik de schuifregelaar vCores om de rekencapaciteit voor uw cluster te kiezen. Beschikbare opties variëren van 2 tot 128 vCores. Geheugen wordt automatisch geschaald op 8 GiB per vCore.

Authentication

Configuratie Beschrijving
Gebruikersnaam van de beheerder Aanmeldingsnaam voor het PostgreSQL-beheerdersaccount.
Beheerderswachtwoord Wachtwoord voor het beheerdersaccount.
Beheerderswachtwoord bevestigen Voer het beheerderswachtwoord opnieuw in.

AI-mogelijkheden

In de sectie AI-mogelijkheden kunt u ingebouwde functies voor AI-modelbeheer inschakelen. Selecteer het selectievakje AI-functies inschakelen om deel te nemen. Wanneer AI-functies zijn ingeschakeld, wordt het cluster voorzien van ondersteuning voor modelbeheer en pgvectorpg_diskann extensies.

Note

De sectie AI-mogelijkheden is een preview-ervaring en wordt mogelijk niet weergegeven voor elke omgeving of clusterconfiguratie. Als de sectie niet zichtbaar is, gaat u verder met de standaardclusterinstellingen Azure HorizonDB (Preview) en implementatiestappen.

Stap 4: Voorwaarden accepteren en implementeren

Onderaan het formulier:

  1. Schakel het selectievakje aanvullende voorwaarden voor het cluster in.
  2. Als u AI-functies hebt ingeschakeld en het selectievakje aanvullende voorwaarden voor AI zichtbaar is, selecteert u deze optie.
  3. Bekijk de gekoppelde gebruiksvoorwaarden en het privacybeleid.
  4. Selecteer Maken om te beginnen met inrichten. Als het formulier onvolledig is, beweegt u de muisaanwijzer over de uitgeschakelde knop Maken om te zien welke velden nog steeds waarden nodig hebben.

De extensie navigeert naar een voortgangspagina die elke fase van de implementatie bijhoudt. In een implementatieoverzicht ziet u de clusternaam, het abonnement, de resourcegroep en de configuratie (vCores en het geheugen) die u hebt geselecteerd.

Wanneer alle fasen zijn voltooid, maakt de extensie een verbindingsprofiel voor het nieuwe cluster. Selecteer Gereed om de voortgangspagina te sluiten.

Note

Als u AI-functies hebt ingeschakeld en de stap voor ai-modelbeheer mislukt, wordt het cluster nog steeds gemaakt en wordt er een verbindingsprofiel toegevoegd. Op de voortgangspagina ziet u een waarschuwing en een koppeling om het cluster te openen in de Azure-portal, zodat u ai-modelbeheer handmatig kunt inschakelen.

Tip

Selecteer Configureren op Azure Portal onder aan het formulier als u opties nodig hebt die verder gaan dan wat de wizard Extensie biedt.

De server controleren

Nadat de server is gemaakt (Docker of Azure):

  1. Vouw het serverknooppunt uit in de structuur Verbindingen .
  2. Controleer of de standaarddatabases (postgres en, voor Docker, een door u opgegeven database) worden vermeld.
  3. Klik met de rechtermuisknop op een database en selecteer Nieuwe query om de queryeditor te openen.
  4. Voer een testquery uit, bijvoorbeeld SELECT version(); om de connectiviteit te controleren.