Azure Database for PostgreSQL ile Spring Data JDBC kullanma

Bu öğreticide, Spring Data JDBC kullanarak Azure Database for PostgreSQL veritabanında veri depolama gösterilmektedir.

JDBC geleneksel ilişkisel veritabanlarına bağlanmak için standart Java API'dir.

Bu öğreticide iki kimlik doğrulama yöntemi ekleyeceğiz: Microsoft Entra kimlik doğrulaması ve PostgreSQL kimlik doğrulaması. Passwordless sekmesi Microsoft Entra kimlik doğrulamasını, Password sekmesinde ise PostgreSQL kimlik doğrulaması gösterilir.

Microsoft Entra kimlik doğrulaması, Microsoft Entra ID tanımlanan kimlikleri kullanarak Azure Database for PostgreSQL bağlanma mekanizmasıdır. Microsoft Entra kimlik doğrulaması ile veritabanı kullanıcı kimliklerini ve diğer Microsoft hizmetlerini merkezi bir konumda yönetebilirsiniz ve bu da izin yönetimini basitleştirir.

PostgreSQL kimlik doğrulaması PostgreSQL'de depolanan hesapları kullanır. Hesapların kimlik bilgileri olarak parolaları kullanmayı seçerseniz, bu kimlik bilgileri user tablosunda depolanır. Bu parolalar PostgreSQL'de depolandığından, parolaların döndürmesini kendiniz yönetmeniz gerekir.

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik .

• Java Development Kit (JDK), sürüm 8 veya üzeri.

• Apache Maven.

• Azure CLI.

• PostgreSQL komut satırı istemcisi.

• Spring Boot uygulamanız yoksa Spring Initializr ile bir Maven projesi oluşturun. Maven Project ve Dependencies altında Spring Web, Spring Data JDBC ve PostgreSQL Driver bağımlılıklarını ekleyin ve ardından Java sürüm 8 veya üzerini seçin.

• Yoksa postgresqlflexibletest adlı bir Azure Database for PostgreSQL Esnek Sunucu örneği ve demo adlı bir veritabanı oluşturun. Yönergeler için bkz. Quickstart: Azure portalında Azure Database for PostgreSQL - Esnek Sunucu oluşturma.

Örnek uygulamaya bakın

Bu öğreticide örnek bir uygulama kodlayacaksınız. Daha hızlı gitmek istiyorsanız, bu uygulama zaten kodlanmış ve https://github.com/Azure-Samples/quickstart-spring-data-jdbc-postgresql konumunda kullanılabilir.

PostgreSQL sunucunuz için güvenlik duvarı kuralı yapılandırma

Azure Database for PostgreSQL örnekleri varsayılan olarak güvenlidir. Gelen bağlantılara izin vermeyen bir güvenlik duvarı vardır.

Veritabanınızı kullanabilmek için sunucunun güvenlik duvarını açarak yerel IP adresinin veritabanı sunucusuna erişmesine izin verin. Daha fazla bilgi için bkz. Azure Database for PostgreSQL - Esnek Sunucu'daki Firewall kuralları.

PostgreSQL sunucunuza Windows bir bilgisayardaki Windows Subsystem for Linux (WSL) üzerinden bağlanıyorsanız WSL ana bilgisayar kimliğini güvenlik duvarınıza eklemeniz gerekir.

PostgreSQL yönetici olmayan kullanıcı oluşturma ve izin verme

Ardından, yönetici olmayan bir kullanıcı oluşturun ve veritabanına tüm izinleri verin.

Parolasız (Önerilen)

Parolasız bağlantı kullanan yönetici olmayan bir kullanıcı oluşturmak için aşağıdaki yöntemi kullanabilirsiniz.

Hizmet Bağlayıcısı (Önerilen)

1. Azure CLI için Service Connector parolasız uzantıyı yüklemek için aşağıdaki komutu kullanın:

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

