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.
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.containerClientofcontainers.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
Zoek in de container van de Activity Bar van PostgreSQL de Verbindingen-boomstructuur.
Selecteer de knop Nieuwe server maken boven aan de structuur Verbindingen of voer deze uit
pgsql.createNewServervanuit 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:
- Selecteer het selectievakje Ik bevestig dat het maken van deze server mogelijk kosten in rekening brengt.
- Bekijk de gekoppelde gebruiksvoorwaarden en het privacybeleid.
- 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:
- Schakel het selectievakje aanvullende voorwaarden voor het cluster in.
- Als u AI-functies hebt ingeschakeld en het selectievakje aanvullende voorwaarden voor AI zichtbaar is, selecteert u deze optie.
- Bekijk de gekoppelde gebruiksvoorwaarden en het privacybeleid.
- 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):
- Vouw het serverknooppunt uit in de structuur Verbindingen .
- Controleer of de standaarddatabases (
postgresen, voor Docker, een door u opgegeven database) worden vermeld. - Klik met de rechtermuisknop op een database en selecteer Nieuwe query om de queryeditor te openen.
- Voer een testquery uit, bijvoorbeeld
SELECT version();om de connectiviteit te controleren.