문서가격블로그
문의하기
로그인무료로 가입하기
Back to Tech Articles

Rustにおけるsqlxとbb8/deadpoolを用いた効率的なデータベース接続管理

9月 01, 2025
# Misc

Lukas Schneider

DevOps Engineer · Leapcell

이 게시물은 English, 한국어 및 Deutsch에서도 볼 수 있습니다.
Cover of "Rustにおけるsqlxとbb8/deadpoolを用いた効率的なデータベース接続管理"

はじめに

現代のウェブサービスやバックエンドアプリケーションの分野では、効率的で信頼性の高いデータベースとのやり取りが不可欠です。データベースに頻繁に接続するアプリケーションは、リクエストごとに新しい接続を確立する際のオーバーヘッドに注意を払う必要があります。TCPハンドシェイク、認証、リソース割り当てを含むこのオーバーヘッドは、中程度の負荷でもすぐにパフォーマンスのボトルネックとなる可能性があります。さらに、管理されていない接続の作成は、データベースサーバー自体のリソースを枯渇させ、不安定性やサービス低下を引き起こす可能性があります。

これはまさにデータベース接続プールが輝く場所です。アプリケーションは、すぐに使用できる接続のプールを維持することにより、レイテンシとリソース消費を劇的に削減できます。操作ごとに新しい接続を開く代わりに、接続はプールから借りて、使用され、返却されます。この実践は、スループットとシステムの安定性を大幅に向上させます。Rustのエコシステムでは、sqlxは、型安全で強力なデータベース操作を提供する、愛されている非同期ORMとして登場しました。sqlxの機能 complement するために、bb8やdeadpoolのような接続プールライブラリに目を向けます。これらのライブラリは、これらの貴重なデータベース接続を効率的に管理するために特別に設計されています。この記事では、高性能で回復力のあるRustアプリケーションを構築するために、bb8またはdeadpoolと組み合わせてsqlxを効果的に活用する方法を掘り下げます。

コアコンセプトの理解

実装の詳細に入る前に、議論の中心となるいくつかの重要な用語を明確にしましょう。

  • sqlx: コンパイル時チェッククエリを提供する、非同期で純粋なRustのSQLクレートです。PostgreSQL、MySQL、SQLite、Microsoft SQL Serverなど、さまざまなデータベースをサポートしています。sqlxは、型安全性と習慣的なRustに焦点を当て、実行時前に一般的なSQLインジェクションや型ミスマッチエラーを防ぎます。その非同期性は、現代的で高並行なアプリケーションに最適です。

  • Connection Pool (接続プール): アプリケーションによって維持されるデータベース接続のキャッシュです。リクエストごとに新しい接続を作成するのではなく、アプリケーションはプールから利用可能な接続を要求します。使用後、接続はプールに返却され、次のリクエストの準備ができます。このデザインパターンは、接続オーバーヘッドを大幅に削減し、応答時間を改善します。接続プールは通常、リソース枯渇を防ぐために、接続の検証、アイドルタイムアウト、および最大接続制限も処理します。

  • bb8: Rust向けの汎用非同期接続プールです。さまざまなデータベースドライバー（またはプールを必要とするその他のリソース）と統合できる柔軟なフレームワークを提供します。bb8は、堅牢なエラー処理と設定可能なプール設定で知られており、接続管理の細かい制御を可能にします。

  • deadpool: Rust向けのもう1つの強力な非同期接続プールで、sqlxと一緒によく使用されます。deadpoolは、使いやすいAPIを提供し、シンプルさと効率を目指しています。接続の作成、リサイクル、終了を自動的に処理するため、ほとんどのシナリオで「すぐに動作する」ソリューションとなります。deadpoolは、Rustで最も人気のある非同期ランタイムであるtokioともうまく統合します。

  • tokio: Rust向けの主要な非同期ランタイムです。タスク、I/O、タイマーを含む、高性能な非同期アプリケーションを構築するために必要なツールとプリミティブを提供します。sqlx、bb8、deadpoolのすべてがtokio上に構築されているか、シームレスに統合されています。

sqlxとbb8/deadpoolを用いた堅牢な接続プールの構築

sqlxと接続プールを一緒に使用する中心的な考え方は、アプリケーションの起動時にプールを一度初期化し、データベース操作が必要なときにこのプールから接続を取得（または「取得」）することです。bb8とdeadpoolでこれを達成する方法を見てみましょう。

bb8との統合

bb8は、sqlxのPgConnection（または他の接続タイプ）に直接統合されるbb8-postgresクレート（または他のデータベース用の同様のもの）を提供します。

まず、Cargo.tomlに必要な依存関係を追加します。

[dependencies]
sqlx = { version = "0.7", features = ["postgres", "runtime-tokio-rustls", "macros", "time"] }
tokio = { version = "1", features = ["full"] }
bb8 = "0.8"
bb8-postgres = "0.8"
dotenvy = "0.15" # 環境変数をロードするため

次に、接続プールを設定し、その使用方法をデモンストレーションしましょう。

