Rugalmas Azure Database for PostgreSQL kiszolgáló létrehozása a Java Azure SDK használatával

Ebben a rövid útmutatóban megtudhatja, hogyan hozhat létre, frissíthet és törölhet Azure Database for PostgreSQL rugalmas kiszolgálót a Java Azure SDK használatával. A példakódok Java nyelven vannak megírva, és az Azure SDK-kódtárak használatával kommunikálnak az Azure Database for PostgreSQL szolgáltatással.

A Java Azure SDK olyan kódtárakat biztosít, amelyekkel Azure szolgáltatásokkal kommunikálhat a Java használatával. Az SDK konzisztens programozási modellt biztosít, és leegyszerűsíti az Azure-szolgáltatások, köztük az Azure Database for PostgreSQL használatát.

Prerequisites

Az Azure Java SDK által támogatott műveletek

A Java Azure SDK biztosítja azokat a azure-resourcemanager-postgresqlflexibleserver függőségeket, amelyek támogatják ezeket a műveleteket Azure Databases for PostgreSQL-hez.

  • Azure Database for PostgreSQL rugalmas kiszolgálók létrehozása
    Létrehozhat egy új Azure Rugalmas PostgreSQL-kiszolgálót a megadott konfigurációkkal, például helyekkel, termékváltozattal, tárhellyel és verzióval.

  • Az Azure Database for PostgreSQL rugalmas üzembe helyezésű kiszolgálóinak frissítése
    Frissítheti a meglévő Azure PostgreSQL rugalmas kiszolgálóit, 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.

  • Az Azure Database for PostgreSQL rugalmas kiszolgálóinak törlése

  • Az Azure Database for PostgreSQL adatainak lekérése
    Lekérheti a meglévő Azure Rugalmas PostgreSQL-kiszolgálók adatait, beleértve azok konfigurációit, állapotát és egyéb metaadatait.

  • Adatbázisok kezelése
    Létrehozhat, frissíthet, törölhet és lekérhet adatbázisokat a rugalmas Azure PostgreSQL-kiszolgálón.

  • 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.

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

Fiók beállítása a Azure CLI használatával

Mielőtt az Azure SDK for Java használatával Azure Database for PostgreSQL rugalmas kiszolgálót hozna létre, frissítene vagy törölne, jelentkezzen be Azure-fiókjába az Azure CLI használatával.

Jelentkezzen be a fiókjába Azure CLI használatával.

az login

Kérje le a fiók bérlőazonosítóját, amint szüksége van rá a későbbi szakaszban található kódhoz.

az account show --query tenantId --output tsv

Projekt létrehozása

Hozzon létre egy új Maven-projektet az előnyben részesített IDE-ben, és adja hozzá az Azure Database for PostgreSQL-kódtár függőségeit.

Maven-projekt létrehozásakor létre kell hoznia egy pom.xml fájlt. Győződjön meg arról, hogy az összes függőséget a fájl <dependencies> címkéje alá adja hozzá.

<dependency>
 <groupId>com.azure</groupId>
 <artifactId>azure-core-management</artifactId>
 <version>1.17.0</version>
</dependency>
<dependency>
 <groupId>com.azure</groupId>
 <artifactId>azure-identity</artifactId>
 <version>1.15.3</version>
 <scope>compile</scope>
</dependency>
<dependency>
 <groupId>com.azure.resourcemanager</groupId>
 <artifactId>azure-resourcemanager-resources</artifactId>
 <version>2.48.0</version>
</dependency>
 <dependency>
 <groupId>com.azure.resourcemanager</groupId>
 <artifactId>azure-resourcemanager-postgresqlflexibleserver</artifactId>
 <version>1.1.0</version>
</dependency>
<dependency>
 <groupId>com.azure</groupId>
 <artifactId>azure-core-http-netty</artifactId>
 <version>1.15.11</version>
