AWS SDK for Java v2 - RDS Management

Overview

このスキルは、AWS SDK for Java 2.x を使用して Amazon RDS (Relational Database Service) を操作するための包括的なガイダンスを提供します。データベースインスタンス管理、スナップショット、パラメータグループ、RDS操作をカバーしています。

When to Use

• RDS データベースインスタンスの作成、変更、削除
• DB スナップショット、パラメータグループ、設定の管理
• Multi-AZ デプロイメントと自動バックアップのセットアップ
• Lambda 関数から RDS データベースへの接続
• インスタンスステータスとパフォーマンスの監視

Instructions

Amazon RDS を操作するには、以下の手順に従ってください。

1. 依存関係を追加 - AWS RDS SDK 依存関係とデータベースドライバーを含める
2. RDS クライアントを作成 - 適切なリージョンと認証情報を使用して RdsClient をインスタンス化する
3. DB インスタンスを作成 - createDBInstance() を適切な設定で使用する
4. セキュリティを設定 - VPC セキュリティグループと暗号化をセットアップする
5. バックアップを設定 - 自動バックアップウィンドウと保持期間を設定する
6. ステータスを監視 - describeDBInstances() を使用してインスタンスの状態を確認する
7. スナップショットを作成 - 大きな変更前に手動スナップショットを取得する
8. フェイルオーバーを処理 - 高可用性のために Multi-AZ を設定する

Getting Started

RDS Client Setup

RdsClient は Amazon RDS と相互作用するためのメインエントリーポイントです。

基本的なクライアント作成:

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.rds.RdsClient;

RdsClient rdsClient = RdsClient.builder()
    .region(Region.US_EAST_1)
    .build();

// クライアントを使用
describeInstances(rdsClient);

// 常にクライアントをクローズする
rdsClient.close();

カスタム設定を使用したクライアント:

import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.http.apache.ApacheHttpClient;

RdsClient rdsClient = RdsClient.builder()
    .region(Region.US_WEST_2)
    .credentialsProvider(ProfileCredentialsProvider.create("myprofile"))
    .httpClient(ApacheHttpClient.builder()
        .connectionTimeout(Duration.ofSeconds(30))
        .socketTimeout(Duration.ofSeconds(60))
        .build())
    .build();

DB インスタンスの説明

DescribeDbInstancesResponse response = rdsClient.describeDBInstances();
for (DBInstance instance : response.dbInstances()) {
    System.out.println(instance.dbInstanceArn() + " - " + instance.dbInstanceStatus());
}

Key Operations

DB インスタンスの作成

CreateDbInstanceRequest request = CreateDbInstanceRequest.builder()
    .dbInstanceIdentifier(dbInstanceIdentifier)
    .dbName(dbName)
    .engine("postgres")
    .engineVersion("15.4")
    .dbInstanceClass("db.t3.micro")
    .allocatedStorage(20)
    .masterUsername(masterUsername)
    .masterUserPassword(masterPassword)
    .publiclyAccessible(false)
    .build();

CreateDbInstanceResponse response = rdsClient.createDBInstance(request);

// VALIDATION CHECKPOINT: インスタンスが利用可能になるのを待つ
rdsClient.waiter().waitUntilDBInstanceAvailable(
    DescribeDbInstancesRequest.builder().dbInstanceIdentifier(dbInstanceIdentifier).build()
);
System.out.println("Instance " + dbInstanceIdentifier + " is available!");

DB パラメータグループの管理

CreateDbParameterGroupRequest request = CreateDbParameterGroupRequest.builder()
    .dbParameterGroupName(groupName)
    .dbParameterGroupFamily("postgres15")
    .description(description)
    .build();
rdsClient.createDBParameterGroup(request);

DB スナップショットの管理

CreateDbSnapshotRequest request = CreateDbSnapshotRequest.builder()
    .dbInstanceIdentifier(dbInstanceIdentifier)
    .dbSnapshotIdentifier(snapshotIdentifier)
    .build();
CreateDbSnapshotResponse response = rdsClient.createDBSnapshot(request);

Integration Patterns

Spring Boot Integration

完全な Spring Boot 統合例については references/spring-boot-integration.md を参照してください。以下が含まれます:

• application properties を使用した Spring Boot 設定
• RDS クライアント Bean 設定
• サービスレイヤーの実装
• REST コントローラーの設計
• 例外処理
• テスト戦略