2. Yönetici olmayan Microsoft Entra kullanıcı oluşturmak için aşağıdaki komutu kullanın:

     az connection create postgres-flexible \
          --resource-group <your_resource_group_name> \
          --connection postgres_conn \
          --target-resource-group <your_resource_group_name> \
          --server postgresqlflexibletest \
          --database demo \
          --user-account \
          --query authInfo.userName \
          --output tsv
   

   Komut tamamlandığında konsol çıkışındaki kullanıcı adını not alın.

El ile yapılandırma

Önemli

Parolasız bağlantıları kullanmak için Azure Database for PostgreSQL Esnek Sunucu örneğinin Microsoft Entra yönetici kullanıcısını yapılandırın. Daha fazla bilgi için bkz. Azure Database for PostgreSQL Esnek Sunucuda Microsoft Entra rollerini yönetme.

Yönetici olmayan kullanıcı oluşturmak için create_ad_user.sql adlı bir SQL betiği oluşturun. Aşağıdaki içeriği ekleyin ve yerel olarak kaydedin:

cat << EOF > create_ad_user.sql
select * from pgaadauth_create_principal('<your_postgresql_ad_non_admin_username>', false, false);
EOF

Ardından, yönetici olmayan Microsoft Entra kullanıcı oluşturmak üzere SQL betiğini çalıştırmak için aşağıdaki komutu kullanın:

psql "host=postgresqlflexibletest.postgres.database.azure.com user=<your_postgresql_ad_admin_username> dbname=postgres port=5432 password=$(az account get-access-token --resource-type oss-rdbms --output tsv --query accessToken) sslmode=require" < create_ad_user.sql

İpucu

Azure Database for PostgreSQL bağlanmak için Microsoft Entra kimlik doğrulamasını kullanmak için, ayarladığınız Microsoft Entra yönetici kullanıcısıyla oturum açmanız ve ardından erişim belirtecini parola olarak almanız gerekir. Daha fazla bilgi için bkz. Azure Database for PostgreSQL - Esnek Sunucu ile kimlik doğrulaması için Microsoft Entra ID kullanma.

Parola

Yönetici olmayan kullanıcı oluşturmak için create_user.sql adlı bir SQL betiği oluşturun. Aşağıdaki içeriği ekleyin ve yerel olarak kaydedin:

cat << EOF > create_user.sql
CREATE ROLE "<your_postgresql_non_admin_username>" WITH LOGIN PASSWORD '<your_postgresql_non_admin_password>';
GRANT ALL PRIVILEGES ON DATABASE demo TO "<your_postgresql_non_admin_username>";
EOF

Ardından, yönetici olmayan Microsoft Entra kullanıcı oluşturmak üzere SQL betiğini çalıştırmak için aşağıdaki komutu kullanın:

psql "host=postgresqlflexibletest.postgres.database.azure.com user=<your_postgresql_admin_username> dbname=demo port=5432 password=<your_postgresql_admin_password> sslmode=require" < create_user.sql

Not

Daha fazla bilgi için bkz. Azure Database for PostgreSQL Esnek Sunucuda kullanıcıları oluşturma.

Azure Database for PostgreSQL verilerini depolama

Artık Azure Database for PostgreSQL Esnek Sunucu örneğiniz olduğuna göre Spring Cloud Azure kullanarak verileri depolayabilirsiniz.

Spring Cloud Azure Starter JDBC PostgreSQL modülünü yüklemek için pom.xml dosyanıza aşağıdaki bağımlılıkları ekleyin:

• Spring Cloud Azure Ürün Reçetesi( BOM):

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-dependencies</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  

  Not

  Spring Boot 4.0.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 7.1.0 olarak ayarladığınızdan emin olun.

  Spring Boot 3.5.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 6.1.0 olarak ayarladığınızdan emin olun.

  Spring Boot 3.1.x-3.5.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 5.25.0 olarak ayarladığınızdan emin olun.

  Eğer Spring Boot 2.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 4.20.0 olarak ayarladığınızdan emin olun.

  Bu Parça Listesi (BOM), <dependencyManagement> bölümünde pom.xml dosyanızda yapılandırılmalıdır. Bu, tüm Spring Cloud Azure bağımlılıklarının aynı sürümü kullanmasını sağlar.

  Bu BOM için kullanılan sürüm hakkında daha fazla bilgi için bkz. Hangi Spring Cloud Azure Sürümünü Kullanmalıyım.