</dependency>
<dependency>
 <groupId>org.apache.logging.log4j</groupId>
 <artifactId>log4j-slf4j-impl</artifactId>
 <version>2.20.0</version>
</dependency>

Megjegyzés:

Mielőtt hozzáadja őket a fájlhoz, ellenőrizze az összes függőség legújabb verzióját.

Hozzon létre egy Azure Database for PostgreSQL-példányt

Rugalmas Azure PostgreSQL-kiszolgáló létrehozásához hozzon létre egy fájlt CreateServer.java az alábbi kóddal.

package com.example.restservice;
import java.util.HashMap;
import java.util.Map;

import com.azure.core.credential.TokenCredential;
import com.azure.core.http.policy.HttpLogDetailLevel;
import com.azure.core.http.policy.HttpLogOptions;
import com.azure.core.management.AzureEnvironment;
import com.azure.core.management.profile.AzureProfile;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.resourcemanager.postgresqlflexibleserver.PostgreSqlManager;
import com.azure.resourcemanager.postgresqlflexibleserver.models.ActiveDirectoryAuthEnum;
import com.azure.resourcemanager.postgresqlflexibleserver.models.ArmServerKeyType;
import com.azure.resourcemanager.postgresqlflexibleserver.models.AuthConfig;
import com.azure.resourcemanager.postgresqlflexibleserver.models.DataEncryption;
import com.azure.resourcemanager.postgresqlflexibleserver.models.HighAvailability;
import com.azure.resourcemanager.postgresqlflexibleserver.models.HighAvailabilityMode;
import com.azure.resourcemanager.postgresqlflexibleserver.models.IdentityType;
import com.azure.resourcemanager.postgresqlflexibleserver.models.PasswordAuthEnum;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Server;
import com.azure.resourcemanager.postgresqlflexibleserver.models.ServerVersion;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Sku;
import com.azure.resourcemanager.postgresqlflexibleserver.models.SkuTier;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Storage;
import com.azure.resourcemanager.postgresqlflexibleserver.models.UserAssignedIdentity;
public class CreateServer {
    public static void main(String[] args) throws Exception {
              String subscriptionId = "<subscription-id>";
              AzureProfile profile = new AzureProfile("<tenant-id>", subscriptionId, AzureEnvironment.AZURE);

              TokenCredential credential = new DefaultAzureCredentialBuilder()
              .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()).build();
              PostgreSqlManager manager = PostgreSqlManager.authenticate(credential, profile);
              server = manager.servers()
              .define("<server-name>")
              .withRegion("<location>")
              .withExistingResourceGroup("<resource-group-name>")
              .withSku(new Sku().withName("Standard_D4ds_v5").withTier(SkuTier.GENERAL_PURPOSE))
              .withAuthConfig(new AuthConfig().withActiveDirectoryAuth(ActiveDirectoryAuthEnum.DISABLED)
              .withPasswordAuth(PasswordAuthEnum.ENABLED))
              .withIdentity(new UserAssignedIdentity().withType(IdentityType.NONE))
              .withDataEncryption(new DataEncryption().withType(ArmServerKeyType.SYSTEM_MANAGED))
              .withVersion(ServerVersion.ONE_SIX).withAuthConfig(null)
              .withAdministratorLogin("<user-name>")
              .withAdministratorLoginPassword("<password>").withStorage(new Storage().withStorageSizeGB(32))
              .withHighAvailability(new HighAvailability().withMode(HighAvailabilityMode.DISABLED))
              .create();
              System.out.println("Azure Database for PostgreSQL Flexible server is created with server name"+server.name());
    }
}

Ez a példa bemutatja, hogyan hozhat létre rugalmas Azure Database for PostgreSQL-példánykiszolgálót az PostgreSqlManager osztály használatával. A létrehozási módszer meghívása előtt a TokenCredential és az AzureProfile használatával hitelesíti magát. A hitelesítés után meghatározza a Azure Rugalmas PostgreSQL-kiszolgálót a megadott konfigurációval.

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.
  • tenant-id : A Microsoft Entra-fiók bérlőazonosítója. Ezt a portálról vagy a parancssori felületről szerezheti be.
  • 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.

