Een Azure Database for PostgreSQL-exemplaar maken met behulp van .NET SDK

In deze quickstart leert u hoe u de Azure SDK-bibliotheken in .NET kunt gebruiken om een flexibele Azure PostgreSQL-serverinstantie te maken, bij te werken en te verwijderen. Azure Database for PostgreSQL is een beheerde service waarmee u PostgreSQL-databases met hoge beschikbaarheid in de cloud kunt uitvoeren, beheren en schalen. Met behulp van de .NET SDK kunt u een exemplaar van een flexibele Azure Database for PostgreSQL-server, meerdere servers of meerdere databases op een server inrichten.

Prerequisites

Een Azure-account met een actief abonnement.
Quickstart: Een Azure Database for PostgreSQL flexibele server maken.
.NET Framework geïnstalleerd op uw lokale computer.
Azure CLI is geïnstalleerd op uw lokale computer.

Azure.ResourceManager.PostgreSql-bibliotheek

De Azure.ResourceManager.PostgreSql bibliotheek maakt deel uit van de Azure SDK voor .NET en biedt functionaliteit voor het beheren van postgreSQL flexibele serverexemplaren in Azure. Met deze bibliotheek kunt u verschillende bewerkingen uitvoeren met betrekking tot postgreSQL flexibele serverexemplaren, waaronder maar niet beperkt tot:

Flexibele Azure PostgreSQL-serverexemplaren maken:
U kunt nieuwe flexibele serverexemplaren maken met opgegeven configuraties, zoals locatie, SKU, opslag en versie.
Azure PostgreSQL flexibele serverinstanties bijwerken:
U kunt bestaande exemplaren van flexibele PostgreSQL-servers bijwerken, waaronder het wijzigen van configuraties zoals aanmelding van de beheerder, wachtwoord, SKU, opslag en versie.
Azure PostgreSQL flexibele serverinstanties verwijderen:
U kunt bestaande exemplaren van flexibele Azure PostgreSQL-servers verwijderen.
Azure PostgreSQL-gegevens ophalen:
U kunt details ophalen over bestaande exemplaren van flexibele PostgreSQL-servers, inclusief hun configuraties, status en andere metagegevens.
Databases beheren:
U kunt databases maken, bijwerken, verwijderen en opvragen in de flexibele serverinstance van Azure PostgreSQL.
Firewallregels beheren:
U kunt firewallregels maken, bijwerken, verwijderen en ophalen voor een instantie om toegang te beheren.
Configuratie-instellingen beheren:
U kunt configuratie-instellingen beheren voor een exemplaar van een Azure flexibele PostgreSQL-server, waaronder het ophalen en bijwerken van parameters.

Meld u aan bij Azure

Voordat u de Azure SDK voor .NET gebruikt om een exemplaar van een flexibele Azure Database for PostgreSQL-server te maken, bij te werken of te verwijderen, moet u zich aanmelden bij uw Azure-account met behulp van de Azure CLI.

Meld u aan bij uw account met behulp van az CLI

az login

De vereiste pakketten installeren

Installeer de benodigde pakketten met behulp van de volgende opdrachten:

dotnet add package Azure.Identity
dotnet add package Azure.ResourceManager
dotnet add package Azure.ResourceManager.PostgreSql

Nadat u deze pakketten hebt geïnstalleerd, moet u ervoor zorgen dat elk item in het bestand .csproj wordt vermeld voordat u de build- en run-opdrachten uitvoert.

Ga naar .csproj voor meer informatie over het bestand .

Note

Als u problemen ondervindt met betrekking tot de eerste installatie voor .NET, volgt u deze handleiding.

Het project maken

Maak een nieuw .NET-project door de stappen in deze koppeling te volgen

De server maken

Als u een exemplaar van een flexibele PostgreSQL-server wilt maken, maakt u een bestand met de naam CreateServer.cs met de volgende code.

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.PostgreSql.FlexibleServers;
using Azure.ResourceManager.PostgreSql.FlexibleServers.Models;