• Spring Cloud Azure Starter JDBC PostgreSQL bileşeni:

  <dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-jdbc-postgresql</artifactId>
  </dependency>
  

Not

Sürümünden 4.5.0bu yana parolasız bağlantılar desteklenmektedir.

Spring Boot'ı Azure Database for PostgreSQL kullanacak şekilde yapılandırma

Spring Data JDBC kullanarak Azure Database for PostgreSQL verilerini depolamak için uygulamayı yapılandırmak için şu adımları izleyin:

1. application.properties yapılandırma dosyanıza aşağıdaki özellikleri ekleyerek Azure Database for PostgreSQL kimlik bilgilerini yapılandırın.

   Parolasız (Önerilen)

   logging.level.org.springframework.jdbc.core=DEBUG
   
   spring.datasource.url=jdbc:postgresql://postgresqlflexibletest.postgres.database.azure.com:5432/demo?sslmode=require
   spring.datasource.username=<your_postgresql_ad_non_admin_username>
   spring.datasource.azure.passwordless-enabled=true
   
   spring.sql.init.mode=always
   

   Parola

   logging.level.org.springframework.jdbc.core=DEBUG
   
   spring.datasource.url=jdbc:postgresql://postgresqlflexibletest.postgres.database.azure.com:5432/demo?sslmode=require
   spring.datasource.username=<your_postgresql_non_admin_username>
   spring.datasource.password=<your_postgresql_non_admin_password>
   
   spring.sql.init.mode=always
   

   Uyarı

   Yapılandırma özelliğispring.sql.init.mode=always, Spring Boot'un sunucu her başlatıldığında bir sonraki oluşturacağınız schema.sql dosyasını kullanarak otomatik olarak bir veritabanı şeması oluşturacağı anlamına gelir. Bu özellik test için harikadır, ancak her yeniden başlatmada verilerinizi sileceğini unutmayın; bu nedenle üretimde kullanmamalısınız.

• Eğer henüz yoksa, postgresqlsingletest adlı bir Azure Database for PostgreSQL Tek Sunucu örneği ve demo adlı bir veritabanı oluşturun. Yönergeler için bkz. Quickstart: Azure portalını kullanarak Azure Database for PostgreSQL sunucusu oluşturma.

Örnek uygulamaya bakın

Bu makalede örnek bir uygulama kodlayacaksınız. Daha hızlı gitmek istiyorsanız, bu uygulama zaten kodlanmış ve https://github.com/Azure-Samples/quickstart-spring-data-jdbc-postgresql konumunda kullanılabilir.

PostgreSQL sunucunuz için güvenlik duvarı kuralı yapılandırma

Azure Database for PostgreSQL örnekleri varsayılan olarak güvenlidir. Gelen bağlantılara izin vermeyen bir güvenlik duvarı vardır.

Veritabanınızı kullanabilmek için sunucunun güvenlik duvarını açarak yerel IP adresinin veritabanı sunucusuna erişmesine izin verin. Daha fazla bilgi için bkz. Azure portalını kullanarak Azure Database for PostgreSQL - Tek Sunucu için güvenlik duvarı kuralları oluşturma ve yönetme.

PostgreSQL sunucunuza Windows bir bilgisayardaki Windows Subsystem for Linux (WSL) üzerinden bağlanıyorsanız WSL ana bilgisayar kimliğini güvenlik duvarınıza eklemeniz gerekir.

PostgreSQL yönetici olmayan kullanıcı oluşturma ve izin verme

Ardından, yönetici olmayan bir kullanıcı oluşturun ve veritabanına tüm izinleri verin.

Parolasız (Önerilen)