Authentication

Hitelesítő adatait különböző módokon hitelesítheti. Ebben a példában DefaultAzureCredentialBuilder tokenCredential objektumot konfigurálhat és hozhat létre, amely egy hitelesítő adat, amelyet Azure szolgáltatásokkal történő hitelesítéshez használhat. Jelentkezzen be az előfeltételekben említett Azure CLI használatával.

A fájl futtatása

Győződjön meg arról, hogy létrehoz egy Maven-projektet, és végrehajtja a következő parancsokat. Futtassa ezeket a parancsokat minden alkalommal, amikor új függőséget ad hozzá a pom.xml fájlhoz, hogy telepítse a függőséget a helyi adattárban:

mvn clean install

A fájl futtatásához használja az IDE-t a kód futtatásához, vagy a parancssort a Java fájl futtatásához.

javac <file-name>.java
java <file-name>

Megjegyzés:

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

Az üzembe helyezett Azure Rugalmas PostgreSQL-kiszolgálót a Azure portálon, Azure CLI, Azure PowerShell és egyéb eszközökkel ellenőrizheti az üzembe helyezést, és áttekintheti az üzembe helyezett erőforrásokat.

Adatbázis létrehozása

Hozzáadhat egy új adatbázist az újonnan létrehozott kiszolgálóhoz. Győződjön meg arról, hogy a Azure Database for PostgreSQL rugalmas kiszolgáló fut.

package com.example.restservice;

import com.azure.core.credential.TokenCredential;
import com.azure.core.http.policy.HttpLogDetailLevel;
import com.azure.core.http.policy.HttpLogOptions;
import com.azure.core.management.AzureEnvironment;
import com.azure.core.management.profile.AzureProfile;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.resourcemanager.postgresqlflexibleserver.PostgreSqlManager;

public class CreateDatabaseSample {
    public static void main(String args[]) {
        String subscriptionId = "<subscription-id>";
        AzureProfile profile = new AzureProfile("<tenant-id>", subscriptionId, AzureEnvironment.AZURE);

        TokenCredential credential = new DefaultAzureCredentialBuilder()
        .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()).build();
        PostgreSqlManager manager = PostgreSqlManager.authenticate(credential, profile);
        manager.databases()
        .define("<database-name>")
        .withExistingFlexibleServer("<resource-group-name>", "<server-name>")
        .withCharset("utf8")
        .withCollation("en_US.utf8")
        .create();
    }
}

Kiszolgálóadatok frissítése

Hozzon létre egy UpdateServer.java fájlt.

A szerveradatokat ezzel a Java SDK-val is frissítheti, a(z) postgresqlflexibleserver könyvtár update() metódusának meghívásával.

A módszerrel frissítheti a update verziót, a rendszergazdai felhasználónevet, a jelszót és más tulajdonságokat.

package com.example.restservice;

import com.azure.core.credential.TokenCredential;
import com.azure.core.http.policy.HttpLogDetailLevel;
import com.azure.core.http.policy.HttpLogOptions;
import com.azure.core.management.AzureEnvironment;
import com.azure.core.management.profile.AzureProfile;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.resourcemanager.postgresqlflexibleserver.PostgreSqlManager;
import com.azure.resourcemanager.postgresqlflexibleserver.models.ActiveDirectoryAuthEnum;
import com.azure.resourcemanager.postgresqlflexibleserver.models.AuthConfig;
import com.azure.resourcemanager.postgresqlflexibleserver.models.AzureManagedDiskPerformanceTiers;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Backup;
import com.azure.resourcemanager.postgresqlflexibleserver.models.CreateModeForUpdate;
import com.azure.resourcemanager.postgresqlflexibleserver.models.PasswordAuthEnum;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Server;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Sku;
import com.azure.resourcemanager.postgresqlflexibleserver.models.SkuTier;
import com.azure.resourcemanager.postgresqlflexibleserver.models.Storage;
import com.azure.resourcemanager.postgresqlflexibleserver.models.StorageAutoGrow;

