Cドライバーを使い始める

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

Complete the MongoDB Get Started guide to set up a new Atlas account and load sample data into a new free tier MongoDB deployment.

認証情報を保存します。

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

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

To retrieve your connection string for the deployment that you created in the previous step, log in to your Atlas account and navigate to the Clusters page under the Database section. Click the Connect button for your new deployment.

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

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

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

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

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

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

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

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

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

シェルで、アプリケーションを作成する場所に移動し、次のコマンドを実行して、このプロジェクト用に c-quickstart というディレクトリを作成します。

mkdir c-quickstart

オペレーティング システムに対応するタブを選択し、次のコマンドを実行して、 c-quickstartディレクトリにquickstart.cアプリケーション ファイルを作成します。

cd c-quickstart
touch quickstart.c

cd c-quickstart
type nul > quickstart.c

Cドライバーアプリケーションを作成します。

次のコードをコピーして、 quickstart.cファイルに貼り付けます。このコードは、 sample_mflixデータベース内のmoviesコレクションをクエリします。

#include <bson/bson.h>
#include <mongoc/mongoc.h>
#include <stdio.h>
int
main(void)
{
    const bson_t *doc;
    mongoc_init();
    mongoc_client_t *client = mongoc_client_new("<connection string>");
    mongoc_collection_t *collection = mongoc_client_get_collection(client, "sample_mflix", "movies");
    // Specify the query filter
    bson_t *query = BCON_NEW("title", "The Shawshank Redemption");
    mongoc_cursor_t *results = mongoc_collection_find_with_opts(collection, query, NULL, NULL);
    // Print the results
    while (mongoc_cursor_next(results, &doc))
    {
        char* str = bson_as_canonical_extended_json(doc, NULL);
        printf("%s\n", str);
        bson_free(str);
    }
    bson_destroy(query);
    mongoc_cursor_destroy(results);
    mongoc_collection_destroy(collection);
    mongoc_client_destroy(client);
    mongoc_cleanup();
    return EXIT_SUCCESS;
}

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

Replace the <connection string> placeholder with the connection string that you copied from the Create a Connection String step of this guide.

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

shellで次のコマンドを実行し、このアプリケーションをコンパイルして実行します。

gcc -o quickstartc quickstart.c $(pkg-config --libs --cflags libmongoc-1.0)
./quickstartc

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

{ "_id" : { "$oid" : "..." },
"plot" : "Two imprisoned men bond over a number of years, finding solace
and eventual redemption through acts of common decency.",
...
"title" : "The Shawshank Redemption",
...

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