Azure Database for PostgreSQL kötése az alkalmazáshoz az Azure Spring Appsben

Feljegyzés

A Alapszintű, Standardés Enterprise tervek 2025. március 17-én nyugdíjazási időszakba léptek. További információkért lásd az Azure Spring Apps kivonási bejelentését.

Ez a cikk a következőre vonatkozik:✅ Java ✅ C#

Ez a cikk a következőre vonatkozik:✅ Basic/Standard ✅ Enterprise

Az Azure Spring Apps használatával automatikusan összekapcsolhatja a kiválasztott Azure-szolgáltatásokat az alkalmazásokkal, ahelyett, hogy manuálisan kellene konfigurálnia a Spring Boot-alkalmazást. Ez a cikk bemutatja, hogyan kötheti az alkalmazást az Azure Database for PostgreSQL-példányhoz.

Ebben a cikkben két hitelesítési módszert használunk: a Microsoft Entra-hitelesítést és a PostgreSQL-hitelesítést. A Jelszó nélküli lapon a Microsoft Entra-hitelesítés, a Jelszó lapon pedig a PostgreSQL-hitelesítés látható.

A Microsoft Entra-hitelesítés az Azure Database for PostgreSQL-hez való csatlakozás mechanizmusa a Microsoft Entra ID-ban meghatározott identitások használatával. A Microsoft Entra-hitelesítéssel központi helyen kezelheti az adatbázis felhasználói identitásait és más Microsoft-szolgáltatások, ami leegyszerűsíti az engedélykezelést.

A PostgreSQL-hitelesítés a PostgreSQL-ben tárolt fiókokat használja. Ha jelszavakat használ a fiókok hitelesítő adataiként, ezeket a hitelesítő adatokat a rendszer a felhasználói táblában tárolja. Mivel ezek a jelszavak a PostgreSQL-ben vannak tárolva, saját maga kell kezelnie a jelszavak rotálását.

Előfeltételek

• Az Azure Spring Appsben üzembe helyezett alkalmazás. További információ : Rövid útmutató: Az első alkalmazás üzembe helyezése az Azure Spring Appsben.
• Egy Azure Database for PostgreSQL rugalmas kiszolgálópéldány.
• Az Azure CLI 2.45.0-s vagy újabb verziója.

A projekt előkészítése

Java

A projekt előkészítéséhez kövesse az alábbi lépéseket.

1. A projekt pom.xml fájljában adja hozzá a következő függőséget:

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa</artifactId>
   </dependency>
   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>spring-cloud-azure-starter-jdbc-postgresql</artifactId>
   </dependency>
   

2. Az application.properties fájlban távolítsa el a tulajdonságokatspring.datasource.*.

3. Frissítse az aktuális alkalmazást a futtatással az spring app deploy, vagy hozzon létre egy új üzembe helyezést ehhez a módosításhoz a futtatással az spring app deployment create.

Soknyelvű

A rendszer az összes kapcsolati sztring és hitelesítő adatot környezeti változóként injektálja, amelyre az alkalmazáskódban hivatkozhat.

Az alapértelmezett környezeti változóneveket a Service Connectorrel integrált Azure Database for PostgreSQL témakörben találja.

Az alkalmazás kötése az Azure Database for PostgreSQL-példányhoz

Feljegyzés

Ügyeljen arra, hogy a kapcsolat létrehozásához csak az alábbi módszerek egyikét válassza ki. Ha már létrehozott táblákat egy kapcsolattal, a többi felhasználó nem tudja elérni vagy módosítani a táblákat. A másik módszer kipróbálásakor az alkalmazás olyan hibákat fog eredményezni, mint a "Engedély megtagadva". A probléma megoldásához csatlakozzon egy új adatbázishoz, vagy törölje és hozza létre újra a meglévőt.

Feljegyzés

Alapértelmezés szerint a szolgáltatás-összekötők az alkalmazás szintjén jönnek létre. A kapcsolatok felülbírálásához létrehozhat más kapcsolatokat a kihelyezésekben.

Jelszó nélküli (ajánlott)

1. Telepítse a Service Connector jelszó nélküli bővítményét az Azure CLI-hez:

   az extension add --name serviceconnector-passwordless --upgrade
   

2. Konfigurálja az Azure Spring Appst a PostgreSQL-adatbázishoz való csatlakozáshoz egy rendszer által hozzárendelt felügyelt identitással a az spring connection create parancs használatával.

   az spring connection create postgres-flexible \
       --resource-group $AZ_SPRING_APPS_RESOURCE_GROUP \
       --service $AZ_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --deployment $DEPLOYMENT_NAME \
       --target-resource-group $POSTGRES_RESOURCE_GROUP \
       --server $POSTGRES_SERVER_NAME \
       --database $DATABASE_NAME \
       --system-identity
   

Jelszó

Az alábbi lépésekkel titkos kóddal kötheti össze az alkalmazást.

1. Jegyezze fel az Azure Database for PostgreSQL-fiók rendszergazdai felhasználónevét és jelszavát.

2. Csatlakozzon a kiszolgálóhoz, hozzon létre egy testdb nevű adatbázist egy PostgreSQL-ügyfélből, majd hozzon létre egy új, nem rendszergazdai fiókot.

3. Futtassa az alábbi parancsot az adatbázishoz való csatlakozáshoz rendszergazdai felhasználónévvel és jelszóval.

   az spring connection create postgres-flexible \
       --resource-group $AZ_SPRING_APPS_RESOURCE_GROUP \
       --service $AZ_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --deployment $DEPLOYMENT_NAME \
       --target-resource-group $POSTGRES_RESOURCE_GROUP \
       --server $POSTGRES_SERVER_NAME \
       --database $DATABASE_NAME \
       --secret name=$USERNAME secret=$PASSWORD
   

Következő lépések

Ebből a cikkből megtudhatja, hogyan köthet egy alkalmazást az Azure Spring Appsben egy Azure Database for PostgreSQL-példányhoz. Ha többet szeretne tudni a szolgáltatások alkalmazáshoz való kötéséről, olvassa el az Azure Cosmos DB-adatbázisok azure Spring Apps-alkalmazásokhoz való kötését ismertető témakört.