use sqlx::{PgPool, postgres::PgPoolOptions};
use tokio::net::TcpStream;
use bb8::{Pool, PooledConnection};
use bb8_postgres::PostgresConnectionManager;
use dotenvy::dotenv;
use std::time::Duration;
use tokio::sync::OnceCell;

// グローバル接続プール
static DB_POOL: OnceCell<Pool<PostgresConnectionManager>> = OnceCell::const_new();

async fn initialize_db_pool() -> Result<(), Box<dyn std::error::Error>> {
    dotenv().ok();
    let database_url = std::env::var("DATABASE_URL")
        .expect("DATABASE_URL must be set in .env file or environment variables.");

    let manager = PostgresConnectionManager::new(
        database_url.parse()?,
        tokio_postgres::NoTls, // またはTLSで接続するには tokio_postgres::TlsStream
    );

    let pool = Pool::builder()
        .max_size(10) // プール内の最大接続数
        .min_idle(Some(2)) // 最小アイドル接続数
        .build(manager)
        .await?;

    DB_POOL.set(pool).map_err(|_| "Failed to set DB_POOL")?;
    println!("Database pool initialized successfully with bb8.");
    Ok(())
}

async fn create_user(username: &str, email: &str) -> Result<(), sqlx::Error> {
    let pool = DB_POOL.get().expect("DB_POOL not initialized");
    let conn = pool.get().await.map_err(|e| sqlx::Error::PoolTimedOut)?; // 必要に応じてbb8エラーをsqlxエラーに変換

    sqlx::query!(
        r#" 
        INSERT INTO users (username, email)
        VALUES ($1, $2)
        "#,
        username,
        email
    )
    .execute(&*conn) // PooledConnectionを&PgConnectionに逆参照
    .await?;

    println!("User '{}' created.", username);
    Ok(())
}

async fn get_user_count() -> Result<i64, sqlx::Error> {
    let pool = DB_POOL.get().expect("DB_POOL not initialized");
    let conn = pool.get().await.map_err(|e| sqlx::Error::PoolTimedOut)?;

    let count: i64 = sqlx::query_scalar!(
        r#" 
        SELECT COUNT(*) FROM users
        "#
    )
    .fetch_one(&*conn)
    .await?;

    Ok(count)
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    initialize_db_pool().await?;

    // 使用例
    create_user("Alice", "alice@example.com").await?;
    create_user("Bob", "bob@example.com").await?;

    let user_count = get_user_count().await?;
    println!("Total users: {}", user_count);

    Ok(())
}

このbb8の例では：

  1. 接続プールを保持するためのstatic OnceCellを定義し、一度だけ初期化されることを保証します。
  2. PostgresConnectionManagerは、sqlx PostgreSQL接続を作成および管理するために使用されます。
  3. Pool::builder()により、max_sizeおよびmin_idle接続の設定が可能になります。
  4. pool.get().awaitはプールから接続を取得します。これはPooledConnectionを返しますが、スコープを外れると自動的に接続をプールに解放します。
  5. &*connを使用してPooledConnectionを&PgConnectionに逆参照し、sqlxがクエリ実行に期待するものです。

deadpoolとの統合

deadpoolは、sqlxデータベースタイプ用の特別なアダプターを備えていることが多く、統合をさらに簡素化します。

Cargo.tomlに依存関係を追加します。

[dependencies]
sqlx = { version = "0.7", features = ["postgres", "runtime-tokio-rustls", "macros", "time"] }
tokio = { version = "1", features = ["full"] }
deadpool-postgres = { version = "0.12", features = ["tokio_1"] }
deadpool = "0.10" # これはdeadpool-postgresによって暗黙的にプルされるかもしれませんが、汎用トレイトに必要であれば明示的に含めるのが良いでしょう
dotenvy = "0.15"
tokio-postgres = "0.7" # deadpool-postgresによって直接使用される

次に、deadpoolで接続プーリングを実装しましょう。

use sqlx::{PgPool, postgres::PgPoolOptions};
use deadpool_postgres::{Pool, Manager, Config, PoolError, tokio_postgres::NoTls};
use dotenvy::dotenv;
use std::time::Duration;
use tokio::sync::OnceCell;

// グローバル接続プール
static DB_POOL: OnceCell<Pool> = OnceCell::const_new();

async fn initialize_deadpool() -> Result<(), Box<dyn std::error::Error>> {
    dotenv().ok();
    let database_url = std::env::var("DATABASE_URL")
        .expect("DATABASE_URL must be set in .env file or environment variables.");

    let mut cfg = Config::new();
    cfg.url = Some(database_url);
    cfg.manager = Some(Manager::new(NoTls)); // TLSの場合は TlsStream
    cfg.pool = Some(deadpool_postgres::PoolConfig {
        max_size: Some(10), // 最大接続数
        timeouts: Some(deadpool_postgres::Timeouts {
            wait: Some(Duration::from_secs(5)), // 接続を待つ時間
            create: Some(Duration::from_secs(5)), // 新しい接続を作成する時間
            recycle: Some(Duration::from_secs(5)), // 古い接続をリサイクルする時間
        }),
        ..Default::default()
    });

    let pool = cfg.create_pool()?;
    DB_POOL.set(pool).map_err(|_| "Failed to set DB_POOL")?;
    println!("Database pool initialized successfully with deadpool.");
    Ok(())
}