public class UpdateServer {
    public static void main(String args[]) {
         String subscriptionId = "<subscription-id>";
         AzureProfile profile = new AzureProfile("<tenant-id>", subscriptionId, AzureEnvironment.AZURE);

         TokenCredential credential = new DefaultAzureCredentialBuilder()
         .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()).build();
         PostgreSqlManager manager = PostgreSqlManager.authenticate(credential, profile);
         PostgreSqlManager postgreSqlManager = PostgreSqlManager.configure()
         .withLogOptions(new HttpLogOptions()
         .setLogLevel(HttpLogDetailLevel.BODY_AND_HEADERS))
         .authenticate(credential, profile);
         Server resource = manager.servers()
         .getByResourceGroupWithResponse("<resource-group-name>", "<server-name>", com.azure.core.util.Context.NONE)
         .getValue();
         resource.update()
         .withSku(new Sku().withName("Standard_D16ds_v5").withTier(SkuTier.GENERAL_PURPOSE))
         .withAdministratorLoginPassword("<password>")
         .withStorage(new Storage().withStorageSizeGB(1024)
         .withAutoGrow(StorageAutoGrow.DISABLED)
         .withTier(AzureManagedDiskPerformanceTiers.P30))
         .withBackup(new Backup().withBackupRetentionDays(20))
         .withAuthConfig(new AuthConfig().withActiveDirectoryAuth(ActiveDirectoryAuthEnum.ENABLED)
         .withPasswordAuth(PasswordAuthEnum.ENABLED)
         .withTenantId("<tenant-id>"))
         .withCreateMode(CreateModeForUpdate.UPDATE)
         .apply();
         System.out.println("Updated successfully");
 }
}

Futtassa a Java fájlt, és tekintse át az erőforrásban végrehajtott módosításokat a UpdateServer.java fájl használatával.

Erőforrások tisztítása

A létrehozott rugalmas kiszolgálókat a(z) postgresqlflexibleserver kódtár delete() metódusával törölheti.

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

package com.example.restservice;

import com.azure.core.credential.TokenCredential;
import com.azure.core.http.policy.HttpLogDetailLevel;
import com.azure.core.http.policy.HttpLogOptions;
import com.azure.core.management.AzureEnvironment;
import com.azure.core.management.profile.AzureProfile;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.resourcemanager.postgresqlflexibleserver.PostgreSqlManager;

public class DeleteInstance {
    public static void main(String args[]) {
          String subscriptionId = "<subscription-id>";
          AzureProfile profile = new AzureProfile("<tenant-id>", subscriptionId, AzureEnvironment.AZURE);

          TokenCredential credential = new DefaultAzureCredentialBuilder()
          .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()).build();
          PostgreSqlManager manager = PostgreSqlManager.authenticate(credential, profile);
          PostgreSqlManager postgreSqlManager = PostgreSqlManager.configure()
          .withLogOptions(new HttpLogOptions()
          .setLogLevel(HttpLogDetailLevel.BODY_AND_HEADERS))
          .authenticate(credential, profile);
          manager.servers().delete("<resource-group>", "<server-name>", com.azure.core.util.Context.NONE);
          System.out.println("Deleted successfully");
 }

}

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

  • subscription-id: Saját előfizetés-azonosító.
  • resource-group: A használni kívánt erőforráscsoport neve.
  • tenant-id : A Microsoft Entra-fiók bérlőazonosítója. Ezt a portálról vagy a parancssori felületről szerezheti be.
  • server-name: A létrehozott Azure Database Flexible Server 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.

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

  • Utolsó frissítés időpontja: