Rustを使い始める

Rustと MongoDB をインストールします。

開発環境にRust 1.74 以降とRustパッケージマネージャーの Rust がインストールされていることを確認してください。

Rustおよび Cardgo をインストールする方法の詳細については、 Rustのダウンロードとインストールに関するRust の公式ガイドを参照してください。

プロジェクトディレクトリを作成します。

shell で次のコマンドを実行して、このプロジェクト用に rust_quickstart というディレクトリを作成します。

cargo new rust_quickstart

このコマンドが正常に完了すると、 Cargo.tomlファイルとsrcディレクトリが作成され、 rust_quickstartディレクトリにはmain.rsファイルが含まれます。

次のコマンドを実行して、プロジェクト ディレクトリに移動します。

cd rust_quickstart

Rustドライバーをインストールします。

次のクライアントをプロジェクトのCargo.tomlファイルにある依存関係リストに含めて、プロジェクトに追加します。

• mongodb、Rust ドライバー crate

• serde、直列化クローン

• futures、コア抽象化を提供する非同期ランタイム crate

ドライバーは非同期ランタイムと同期ランタイムの両方をサポートしています。 各ランタイムの依存関係リストの例を表示するには、次のAsynchronous API タブとSynchronous API タブから選択します。

[dependencies]
serde = "1.0.188"
futures = "0.3.28"
tokio = {version = "1.32.0", features = ["full"]}
[dependencies.mongodb]
version = "3.5.2"

[dependencies]
serde = "1.0.188"
[dependencies.mongodb]
version = "3.5.2"
features = ["sync"]

非同期ランタイムと同期ランタイムの詳細については、 非同期 API と同期 APIガイドをご覧ください。

Atlas に無料のMongoDB配置を作成します。

MongoDB の使用開始ガイドを完了して、新しい Atlas アカウントを設定し、サンプルデータを新しい無料階層の MongoDB 配置にロードします。

認証情報を保存します。

データベースユーザーを作成したら、そのユーザーのユーザー名とパスワードを安全な場所に保存して、後の手順で使用します。

MongoDB Atlas接続文字列を見つけます。

前のステップで作成した配置の接続文字列を取得するには、Atlas アカウントにログインし、Clusters セクションの下の Database ページに移動します。新しい配置で Connect ボタンをクリックします。

データベースユーザーをまだ設定していない場合、 MongoDB は新しいユーザーを作成して構成するように要求します。

Connect to your application の下の [Drivers ボタンをクリックし、Driver 選択メニューから「Rust」を選択し、Version 選択メニューからインストールしたバージョンに最適なバージョンを選択します。

接続文字列のみを表示するには、View full code sample オプションが選択されていないことを確認します。

接続文字列をコピーします。

次のスクリーンショットに示すように、接続stringの右側にあるコピーアイコンをクリックして、クリップボードにコピーします。

パスワード プレースホルダーを更新します。

この接続文字列をテキストエディタのファイルに貼り付け、<db_password> プレースホルダーをデータベースユーザーのパスワードに置き換えます。接続文字列には、すでにデータベースユーザーのユーザー名が入力されています。

このファイルを安全な場所に保存して、次の手順で使用します。

Rustアプリケーションを作成します。

rust_quickstart/srcプロジェクトディレクトリ内の main.rs というファイルを開きます。このファイルで、アプリケーションの記述を開始できます。

以下のコードをコピーして、main.rs ファイルに貼り付けます。

use mongodb::{ 
	bson::{Document, doc},
	Client,
	Collection 
};
#[tokio::main]
async fn main() -> mongodb::error::Result<()> {
    // Replace the placeholder with your Atlas connection string
    let uri = "<connection string URI>";
    // Create a new client and connect to the server
    let client = Client::with_uri_str(uri).await?;
    // Get a handle on the movies collection
    let database = client.database("sample_mflix");
    let my_coll: Collection<Document> = database.collection("movies");
    // Find a movie based on the title value
    let my_movie = my_coll.find_one(doc! { "title": "The Perils of Pauline" }).await?;
    // Print the document
    println!("Found a movie:\n{:#?}", my_movie);
    Ok(())
}

use mongodb::{ 
	bson::{Document, doc},
	sync::{Client, Collection} 
};
fn main() -> mongodb::error::Result<()> {
    // Replace the placeholder with your Atlas connection string
    let uri = "<connection string URI>";
    // Create a new client and connect to the server
    let client = Client::with_uri_str(uri)?;
    // Get a handle on the movies collection
    let database = client.database("sample_mflix");
    let my_coll: Collection<Document> = database.collection("movies");
    // Find a movie based on the title value
    let my_movie = my_coll
        .find_one(doc! { "title": "The Perils of Pauline" })
        .run()?;
    // Print the document
    println!("Found a movie:\n{:#?}", my_movie);
    Ok(())
}

接続文字列を割り当てます。

<connection string URI> プレースホルダーを、このガイドの接続文字列の作成ステップからコピーした接続文字列に置き換えます。

Rustアプリケーション を実行します。

rust_quickstartプロジェクトディレクトリから、次のコマンドを実行して、このアプリケーションをコンパイルして実行します。

cargo run

コマンドライン出力には、検索された映画ドキュメントの詳細が含まれます。

Found a movie:
Some(
    Document({
        "_id": ObjectId(...),
        "title": String(
            "The Perils of Pauline",
        ),
        "plot": String(
            "Young Pauline is left a lot of money ...",
        ),
        "runtime": Int32(
            199,
        ),
        "cast": Array([
            String(
                "Pearl White",
            ),
            String(
                "Crane Wilbur",
            ),
            ...
        ]),
    }),
)

エラーが発生した場合や出力が表示されない場合は、main.rs ファイルに適切な接続stringが指定されており、サンプル データがロードされていることを確認してください。