Parolasız bağlantı kullanan yönetici olmayan bir kullanıcı oluşturmak için aşağıdaki yöntemi kullanabilirsiniz.

Hizmet Bağlayıcısı (Önerilen)

1. Azure CLI için Service Connector parolasız uzantıyı yüklemek için aşağıdaki komutu kullanın:

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

2. Yönetici olmayan Microsoft Entra kullanıcı oluşturmak için aşağıdaki komutu kullanın:

     az connection create postgres \
          --resource-group <your_resource_group_name> \
          --connection postgres_conn \
          --target-resource-group <your_resource_group_name> \
          --server postgresqlsingletest \
          --database demo \
          --user-account \
          --query authInfo.userName \
          --output tsv
   

   Komut tamamlandığında konsol çıkışındaki kullanıcı adını not alın.

El ile yapılandırma

Önemli

Parolasız bağlantıları kullanmak için Azure Database for PostgreSQL Tek Sunucu örneğinin Microsoft Entra yönetici kullanıcısını yapılandırın. Daha fazla bilgi için bkz. PostgreSQL ile kimlik doğrulaması için Microsoft Entra ID kullanma.

Yönetici olmayan kullanıcı oluşturmak için create_ad_user.sql adlı bir SQL betiği oluşturun. Aşağıdaki içeriği ekleyin ve yerel olarak kaydedin:

cat << EOF > create_ad_user.sql
SET aad_validate_oids_in_tenant = off;
CREATE ROLE "<your_postgresql_ad_non_admin_username>" WITH LOGIN IN ROLE azure_ad_user;
GRANT ALL PRIVILEGES ON DATABASE demo TO "<your_postgresql_ad_non_admin_username>";
EOF

Ardından, yönetici olmayan Microsoft Entra kullanıcı oluşturmak üzere SQL betiğini çalıştırmak için aşağıdaki komutu kullanın:

psql "host=postgresqlsingletest.postgres.database.azure.com user=<your_postgresql_ad_admin_username>@postgresqlsingletest dbname=postgres port=5432 password=$(az account get-access-token --resource-type oss-rdbms --output tsv --query accessToken) sslmode=require" < create_ad_user.sql

İpucu

Azure Database for PostgreSQL bağlanmak için Microsoft Entra kimlik doğrulamasını kullanmak için, ayarladığınız Microsoft Entra yönetici kullanıcısıyla oturum açmanız ve ardından erişim belirtecini parola olarak almanız gerekir. Daha fazla bilgi için bkz. PostgreSQL ile kimlik doğrulaması için Microsoft Entra ID kullanma.

Parola

Yönetici olmayan kullanıcı oluşturmak için create_user.sql adlı bir SQL betiği oluşturun. Aşağıdaki içeriği ekleyin ve yerel olarak kaydedin:

cat << EOF > create_user.sql
CREATE ROLE "<your_postgresql_non_admin_username>" WITH LOGIN PASSWORD '<your_postgresql_non_admin_password>';
GRANT ALL PRIVILEGES ON DATABASE demo TO "<your_postgresql_non_admin_username>";
EOF

Ardından, yönetici olmayan Microsoft Entra kullanıcı oluşturmak üzere SQL betiğini çalıştırmak için aşağıdaki komutu kullanın:

psql "host=postgresqlsingletest.postgres.database.azure.com user=<your_postgresql_admin_username>@postgresqlsingletest dbname=demo port=5432 password=<your_postgresql_admin_password> sslmode=require" < create_user.sql

Not

Azure Database for PostgreSQL'da PostgreSQL kullanıcıları oluşturma hakkında daha ayrıntılı bilgileri okuyabilirsiniz.

Azure Database for PostgreSQL verilerini depolama

Artık Azure Database for PostgreSQL Tek sunucu örneğiniz olduğuna göre Spring Cloud Azure kullanarak verileri depolayabilirsiniz.

Spring Cloud Azure Starter JDBC PostgreSQL modülünü yüklemek için pom.xml dosyanıza aşağıdaki bağımlılıkları ekleyin:

• Spring Cloud Azure Ürün Reçetesi( BOM):

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.azure.spring</groupId>
        <artifactId>spring-cloud-azure-dependencies</artifactId>
        <version>7.1.0</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  

  Not

  Spring Boot 4.0.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 7.1.0 olarak ayarladığınızdan emin olun.

  Spring Boot 3.5.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 6.1.0 olarak ayarladığınızdan emin olun.

  Spring Boot 3.1.x-3.5.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 5.25.0 olarak ayarladığınızdan emin olun.

  Eğer Spring Boot 2.x kullanıyorsanız, spring-cloud-azure-dependencies sürümünü 4.20.0 olarak ayarladığınızdan emin olun.

  Bu Parça Listesi (BOM), <dependencyManagement> bölümünde pom.xml dosyanızda yapılandırılmalıdır. Bu, tüm Spring Cloud Azure bağımlılıklarının aynı sürümü kullanmasını sağlar.

  Bu BOM için kullanılan sürüm hakkında daha fazla bilgi için bkz. Hangi Spring Cloud Azure Sürümünü Kullanmalıyım.

• Spring Cloud Azure Starter JDBC PostgreSQL bileşeni:

  <dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-jdbc-postgresql</artifactId>
  </dependency>
  

Not

Sürümünden 4.5.0bu yana parolasız bağlantılar desteklenmektedir.

Spring Boot'ı Azure Database for PostgreSQL kullanacak şekilde yapılandırma

Spring Data JDBC kullanarak Azure Database for PostgreSQL verilerini depolamak için uygulamayı yapılandırmak için şu adımları izleyin:

1. application.properties yapılandırma dosyanıza aşağıdaki özellikleri ekleyerek Azure Database for PostgreSQL kimlik bilgilerini yapılandırın.

   Parolasız (Önerilen)

   logging.level.org.springframework.jdbc.core=DEBUG
   
   spring.datasource.url=jdbc:postgresql://postgresqlsingletest.postgres.database.azure.com:5432/demo?sslmode=require
   spring.datasource.username=<your_postgresql_ad_non_admin_username>@postgresqlsingletest
   spring.datasource.azure.passwordless-enabled=true
   
   spring.sql.init.mode=always
   

   Parola

   logging.level.org.springframework.jdbc.core=DEBUG
   
   spring.datasource.url=jdbc:postgresql://postgresqlsingletest.postgres.database.azure.com:5432/demo?sslmode=require
   spring.datasource.username=<your_postgresql_non_admin_username>@postgresqlsingletest
   spring.datasource.password=<your_postgresql_non_admin_password>
   
   spring.sql.init.mode=always
   

   Uyarı

   Yapılandırma özelliğispring.sql.init.mode=always, Spring Boot'un sunucu her başlatıldığında bir sonraki oluşturacağınız schema.sql dosyasını kullanarak otomatik olarak bir veritabanı şeması oluşturacağı anlamına gelir. Bu özellik test için harikadır, ancak her yeniden başlatmada verilerinizi sileceğini unutmayın; bu nedenle üretimde kullanmamalısınız.

2. Veritabanı şemasını yapılandırmak için src/main/resources/schema.sql yapılandırma dosyasını oluşturun ve aşağıdaki içeriği ekleyin.

   DROP TABLE IF EXISTS todo;
   CREATE TABLE todo (id SERIAL PRIMARY KEY, description VARCHAR(255), details VARCHAR(4096), done BOOLEAN);
   

3. Yeni bir Todo Java sınıfı oluşturun. Bu sınıf, Spring Boot tarafından otomatik olarak oluşturulacak tabloya todo eşlenen bir etki alanı modelidir. Aşağıdaki kod, getters ve setters yöntemlerini yoksayar.

   import org.springframework.data.annotation.Id;
   
   public class Todo {
   
       public Todo() {
       }
   
       public Todo(String description, String details, boolean done) {
           this.description = description;
           this.details = details;
           this.done = done;
       }
   
       @Id
       private Long id;
   
       private String description;
   
       private String details;
   
       private boolean done;
   
   }
   

