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をクリップボードにコピーします。

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

この接続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#アプリケーションを設定する

アプリケーションを構成するには、プロジェクトディレクトリに CMakeLists.txtファイルを作成します。次に、ファイルに次のコードを追加します。

cmake_minimum_required(VERSION 3.11)
project(c-quickstart LANGUAGES C)
add_executable (quickstart.out quickstart.c)
find_package(mongoc <version> REQUIRED)
target_link_libraries(quickstart.out mongoc::mongoc)

上記のコードは、次のアクションを実行します。

• Cプロジェクトを構成します。

• アプリケーション用の quickstart.out 実行可能ファイルを作成します。

• は、 Cドライバーが必要です。<version> プレースホルダーをCドライバーのバージョン番号（2.1.2 など）に置き換えます。

• プログラムを libmongoc ライブラリにリンクします。

Cアプリケーションの実行

このアプリケーションをビルドして実行するには、 シェルで次のコマンドを実行します。

cmake -S. -Bcmake-build
cmake --build cmake-build --target quickstart.out
./cmake-build/quickstart.out

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

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