namespace CreatePostgreSqlFlexibleServer
{
    class Program
 {
        static async Task Main(string[] args)
   {

            TokenCredential credential = new DefaultAzureCredential();
            ArmClient armClient = new ArmClient(credential);
            // Replace with your subscription ID
            string subscriptionId = "subscription-id";
            // Replace with your resource group name
            string resourceGroupName = "resource-group-name";
           // Replace with a unique server name
            string serverName = "server-name";
           // Replace with your desired region
            string location = "region-name";
          // Create the resource identifier for the resource group
            ResourceIdentifier resourceGroupId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
            ResourceGroupResource resourceGroup = await armClient.GetResourceGroupResource(resourceGroupId).GetAsync();
            // Prepare server data
            var serverData = new PostgreSqlFlexibleServerData(location)
            {
              AdministratorLogin = "admin-username",
              AdministratorLoginPassword = "<admin-password>",
              Version = "pgVersion",
              Storage = new PostgreSqlFlexibleServerStorage() { StorageSizeInGB = 128 },
              Sku = new PostgreSqlFlexibleServerSku("Standard_B1ms", PostgreSqlFlexibleServerSkuTier.Burstable),
           };
            try
            {
               ArmOperation<PostgreSqlFlexibleServerResource> operation = await resourceGroup.GetPostgreSqlFlexibleServers().CreateOrUpdateAsync(Azure.WaitUntil.Completed, serverName, serverData);
              PostgreSqlFlexibleServerResource serverResource = operation.Value;
              Console.WriteLine($"PostgreSQL flexible server '{serverResource.Data.Name}' created successfully.");
           }
            catch (Exception ex)
            {
               Console.WriteLine($"An error occurred: {ex.Message}");
            }
   }
  }
}

In dit voorbeeld ziet u hoe u een exemplaar van een flexibele PostgreSQL-server maakt met behulp van Azure Resource Manager. PostgreSql-bibliotheek. U kunt op dezelfde manier andere methoden van de bibliotheek gebruiken om uw postgreSQL flexibele serverexemplaren en gerelateerde resources te beheren.

Vervang de volgende parameters in de code door uw gegevens:

subscription-id: uw Azure-abonnements-id.
resource-group-name: de naam van uw resourcegroep.
server-name: Een unieke naam voor uw PostgreSQL-server.
location: de Azure-regio voor uw server.
admin-username: de gebruikersnaam van de beheerder.
admin-password: het beheerderswachtwoord.
pgVersion: De PostgreSQL-versie (bijvoorbeeld 11, 12, 13, 14, 15 of 16).

Authentication

De DefaultAzureCredential klasse probeert te verifiëren met behulp van methoden zoals omgevingsvariabelen, beheerde identiteiten of Azure CLI. Zorg ervoor dat u een van deze methoden hebt geconfigureerd.

Het bestand uitvoeren

Als u het bestand wilt uitvoeren, moet u het .cs-bestand bouwen en uitvoeren met behulp van de .NET CLI. Hiermee wordt het proces voor het maken, bijwerken of verwijderen van het PostgreSQL-exemplaar gestart volgens de code.

Telkens wanneer u een wijziging aanbrengt in het .cs-bestand, vergeet dan niet om het bestand te bouwen en vervolgens uit te voeren

Voer het .cs-bestand uit met de onderstaande opdrachten

dotnet build
dotnet run

Note

Als u deze code uitvoert, wordt het proces voor het maken van de instantie gestart. Dit kan enkele minuten duren om te voltooien.

Geïmplementeerde middelen beoordelen

U kunt het geïmplementeerde exemplaar van een flexibele server controleren via Azure Portal, Azure CLI, Azure PowerShell en verschillende andere hulpprogramma's om de implementatie te valideren en de geïmplementeerde resources te controleren.

Servergegevens bijwerken

Maak een UpdateServerData.cs-bestand.

U kunt servergegevens ook bijwerken met behulp van de Azure PostgreSQL .NET SDK.

U kunt bijvoorbeeld de versie, gebruikersnaam, wachtwoord van de beheerder, enzovoort bijwerken met behulp van de CreateOrUpdateAsync methode.

