Azure Database for PostgreSQL-példány létrehozása a .NET SDK használatával

Ebben a rövid útmutatóban megtudhatja, hogyan használhatja az Azure SDK-kódtárakat a .NET-ben egy rugalmas Azure PostgreSQL-kiszolgálópéldány létrehozásához, frissítéséhez és törléséhez. Az Azure Database for PostgreSQL egy felügyelt szolgáltatás, amellyel magas rendelkezésre állású PostgreSQL-adatbázisokat futtathat, kezelhet és méretezhet a felhőben. A .NET SDK használatával rugalmas Azure Database for PostgreSQL-kiszolgálópéldányt, több kiszolgálót vagy több adatbázist építhet ki egy kiszolgálón.

Prerequisites

Azure.ResourceManager.PostgreSql-kódtár

A Azure.ResourceManager.PostgreSql kódtár a .NET-hez készült Azure SDK része, és a Rugalmas PostgreSQL-kiszolgálópéldányok Azure-beli kezelésére szolgál. Ezzel a kódtárral különböző műveleteket hajthat végre rugalmas PostgreSQL-kiszolgálópéldányokkal kapcsolatban, többek között a következőkre:

  1. Rugalmas Azure PostgreSQL-kiszolgálópéldányok létrehozása:
    Létrehozhat új rugalmas kiszolgálópéldányokat a megadott konfigurációkkal, például helyekkel, termékváltozattal, tárhellyel és verzióval.

  2. Rugalmas Azure PostgreSQL-kiszolgálópéldányok frissítése:
    A meglévő rugalmas PostgreSQL-kiszolgálópéldányokat frissítheti, beleértve a konfigurációk módosítását, például a rendszergazdai bejelentkezést, a jelszót, az termékváltozatot, a tárterületet és a verziót.

  3. Rugalmas Azure PostgreSQL-kiszolgálópéldányok törlése:
    A meglévő rugalmas Azure PostgreSQL-kiszolgálópéldányokat törölheti.

  4. Az Azure PostgreSQL adatainak lekérése:
    Lekérheti a meglévő rugalmas PostgreSQL-kiszolgálópéldányok adatait, beleértve azok konfigurációit, állapotát és egyéb metaadatait.

  5. Adatbázisok kezelése:
    Az Azure PostgreSQL rugalmas kiszolgálópéldányában adatbázisokat hozhat létre, frissíthet, törölhet és lekérhet.

  6. Tűzfalszabályok kezelése:
    A hozzáférés szabályozásához létrehozhat, frissíthet, törölhet és lekérdezhet egy példányhoz tartozó tűzfalszabályokat.

  7. Konfigurációs beállítások kezelése:
    A rugalmas Azure PostgreSQL-kiszolgálópéldány konfigurációs beállításait kezelheti, beleértve a paraméterek lekérését és frissítését is.

Jelentkezzen be az Azure-ba

Mielőtt az Azure SDK for .NET használatával rugalmas Azure Database for PostgreSQL-kiszolgálópéldányt hoz létre, frissít vagy töröl, be kell jelentkeznie az Azure-fiókjába az Azure CLI használatával.

A bejelentkezési parancs futtatása

Bejelentkezés a fiókjába az CLI használatával 

az login

A szükséges csomagok telepítése

Telepítse a szükséges csomagokat a következő parancsokkal:

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

A csomagok telepítése után győződjön meg arról, hogy minden em szerepel a .csproj fájlban, mielőtt végrehajtaná a build- és futtatási parancsokat.

Ha többet szeretne megtudni a fájlról, látogasson el a .csproj Web Deployment webhelyre.

Megjegyzés:

Ha problémákat tapasztal a .NET kezdeti beállításával kapcsolatban, kövesse ezt az útmutatót.

A projekt létrehozása

Hozzon létre egy új .NET-projektet a hivatkozásban ismertetett lépések végrehajtásával

A kiszolgáló létrehozása

Rugalmas PostgreSQL-kiszolgálópéldány létrehozásához hozzon létre egy fájlt CreateServer.cs az alábbi kóddal.

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}");
            }
   }
  }
}

