Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs Menu
Docs Home
/ / /
C 드라이버
/ / /

사전 빌드된 MongoDB C 드라이버 라이브러리 설치

libmongoclibbson 라이브러리는 일반 Linux 배포판Homebrew를 통한 macOS의 패키지 관리 리포지토리에서 사용할 수 있는 경우가 많습니다.

참고

Windows 의 경우 로컬 도구 체인과의 호환성을 극대화하려면 대신 소스에서라이브러리를 빌드 것이 좋습니다. 소스에서 빌드하는 작업은 Conan 또는 vcpkg와 같은 소스 라이브러리 패키지 관리 도구를 사용하여 자동화할 수 있습니다( 참조: 라이브러리 패키지 관리자를 사용한 크로스 플랫폼 설치 참조).

경고

타사 패키지 프로그램에서 사전 빌드된 바이너리를 설치하고 사용하는 경우 해당 문서 페이지(1.28)에 설명된 라이브러리 버전보다 뒤처질 수 있습니다. 설치 버전을 기록하고 이 페이지를 읽을 때 염두에 두세요.

C 드라이버 라이브러리의 최신 버전을 사용하려면 소스에서 빌드하는 것이 좋습니다.

사용 가능한 패키지에 대한 목록과 일반적인 참조는 패키지 설치 참조를 참조하세요.

다양한 라이브러리 패키지 관리자는 libbson libmongoc 및 을(를) 설치 가능한 패키지로 제공하며, 여기에는 Conan 및 vcpkg 가 포함됩니다. 이 섹션에서는 이러한 도구를 사용하여 설치하는 방법을 자세히 설명합니다.

vcpkg 매니페스트 모드 에서 원하는 라이브러리를 프로젝트의 vcpkg.json 매니페스트 파일 에 추가합니다.

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

vcpkg 통합을 사용하여 CMake 프로젝트 를 빌드 하고 vcpkg.json 매니페스트 파일 이 있는 경우 vcpkg는 구성 단계를 진행하기 전에 프로젝트의 종속성을 자동으로 설치하므로 추가 수작업이 필요하지 않습니다.

vcpkg 클래식 모드 에서는libbsonlibmongoc libbsonmongo-c-driver 각각 및 이라는 이름으로 설치할 수 있습니다.

$ vcpkg install mongo-c-driver

( mongo-c-driver 을 설치하면 libbson 도 이행적으로 설치됩니다.)

libmongoclibbson 패키지가 설치되고 vcpkg가 빌드 시스템에 제대로 통합되면 원하는 라이브러리를 가져올 수 있습니다.

CMake를 사용하면 표준 구성 파일 패키지와 생성된 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는 한 번에 두 가지 라이브러리 유형 중 하나만 설치합니다.

vcpkg 통합을 사용하여 CMake 프로젝트를 구성하려면 초기 구성 명령에서 CMake 도구 체인 파일을 설정하기만 하면 됩니다.

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

libbsonlibmongoc 의 이름과 설치 프로세스는 배포판에 따라 다르지만 일반적으로 유사한 패턴을 따릅니다.

다음 Linux 배포판은 libbsonlibmongoc 패키지를 제공합니다.

사용 가능한 패키지 및 패키지 옵션 목록은 패키지 설치 참조를 참조하세요.

RedHat 기반 Linux 배포판( Fedora, CentOS, Rocky Linux, AlmaLinux 등)에서 C 운전자 라이브러리는 Yum/DNF와 함께 설치할 수 있습니다.

참고

Fedora 및 엔터프라이즈 Linux 버전 8 이상에서는 yum 명령 대신 dnf 명령을 사용하는 것이 좋습니다.

중요

Fedora 제외:

C 드라이버 라이브러리는 각 엔터프라이즈 Linux 배포의 7 이상 버전에서만 사용할 수 있습니다. 그러나 C 드라이버 라이브러리는 기본 리포지토리에서 사용할 수 없지만 EPEL 리포지토리를 활성화하여 얻을 수 있습니다. 이 작업은 epel-release 패키지를 설치하여 수행할 수 있습니다.

# yum install epel-release

epel-release C 드라이버 라이브러리를 설치하기 전에 설치해야 합니다(즉, 단일 yum install 명령으로 두 라이브러리를 모두 설치할 수는 없습니다).

libbson 만 설치하려면 libbson-devel 패키지를 설치합니다.

# yum install libbson-devel

전체 C 데이터베이스 드라이버(libmongoc)를 설치하려면 mongo-c-driver-devel 을(를) 설치합니다.

## (This package will transitively install libbson-devel)
# yum install mongo-c-driver-devel

사용 가능한 버전을 확인하려면 https://packages.fedoraproject.org/pkgs/mongo-c-driver/mongo-c-driver-devel을 참조하세요.

개발 패키지( -devel 로 끝남)에는 libbsonlibmongoc 를 사용하여 애플리케이션을 빌드하는 데 필요한 파일이 포함되어 있습니다. 개발 파일 없이 라이브러리만 설치하려면 libbson 또는 mongo-c-driver-libs 패키지를 설치합니다.

Ubuntu 및 Ubuntu 파생 상품을 포함한 Debian 기반 Linux 배포에서 libbsonlibmongoc 은 APT를 통해 배포 리포지토리에서 사용할 수 있으며, 각각 libbson-devlibmongoc-dev 로 설치할 수 있습니다.

## Update repository information, if necessary:
# apt update

libbson 만 설치하려면 다음을 수행합니다.

# apt install libbson-dev

libmongoc 을(를) 설치하려면( libbson 도 설치됨):

# apt install libmongoc-dev

사용 가능한 버전을 확인하려면 apt-cache policy libmongoc-dev 를 실행합니다.

개발 패키지( -dev 로 끝남)에는 libbsonlibmongoc 를 사용하여 애플리케이션을 빌드하는 데 필요한 파일이 포함되어 있습니다. 개발 파일 없이 라이브러리만 설치하려면 libbson-1.0-0 또는 libmongoc-1.0-0 패키지를 설치합니다.

macOS 시스템을 사용하는 경우 Homebrew 패키지 관리자를 사용하여 다음 명령과 함께 C 운전자 라이브러리(libmongoc 및 모두 libbson 포함)를 설치할 수 있습니다.

$ brew install mongo-c-driver

참고

Homebrew는 libbsonlibmongoc 에 대한 별도의 패키지를 제공하지 않습니다.

Homebrew 패키지 관리자는 macOS에 기본값 으로 설치되지 않습니다. Homebrew 설치에 대한 자세한 내용은 Homebrew 설치 설명서 페이지를 참조하세요.

돌아가기

소스에서 빌드

이 페이지의 내용