Partager via


Fournisseur de base de données MICROSOFT SQL Server EF Core

Ce fournisseur de base de données permet à Entity Framework Core d’être utilisé avec Microsoft SQL Server (y compris Azure SQL et Azure Synapse Analytics). Le fournisseur est géré dans le cadre du projet Entity Framework Core .

Installer

Installez le package NuGet Microsoft.EntityFrameworkCore.SqlServer.

dotnet add package Microsoft.EntityFrameworkCore.SqlServer

Remarque

Le fournisseur fait référence à Microsoft.Data.SqlClient (pas System.Data.SqlClient). Si votre projet prend une dépendance directe sur SqlClient, vérifiez qu’il fait référence au package Microsoft.Data.SqlClient.

Conseil

Le package Microsoft.Data.SqlClient est fourni plus fréquemment que le fournisseur EF Core. Si vous souhaitez tirer parti des nouvelles fonctionnalités et des correctifs de bogues, vous pouvez ajouter une référence de package directe à la dernière version de Microsoft.Data.SqlClient.

Avertissement

L’implémentation asynchrone de Microsoft.Data.SqlClient présente malheureusement des problèmes connus (par exemple, #593, #601, etc.). Si vous rencontrez des problèmes de performances inattendus, essayez d’utiliser l’exécution des commandes de synchronisation à la place, en particulier lorsque vous traitez de valeurs texte ou binaire volumineuses.

Utilisation

À compter d’EF 9, il est recommandé d’utiliser UseAzureSql et de UseAzureSynapse pour spécifier que vous vous connectez à Azure SQL ou Azure Synapse Analytics spécifiquement, et UseSqlServer pour spécifier que vous vous connectez à SQL Server local ; cela permet au fournisseur d’optimiser et de prendre correctement en charge ces plateformes. Il est également recommandé d’utiliser UseCompatibilityLevel méthode pour spécifier le niveau de compatibilité afin que le SQL généré soit compatible et/ou utilise les dernières fonctionnalités possibles.

Remarque

Les méthodes UseAzureSql et UseAzureSynapse ont été introduites dans EF Core 9.0.

Moteurs de base de données pris en charge

  • Microsoft SQL Server (version 2012 ultérieure)
  • Azure SQL
  • Azure Synapse Analytics