/ /

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 Edition および 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 以降を使用している場合は、次の手順も完了する必要があります。

NuGet からMongoDB.Driver.Encryptionパッケージをインストールします。このパッケージは自動暗号化を有効にします。
アプリケーションがLinuxで実行される場合は、libmongocrypt を手動でインストールします。次に、LIBMONGOCRYPT_PATH 環境変数を libmongocryptファイルの絶対パスに設定します。
アプリケーションが64 ビットLinuxで実行され、かつドライバーバージョン 3.4.3 またはそれ以前のバージョンを使用している場合は、次の XML 行を .csprojファイルに追加します。<MongoDriverEncryptionVersion> 要素の値を、インストールしている MongoDB.Driver.Encryptionパッケージのバージョンと一致するように変更します。

<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-クライアント暗号化バージョン 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 ヘルパーバージョン 1.8.0またはそれ以降

RustドライバーでQueryable Encryptionを使用するには、次のコンポーネントをインストールします。

ドライバーバージョン 2.4.0 以降
libmongocrypt バージョン 1.8.0 以降

ScalaドライバーでQueryable Encryptionを使用するには、次のコンポーネントをインストールします。

ドライバーバージョン 4.10.0 以降
mongodb-crypt バージョン 1.8.0またはそれ以降

戻る

明示的な暗号化の使用

Queryable Encryption の制限