Ez a példa bemutatja, hogyan hozhat létre rugalmas PostgreSQL-kiszolgálópéldányt az Azure Resource Manager használatával. PostgreSql-kódtár. Más könyvtár által biztosított módszerek is hasznosíthatók a PostgreSQL rugalmas szerver példányok és az ezekhez kapcsolódó erőforrások kezeléséhez.

A kódban cserélje le az alábbi paramétereket az Ön adataira:

  • subscription-id: Az Ön Azure-előfizetési azonosítója.
  • resource-group-name: Az erőforráscsoport neve.
  • server-name: A PostgreSQL-kiszolgáló egyedi neve.
  • location: A kiszolgáló Azure-régiója.
  • admin-username: A rendszergazda felhasználóneve.
  • admin-password: A rendszergazda jelszava.
  • pgVersion: A PostgreSQL-verzió (például 11, 12, 13, 14, 15 vagy 16).

Authentication

Az DefaultAzureCredential osztály olyan módszerekkel próbál hitelesíteni, mint a környezeti változók, a felügyelt identitások vagy az Azure CLI. Győződjön meg arról, hogy az alábbi módszerek egyikét konfigurálta.

A fájl futtatása

A fájl futtatásához létre kell készítenie és végre kell hajtania a .cs fájlt a .NET CLI használatával. Ez elindítja a PostgreSQL-példány létrehozásának, frissítésének vagy törlésének folyamatát a kód alapján.

Minden alkalommal, amikor bármilyen módosítást hajt végre a .cs fájlban, ne felejtse el létrehozni, majd futtatni a fájlt

Futtassa a .cs-fájlt az alábbi parancsokkal.

dotnet build
dotnet run

Megjegyzés:

A kód futtatása elindítja a példánylétrehozási folyamatot, ami eltarthat néhány percig.

Üzembe helyezett erőforrások áttekintése

Az üzembe helyezett rugalmas kiszolgálópéldányt az Azure Portalon, az Azure CLI-vel, az Azure PowerShell-lel és más eszközökkel tekintheti át az üzembe helyezés ellenőrzéséhez és az üzembe helyezett erőforrások áttekintéséhez.

Kiszolgálóadatok frissítése

Hozzon létre egy UpdateServerData.cs fájlt.

A kiszolgálóadatokat az Azure PostgreSQL .NET SDK-val is frissítheti.

A módszerrel például frissítheti a verziót, a rendszergazdai felhasználónevet, a CreateOrUpdateAsync jelszót stb.

A CreateOrUpdateAsync metódus vagy létrehoz egy új példányt, ha nincs azonos nevű példány, vagy frissíti a meglévő példányt az új kiszolgálóadatokkal, ha létezik.

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}");
            }
   }
  }
}

Futtassa a fájlt, és tekintse át az erőforrásban végrehajtott módosításokat a "UpdateServerData.cs" fájllal.

Erőforrások tisztítása

A létrehozott rugalmas kiszolgálópéldányok eltávolításához törölje a rugalmas kiszolgálópéldányt a .NET-hez készült Azure SDK-val.

Hozzon létre egy DeleteServer.cs fájlt, és adja hozzá a következő kódot.

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}");
            }
   }
  }
}

Cserélje le a következő paramétereket az ön adataira:

  • subscription-id: Saját előfizetés-azonosító.
  • resource-group-name: A használni kívánt erőforráscsoport neve. A szkript létrehoz egy új erőforráscsoportot, ha nem létezik.
  • server-name: A létrehozott rugalmas Azure Database-kiszolgálópéldány neve.

A portálon, a parancssori felületen vagy a PowerShellen keresztül létrehozott erőforráscsoportot is törölheti. Ha a parancssori felület vagy a PowerShell használatával szeretné törölni, kövesse a parancssori felület és a PowerShell szakasz lépéseit.

Cserélje le a helyőrzőket az Ön adataira, majd futtassa a fájlt.

Másik lehetőségként az erőforráscsoportot a következő módon távolíthatja el:

  • Azure CLI:az group delete --name <resource_group>
  • PowerShell:Remove-AzResourceGroup -Name <resource_group>
  • Azure Portal: Lépjen az erőforráscsoportra, és törölje azt.

Kapcsolódó tartalom

  • Last updated on