Membuat instans server fleksibel Azure Database for PostgreSQL menggunakan SDK .NET

Dalam panduan cepat ini, Anda mempelajari cara menggunakan library Azure SDK di .NET untuk membuat, memperbarui, dan menghapus instance server fleksibel Azure PostgreSQL. Azure Database for PostgreSQL adalah layanan terkelola yang memungkinkan Anda menjalankan, mengelola, dan menskalakan database PostgreSQL yang sangat tersedia di cloud. Dengan menggunakan .NET SDK, Anda dapat menyediakan instans server fleksibel Azure Database for PostgreSQL, beberapa server, atau beberapa database di server.

Prerequisites

Akun Azure dengan langganan aktif.
Mulai cepat: Buat server fleksibel Azure Database for PostgreSQL.
Kerangka kerja .NET diinstal pada komputer lokal Anda.
Azure CLI diinstal pada komputer lokal Anda.

Pustaka Azure.ResourceManager.PostgreSql

Pustaka Azure.ResourceManager.PostgreSql adalah bagian dari Azure SDK untuk .NET dan menyediakan fungsionalitas untuk mengelola instans server fleksibel PostgreSQL di Azure. Dengan pustaka ini, Anda dapat melakukan berbagai operasi yang terkait dengan instans server fleksibel PostgreSQL, termasuk tetapi tidak terbatas pada:

Membuat instans server fleksibel Azure PostgreSQL:
Anda dapat membuat instans server fleksibel baru dengan konfigurasi tertentu seperti lokasi, SKU, penyimpanan, dan versi.
Memperbarui instans server fleksibel Azure PostgreSQL:
Anda dapat memperbarui instans server fleksibel PostgreSQL yang ada, termasuk mengubah konfigurasi seperti login administrator, kata sandi, SKU, penyimpanan, dan versi.
Menghapus instans server fleksibel Azure PostgreSQL:
Anda dapat menghapus instans server fleksibel Azure PostgreSQL yang ada.
Mengambil Informasi Azure PostgreSQL:
Anda dapat mengambil detail tentang instans server fleksibel PostgreSQL yang ada, termasuk konfigurasi, status, dan metadata lainnya.
Mengelola Database:
Anda dapat membuat, memperbarui, menghapus, dan mengambil database dalam instans server fleksibel Azure PostgreSQL.
Mengelola Aturan Firewall:
Anda dapat membuat, memperbarui, menghapus, dan mengambil aturan firewall untuk instans guna mengontrol akses.
Mengelola Pengaturan Konfigurasi:
Anda dapat mengelola pengaturan konfigurasi untuk instans server fleksibel PostgreSQL Azure, termasuk mengambil dan memperbarui parameter.

Masuk ke Azure

Sebelum menggunakan Azure SDK untuk .NET untuk membuat, memperbarui, atau menghapus instans server fleksibel Azure Database for PostgreSQL, Anda harus masuk ke akun Azure Anda menggunakan Azure CLI.

Masuk ke akun Anda menggunakan az CLI

az login

Memasang paket yang diperlukan

Instal paket yang diperlukan menggunakan perintah berikut:

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

Setelah menginstal paket ini, pastikan bahwa setiap paket tercantum dalam file .csproj sebelum menjalankan perintah build dan run.

Untuk mempelajari lebih lanjut tentang file .csproj, kunjungi Penyebaran Web.

Note

Jika Anda mengalami masalah terkait penyiapan awal untuk .NET, ikuti panduan ini.

Membuat proyek

Buat proyek .NET baru dengan mengikuti langkah-langkah yang disebutkan dalam tautan ini

Membuat Server

Untuk membuat instans server fleksibel PostgreSQL, buat file bernama CreateServer.cs dengan kode berikut.

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

Contoh ini menunjukkan pembuatan instans server fleksibel PostgreSQL menggunakan Azure Resource Manager. Perpustakaan PostgreSql. Anda juga dapat menggunakan metode lain yang disediakan oleh pustaka untuk mengelola instans server fleksibel PostgreSQL dan sumber daya terkait.

Ganti parameter berikut dalam kode dengan data Anda:

subscription-id: ID langganan Azure Anda.
resource-group-name: Nama grup sumber daya Anda.
server-name: Nama unik untuk server PostgreSQL Anda.
location: Wilayah Azure untuk server Anda.
admin-username: Nama pengguna administrator.
admin-password: Kata sandi administrator.
pgVersion: Versi PostgreSQL (misalnya, 11, 12, 13, 14, 15, atau 16).

Authentication

Kelas DefaultAzureCredential mencoba mengautentikasi menggunakan metode seperti variabel lingkungan, identitas terkelola, atau Azure CLI. Pastikan Anda memiliki salah satu metode ini yang dikonfigurasi.

Jalankan file

Untuk menjalankan file, Anda harus membangun dan menjalankan file .cs menggunakan .NET CLI. Ini memulai proses pembuatan, pembaruan, atau penghapusan untuk instans PostgreSQL sesuai kode.

Setiap kali Anda membuat perubahan dalam file .cs, jangan lupa untuk membuat lalu menjalankan file

Jalankan file .cs dengan perintah di bawah ini

dotnet build
dotnet run

Note

Menjalankan kode ini akan memulai proses pembuatan instans, yang mungkin memerlukan waktu beberapa menit untuk diselesaikan.

Meninjau sumber daya yang disebarkan

Anda dapat meninjau instans server fleksibel yang disebarkan melalui portal Microsoft Azure, Azure CLI, Azure PowerShell, dan berbagai alat lainnya untuk memvalidasi penyebaran dan meninjau sumber daya yang disebarkan.

Memperbarui data server

Buat file UpdateServerData.cs.

Anda juga dapat memperbarui data server menggunakan Azure PostgreSQL .NET SDK.

Misalnya, Anda dapat memperbarui versi, nama pengguna admin, kata sandi, dll., menggunakan metode .CreateOrUpdateAsync

Metode ini CreateOrUpdateAsync membuat instans baru jika tidak ada instans dengan nama yang sama atau memperbarui instans yang ada dengan data server baru jika ada.

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

Jalankan file dan tinjau perubahan yang dibuat di sumber daya dengan file 'UpdateServerData.cs'.

Membersihkan sumber daya

Anda dapat membersihkan instans server fleksibel yang dibuat dengan menghapus instans server fleksibel dengan Azure SDK untuk .NET.

Buat DeleteServer.cs file dan tambahkan kode berikut.

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

Ganti parameter berikut dengan data Anda:

subscription-id: ID langganan Anda sendiri.
resource-group-name: Nama grup sumber daya yang ingin Anda gunakan. Skrip ini membuat grup sumber daya baru jika belum ada.
server-name: Nama instans server fleksibel database Azure yang Anda buat.

Anda juga dapat menghapus grup sumber daya yang dibuat melalui Portal, CLI, atau PowerShell. Ikuti langkah-langkah yang disebutkan di bagian CLI dan PowerShell jika Anda ingin menghapusnya menggunakan CLI atau PowerShell.

Ganti tempat penampung dengan detail Anda dan jalankan file.

Atau, Anda dapat menghapus grup sumber daya menggunakan:

Azure CLI:az group delete --name <resource_group>
PowerShell: Remove-AzResourceGroup -Name <resource_group>
Portal Microsoft Azure: Navigasikan ke grup sumber daya dan hapus.

Mulai cepat: Membuat server fleksibel Azure Database for PostgreSQL

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-06-12