/ /

Queryable Encryption 호환성

동일성 쿼리를 사용한 Queryable Encryption 은 MongoDB 7.0 이상에서 GA(일반 사용 가능)로 제공됩니다. 버전 6.0 에서 릴리스된 Queryable Encryption Public Preview는 더 이상 지원되지 않습니다. 공개 미리 보기를 사용하여 암호화됨 데이터는 기능 출시하다 와 호환되지 않습니다. 자세한 내용은 MongoDB 7.0의 호환성 변경 사항을 참조하세요.

이 페이지에서는 Queryable Encryption 이 호환되는 MongoDB 및 운전자 버전에 대해 설명합니다.

➤ 언어 선택 드롭다운 메뉴를 사용하여 운전자 선택하고 Queryable Encryption 과의 호환성을 확인합니다.

MongoDB Edition, 토폴로지 및 버전 호환성

자동 암호화 를 포함하는 Queryable Encryption 은 MongoDB Enterprise 및 MongoDB Atlas 에서만 사용할 수 있습니다. Queryable Encryption 은 MongoDB 복제본 세트 또는 샤딩된 클러스터 에서 사용할 수 있지만 독립형 인스턴스 에서는 사용할 수 없습니다.

명시적 암호화 는 MongoDB Community 및 Enterprise Edition에서 사용할 수 있습니다.

드라이버 호환성

C 운전자 와 함께 Queryable Encryption 사용하려면 다음 구성 요소를 설치합니다.

드라이버 버전 1.24.0 이상
libmongocrypt 버전 1.8.0 이상

C++ 운전자 에서 Queryable Encryption 사용하려면 다음 구성 요소를 설치합니다.

드라이버 버전 3.8.0 이상
libmongocrypt 버전 1.8.0 이상

.NET/ C# 운전자 와 함께 Queryable Encryption 사용하려면 운전자 버전 이상을 2.20.0 설치합니다.

운전자 버전 3.0 이상을 사용하는 경우 다음 단계도 완료해야 합니다.

MongoDB 설치합니다. NuGet의 드라이버.Encryption 패키지 . 이 패키지 자동 암호화 활성화합니다.
애플리케이션이 Linux에서 실행되는 경우 libmongocrypt 를 수동으로 설치합니다. 그런 다음 LIBMONGOCRYPT_PATH 환경 변수를 libmongocrypt 파일 의 절대 경로로 설정하다 .
애플리케이션 64비트 Linux 에서 실행되고 운전자 버전 3.4.3 이하를 사용하는 경우 .csproj 파일 에 다음 XML 줄을 추가합니다. 설치한 MongoDB.Driver.Encryption 패키지 의 버전과 일치하도록 <MongoDriverEncryptionVersion> 요소의 값을 변경합니다.

<PropertyGroup>
    <!-- replace the version here with your package version -->
    <MongoDriverEncryptionVersion>3.4.2</MongoDriverEncryptionVersion>
    <MongoDriverEncryptionPath>$(NuGetPackageRoot)mongodb.driver.encryption\$(MongoDriverEncryptionVersion)</MongoDriverEncryptionPath>
</PropertyGroup>
<PropertyGroup>
    <!-- Suppresses the duplicate file error -->
    <ErrorOnDuplicatePublishOutputFiles>false</ErrorOnDuplicatePublishOutputFiles>
</PropertyGroup>
<!-- Ensures the correct library after build or publish -->
<Target Name="EnsureCorrectMongoEncryption" AfterTargets="Build;Publish" Condition="'$(RuntimeIdentifier)' != ''">
    <!-- Determine paths based on current operation -->
    <PropertyGroup>
        <_TargetDir Condition="Exists('$(PublishDir)')">$(PublishDir)</_TargetDir>
        <_TargetDir Condition="'$(_TargetDir)' == ''">$(OutputPath)</_TargetDir>
    </PropertyGroup>
    <!-- Copy the correct library based on runtime identifier (RID) -->
    <ItemGroup>
        <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/x64/libmongocrypt.so"
                          Condition="'$(RuntimeIdentifier)' == 'linux-x64'" />
        <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/arm64/libmongocrypt.so"
                          Condition="'$(RuntimeIdentifier)' == 'linux-arm64'" />
        <_CorrectMongoLib Include="$(MongoDriverEncryptionPath)/runtimes/linux/native/alpine/libmongocrypt.so"
                          Condition="'$(RuntimeIdentifier)' == 'linux-musl-arm64'" />
    </ItemGroup>
    <!-- Copy with overwrite -->
    <Copy SourceFiles="@(_CorrectMongoLib)"
          DestinationFolder="$(_TargetDir)"
          Condition="'@(_CorrectMongoLib)' != ''"
          OverwriteReadOnlyFiles="true" />
    <Message Text="Fixed MongoDB encryption library for $(RuntimeIdentifier)"
             Condition="'@(_CorrectMongoLib)' != ''" />
</Target>

고 (Go) 운전자 와 함께 Queryable Encryption 사용하려면 다음 구성 요소를 설치하세요.

드라이버 버전 1.12 이상
libmongocrypt 버전 1.8.0 이상

Java Reactive Streams 운전자 에서 Queryable Encryption 사용하려면 다음 구성 요소를 설치하세요.

드라이버 버전 4.10.0 이상
mongodb-crypt 버전 1.8.0 이상

Java Sync 운전자와 함께 Queryable Encryption 사용하려면 다음 구성 요소를 설치합니다.

드라이버 버전 4.10.0 이상
mongodb-crypt 버전 1.8.0 이상

Node.js 운전자 와 함께 Queryable Encryption 사용하려면 다음 구성 요소를 설치합니다.

드라이버 버전 5.5.0 이상
mongodb-client-encryption 버전 2.8.0 이상

Node.js 운전자 버전 6.0 이상을 사용하는 경우 mongodb-client-encryption 버전 6.0 이상도 사용해야 합니다.

PHP 운전자 에서 Queryable Encryption 사용하려면 운전자 버전 1.16 이상을 설치합니다.

PyMongo에서 Queryable Encryption 사용하려면 다음 구성 요소를 설치하세요.

드라이버 버전 4.4 이상
pymongocrypt 버전 1.6 이상

Ruby 운전자 에서 Queryable Encryption 사용하려면 다음 구성 요소를 설치하세요.

드라이버 버전 2.19 이상
libmongocrypt-helper 버전 1.8.0 이상

Rust 운전자 와 함께 Queryable Encryption 사용하려면 다음 구성 요소를 설치하세요.

드라이버 버전 2.4.0 이상
libmongocrypt 버전 1.8.0 이상

스칼라 운전자 와 함께 Queryable Encryption 사용하려면 다음 구성 요소를 설치하세요.

드라이버 버전 4.10.0 이상
mongodb-crypt 버전 1.8.0 이상

돌아가기

명시적 암호화 사용

Queryable Encryption 제한