Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 .
Installez
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.
EnableRetryOnFailureByDefault
EF 9 a introduit EnableRetryOnFailureByDefault une méthode qui configure le contexte en stratégie d’exécution par défaut, sauf si elle est configurée explicitement (c’est-à-dire lors de l’utilisation de l’interface de ligne de commande). Pour l’utiliser, il vous suffit d’appeler ConfigureSqlEngine(c => c.EnableRetryOnFailureByDefault()) et plus tard vous pouvez l’utiliser UseSqlServer comme d’habitude. Il n’est pas nécessaire d’appeler EnableRetryOnFailureByDefault lors de l’utilisation UseAzureSql ou UseAzureSynapse, car ils activent déjà la stratégie d’exécution par défaut.
Moteurs de base de données pris en charge
- Microsoft SQL Server (version 2012 ultérieure)
- Azure SQL
- Azure Synapse Analytics
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
