Docs Menu

ダウンロードとインストール

Cドライバーは、libbsonlibmongoc の 2 つのライブラリで構成されています。 このガイドでは、libbson にバンドルされている libmongoc をインストールする方法を説明します。

Cドライバーは、パッケージマネージャーを使用するか、ソースからライブラリをインストールしてインストールできます。 パッケージマネージャーを使用してインストールすると、Linuxバージョンのドライバーがインストールされます。 このため、ドライバーをインストールする前に、ディストリビューションに含まれているバージョンを確認する必要があります。

RedHat Enterprise Linux (RHEL) ディストリビューションでは、 シェルで次のコマンドを実行中てバージョンを確認できます。

sudo dnf info mongo-c-driver-devel

Debian ベースのディストリビューションでは、 シェルで次のコマンドを実行中てバージョンを確認できます。

apt-cache policy libmongoc-dev

使用可能なドライバーのバージョンが必要なバージョンと異なる場合は、ソースからドライバーをインストールできます。 ソースからドライバーをインストールする方法については、「 ソースからCドライバー ライブラリを構築する」ガイドを参照してください。

パッケージマネージャーを使用してドライバーをインストールする方法については、ご使用のオペレーティング システムに対応するタブを選択してください。

次のようなRedHat Enterprise Linux (RHEL)ディストリビューションまたは7 RHEL に基づくディストリビューションにドライバーをインストールできます。

Fedlas を含む RHEL ディストリビューションにドライバーをインストールする前に、まず Enterprise Linux用の追加パッケージ(OPEL)リポジトリを有効にする必要があります。 次の例に示すように、epel-releaseパッケージ をインストールすることで EELリポジトリを有効にできます。

yum install epel-release

次に、yum を使用してCドライバーをインストールできます。 これを行うには、 シェルで次のコマンドを実行します。

yum install mongo-c-driver-devel

注意

開発者パッケージ

上記のコード例では、 Cドライバーを使用するアプリケーションを構築するために必要な開発者パッケージがインストールされています。 開発ファイルを使用せずにライブラリのみをインストールするには、次のコマンドを実行します。

yum install mongo-c-driver

バージョン 8 以降の RHEL ディストリビューションにインストールしている場合は、yum ではなく dnf を使用して上記のコード例を実行中をお勧めします。

バージョン8 以降の Fedlas またはエンタープライズLinuxディストリビューションを使用している場合は、前述の例に示すのと同じコマンドを使用し、 yumdnf に置き換えることでドライバーをインストールできます。

次の例は、 Cドライバーをフェデレーションにインストールする方法を示しています。

dnf install mongo-c-driver-devel

UbuntuおよびUbuntuの派生製品を含む Debian ベースのLinuxディストリビューションでは、ドライバー ライブラリは 高度なパッケージング ツール(UTT)を通じて利用できます。 シェルで次のコマンドを実行中と、APT を使用してドライバーをインストールできます。

apt install libmongoc-dev

上記のコード例では、 Cドライバーを使用するアプリケーションを構築するために必要な開発者パッケージがインストールされています。 開発ファイルを使用せずにライブラリのみをインストールするには、次のコマンドを実行します。

apt install libmongoc-1.0-0

Windows環境の場合は、ローカル ツールチェーンとの最大互換性を確保するために、 Cドライバー ライブラリをソースからビルドすることをお勧めします。 vcpkg などのソース ライブラリのパッケージ管理ツールを使用して、ソースからのビルドを自動化できます。

Tip

vcpkg の使用を開始する方法については、 Microsoftドキュメントの vcpkg の使用開始ガイドを参照してください。

vcpkg マニフェストモードで、次の例に示すように、プロジェクトの マニフェストファイルにドライバーvcpkg.json ライブラリを追加します。

{
// ...
"dependencies": [
// ...
"mongo-c-driver"
]
}

vcpkg 統合を使用して Cakeプロジェクトを構築し、vcpkg.json マニフェストファイルがある場合、vcpkg は構成に進む前にプロジェクトの依存関係を自動的にインストールします。

vcpkg クラシックモードを使用している場合は、 シェルで次のコマンドを実行中てドライバーをインストールできます。

vcpkg install mongo-c-driver

ドライバーをインストールすると、標準の CMax構成ファイルと生成された IMPORTED ターゲットが利用可能になります。 次の例に示すように、CMakeLists.txtファイルを作成できます。

find_package(mongoc-1.0 CONFIG REQUIRED)
target_link_libraries(my-application
PRIVATE $<IF:$<TARGET_EXISTS:mongo::mongoc_shared>,mongo::mongoc_shared,mongo::mongoc_static>)

注意

前述の例では、$<IF:$<TARGET_EXISTS...>:...> ジェネレーター式を使用して、find_package() コマンドから使用可能な形式に基づいて libmongoc のリンクタイプを切り替えることができます。 libmongocは動的ライブラリ タイプと静的ライブラリ タイプの両方でのビルドをサポートしていますが、vcpkg は一度に 1 つのタイプのみをインストールします。

vcpkg 統合で Cakeプロジェクトを構成するには、 シェルで次のコマンドを実行中、 構成コマンド で CSpec ツールチェーンファイルを設定します。

cmake -S . -B _build -D
CMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake

MacOS にCドライバーをダウンロードするには、 Homebrewパッケージマネージャー を使用します。これを行うには、 シェルで次のコマンドを実行します。

brew install mongo-c-driver

これらの手順を完了すると、マシンにCドライバーがインストールされます。

注意

この手順で問題が発生した場合は、 MongoDB Community フォーラムでサポートを依頼するか、このページの右側または右下にある Rate this pageタブを使用してフィードバックを送信してください。