ダウンロードとインストール
Cドライバーをダウンロード
Cドライバーは、 libbson
と libmongoc
の 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ション
次のような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
を使用して、前述のコード例を実行中することをお勧めします。
Fedora
バージョン8 以降の Fedlas またはエンタープライズLinuxションを使用している場合は、前述の例に示すのと同じコマンドを使用し、 yum
をdnf
に置き換えることでドライバーをインストールできます。
次の例は、 Cドライバーをフェデレーションにインストールする方法を示しています。
dnf install mongo-c-driver-devel
Debian ベースのディストリビューション
UbuntuおよびUbuntuの派生製品を含む Debian ベースのLinuxションでは、ドライバー ライブラリは 高度なパッケージング ツール(UTT)を通じて利用できます。 シェルで次のコマンドを実行中すると、APT を使用してドライバーをインストールできます。
apt install libmongoc-dev
上記のコード例では、 Cドライバーを使用するアプリケーションを構築するために必要な開発者パッケージがインストールされています。開発ファイルを使用せずにライブラリのみをインストールするには、次のコマンドを実行します。
apt install libmongoc-1.0-0
Windows環境の場合は、ローカル ツールチェーンとの最大互換性を確保するために、 Cドライバー ライブラリをソースからビルドすることをお勧めします。 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...>:...>
前述の例では、 ジェネレーター式を使用して、libmongoc
コマンドから使用可能な形式に基づいてfind_package()
のリンクタイプを切り替えることができます。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タブを使用してフィードバックを送信してください。