async fn create_user_deadpool(username: &str, email: &str) -> Result<(), sqlx::Error> {
    let pool = DB_POOL.get().expect("DB_POOL not initialized");
    let conn = pool.get().await.map_err(|e| sqlx::Error::PoolTimedOut)?; // deadpoolエラーを変換

    // deadpool接続は直接sqlx::Executorを実装しています。
    // また、deadpool接続は、sqlxメソッドの&mut PgConnectionとして直接使用されるように設計されています。
    // しかし、sqlxクエリは通常`&mut PgConnection`または`&PgPool`を期待します。
    // deadpoolのクライアントは `&(impl PgExecutor + PgRowExecutor)` として借用できます。
    sqlx::query!(
        r#" 
        INSERT INTO users (username, email)
        VALUES ($1, $2)
        "#,
        username,
        email
    )
    .execute(&*conn) // deadpool_postgresからのClient型はsqlx::Executorを実装します
    .await?;

    println!("User '{}' created.", username);
    Ok(())
}

async fn get_user_count_deadpool() -> Result<i64, sqlx::Error> {
    let pool = DB_POOL.get().expect("DB_POOL not initialized");
    let conn = pool.get().await.map_err(|e| sqlx::Error::PoolTimedOut)?;

    let count: i64 = sqlx::query_scalar!(
        r#" 
        SELECT COUNT(*) FROM users
        "#
    )
    .fetch_one(&*conn)
    .await?;

    Ok(count)
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    initialize_deadpool().await?;

    // 使用例
    create_user_deadpool("Charlie", "charlie@example.com").await?;
    create_user_deadpool("Diana", "diana@example.com").await?;

    let user_count = get_user_count_deadpool().await?;
    println!("Total users with deadpool: {}", user_count);

    Ok(())
}

deadpoolの例では：

  1. プールには、ここでもstatic OnceCellを使用します。
  2. deadpool_postgres::Configは、接続詳細とプールオプションを指定するために使用されます。
  3. cfg.create_pool()?がプールを初期化します。
  4. pool.get().awaitは接続（deadpool_postgres::Client）を取得します。
  5. bb8と同様に、Clientは逆参照することで（例：&*conn）、sqlxクエリメソッドで直接使用できます。

本番アプリケーションの主な考慮事項

  • 初期化戦略: AxumやActix-webなどのWebフレームワークでは、データベースプールは依存関係注入またはグローバル状態管理を使用してアプリケーション状態として渡されることがよくあります。OnceCellまたはlazy_static!をグローバルプールに使用することは、よりシンプルなアプリケーションまたはフレームワークの状態管理がないサービスで一般的です。
  • エラーハンドリング: 接続の取得時（例：PoolTimedOutまたは接続確立の失敗）のエラーを適切に処理します。データベースが利用できない場合は、リトライメカニズムを実装するか、サービスを正常に縮小します。
  • プール構成:
    • max_size: 最大接続数を決定します。これは、アプリケーションの負荷、サーバーリソース、およびデータベースの制限に基づいて調整する必要があります。
    • min_idle (bb8): 最小限のアイドル接続が維持されることを保証し、バースト期間中の接続作成レイテンシを削減します。
    • timeout: タイムアウトする前に、利用可能な接続を待つ時間。
    • connection_timeout: 新しい接続を確立するのにかかる時間。
  • ヘルスチェック: 本番環境では、接続の定期的なヘルスチェックが役立ちます。bb8とdeadpoolの両方で、ある程度の接続検証（例：破損した接続の自動ドロップ）が行われますが、明示的なアプリケーションレベルのヘルスチェックは、さらに高い回復力を提供できます。
  • トランザクション管理: トランザクションを使用する場合、sqlxは接続またはプールでbegin()、commit()、rollback()メソッドを提供します。トランザクションの場合、通常は単一の接続を取得し、トランザクションが完了するまで保持します。

結論

効率的なデータベース接続プーリングは、スケーラブルでパフォーマンスの高いRustアプリケーションを構築するための基盤です。sqlxをbb8やdeadpoolのような堅牢なプーリングライブラリと統合することにより、接続オーバーヘッドを大幅に削減し、応答時間を改善し、データベース操作の全体的な安定性を向上させることができます。汎用的な柔軟性を求めてbb8を選択するにしても、またはdeadpoolの簡略化されたAPIと緊密なtokio統合を選択するにしても、どちらもデータベース接続を管理するための優れたソリューションを提供し、自信を持って回復力があり高スループットなサービスを構築できるようになります。

Share this article

HackerNews

More Posts from Leapcell

Popular Posts