Lambda Integration

Lambda 統合例については references/lambda-integration.md を参照してください。以下が含まれます:

• 従来の Lambda + RDS 接続
• コネクションプーリング付きの Lambda
• AWS Secrets Manager を使用した認証情報の管理
• RDS 管理用の AWS SDK を使用した Lambda
• セキュリティ設定とベストプラクティス

Advanced Operations

DB インスタンスの変更

ModifyDbInstanceRequest request = ModifyDbInstanceRequest.builder()
    .dbInstanceIdentifier(dbInstanceIdentifier)
    .dbInstanceClass(newInstanceClass)
    .applyImmediately(false)
    .build();
rdsClient.modifyDBInstance(request);

DB インスタンスの削除

// VALIDATION CHECKPOINT: インスタンスの存在確認とステータス確認
DBInstance instance = rdsClient.describeDBInstances(
    DescribeDbInstancesRequest.builder().dbInstanceIdentifier(dbInstanceIdentifier).build()
).dbInstances().get(0);

if ("available".equals(instance.dbInstanceStatus())) {
    DeleteDbInstanceRequest request = DeleteDbInstanceRequest.builder()
        .dbInstanceIdentifier(dbInstanceIdentifier)
        .skipFinalSnapshot(false)
        .finalDBSnapshotIdentifier(snapshotId)
        .build();
    rdsClient.deleteDBInstance(request);
}

Examples

検証付き完全な RDS インスタンス作成

public String createSecurePostgreSQLInstance(RdsClient rdsClient,
                                            String instanceIdentifier,
                                            String dbName,
                                            String masterUsername,
                                            String masterPassword,
                                            String vpcSecurityGroupId) {
    // セキュリティ設定でインスタンスを作成
    CreateDbInstanceRequest request = CreateDbInstanceRequest.builder()
        .dbInstanceIdentifier(instanceIdentifier)
        .dbName(dbName)
        .masterUsername(masterUsername)
        .masterUserPassword(masterPassword)
        .engine("postgres")
        .engineVersion("15.4")
        .dbInstanceClass("db.t3.micro")
        .allocatedStorage(20)
        .storageEncrypted(true)
        .vpcSecurityGroupIds(vpcSecurityGroupId)
        .publiclyAccessible(false)
        .multiAZ(true)
        .backupRetentionPeriod(7)
        .deletionProtection(true)
        .build();

    rdsClient.createDBInstance(request);

    // VALIDATION: インスタンスの利用可能性を待つ
    rdsClient.waiter().waitUntilDBInstanceAvailable(
        DescribeDbInstancesRequest.builder().dbInstanceIdentifier(instanceIdentifier).build()
    );
    System.out.println("Instance " + instanceIdentifier + " is available!");
    return instanceIdentifier;
}

Best Practices

セキュリティ: 暗号化を有効にする (storageEncrypted=true)、VPC セキュリティグループを使用、パブリックアクセスを無効にする。

高可用性: 本番ワークロードのために Multi-AZ を有効にする。

バックアップ: 7日以上の保持期間で自動バックアップを設定する。

削除保護: 本番データベースに対して deletionProtection(true) を有効にする。

リソース管理: try-with-resources でクライアントを常にクローズする:

try (RdsClient rdsClient = RdsClient.builder().region(Region.US_EAST_1).build()) {
    // クライアントを使用
}

Dependencies

<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>rds</artifactId>
    <version>2.20.0</version>
</dependency>
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.6.0</version>
</dependency>

Reference Documentation

詳細な API リファレンスについては、以下を参照してください:

• API Reference - 完全な API ドキュメンテーションとデータモデル
• Spring Boot Integration - Spring Boot パターンと例
• Lambda Integration - Lambda 関数パターンとベストプラクティス

Error Handling

一般的な例外、エラーレスポンス構造、ページネーション対応を含む包括的なエラー処理パターンについては、API Reference を参照してください。

Constraints and Warnings

• インスタンスの制限: リージョンあたりの DB インスタンス数に対するアカウント制限
• Multi-AZ コスト: 計算コストがおよそ2倍になる
• スナップショットコスト: 手動スナップショットは使用ストレージあたりで課金される
• 削除保護: 保護が有効なインスタンスは削除できない
• メンテナンスウィンドウ: アップデート中はインスタンスが利用できない場合がある