The Will Will Web

記載著 Will 在網路世界的學習心得與技術分享

解決 Entity Framework 6 無法在交易內進行備份或還原動作的問題

我們都知道 Entity Framework 是一個 ORM 框架,在應用程式中基本上都不太會去碰觸太多關於後端資料庫的特定語法,但針對一些效能調校或資料庫管理等需求時,其實還是能透過 Entity Framework 幫我們執行一些自訂的 T-SQL 語法,只是有些地方需要注意一下,如果你今天遇到無法在 Entity Framework 中執行預存程序或匯入函式時,那麼這篇文章可能對你有幫助。

如果要在 Entity Framework 中執行任意 DDL 命令,可以使用 DbContext 類別下的 Database 屬性來執行任意命令,主要有以下方法可用:

底下有個簡單的例子可以重現本文想強調的問題,以下是透過 ExecuteSqlCommand 執行一段「備份資料庫」的 T-SQL 命令,照理說 Entity Framework 會原封不動的將 T-SQL 送到 SQL Server 執行:

using (var db = new ContosoUniversity2Entities())
{
db.Database.ExecuteSqlCommand("BACKUP DATABASE [ContosoUniversity2] TO DISK = N'G:\\ContosoUniversity2.bak' WITH NOFORMAT, NOINIT, NAME = N'ContosoUniversity2-Full Database Backup', SKIP, NOREWIND, NOUNLOAD");
}

這段程式碼如果跑在 Entity Framework 5 (EF5) 的話,其實是沒有問題的!

不過,如果你的專案用的是 Entity Framework 6 (EF6) 時,此時你就會得到 System.Data.SqlClient.SqlException 的例外錯誤,中英文錯誤訊息如下:

  • Cannot perform a backup or restore operation within a transaction.
  • 無法在交易內進行備份或還原動作。

會得到這句錯誤訊息的原因是,EF6 當透過 預存程序 (Stored Procedure) 或 ExecuteSqlCommand 來執行一些特殊的 DDL 命令時,因為 Entity Framework 6 預設會自動啟用交易處裡,這會導致那些「不能啟用交易時執行的 T-SQL 命令」無法被執行,例如 備份(Backup)、還原(Restore) 或 修改(Alter) 資料庫等工作。

從 Entity Framework 6.1.2 開始,在 db.Configuration 屬性下增加了一個新屬性,叫做:

這個屬性值預設為 true,也就是所有執行 EF 匯入函式或自訂命令時,會自動啟用交易處理。

因此,如果要執行特殊命令時,只要將他修改成 false 就可以順利執行了,範例程式如下:

using (var db = new ContosoUniversity2Entities())
{
db.Configuration.EnsureTransactionsForFunctionsAndCommands = false;
db.Database.ExecuteSqlCommand("BACKUP DATABASE [ContosoUniversity2] TO DISK = N'G:\\ContosoUniversity2.bak' WITH NOFORMAT, NOINIT, NAME = N'ContosoUniversity2-Full Database Backup', SKIP, NOREWIND, NOUNLOAD");
}


最後一點請注意,設定這個 EnsureTransactionsForFunctionsAndCommands 屬性不會影響 SaveChanges() 的任何動作或行為模式。

相關連結