Met CreateOrUpdateAsync de methode wordt een nieuw exemplaar gemaakt als er geen exemplaar met dezelfde naam is of het bestaande exemplaar bijwerken met de nieuwe servergegevens als deze wel bestaat.

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.PostgreSql.FlexibleServers;
using Azure.ResourceManager.PostgreSql.FlexibleServers.Models;

namespace UpdateServerData
{
    class Program
 {
        static async Task Main(string[] args)
   {

            TokenCredential credential = new DefaultAzureCredential();
            ArmClient armClient = new ArmClient(credential);
            // Replace with your subscription ID
            string subscriptionId = "subscription-id";
            // Replace with your resource group name
            string resourceGroupName = "resource-group-name";
            // Replace with a unique server name
            string serverName = "server-name";
            // Replace with your desired region
            string location = "region-name";
            ResourceIdentifier resourceGroupId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
            ResourceGroupResource resourceGroup = await armClient.GetResourceGroupResource(resourceGroupId).GetAsync();
            // Prepare server data
            var serverData = new PostgreSqlFlexibleServerData(location)
           {
              // Updating version from a lower version to a higher version
              Version = "16",
           };
            try
             {
               ArmOperation<PostgreSqlFlexibleServerResource> operation = await resourceGroup.GetPostgreSqlFlexibleServers().CreateOrUpdateAsync(Azure.WaitUntil.Completed, serverName, serverData);
               PostgreSqlFlexibleServerResource serverResource = operation.Value;
               Console.WriteLine($"PostgreSQL flexible server '{serverResource.Data.Name}' updated successfully.");
            }
            catch (Exception ex)
            {
              Console.WriteLine($"An error occurred: {ex.Message}");
            }
   }
  }
}

Voer het bestand uit en controleer de wijzigingen die in de resource zijn aangebracht met het bestand 'UpdateServerData.cs'.

De hulpbronnen opschonen

U kunt de gemaakte flexibele serverexemplaren opruimen door de flexibele serverexemplaren te verwijderen met de Azure SDK voor .NET.

Maak een DeleteServer.cs bestand en voeg de volgende code toe.

using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.PostgreSql.FlexibleServers;
using Azure.ResourceManager.PostgreSql.FlexibleServers.Models;

namespace DeleteServer
{
    class Program
  {
        static async Task Main(string[] args)
   {

            // Replace with your subscription ID
            string subscriptionId = "subscription-id";
            // Replace with your resource group name
            string resourceGroupName = "resource-group-name";
            // Replace with a unique server name
            string serverName = "server-name";
            var credential = new DefaultAzureCredential();
            var armClient = new ArmClient(credential);
            try
            {
                // Get the PostgreSQL flexible server resource
                var postgresServerResourceId = PostgreSqlFlexibleServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
                var postgresServer = armClient.GetPostgreSqlFlexibleServerResource(postgresServerResourceId);
                // Delete the server
                await postgresServer.DeleteAsync(Azure.WaitUntil.Completed);
                Console.WriteLine($"PostgreSQL flexible server '{serverName}' deleted successfully.");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"An error occurred: {ex.Message}");
            }
   }
  }
}

Vervang de volgende parameters door uw gegevens:

subscription-id: Uw eigen abonnements-id.
resource-group-name: De naam van de resourcegroep die u wilt gebruiken. Met het script wordt een nieuwe resourcegroep gemaakt als deze niet bestaat.
server-name: De naam van het flexibele exemplaar van de Azure-databaseserver dat u hebt gemaakt.

U kunt ook de resourcegroep verwijderen die is gemaakt via de portal, CLI of PowerShell. Volg de stappen in de sectie CLI en PowerShell als u deze wilt verwijderen met behulp van CLI of PowerShell.

Vervang tijdelijke aanduidingen door uw gegevens en voer het bestand uit.

U kunt de resourcegroep ook verwijderen met behulp van:

Azure CLI:az group delete --name <resource_group>
PowerShell:Remove-AzResourceGroup -Name <resource_group>
Azure Portal: Navigeer naar de resourcegroep en verwijder deze.

Quickstart: Een flexibele Azure Database for PostgreSQL-server maken

Feedback

Is deze pagina nuttig?

Last updated on 2026-06-12