Docs Menu
Docs Home
/ / /
C ドライバー
/

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

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 に基づくディストリビューションにドライバーをインストールできます。

  • CentOS

  • Rocky Linux

  • AlmaLinux

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...>:...>前述の例では、 ジェネレーター式を使用して、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タブを使用してフィードバックを送信してください。

戻る

はじめる