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

Atlas で無料の MongoDB 配置を作成

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

認証情報の保存

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

MongoDB Atlas 接続文字列を見つける

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

Connect your application セクションに進み、Driver 選択メニューから「C」を選択し、Version 選択メニューからインストールしたバージョンに最適なバージョンを選択します。

Password (SCRAM)認証メカニズムを選択します。

接続stringのみを表示するには、Include full driver code example オプションの選択を解除します。

接続文字列のコピー

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

プレースホルダーを更新します

この接続stringをテキストエディタのファイルに貼り付け、<db_username> と <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;
}

接続文字列の割り当て

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

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が指定されており、サンプル データがロードされていることを確認してください。