Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu öğreticide Spring Data JDBC kullanarak MySQL için Azure Veritabanı 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 MySQL kimlik doğrulaması. Passwordless sekmesi Microsoft Entra kimlik doğrulamasını gösterir ve Password sekmesi MySQL kimlik doğrulamasını gösterir.
Microsoft Entra kimlik doğrulaması, Microsoft Entra ID tanımlanan kimlikleri kullanarak MySQL için Azure Veritabanı bağlanmaya yönelik bir mekanizmadır. Microsoft Entra kimlik doğrulamasıyla, veritabanı kullanıcı kimliklerini ve diğer Microsoft hizmetleri merkezi bir konumda yönetebilirsiniz ve bu da izin yönetimini basitleştirir.
MySQL kimlik doğrulaması, MySQL'de depolanan hesapları kullanır. Hesapların kimlik bilgileri olarak parolaları kullanmayı seçerseniz, bu kimlik bilgileri user tablosunda depolanır. Bu parolalar MySQL'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.
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 MySQL Driver bağımlılıklarını ekleyin ve ardından Java sürüm 8 veya üzerini seçin.
- Eğer yoksa,
mysqlflexibletestadlı bir MySQL için Azure Veritabanı Esnek Sunucusu örneği oluşturun. Yönergeler için bkz. Quickstart: MySQL için Azure Veritabanı Esnek Sunucu oluşturmak için Azure portalını kullanma. Ardından adlıdemobir veritabanı oluşturun. Yönergeler için bkz. MySQL için Azure Veritabanı Esnek Sunucu için veritabanları oluşturma ve yönetme.
Ö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-mysql konumunda kullanılabilir.
MySQL sunucunuz için bir güvenlik duvarı kuralı yapılandırma
MySQL için Azure Veritabanı ö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 Esnek Sunucu MySQL için Azure Veritabanı için güvenlik duvarı kurallarını yönetme.
Windows bir bilgisayarda Linux için Windows Alt Sistemi 'den (WSL) MySQL sunucunuza bağlanıyorsanız, WSL ana bilgisayar IP adresini güvenlik duvarınıza eklemeniz gerekir.
Yönetici olmayan bir MySQL kullanıcısı oluşturma ve izin verme
Bu adım yönetici olmayan bir kullanıcı oluşturur ve veritabanındaki demo tüm izinleri ona verir.
Parolasız bağlantı kullanan yönetici olmayan bir kullanıcı oluşturmak için aşağıdaki yöntemi kullanabilirsiniz.
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 --upgradeYönetici olmayan Microsoft Entra kullanıcı oluşturmak için aşağıdaki komutu kullanın:
az connection create mysql-flexible \ --resource-group <your_resource_group_name> \ --connection mysql_conn \ --target-resource-group <your_resource_group_name> \ --server mysqlflexibletest \ --database demo \ --user-account mysql-identity-id=/subscriptions/<your_subscription_id>/resourcegroups/<your_resource_group_name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<your_user_assigned_managed_identity_name> \ --query authInfo.userName \ --output tsvKomut tamamlandığında konsol çıkışındaki kullanıcı adını not alın.
MySQL için Azure Veritabanı verilerini depolama
Artık MySQL için Azure Veritabanı Esnek sunucu örneğiniz olduğuna göre Spring Cloud Azure kullanarak verileri depolayabilirsiniz.
Spring Cloud Azure Starter JDBC MySQL 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.2.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>Not
Spring Boot 4.0.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü7.2.0olarak ayarladığınızdan emin olun.Spring Boot 3.5.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü6.2.0olarak ayarladığınızdan emin olun.Spring Boot 3.1.x-3.5.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü5.25.0olarak ayarladığınızdan emin olun.Eğer Spring Boot 2.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü4.20.0olarak 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 ürün reçetesi 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 MySQL yapıtı:
<dependency> <groupId>com.azure.spring</groupId> <artifactId>spring-cloud-azure-starter-jdbc-mysql</artifactId> </dependency>
Not
Sürümünden 4.5.0bu yana parolasız bağlantılar desteklenmektedir.
Spring Boot'ı MySQL için Azure Veritabanı kullanacak şekilde yapılandırma
Spring Data JDBC kullanarak MySQL için Azure Veritabanı verilerini depolamak için uygulamayı yapılandırmak için şu adımları izleyin:
application.properties yapılandırma dosyanıza aşağıdaki özellikleri ekleyerek MySQL için Azure Veritabanı kimlik bilgilerini yapılandırın.
logging.level.org.springframework.jdbc.core=DEBUG spring.datasource.url=jdbc:mysql://mysqlflexibletest.mysql.database.azure.com:3306/demo?serverTimezone=UTC spring.datasource.username=<your_mysql_ad_non_admin_username> spring.datasource.azure.passwordless-enabled=true spring.sql.init.mode=alwaysUyarı
Yapılandırma özelliği
spring.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.Yapılandırma özelliği
spring.datasource.url?serverTimezone=UTC, JDBC sürücüsüne veritabanına bağlanırken UTC tarih biçimini (veya Eşgüdümlü Evrensel Saat) kullanmasını bildirmek için eklenmiştir. Bu parametre olmadan, Java sunucunuz veritabanıyla aynı tarih biçimini kullanmaz ve bu da hataya neden olur.
- Eğer yoksa,
mysqlsingletestadıyla bir MySQL için Azure Veritabanı Tek Sunucu örneği oluşturun. Yönergeler için bkz. Quickstart: Azure portalını kullanarak MySQL için Azure Veritabanı sunucusu oluşturma. Ardından adlıdemobir veritabanı oluşturun. Yönergeler için Veri tabanı oluşturma bölümüne bakın> MySQL için Azure Veritabanı'da kullanıcıları 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-mysql konumunda kullanılabilir.
MySQL sunucunuz için bir güvenlik duvarı kuralı yapılandırma
MySQL için Azure Veritabanı ö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 MySQL için Azure Veritabanı güvenlik duvarı kurallarını oluşturma ve yönetme.
Windows bir bilgisayarda Linux için Windows Alt Sistemi 'den (WSL) MySQL sunucunuza bağlanıyorsanız, WSL ana bilgisayar IP adresini güvenlik duvarınıza eklemeniz gerekir.
Yönetici olmayan bir MySQL kullanıcısı oluşturma ve izin verme
Bu adım yönetici olmayan bir kullanıcı oluşturur ve veritabanındaki demo tüm izinleri ona verir.
Önemli
Parolasız bağlantıları kullanmak için MySQL için Azure Veritabanı örneğine Microsoft Entra bir yönetici kullanıcı oluşturun. Daha fazla bilgi için, MySQL ile kimlik doğrulaması için Microsoft Entra ID kullanma belgelerinin Microsoft Entra Yöneticisi kullanıcı ayarlama bölümüne bakın.
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:
export AZ_MYSQL_AD_NON_ADMIN_USERID=$(az ad signed-in-user show --query id --output tsv)
cat << EOF > create_ad_user.sql
SET aad_auth_validate_oids_in_tenant = OFF;
CREATE AADUSER '<your_mysql_ad_non_admin_username>' IDENTIFIED BY '$AZ_MYSQL_AD_NON_ADMIN_USERID';
GRANT ALL PRIVILEGES ON demo.* TO '<your_mysql_ad_non_admin_username>'@'%';
FLUSH privileges;
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:
mysql -h mysqlsingletest.mysql.database.azure.com --user <your_mysql_ad_admin_username>@mysqlsingletest --enable-cleartext-plugin --password=$(az account get-access-token --resource-type oss-rdbms --output tsv --query accessToken) < create_ad_user.sql
İpucu
MySQL için Azure Veritabanı 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. MySQL ile kimlik doğrulaması için Microsoft Entra ID kullanma.
MySQL için Azure Veritabanı verilerini depolama
Artık MySQL için Azure Veritabanı Tek Sunucu örneğiniz olduğuna göre Spring Cloud Azure kullanarak verileri depolayabilirsiniz.
Spring Cloud Azure Starter JDBC MySQL 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.2.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>Not
Spring Boot 4.0.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü7.2.0olarak ayarladığınızdan emin olun.Spring Boot 3.5.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü6.2.0olarak ayarladığınızdan emin olun.Spring Boot 3.1.x-3.5.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü5.25.0olarak ayarladığınızdan emin olun.Eğer Spring Boot 2.x kullanıyorsanız,
spring-cloud-azure-dependenciessürümünü4.20.0olarak 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 ürün reçetesi 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 MySQL bileşeni:
<dependency> <groupId>com.azure.spring</groupId> <artifactId>spring-cloud-azure-starter-jdbc-mysql</artifactId> </dependency>
Not
Sürümünden 4.5.0bu yana parolasız bağlantılar desteklenmektedir.
Spring Boot'ı MySQL için Azure Veritabanı kullanacak şekilde yapılandırma
Spring Data JDBC kullanarak MySQL için Azure Veritabanı verilerini depolamak için uygulamayı yapılandırmak için şu adımları izleyin:
application.properties yapılandırma dosyanıza aşağıdaki özellikleri ekleyerek MySQL için Azure Veritabanı kimlik bilgilerini yapılandırın.
logging.level.org.springframework.jdbc.core=DEBUG spring.datasource.url=jdbc:mysql://mysqlsingletest.mysql.database.azure.com:3306/demo?serverTimezone=UTC spring.datasource.username=<your_mysql_ad_non_admin_username>@mysqlsingletest spring.datasource.azure.passwordless-enabled=true spring.sql.init.mode=alwaysUyarı
Yapılandırma özelliği
spring.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.Yapılandırma özelliği
spring.datasource.url?serverTimezone=UTC, JDBC sürücüsüne veritabanına bağlanırken UTC tarih biçimini (veya Eşgüdümlü Evrensel Saat) kullanmasını bildirmek için eklenmiştir. Bu parametre olmadan, Java sunucunuz veritabanıyla aynı tarih biçimini kullanmaz ve bu da hataya neden olur.
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);
Yeni bir
TodoJava sınıfı oluşturun. Bu sınıf, Spring Boot tarafından otomatik olarak oluşturulacak tabloyatodoeşlenen bir etki alanı modelidir. Aşağıdaki kod,gettersvesettersyö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; }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ığı
DefaultAzureCredentialkullanır.DefaultAzureCredentialbirden ç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?
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 yapma
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 MySQL Örnekleri