4. Aşağıdaki içeriği göstermek için başlangıç sınıfı dosyasını düzenleyin.

   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.boot.context.event.ApplicationReadyEvent;
   import org.springframework.context.ApplicationListener;
   import org.springframework.context.annotation.Bean;
   import org.springframework.data.repository.CrudRepository;
   
   import java.util.stream.Stream;
   
   @SpringBootApplication
   public class DemoApplication {
   
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
   
       @Bean
       ApplicationListener<ApplicationReadyEvent> basicsApplicationListener(TodoRepository repository) {
           return event->repository
               .saveAll(Stream.of("A", "B", "C").map(name->new Todo("configuration", "congratulations, you have set up correctly!", true)).toList())
               .forEach(System.out::println);
       }
   
   }
   
   interface TodoRepository extends CrudRepository<Todo, Long> {
   
   }
   

   İpucu

   Bu öğreticide yapılandırmalarda veya kodda kimlik doğrulama işlemi yoktur. Ancak, Azure hizmetlerine bağlanmak için kimlik doğrulaması gerekir. Kimlik doğrulamasını tamamlamak için Azure Identity kullanmanız gerekir. Spring Cloud Azure, Azure Kimlik kitaplığının herhangi bir kod değişikliği yapmadan kimlik bilgilerini almanıza yardımcı olmak için sağladığı DefaultAzureCredential kullanır.

   DefaultAzureCredential birden çok kimlik doğrulama yöntemini destekler ve çalışma zamanında hangi yöntemin kullanılacağını belirler. Bu yaklaşım, uygulamanızın ortama özgü kod uygulamadan farklı ortamlarda (yerel ve üretim ortamları gibi) farklı kimlik doğrulama yöntemleri kullanmasını sağlar. Daha fazla bilgi için bkz. DefaultAzureCredential.

   Yerel geliştirme ortamlarında kimlik doğrulamasını tamamlamak için Azure CLI, Visual Studio Code, PowerShell veya diğer yöntemleri kullanabilirsiniz. Daha fazla bilgi için bkz. Java geliştirme ortamlarında Azure kimlik doğrulaması. Azure barındırma ortamlarında kimlik doğrulamasını tamamlamak için kullanıcı tarafından atanan yönetilen kimliği kullanmanızı öneririz. Daha fazla bilgi için bkz. Azure kaynakları için yönetilen kimlikler nelerdir?

5. Uygulamayı başlatın. Uygulama verileri veritabanına depolar. Aşağıdaki örneğe benzer günlükler görürsünüz:

   2023-02-01 10:22:36.701 DEBUG 7948 --- [main] o.s.jdbc.core.JdbcTemplate : Executing prepared SQL statement [INSERT INTO todo (description, details, done) VALUES (?, ?, ?)]    
   com.example.demo.Todo@4bdb04c8
   

Azure Spring Apps'e dağıtım yapın

Spring Boot uygulamasını yerel olarak çalıştırdığınıza göre artık uygulamayı üretim ortamına taşımanın zamanı geldi. Azure Spring Apps Spring Boot uygulamalarını kod değişikliği olmadan Azure dağıtmayı kolaylaştırır. Hizmet, geliştiricilerin kodlarına odaklanabilmesi için Spring uygulamalarının altyapısını yönetir. Azure Spring Apps kapsamlı izleme ve tanılama, yapılandırma yönetimi, hizmet bulma, CI/CD tümleştirmesi, mavi-yeşil dağıtımlar ve daha fazlasını kullanarak yaşam döngüsü yönetimi sağlar. Uygulamanızı Azure Spring Apps dağıtmak için bkz. İlk uygulamanızı Azure Spring Apps'a dağıtma.

Sonraki adımlar

Spring geliştiricileri için AzureSpring Cloud Azure PostgreSQL Örnekleri