ドライバーのバージョンをアップグレードする
Overview
このセクションでは、ドライバーを新しいバージョンにアップグレードするときにアプリケーションに加える必要がある重要な変更を特定できます。
アップグレードする前に、次のアクションを実行してください。
新しいバージョンが、アプリケーションが接続する MongoDB Server のバージョンと、アプリケーションが実行される.NET フレームワークのバージョンと互換性があることを確認します。 この情報については、 .NET/C# ドライバーの互換性ページを参照してください。
アプリケーションが使用しているドライバーの現在のバージョンとアップグレード予定のバージョンとの間の重大な変更について、 重大な変更セクションで対処します。 MongoDB Server リリースの互換性の変更の詳細については、「サーバー リリースの互換性の変更 」セクションを参照してください。
Tip
将来ドライバー バージョンをアップグレードする際にアプリケーションで必要になる変更数を最小限に抑えるには、 Stable API を使用します。
重大な変更
重大な変更とは、ドライバーの特定のバージョン以降の規則または動作の変更です。 このタイプの変更では、ドライバーをアップグレードする前に対処しないと、アプリケーションが正常に動作しなくなる可能性があります。
このセクションの重大な変更は、それを導入したドライバーのバージョンによって分類されます。 ドライバーのバージョンをアップグレードするときは、現在のバージョンとアップグレードのバージョン間のすべての重大な変更に対処してください。 たとえば、ドライバーを v 2.0から v 2.20にアップグレードする場合、v 2.0以降のバージョンからの重大な変更に対処します。 v 2.20にリストされているすべての を含みます。
バージョン2.28.0 重大な変更の可能性
すべての .NET/C# ドライバー コンポーネントには厳密に名前が付けられます。 ドライバー バージョン2.28以降を使用しており、アプリケーションに複数の .NET/C# ドライバー バージョンを参照する依存関係がある場合は、次の例に示すように、バインディング リダイレクトを作成する必要があります。
<configuration> <runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <dependentAssembly> <assemblyIdentity name="MongoDB.Driver" publicKeyToken="94992a530f44e321" culture="neutral" /> <bindingRedirect oldVersion="2.28.0.0" newVersion="<version number to use>" /> </dependentAssembly> <dependentAssembly> <assemblyIdentity name="MongoDB.Bson" publicKeyToken="94992a530f44e321" culture="neutral" /> <bindingRedirect oldVersion="2.28.0.0" newVersion="<version number to use>" /> </dependentAssembly> <dependentAssembly> <assemblyIdentity name="MongoDB.Driver.Core" publicKeyToken="94992a530f44e321" culture="neutral" /> <bindingRedirect oldVersion="2.28.0.0" newVersion="<version number to use>" /> </dependentAssembly> </assemblyBinding> </runtime> </configuration>
バージョン2.21.0 重大な変更
Atlas Search ビルダの
Render
メソッドの関数署名が変更されました。 次のコード スニペットは、変更前と変更後の関数シグネチャを示しています。// Render function signature prior to v2.21.0 Render(IBsonSerializer<TDocument> documentSerializer, IBsonSerializerRegistry serializerRegistry); // Render function signature in v2.21.0 and later Render(SearchDefinitionRenderContext<TDocument> renderContext);
バージョン2.19.0 重大な変更
ObjectSerializer
は、安全であると見なされる型の逆直列化のみを許可します。 特に指定されていない場合、ObjectSerializer
はObjectSerializer.DefaultAllowedTypes
によって返された型を使用します。ObjectSerializer
の詳細については、 FAQをご覧ください。DefaultAllowedTypes
の詳細については、 APIドキュメント をご覧ください。デフォルトの
LinqProvider
は LINQ 3に変更されました。 次のコード例に示すように、MongoClientSettings
で LINQ 2用にLinqProvider
を構成することができます。var connectionString = "<connection string>"; var clientSettings = MongoClientSettings .FromConnectionString(connectionString); clientSettings.LinqProvider = LinqProvider.V2; var client = new MongoClient(clientSettings);
バージョン 2.14.0 重大な変更
この MongoDB .NET/C# ドライバーのバージョンでは、.NET フレームワーク v 4.5.2またはそれ以前のバージョンのサポートが削除されました。サポートされる最小の .NET フレームワークは v 4.7.2です。
このバージョンの MongoDB .NET/C# ドライバーは .NET Standard v 1.5をサポートしていません。サポートされる最小の .NET 標準は v 2.0です。
バージョン2.13.0 重大な変更
slave0k
接続stringオプションが削除されました。代わりにreadPreference
オプションが使用されるようになりました。
サーバー リリースの互換性の変更
サーバー リリースの互換性の変更とは、MongoDB .NET/C# ドライバーに対する変更で、MongoDB Server のバージョンのセットのサポートを廃止します。
ドライバーは、サポート終了(EOL)に達すると、MongoDB Server バージョンのサポートを終了します。
EOL 製品の MongoDB サポートの詳細については、サポート レガシー ポリシー を参照してください。
.NET/C# ドライバーのバージョンと MongoDB Server のバージョンの互換性の詳細については、互換性ページをご覧ください。
バージョン2.14 サポートの変更をリリース
v 2.14ドライバーは MongoDB Server v 3.4以前のサポートを削除します。 v 2.14以降の任意のドライバーを使用するには、MongoDB Server は v 3.6である必要があります 以降に更新します。
MongoDB Server 配置をアップグレードする方法については、MongoDB Server マニュアルのリリースノートを参照してください。