EntityFrame Work 5 性能注意事项(转自MSDN)
1.简介
对象关系映射框架是一种在面向对象的应用程序中提供数据访问抽象的便捷方式。对于 .NET 应用程序,Microsoft 推荐的 O/RM 是实体框架。但任何抽象都要考虑性能。
本白皮书旨在介绍在使用实体框架开发应用程序时的性能注意事项,使开发人员了解能够影响性能的实体框架内部算法,以及提供有关进行调查及在使用实体框架的应用程序中提高性能的提示。网络上有大量很好的有关性能的主题,我们还尽可能地指出这些资源的链接。
性能是一个很微妙的主题。对于使用实体框架的应用程序,可将本白皮书作为资源来帮助做出与性能相关的决策。我们提供了一些测试指标来演示性能,但这些指标不是在应用程序中看到的性能的绝对指标。
出于实用考虑,本文假设实体框架 4 在 .NET 4.0 下运行,实体框架 5 在 .NET 4.5 下运行。对实体框架 5 进行的许多性能改进存在于 .NET 4.5 附带的核心组件中。
2.冷与热查询执行
第一次针对给定模型进行任何查询时,实体框架在后台进行了大量工作来加载和验证模型。我们经常将这个第一次查询称为“冷”查询。针对已加载模型的进一步查询称为“热”查询,速度更快。
我们深入了解一下在使用实体框架执行查询时,时间花在了哪里,看看实体框架 5 在哪些方面进行了改进。
首次查询执行 — 冷查询
第二次查询执行 — 热查询
有几种方式可降低冷、热查询的性能成本,后面几节将探讨这些方式。具体讲,我们将介绍通过使用预生成的视图降低冷查询中模型加载的成本,这应有助于缓解在视图生成过程中遇到的性能问题。对于热查询,将介绍查询计划缓存、无跟踪查询和不同的查询执行选项。
2.1 什么是视图生成?
要了解什么是视图生成,必须先了解什么是“映射视图”。映射视图是每个实体集和关联的映射中指定的转换的可执行表示。在内部,这些映射视图采用 CQT(规范查询树)的形状。映射视图有两种类型:
- 查询视图:表示从数据库架构转到概念架构所需的规范转换。
- 更新视图:表示从概念模型转到数据库架构所需的规范转换。
根据映射规范计算这些视图的过程即是所谓的视图生成。视图生成可在加载模型时动态进行,也可在生成时通过使用“预生成的视图”进行;后者以实体 SQL 语句的形式序列化为 C# 或 VB 文件。
生成视图时还会对它们进行验证。从性能角度看,视图生成的绝大部分成本实际上是视图验证产生的,视图验证可确保实体之间的连接有意义,并且对于所有支持的操作都有正确的基数。
在执行实体集查询时,查询与相应查询视图相组合,这种组合的结果通过计划编译器运行,以便创建后备存储能够理解的查询表示。对于 SQL Server,编译的最终结果是 T-SQL SELECT 语句。首次对实体集执行更新时,更新视图通过类似过程运行,将其转换成用于目标数据库的 DML 语句。
2.2 影响视图生成性能的因素
视图生成步骤的性能不仅取决于模型的大小,还取决于模型的互连方式。如果两个实体通过继承链或关联进行连接,则称它们已连接。同样,如果两个表通过外键进行连接,则它们已连接。随着架构中已连接实体和表数目的增加,视图生成的成本也增加。
在最糟糕的情况下,尽管我们使用一些优化进行改进,用于生成和验证视图的算法仍呈现指数特性。对性能具有最大负面影响的因素有:
- 模型大小,指的是实体的数目以及这些实体之间的关联数量。
- 模型复杂性,具体讲是涉及大量类型的继承。
- 使用独立关联,而不是外键关联。
简单的小模型,成本小到不值得使用预生成的视图。随着模型大小和复杂性的增加,有多种选择可降低视图生成和验证的成本。
2.3 使用预生成的视图缩短模型加载时间
2.3.1 如何在 EDMGen 创建的模型中使用预生成的视图
当利用 EDMGen 生成模型时,输出包含一个 Views 文件。这是一个代码文件,包含针对每个实体集的实体 SQL 代码段。要启用预生成的视图,在项目中包含此文件即可。
如果手动编辑模型的架构文件,需要重新生成视图文件。为此,可带 /mode:ViewGeneration 标志运行 EDMGen。
有关进一步参考,请参见 MSDN 主题“如何:预生成视图以改善查询性能”:http://msdn.microsoft.com/library/bb896240.aspx。
2.3.2 如何使用 EDMX 文件的预生成视图
另外,还可以使用 EDMGen 来生成 EDMX 文件的视图 — 前面提到的 MSDN 主题介绍如何添加预生成事件来执行此操作 — 但这很复杂,并且有时候不适用。当模型位于 edmx 文件中时,使用 T4 模板生成视图通常更加容易。
ADO.NET 团队博客中有一篇文章介绍如何使用 T4 模板进行视图生成 (http://blogs.msdn.com/b/adonet/archive/2008/06/20/how-to-use-a-t4-template-for-view-generation.aspx)。这篇文章包括一个模板,您可以下载和添加到项目中。这个模板是为实体框架的第一个版本编写的。要在 Visual Studio 2010 中使用这个模板,需要在 GetConceptualMappingAndStorageReaders 方法中修改 XML 命名空间,以便使用实体框架 5 的命名空间:
XNamespace edmxns = "http://schemas.microsoft.com/ado/2009/11/edmx";
XNamespace csdlns = "http://schemas.microsoft.com/ado/2009/11/edm";
XNamespace mslns = "http://schemas.microsoft.com/ado/2009/11/mapping/cs";
XNamespace ssdlns = "http://schemas.microsoft.com/ado/2009/11/edm/ssdl";
2.3.3 如何在 Code First 模型中使用预生成的视图
另外,可以在 Code First 项目中使用预生成的视图。实体框架 Power Tools 能够为 Code First 项目生成视图文件。通过在 Visual Studio 库中搜索“实体框架 Power Tools”,可以找到这些增强工具。在编写本文时,预发行版 CTP1 中提供了增强工具。
2.4 降低视图生成的成本
使用预生成的视图可将视图生成成本从模型加载(运行时)转移到编译时。尽管这会改善运行时的启动性能,但在开发时仍会遇到视图生成问题。有几种其他技巧可帮助在编译时和运行时降低视图生成的成本。
2.4.1 使用外键关联降低视图生成成本
将模型中的关联从独立关联转换为外键关联可极大缩短视图生成所用的时间,这种情况很常见。
为演示这种改进,我们使用 EDMGen 生成了 Navision 模型的两个版本。注意:有关 Navision 模型的说明,请参见附录 C。在这个练习中,Navision 模型非常有趣,它有大量实体,实体之间有大量关系。
这种超大模型的一个版本是使用外键关联生成的,另一个是使用独立关联生成的。然后我们对使用 EDMGen 为每个模型生成视图所用的时间进行了计时。对于使用外键的模型,视图生成所用的时间为 104 分钟。不知道生成使用独立关联的模型会用多长时间。我们让这次测试运行了一个多月,然后在实验室中重新启动计算机,以便安装每月更新。
2.4.1.1 如何使用外键,而不是独立关联
当使用 EDMGen 或 Visual Studio 中的 Entity Designer 时,在默认情况下会得到外键,它仅用一个复选框或命令行标志在外键与独立关联之间进行切换。
如果有大型 Code First 模型,使用独立关联对视图生成具有相同影响。可通过在依赖对象的类上包含外键属性来避免这种影响,但有些开发人员认为这会污染他们的对象模型。在 http://blog.oneunicorn.com/2011/12/11/whats-the-deal-with-mapping-foreign-keys-using-the-entity-framework/ 中可获得有关该主题的更多信息。
使用的工具 | 进行的操作 |
实体设计器 | 在两个实体之间添加了关联后,确保具有引用约束。引用约束告诉实体框架使用外键,而不是独立关联。有关更多详细信息,请访问http://blogs.msdn.com/b/efdesign/archive/2009/03/16/foreign-keys-in-the-entity-framework.aspx。 |
EDMGen | 使用 EDMGen 从数据库生成文件时,需要外键,因此外键会添加到模型中。有关 EDMGen 公开的不同选项的更多信息,请访问http://msdn.microsoft.com/library/bb387165.aspx。 |
Code First | 有关在使用 Code First 时如何包含依赖对象的外键属性的信息,请参见 MSDN 中“Code First 约定”主题的“关系约定”部分 (http://msdn.microsoft.com/library/hh161541(v=VS.103).aspx)。 |
2.4.2 将模型移到单独程序集
如果在应用程序的项目中直接包含模型,通过预生成事件或 T4 模板生成视图,则只要重新生成项目,即使没有更改模型,也会进行视图生成和验证。如果将模型移到单独程序集,从应用程序的项目中引用它,则可对应用程序进行其他更改,无需重新生成包含模型的项目。
注意:在将模型移到单独程序集时,记住将模型的连接字符串复制到客户端项目的应用程序配置文件中。
2.4.3 禁用对基于 edmx 的模型的验证
EDMX 模型在编译时进行验证,即使模型未更改也是如此。如果已经验证了模型,则可通过在属性窗口中将“生成时验证”属性设置为 False 来禁用验证。更改映射或模型时,可临时重新启用验证,以验证更改。
2.4.4 将模型标记为只读
如果应用程序仅用于查询方案,则可通过向 XML 映射中的 EntityContainerMapping 元素添加 GenerateUpdateViews 属性,然后将其设置为 False,将模型标记为只读。经验表明,生成更新视图的成本比生成查询视图的成本更高,因此要意识到这一点,避免在不需要时生成更新视图。
3实体框架中的缓存
实体框架有以下内置缓存形式:
- 对象缓存 — 内置在 ObjectContext 实例中的 ObjectStateManager 保持跟踪,以便记住已使用该实例检索的对象。这也称为一级缓存。
- 查询计划缓存 — 在多次执行查询时重用生成的存储命令。
- 元数据缓存 — 在与同一模型的不同连接之间共享模型的元数据。
除实体框架提供的随取即用缓存外,还可使用一种特殊类型的 ADO.NET 数据提供程序(称为包装提供程序)来扩展实体框架,使其能够缓存从数据库中检索的结果,这也称为二级缓存。
3.1 对象缓存
在默认情况下,当查询结果中返回一个实体时,在 EF 刚对它进行具体化前,ObjectContext 将检查是否已经将具有相同键的实体加载到了其 ObjectStateManager 中。如果已经存在具有相同键的实体,则实体框架会将其包含在查询结果中。尽管 EF 仍将发出对数据库的查询,但此行为可避免多次具体化该实体的大部分成本。
3.1.1 使用 DbContext Find 从对象缓存中获得实体
与常规查询不同,DbSet(API 首次包含在 EF 4.1 中)中的 Find 方法将在内存中执行搜索,即使在发出对数据库的查询之前也是如此。注意,两个不同的 ObjectContext 实例将具有两个不同的 ObjectStateManager 实例,这一点非常重要,这意味着它们有单独的对象缓存。
Find 使用主键值尝试查找上下文所跟踪的实体。如果该实体没有在上下文中,则执行和评估对数据库的查询,如果在上下文或数据库中没有发现该实体,则返回 null。注意,Find 还返回已添加到上下文但尚未保存到数据库中的实体。
使用 Find 时,有一项性能注意事项。在默认情况下,对此方法的调用将触发对象缓存的验证,以便检测仍在等待提交到数据库的更改。如果对象缓存中或者要添加到对象缓存的大型对象图中有非常多的对象,则此过程的成本可能会非常高,但也可禁用此过程。在某些情况下,当禁用自动检测更改时,在调用 Find 方法方面可能存在巨大差异。对象实际上位于缓存中与必须从数据库检索对象这两种情况,也存在巨大差异。以下是使用我们的一些微基准进行测量的示例图,单位为毫秒,加载了 5000 个实例:
自动检测更改已禁用的 Find 示例:
context.Configuration.AutoDetectChangesEnabled = false;
var product = context.Products.Find(productId);
...
使用 Find 方法时必须考虑:
- 如果对象没有在缓存中,则 Find 没有优势,但语法仍比按键进行查询简单。
- 如果启用自动检测更改,则根据模型的复杂性以及对象缓存中的实体数量,Find 方法的成本可能会增加一个数量级,甚至更多。
此外,请注意 Find 仅返回要查找的实体,它不会自动加载未在对象缓存中的关联实体。如果需要检索关联实体,可通过预先加载使用按键查询。
3.1.2 当对象缓存具有许多实体时的性能问题
对象缓存有助于提高实体框架的整体响应能力。但当对象缓存中加载了大量实体时,可能影响某些操作,例如添加、删除、SaveChanges 等。尤其是,极大的对象缓存将对触发对 DetectChanges 的调用的操作产生负面影响。DetectChanges 将对象图与对象状态管理器进行同步,其性能将直接取决于对象图的大小。有关 DetectChanges 的更多信息,请参见 http://msdn.microsoft.com/library/dd456848.aspx。
3.2 查询计划缓存
查询首次执行时,通过内部计划编译器将概念查询转换为存储命令(例如当针对 SQL Server 运行时执行的 T-SQL)。如果启用了查询计划缓存,则在下一次执行此查询时,将直接从查询计划缓存中检索存储命令,以便执行,从而绕开计划编译器。
同一 AppDomain 中的 ObjectContext 实例间共享查询计划缓存。要利用查询计划缓存,不一定只使用一个 ObjectContext 实例。
3.2.1 有关查询计划缓存的一些注意事项
- 所有查询类型均共享查询计划缓存:实体 SQL、LINQ 及 CompiledQuery 对象。
- 对于实体 SQL 查询,无论是通过 EntityCommand 还是通过 ObjectQuery 执行,在默认情况下都会启用查询计划缓存。在 EF 5.0 中,默认情况下对 LINQ 查询也会启用。
- 通过将 EnablePlanCaching 属性(在 EntityCommand 或 ObjectQuery 上)设置为 False,可以禁用查询计划缓存。
- 对于参数化查询,更改参数值仍将命中已缓存的查询。但更改参数的方面(例如大小、精确度或数值范围)将命中缓存中的其他实例。
- 当使用实体 SQL 时,查询字符串是键的一部分。完全更改查询将产生不同的缓存条目,即使这些查询具有等同的功能也是如此。这包括对大小写或空格的更改。
- 当使用 LINQ 时,将对查询进行处理,以生成键的一部分。因此更改 LINQ 表达式将生成不同的键。
- 可能存在其他技术限制;有关更多详细信息,请参见自动编译的查询。
3.2.2 缓存逐出算法
了解内部算法的工作方式有助于确定何时启用或禁用查询计划缓存。清除算法如下:
- 在缓存包含设定数目 (800) 的条目后,我们启动定期(每分钟一次)整理缓存的计时器。
- 在缓存整理过程中,将根据 LFRU(最不常使用 - 最近使用)删除缓存中的条目。在确定弹出哪些条目时,此算法同时考虑命中次数和期限。
- 在每次缓存整理结束时,缓存会再次包含 800 个条目。
在确定逐出哪些条目时会公平对待所有缓存条目。这意味着针对 CompiledQuery 的存储命令与针对实体 SQL 查询的存储命令具有相同的逐出几率。
3.2.3 演示查询计划缓存性能的测试指标
为演示查询计划缓存对应用程序性能的影响,我们进行了一项测试,在测试中,我们对 Navision 模型执行了大量实体 SQL 查询。有关 Navision 模型的说明以及执行的查询类型,请参见附录。在该测试中,我们首先循环访问查询列表,对每个查询执行一次,将它们添加到缓存中(如果缓存已启用)。此步骤不计时。下一步,再次循环访问列表,执行缓存的查询。
3.2.3.1 测试结果
测试 | 缓存已启用? | 结果 |
枚举所有 18723 个查询 | 否 | 所用秒数=238.14 |
是 | 所用秒数=240.31 | |
避免整理(无论复杂性如何,仅前 800 个查询) | 否 | 所用秒数=61.62 |
是 | 所用秒数=0.84 | |
仅 AggregatingSubtotals 查询(共 178 个 - 避免整理) | 否 | 所用秒数=63.22 |
是 | 所用秒数=0.41 |
道理 - 当执行许多不同的查询(例如,动态创建的查询)时,缓存没有帮助,并且最终的缓存刷新会使最能受益于计划缓存的查询实际上无法使用它。
AggregatingSubtotals 查询是我们测试的最复杂的查询。像预计的那样,查询越复杂,越能受益于查询计划缓存。
因为 CompiledQuery 实际上是缓存了计划的 LINQ 查询,所以 CompiledQuery 与等同实体 SQL 查询的比较应具有类似结果。实际上,如果应用程序有许多动态实体 SQL 查询,向缓存中填充查询还会在从缓存中刷新查询时使 CompiledQueries 进行“反编译”。在这种情况下,通过禁用动态查询缓存来确定 CompiledQueries 优先级,可以提高性能。当然,最好将应用程序重新编写为使用参数化查询,而不是动态查询。
3.3 使用 CompiledQuery 改善 LINQ 查询的性能
我们的测试表明,比起自动编译的 LINQ 查询,使用 CompiledQuery 可以带来 7% 的益处;这意味着从实体框架堆栈执行代码将节省 7% 的时间;这不意味着应用程序的速度将提高 7%。一般而言,与获得的好处相比,在 EF 5.0 中编写和维护 CompiledQuery 对象的成本是不值当的。实际情况可能各有不同,因此如果项目需要额外推动力,则运用这种方法。
有关创建和调用 CompiledQuery 的更多信息,请参见 MSDN 文档中的“已编译查询 (LINQ to Entities)”主题:http://msdn.microsoft.com/library/bb896297.aspx。
使用 CompiledQuery 时有两个注意事项,即,使用静态实例的要求,以及它们具有的可组合性要求。以下是这两个注意事项的深入说明。
3.3.1 使用静态 CompiledQuery 实例
由于编译 LINQ 查询是一个非常耗时的过程,我们不想每次从数据库中提取数据时都执行此过程。通过 CompiledQuery 实例,可以编译一次后运行多次,但您必须仔细,每次重用相同 CompiledQuery 实例,而不是一遍一遍地编译它。必须使用静态成员存储 CompiledQuery 实例;否则没有任何用处。
例如,假设页面用以下方法主体处理显示所选类别的产品:
// 警告:这是错误使用 CompiledQuery 的方式
using (NorthwindEntities context = new NorthwindEntities())
{
string selectedCategory = this.categoriesList.SelectedValue;
var productsForCategory = CompiledQuery.Compile<NorthwindEntities, string, IQueryable<Product>>(
(NorthwindEntities nwnd, string category) =>
nwnd.Products.Where(p => p.Category.CategoryName == category)
);
this.productsGrid.DataSource = productsForCategory.Invoke(context, selectedCategory).ToList();
this.productsGrid.DataBind();
}
this.productsGrid.Visible = true;
在这种情况下,每次调用此方法时都会实时创建一个新的 CompiledQuery 实例。每次创建新实例时 CompiledQuery 都会经过计划编译器,而不是通过从查询计划缓存中检索存储命令来获得性能优势。实际上,每次调用此方法时,新的 CompiledQuery 条目都会污染查询计划缓存。
您需要创建已编译查询的静态实例,因此每次调用此方法时都在调用相同的已编译查询。为此,一种方法是添加 CompiledQuery 实例作为对象上下文的成员。然后可通过帮助程序方法访问 CompiledQuery,这样更简单一些:
public partial class NorthwindEntities : ObjectContext
{
private static readonly Func<NorthwindEntities, string, IEnumerable<Product>> productsForCategoryCQ = CompiledQuery.Compile(
(NorthwindEntities context, string categoryName) =>
context.Products.Where(p => p.Category.CategoryName == categoryName)
);
public IEnumerable<Product> GetProductsForCategory(string categoryName)
{
return productsForCategoryCQ.Invoke(this, categoryName).ToList();
}
此帮助程序方法将按照以下方式加以调用:
this.productsGrid.DataSource = context.GetProductsForCategory(selectedCategory);
3.3.2 在 CompiledQuery 上编写
在任何 LINQ 查询上进行编写的能力非常有用;为此,只需在 IQueryable 后调用一个方法,例如 Skip() 或 Count()。但这样做实际上会返回一个新的 IQueryable 对象。尽管没有什么能够在技术上阻止您在 CompiledQuery 上进行编写,但这样做会生成需要再次通过计划编译器的新 IQueryable 对象。
某些组件将利用所编写的 IQueryable 对象启用高级功能。例如,可通过 SelectMethod 属性将 ASP.NET 的 GridView 数据绑定到 IQueryable 对象。然后 GridView 将在该 IQueryable 对象上进行撰写,以便允许在数据模型上进行排序和分页。可以看到,将 CompiledQuery 用于 GridView 不会命中已编译查询,但会生成新的自动编译查询。
客户顾问团队在他们的“已编译 LINQ 查询重新编译的潜在性能问题”博客文章中探讨了这一方面:http://blogs.msdn.com/b/appfabriccat/archive/2010/08/06/potential-performance-issues-with-compiled-linq-query-re-compiles.aspx。
在将渐进式筛选器添加到查询中时可能会遇到此问题。例如,假设客户页面有针对可选筛选器(例如 Country 和 OrdersCount)的多个下拉列表。可针对 CompiledQuery 的 IQueryable 结果编写这些筛选器,但这样会导致每次执行新查询时,新查询都会经过计划编译器。
using (NorthwindEntities context = new NorthwindEntities())
{
IQueryable<Customer> myCustomers = context.InvokeCustomersForEmployee();
if (this.orderCountFilterList.SelectedItem.Value != defaultFilterText)
{
int orderCount = int.Parse(orderCountFilterList.SelectedValue);
myCustomers = myCustomers.Where(c => c.Orders.Count > orderCount);
}
if (this.countryFilterList.SelectedItem.Value != defaultFilterText)
{
myCustomers = myCustomers.Where(c => c.Address.Country == countryFilterList.SelectedValue);
}
this.customersGrid.DataSource = myCustomers;
this.customersGrid.DataBind();
}
为避免这种重复编译,可重写 CompiledQuery,以便考虑可能的筛选器:
private static readonly Func<NorthwindEntities, int, int?, string, IQueryable<Customer>> customersForEmployeeWithFiltersCQ = CompiledQuery.Compile(
(NorthwindEntities context, int empId, int? countFilter, string countryFilter) =>
context.Customers.Where(c => c.Orders.Any(o => o.EmployeeID == empId))
.Where(c => countFilter.HasValue == false || c.Orders.Count > countFilter)
.Where(c => countryFilter == null || c.Address.Country == countryFilter)
);
这将在 UI 中调用,例如:
using (NorthwindEntities context = new NorthwindEntities())
{
int? countFilter = (this.orderCountFilterList.SelectedIndex == 0) ?
(int?)null :
int.Parse(this.orderCountFilterList.SelectedValue);
string countryFilter = (this.countryFilterList.SelectedIndex == 0) ?
null :
this.countryFilterList.SelectedValue;
IQueryable<Customer> myCustomers = context.InvokeCustomersForEmployeeWithFilters(
countFilter, countryFilter);
this.customersGrid.DataSource = myCustomers;
this.customersGrid.DataBind();
}
此处需要权衡的是,生成的存储命令将始终具有带 null 检查的筛选器,但这些应可使数据库服务器比较简单地进行优化:
...
WHERE ((0 = (CASE WHEN (@p__linq__1 IS NOT NULL) THEN cast(1 as bit) WHEN (@p__linq__1 IS NULL) THEN cast(0 as bit) END)) OR ([Project3].[C2] > @p__linq__2)) AND (@p__linq__3 IS NULL OR [Project3].[Country] = @p__linq__4)
3.4 元数据缓存
实体框架还支持元数据缓存。这实质上是与同一模型的不同连接之间的类型信息以及类型到数据库映射信息的缓存。元数据缓存每 AppDomain 都是唯一的。
3.4.1 元数据缓存算法
- 模型的元数据信息存储在每个 EntityConnection 的 ItemCollection 中。
- 顺便说一下,模型的不同部分有不同的 ItemCollection 对象,例如 StoreItemCollections 包含有关数据库模型的信息;ObjectItemCollection 包含有关数据模型的信息;EdmItemCollection 包含有关概念模型的信息。
- 如果两个连接使用同一连接字符串,则它们将共享同一 ItemCollection 实例。
- 功能等同但文本不同的连接字符串可产生不同的元数据缓存。我们标记了连接字符串,因此仅更改这些标记的顺序应产生共享元数据。但是,标记之后看起来功能相同的两个连接字符串不能评估为同一连接字符串。
- 定期检查 ItemCollection 是否可用。如果确定最近尚未访问工作区,则将对其进行标记,以便在下一次缓存整理时进行清除。
- 仅创建 EntityConnection 会导致创建元数据缓存(尽管直到打开连接才会初始化其中的项集合)。此工作区将保持在内存中,直到缓存算法确定它未“在使用”为止。
客户顾问团队写了一篇博客文章,介绍如何保留对 ItemCollection 的引用,以便在使用大模型时避免“不推荐使用的情况”:http://blogs.msdn.com/b/appfabriccat/archive/2010/10/22/metadataworkspace-reference-in-wcf-services.aspx。
3.4.2 元数据缓存与查询计划缓存之间的关系
查询计划缓存实例存在于 MetadataWorkspace 的存储类型 ItemCollection 中。这意味着缓存的存储命令将用于对参照给定 MetadataWorkspace 进行了实例化的任何 ObjectContext 的查询。这还意味着,如果有两个略微不同且在标记之后不匹配的连接字符串,将有不同的查询计划缓存实例。
3.5 结果缓存
凭借结果缓存(也称为“二级缓存”),可将查询结果保留在本地缓存中。在发布查询时,首先查看在对存储进行查询前是否可本地获得这些结果。尽管实体框架不直接支持结果缓存,但可通过使用包装提供程序添加二级缓存。CodePlex 上提供了具有二级缓存的包装提供程序示例:http://code.msdn.microsoft.com/EFProviderWrappers-c0b88f32/view/Discussions/2。
3.5.1 包装提供程序结果缓存的其他参考
- Julie Lerman 写过一篇题为“实体框架和 Windows Azure 中的二级缓存”的 MSDN 文章,说明如何更新示例包装提供程序,以使用 Windows Server AppFabric 缓存:http://msdn.microsoft.com/magazine/hh394143.aspx
- 实体框架团队博客中有一篇文章,介绍如何通过缓存提供程序实现运行:http://blogs.msdn.com/b/adonet/archive/2010/09/13/ef-caching-with-jarek-kowalski-s-provider.aspx。这篇文章还包含一个 T4 模板,可用于自动将二级缓存添加到项目中。
4 自动编译的查询
当使用实体框架发出数据库查询时,在实际具体化结果之前必须经历一系列步骤;其中一个步骤是查询编译。已知实体 SQL 查询具有很好的性能,因为它们是自动缓存的,因此在第二次或第三次执行同一查询时,可跳过计划编译器,而使用缓存的计划。
实体框架 5 还引入了对 LINQ to Entities 的自动缓存。在实体框架的过去版本中,通过创建 CompiledQuery 来提高性能是一种常见做法,因为这会使 LINQ to Entities 查询可缓存。由于现在缓存是自动进行的,无需使用 CompiledQuery,因此我们将该功能称为“自动编译的查询”。有关查询计划缓存及其机制的更多信息,请参见查询计划缓存。
实体框架检测查询何时需要重新编译,在调用查询时,即使之前已对其进行了编译,也会对其进行重新编译。导致重新编译查询的常见条件是:
- 更改与查询关联的 MergeOption。将不使用缓存的查询,而是再次运行计划编译器,并且缓存新创建的计划。
- 更改 ContextOptions.UseCSharpNullComparisonBehavior 的值。这会获得与更改 MergeOption 相同的效果。
其他条件可能阻碍查询使用缓存。常见示例为:
- 使用 IEnumerable<T>.Contains<>(T value)
- 将查询与需要重新编译的另一个查询链接起来。
4.1 使用 IEnumerable<T>.Contains<T>(T value)
实体框架不缓存调用 IEnumerable<T>.Contains<T>(T value) 的对内存中集合的查询,因为该集合的值不稳定。以下示例查询不缓存,因此将始终由计划编译器加以处理:
int[] ids = new int[10000];
...
using (var context = new MyContext())
{
var query = context.MyEntities
.Where(entity => ids.Contains(entity.Id));
var results = query.ToList();
...
}
此外请注意,执行 Contains 所针对的 IEnumerable 的大小确定已编译查询的速度快慢。当使用上例所示的大型集合时,性能会极大下降。
4.2 链接到需要重新编译的查询
按照上述同一示例,如果有第二个查询依赖需要重新编译的查询,则整个第二个查询也将重新编译。以下示例说明了这种情况:
int[] ids = new int[10000];
...
using (var context = new MyContext())
{
var firstQuery = from entity in context.MyEntities
where ids.Contains(entity.Id)
select entity;
var secondQuery = from entity in context.MyEntities
where firstQuery.Any(otherEntity => otherEntity.Id == entity.Id)
select entity;
string results = secondQuery.ToList();
...
}
这是个一般示例,但说明了链接到 firstQuery 如何导致 secondQuery 无法缓存。如果 firstQuery 不是需要重新编译的查询,则会缓存 secondQuery。
5 NoTracking 查询
5.1 禁用更改跟踪,以降低状态管理开销
如果在只读情况中,想要避免将对象加载到 ObjectStateManager 中的开销,则可发出“无跟踪”查询。可在查询层面上禁用更改跟踪。
注意,尽管如此,禁用更改跟踪将有效关闭对象缓存。当查询实体时,我们无法通过从 ObjectStateManager 中拉出先前具体化的查询结果来跳过具体化。如果要在相同上下文中重复查询同一实体,启用更改跟踪实际上可提高性能。
当使用 ObjectContext 进行查询时,ObjectQuery 和 ObjectSet 实例将在 MergeOption 设置后记住它,并且在它们上编写的查询将继承父查询的有效 MergeOption。当使用 DbContext 时,可通过对 DbSet 调用 AsNoTracking() 修饰符禁用跟踪。
5.1.1 在使用 DbContext 时禁用对查询的更改跟踪
通过在查询中链接对 AsNoTracking() 方法的调用,可将查询模式切换到 NoTracking。与 ObjectQuery 不同,DbContext API 中的 DbSet 和 DbQuery 类没有针对 MergeOption 的可变属性。
var productsForCategory = from p in context.Products.AsNoTracking()
where p.Category.CategoryName == selectedCategory
select p;
5.1.2 使用 ObjectContext 在查询层面上禁用更改跟踪
var productsForCategory = from p in context.Products
where p.Category.CategoryName == selectedCategory
select p;
((ObjectQuery)productsForCategory).MergeOption = MergeOption.NoTracking;
5.1.3 使用 ObjectContext 禁用对整个实体集的更改跟踪
context.Products.MergeOption = MergeOption.NoTracking;
var productsForCategory = from p in context.Products
where p.Category.CategoryName == selectedCategory
select p;
5.2 演示 NoTracking 查询的性能优势的测试指标
在这个测试中,通过比较针对 Navision 模型的跟踪和无跟踪查询,我们探讨填充 ObjectStateManager 的成本。有关 Navision 模型的说明以及执行的查询类型,请参见附录。在这个测试中,我们循环访问查询列表,对每个查询执行一次。我们进行了两种不同的测试,一次使用 NoTracking 查询,一次使用“AppendOnly”的默认合并选项。每种测试都进行 3 遍,取测试结果的平均值。在这些测试之间,我们清除了 SQL Server 上的查询缓存,并且通过运行以下命令缩小了 tempdb:
- DBCC DROPCLEANBUFFERS
- DBCC FREEPROCCACHE
- DBCC SHRINKDATABASE (tempdb, 0)
测试结果:
测试类型 | 平均结果(3 次) |
NoTracking 查询 | 所用秒数=315.63,工作集=588997973 |
AppendOnly 查询 | 所用秒数=335.43,工作集=629760000 |
在这些测试中,填充 ObjectStateManager 所用时间多出 6%,所占内存多出 6%。
6 查询执行选项
实体框架提供了几种不同查询方式。下面介绍以下选项,比较每个选项的优缺点,研究它们的性能特点:
- LINQ to Entities。
- 无跟踪 LINQ to Entities。
- ObjectQuery 上的实体 SQL。
- EntityCommand 上的实体 SQL。
- ExecuteStoreQuery。
- SqlQuery。
- CompiledQuery。
6.1 LINQ to Entities 查询
var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
优点
- 适用于 CUD 操作。
- 完全具体化的对象。
- 以编程语言内置语法编写最为简单。
- 良好的性能。
Cons
- 某些技术限制,例如:
- 将 DefaultIfEmpty 用于 OUTER JOIN 查询的模式导致查询比实体 SQL 中的简单 OUTER JOIN 语句更加复杂。
- 在一般模式匹配中仍无法使用 LIKE。
6.2 无跟踪 LINQ to Entities 查询
context.Products.MergeOption = MergeOption.NoTracking;
var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
优点
- 性能比常规 LINQ 查询更高。
- 完全具体化的对象。
- 以编程语言内置语法编写最为简单。
Cons
- 不适用于 CUD 操作。
- 某些技术限制,例如:
- 将 DefaultIfEmpty 用于 OUTER JOIN 查询的模式导致查询比实体 SQL 中的简单 OUTER JOIN 语句更加复杂。
- 在一般模式匹配中仍无法使用 LIKE。
6.3 ObjectQuery 上的实体 SQL
ObjectQuery<Product> products = context.Products.Where("it.Category.CategoryName = 'Beverages'");
优点
- 适用于 CUD 操作。
- 完全具体化的对象。
- 支持查询计划缓存。
Cons
- 涉及文本查询字符串,与内置在语言中的查询构造相比,这些字符串更容易出现用户错误。
6.4 Entity Command 上的实体 SQL
EntityCommand cmd = eConn.CreateCommand();
cmd.CommandText = "Select p From NorthwindEntities.Products As p Where p.Category.CategoryName = 'Beverages'";
using (EntityDataReader reader = cmd.ExecuteReader(CommandBehavior.SequentialAccess))
{
while (reader.Read())
{
// 手动“具体化”产品
}
}
优点
- 支持查询计划缓存。
Cons
- 涉及文本查询字符串,与内置在语言中的查询构造相比,这些字符串更容易出现用户错误。
- 不适用于 CUD 操作。
- 结果不自动进行具体化,并且必须从数据读取器中读取。
6.5 SqlQuery 和 ExecuteStoreQuery
数据库上的 SqlQuery:
// 使用它获得实体,而不是跟踪实体
var q1 = context.Database.SqlQuery<Product>("select * from products");
DbSet 上的 SqlQuery:
// 使用它来获得实体,而不是跟踪实体
var q2 = context.Products.SqlQuery("select * from products");
ExecyteStoreQuery:
ObjectResult<Product> beverages = context.ExecuteStoreQuery<Product>(
@" SELECT P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued, P.DiscontinuedDate
FROM Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
WHERE (C.CategoryName = 'Beverages')"
);
优点
- 通常性能最快,因为绕开了计划编译器。
- 完全具体化的对象。
- 在从 DbSet 使用时适用于 CUD 操作。
Cons
- 查询为文本,容易出错。
- 通过使用存储语义,而不是概念语义,将查询绑定到了特定后端。
- 当存在继承时,手工查询需要说明所请求类型的映射条件。
6.6 CompiledQuery
private static readonly Func<NorthwindEntities, string, IQueryable<Product>> productsForCategoryCQ = CompiledQuery.Compile(
(NorthwindEntities context, string categoryName) =>
context.Products.Where(p => p.Category.CategoryName == categoryName)
);
…
var q = context.InvokeProductsForCategoryCQ("Beverages");
优点
- 性能最多比常规 LINQ 查询高 7%。
- 完全具体化的对象。
- 适用于 CUD 操作。
Cons
- 更高的复杂性和编程开销。
- 如果编写在已编译查询顶部,不会提高性能。
- 某些 LINQ 查询无法编写为 CompiledQuery,例如,匿名类型的投影。
6.7 不同查询选项的性能比较
为比较不同查询选项的性能,我们创建了 5 个单独的测试类型,我们使用不同的查询选项来选择类别名称为“Beverages”的所有产品。每个迭代均包含创建上下文的成本,以及对所有返回的实体进行具体化的成本。先不计时运行 10 次迭代,然后计算 1000 次计时迭代的总和。所示结果是从每个测试的 5 次运行中获得的中值运行。有关更多信息,请参见附录 B,其中包含该测试的代码。
注意:为求完整,我们包含了在 EntityCommand 上执行实体 SQL 查询的测试类型。但由于没有为这些查询具体化结果,因此不必进行同类比较。该测试包含非常接近的具体化近似值,以便尽量做出更公平的比较。
在测试中还使用了简单的微基准,没有对上下文创建进行计时。我们在受控环境中测量了对一组非缓存实体进行的 5000 次查询。这些数字将加以采用,同时警告:它们不反映应用程序生成的实际数字,但却是非常准确的测量值,它们体现了在对不同查询选项进行同类比较时存在多少性能差异。考虑到实际情况,足够接近的数字可视为相等,始终以毫秒为单位:
7 设计时间性能注意事项
7.1 继承策略
在使用实体框架时的另一个性能注意事项是所使用的继承策略。实体框架支持 3 个基本类型的继承及其组合:
- 每个层次结构一张表 (TPH) — 每个继承集均映射到具有鉴别器列的表,以指示行中要表示层次结构中的特定类型。
- 每个类型一张表 (TPT) — 每个类型在数据库中都有自己的表;子表仅定义父表未包含的列。
- 每个类一张表 (TPC) — 每个类型在数据库中都有自己的完整表;子表定义它们的所有字段,包括父类型中定义的字段。
如果模型使用 TPT 继承,则生成的查询将比使用其他继承策略生成的查询更加复杂,这可能导致对存储的执行时间更长。在 TPT 模型上生成查询并具体化最终对象一般需要更长的时间。
请参见“在实体框架中使用 TPT(每个类型一张表)继承时的性能注意事项”MSDN 博客文章:http://blogs.msdn.com/b/adonet/archive/2010/08/17/performance-considerations-when-using-tpt-table-per-type-inheritance-in-the-entity-framework.aspx。
7.1.1 在 Model First 或 Code First 应用程序中避免使用 TPT
当在具有 TPT 架构的现有数据库上创建模型时,没有许多选择。但当使用 Model First 或 Code First 创建应用程序时,由于性能问题,应避免使用 TPT 继承。
当在 Entity Designer 向导中使用 Model First 时,将获得针对模型中任何继承的 TPT。如果要转换到采用 Model First 的 TPH 继承策略,可使用 Visual Studio 库提供的“Entity Designer Database Generation Power Pack”(http://visualstudiogallery.msdn.microsoft.com/df3541c3-d833-4b65-b942-989e7ec74c87/ )。
当使用 Code First 配置具有继承的模型的映射时,在默认情况下实体框架将使用 TPH,即,继承层次结构中的所有实体都映射到同一表。有关更多详细信息,请参见 MSDN 杂志文章“ADO.NET 实体框架 4.1 中的 Code First”的“使用 Fluent API 进行映射”一节 (http://msdn.microsoft.com/magazine/hh126815.aspx )。
7.2 升级到 EF 5 以缩短模型生成时间
EF 5 中实现了对生成模型存储层 (SSDL) 的算法的 SQL Server 特定改进,在安装 Dev10 SP1 时,此改进作为对 EF 4 的更新。以下测试结果演示在生成超大模型(在本例中是 Navision 模型)时的改进。有关更多详细信息,请参见附录 C。
配置 | 持续时间 | 模型生成各阶段的百分比细分 |
Visual Studio 2010。 具有 1005 个实体集和 4227 个关联集的模型。 |
所用秒数=16835.08 (4:40:35) |
SSDL 生成:2 小时 27 分钟 映射生成:<1 分钟 CSDL 生成:<1 分钟 ObjectLayer 生成:<1 分钟 视图生成:2 小时 14 分钟 |
Visual Studio 2010 SP1。 具有 1005 个实体集和 4227 个关联集的模型。 |
所用秒数=6813.18 (1:53:33) |
SSDL 生成:<1 分钟 映射生成:<1 分钟 CSDL 生成:<1 分钟 ObjectLayer 生成:<1 分钟 视图生成:1 小时 53 分钟 |
值得注意的是,当生成 SSDL 时,加载时间几乎完全用在 SQL Server 上,而客户端开发计算机正在空闲地等待从服务器返回结果。这一改进对 DBA 尤其有用。还值得注意的是,实质上模型生成的全部成本现在是在视图生成中产生的。
7.3 利用 Database First 和 Model First 拆分大模型
随着模型大小的增加,设计器图面变得杂乱且难以使用。一般认为具有超过 300 个实体的模型太大,难以有效使用设计器。我们的一位开发组长 Srikanth Mandadi 写了以下博客文章,介绍拆分大模型的几种选择:http://blogs.msdn.com/b/adonet/archive/2008/11/25/working-with-large-models-in-entity-framework-part-2.aspx。
这篇文章是为实体框架的第一个版本所写的,但这些步骤仍适用。
7.4 使用 Entity Data Source 控件时的性能注意事项
我们已看到了多线程性能和压力测试中的用例情况,在这些情况下,使用 EntityDataSource 控件的 Web 应用程序的性能大幅下降。其根本原因是 EntityDataSource 反复调用 Web 应用程序所引用的程序集上的 MetadataWorkspace.LoadFromAssembly,以便发现将用作实体的类型。
解决方案是将 EntityDataSource 的 ContextTypeName 设置为派生 ObjectContext 类的类型名称。这会关闭扫描所有引用的程序集以查找是否有实体类型的机制。
设置 ContextTypeName 字段还会防止以下功能问题:当 .NET 4.0 中的 EntityDataSource 无法通过反射从程序集中加载类型时,它会引发 ReflectionTypeLoadException。该问题在 .NET 4.5 中已得到修复。
7.5 POCO 实体与更改跟踪代理
通过实体框架可将自定义数据类与数据模型一同使用,无需对数据类本身进行任何修改。这意味着可以将“纯旧式”CLR 对象 (POCO)(例如,现有的域对象)与数据模型一起使用。这些 POCO 数据类(也称为缺少持续性的对象,映射到在数据模型中定义的实体)支持与实体数据模型工具生成的实体类型相同的大部分查询、插入、更新和删除行为。
实体框架还能够创建从 POCO 类型派生的代理类,如果需要对 POCO 实体启用延迟加载和自动更改跟踪等功能,可以使用这些类。POCO 类必须符合某些要求才可使实体框架使用代理,如这篇文章所述:http://msdn.microsoft.com/library/dd468057.aspx。
每次实体的任何属性值更改时,更改跟踪代理都将通知对象状态管理器,因此实体框架始终知道这些实体的实际状态。这是通过以下方式实现的:将通知事件添加到属性 setter 方法的主体中,让对象状态管理器处理这些事件。注意,实体框架创建了更多事件集,因此创建代理实体一般比创建非代理 POCO 实体成本更高。
当 POCO 实体没有更改跟踪代理时,通过将实体的内容与先前保存的状态的副本进行比较来查找更改。如果上下文中有许多实体,或者实体有大量属性,这种深入比较将变成一个冗长的过程,即使自上次比较以来它们均没有更改也是如此。
总结:在创建更改跟踪代理时性能会下降,但如果实体有许多属性,或者模型中有许多实体,更改跟踪将有助于加快更改检测过程。对于实体数量没有过多增长、有少量属性的实体,更改跟踪代理的优势可能不明显。
8 加载相关实体
8.1 延迟加载与预先加载
实体框架提供了多种不同方式来加载与目标实体相关的实体。例如,当查询产品时,可通过不同方式将相关订单加载到对象状态管理器中。从性能观点来讲,在加载相关实体时要考虑的最大问题将是使用延迟加载还是预先加载。
当使用预先加载时,相关实体连同目标实体集一同加载。在查询中使用 Include 语句来指示要获取哪些相关实体。
当使用延迟加载时,初始查询仅获取目标实体集。但只要访问导航属性,便会发出对存储的另一个查询,以加载相关实体。
已加载了实体后,对该实体的任何进一步查询都会从对象状态管理器直接加载它,无论正在使用延迟加载还是预先加载。
8.2 如果在延迟加载和预先加载之间做出选择
重要的是了解延迟加载与预先加载之间的区别,这样才能做出适合您应用程序的正确选择。这将有助于您对照数据库评估多个请求之间的权衡,而不是评估可能包含较大负载的单个请求。在应用程序的某些部分中使用预先加载而在其他部分中使用延迟加载可能是适当的做法。
举一个有关在后台发生的情况的例子,假设您想要查询住在英国的客户以及他们的订单数。
使用预先加载
using (NorthwindEntities context = new NorthwindEntities())
{
var ukCustomers = context.Customers.Include(c => c.Orders).Where(c => c.Address.Country == "UK");
var chosenCustomer = AskUserToPickCustomer(ukCustomers);
Console.WriteLine("Customer Id: {0} has {1} orders", customer.CustomerID, customer.Orders.Count);
}
使用延迟加载
using (NorthwindEntities context = new NorthwindEntities())
{
context.ContextOptions.LazyLoadingEnabled = true;
//注意在该查询中,Include 方法调用正在丢失
var ukCustomers = context.Customers.Where(c => c.Address.Country == "UK");
var chosenCustomer = AskUserToPickCustomer(ukCustomers);
Console.WriteLine("Customer Id: {0} has {1} orders", customer.CustomerID, customer.Orders.Count);
}
当使用预先加载时,将发出一个返回所有客户和所有订单的查询。存储命令看起来像:
[Project1].[C1] AS [C1],
[Project1].[CustomerID] AS [CustomerID],
[Project1].[CompanyName] AS [CompanyName],
[Project1].[ContactName] AS [ContactName],
[Project1].[ContactTitle] AS [ContactTitle],
[Project1].[Address] AS [Address],
[Project1].[City] AS [City],
[Project1].[Region] AS [Region],
[Project1].[PostalCode] AS [PostalCode],
[Project1].[Country] AS [Country],
[Project1].[Phone] AS [Phone],
[Project1].[Fax] AS [Fax],
[Project1].[C2] AS [C2],
[Project1].[OrderID] AS [OrderID],
[Project1].[CustomerID1] AS [CustomerID1],
[Project1].[EmployeeID] AS [EmployeeID],
[Project1].[OrderDate] AS [OrderDate],
[Project1].[RequiredDate] AS [RequiredDate],
[Project1].[ShippedDate] AS [ShippedDate],
[Project1].[ShipVia] AS [ShipVia],
[Project1].[Freight] AS [Freight],
[Project1].[ShipName] AS [ShipName],
[Project1].[ShipAddress] AS [ShipAddress],
[Project1].[ShipCity] AS [ShipCity],
[Project1].[ShipRegion] AS [ShipRegion],
[Project1].[ShipPostalCode] AS [ShipPostalCode],
[Project1].[ShipCountry] AS [ShipCountry]
FROM ( SELECT
[Extent1].[CustomerID] AS [CustomerID],
[Extent1].[CompanyName] AS [CompanyName],
[Extent1].[ContactName] AS [ContactName],
[Extent1].[ContactTitle] AS [ContactTitle],
[Extent1].[Address] AS [Address],
[Extent1].[City] AS [City],
[Extent1].[Region] AS [Region],
[Extent1].[PostalCode] AS [PostalCode],
[Extent1].[Country] AS [Country],
[Extent1].[Phone] AS [Phone],
[Extent1].[Fax] AS [Fax],
1 AS [C1],
[Extent2].[OrderID] AS [OrderID],
[Extent2].[CustomerID] AS [CustomerID1],
[Extent2].[EmployeeID] AS [EmployeeID],
[Extent2].[OrderDate] AS [OrderDate],
[Extent2].[RequiredDate] AS [RequiredDate],
[Extent2].[ShippedDate] AS [ShippedDate],
[Extent2].[ShipVia] AS [ShipVia],
[Extent2].[Freight] AS [Freight],
[Extent2].[ShipName] AS [ShipName],
[Extent2].[ShipAddress] AS [ShipAddress],
[Extent2].[ShipCity] AS [ShipCity],
[Extent2].[ShipRegion] AS [ShipRegion],
[Extent2].[ShipPostalCode] AS [ShipPostalCode],
[Extent2].[ShipCountry] AS [ShipCountry],
CASE WHEN ([Extent2].[OrderID] IS NULL) THEN CAST(NULL AS int) ELSE 1 END AS [C2]
FROM [dbo].[Customers] AS [Extent1]
LEFT OUTER JOIN [dbo].[Orders] AS [Extent2] ON [Extent1].[CustomerID] = [Extent2].[CustomerID]
WHERE N'UK' = [Extent1].[Country]
) AS [Project1]
ORDER BY [Project1].[CustomerID] ASC, [Project1].[C2] ASC
当使用延迟加载时,最初将发出以下查询:
SELECT
[Extent1].[CustomerID] AS [CustomerID],
[Extent1].[CompanyName] AS [CompanyName],
[Extent1].[ContactName] AS [ContactName],
[Extent1].[ContactTitle] AS [ContactTitle],
[Extent1].[Address] AS [Address],
[Extent1].[City] AS [City],
[Extent1].[Region] AS [Region],
[Extent1].[PostalCode] AS [PostalCode],
[Extent1].[Country] AS [Country],
[Extent1].[Phone] AS [Phone],
[Extent1].[Fax] AS [Fax]
FROM [dbo].[Customers] AS [Extent1]
WHERE N'UK' = [Extent1].[Country]
每次访问客户的订单导航属性时,便会对存储发出另一个查询,如下:
exec sp_executesql N'SELECT
[Extent1].[OrderID] AS [OrderID],
[Extent1].[CustomerID] AS [CustomerID],
[Extent1].[EmployeeID] AS [EmployeeID],
[Extent1].[OrderDate] AS [OrderDate],
[Extent1].[RequiredDate] AS [RequiredDate],
[Extent1].[ShippedDate] AS [ShippedDate],
[Extent1].[ShipVia] AS [ShipVia],
[Extent1].[Freight] AS [Freight],
[Extent1].[ShipName] AS [ShipName],
[Extent1].[ShipAddress] AS [ShipAddress],
[Extent1].[ShipCity] AS [ShipCity],
[Extent1].[ShipRegion] AS [ShipRegion],
[Extent1].[ShipPostalCode] AS [ShipPostalCode],
[Extent1].[ShipCountry] AS [ShipCountry]
FROM [dbo].[Orders] AS [Extent1]
WHERE [Extent1].[CustomerID] = @EntityKeyValue1',N'@EntityKeyValue1 nchar(5)',@EntityKeyValue1=N'AROUT'
有关更多信息,请参见“加载相关对象”MSDN 文章:http://msdn.microsoft.com/library/bb896272.aspx。
8.2.1 延迟加载与预先加载备忘单
选择预先加载与延迟加载没有一刀切的方法。首先尽量了解这两个策略之间的区别,这样才能做出明智决定;此外考虑代码是否适合下列任何一种情况:
情况 | 建议 | |
是否需要从提取的实体中访问许多导航属性? | 否 | 这两个选择可能都行。但如果查询所产生的负载不太大,则通过使用预先加载可能会提高性能,因为这需要较少的网络往返即可具体化对象。 |
是 | 如果需要从实体访问许多导航属性,最好在采用预先加载的查询中使用多个 include 语句。包含的实体越多,查询将返回的负载就越大。如果查询包含三个或更多实体,考虑转为延迟加载。 | |
是否确切知道在运行时将需要什么数据? | 否 | 更适合采用延迟加载。否则,可能结果是查询不需要的数据。 |
是 | 可能最适合采用预先加载;这有助于更快速地加载整个集。如果查询需要提取大量数据,而速度非常慢,则尝试延迟加载。 | |
代码是否要在远离数据库的位置执行?(更长的网络延迟) | 否 | 当网络延迟不是问题时,使用延迟加载可能会简化代码。请注意,应用程序的拓扑结构可能改变,因此不要认为数据库邻近是理所当然的。 |
是 | 当网络是要考虑的问题时,只有您才能确定适合采用哪种方式。一般预先加载会更好,因为需要的往返次数更少。 |
8.2.2 在使用多个 Include 时的性能问题
当我们听说涉及服务器响应时间问题的性能问题时,根源通常是使用多个 Include 语句的查询。尽管在查询中包含相关实体可实现强大功能,还是应该了解实际情况。
包含多个 Include 语句的查询需要相对较长的时间通过内部计划编译器,才能生成存储命令。这些时间中的大部分用于尝试优化最终查询。根据映射,生成的存储命令将包含针对每个 Include 的 Outer Join 或 Union。这类查询将在单个负载中从数据库获取大量已连接的图形,从而恶化所有带宽问题,在负载存在大量冗余时(即,具有能够在一到多方向中遍历关联的多个 Include 级别),更是如此。
通过以下方式可以查看查询是否存在要返回超大量负载的情况:使用 ToTraceString 访问针对查询的基本 TSQL,在 SQL Server Management Studio 中执行存储命令,查看负载的大小。在这种情况下,可尝试减少查询中的 Include 语句数,仅获取所需的数据。也可将查询分成多个更小的子查询序列,例如:
在拆分查询前:
using (NorthwindEntities context = new NorthwindEntities())
{
var customers = from c in context.Customers.Include(c => c.Orders)
where c.LastName.StartsWith(lastNameParameter)
select c;
foreach (Customer customer in customers)
{
...
}
}
在拆分查询后:
using (NorthwindEntities context = new NorthwindEntities())
{
var orders = from o in context.Orders
where o.Customer.LastName.StartsWith(lastNameParameter)
select o;
orders.Load();
var customers = from c in context.Customers
where c.LastName.StartsWith(lastNameParameter)
select c;
foreach (Customer customer in customers)
{
...
}
}
这仅对跟踪查询有效,因为我们要利用上下文的功能自动执行标识解析和关联修复。
至于延迟加载,权衡结果将是用更多查询实现较小负载。还可使用各属性的投影显式地从每个实体中仅选择所需的数据,但是,在这种情况下不会加载实体,也不支持更新。
8.2.3 属性的延迟加载
实体框架当前不支持标量或复杂属性的延迟加载。但是,如果表中包含 BLOB 等大型对象,可以使用表拆分功能将大属性分成单独实体。例如,假设有一个 Product 表,它包含一个变长二进制图片列。如果不需要经常访问查询中的这个属性,则可使用表拆分功能仅获取通常需要的实体部分。如果明确需要表示产品图片的实体时,仅加载该实体。
要说明如何启用表拆分功能,一个很好的资源是 Gil Fink 的博客文章“实体框架中的表拆分”:http://blogs.microsoft.co.il/blogs/gilf/archive/2009/10/13/table-splitting-in-entity-framework.aspx。
9 调查性能
9.1 使用 Visual Studio 探查器
如果遇到实体框架的性能问题,可使用探查器(如 Visual Studio 内置探查器)查看应用程序将时间用在了哪里。我们使用这个工具生成了博客文章“探究 ADO.NET 实体框架的性能 - 第 1 部分”(http://blogs.msdn.com/b/adonet/archive/2008/02/04/exploring-the-performance-of-the-ado-net-entity-framework-part-1.aspx) 中的饼图,说明在冷查询和热查询过程中实体框架将时间用在了哪里。
数据与建模客户顾问团队的博客文章“使用 Visual Studio 2010 探查器分析实体框架”提供了一个真实示例,说明他们如何使用这个探查器调查性能问题。http://blogs.msdn.com/b/dmcat/archive/2010/04/30/profiling-entity-framework-using-the-visual-studio-2010-profiler.aspx。这篇文章是针对 Windows 应用程序编写的。如果需要分析 Web 应用程序,则 VSPerfCmd 工具可能比使用 Visual Studio 更有效。
9.2 应用程序/数据库分析
通过工具(如 Visual Studio 内置探查器)可以发现应用程序将时间用在哪里。另外还有一种探查器,可根据需要在生产或预生产中动态分析正在运行的应用程序,以及查找数据库访问的常见缺陷和反模式。
实体框架 Profiler (http://efprof.com) 和 ORMProfiler (http://ormprofiler.com) 是两个商用探查器。
如果应用程序是使用 Code First 的 MVC 应用程序,则可使用 StackExchange 的 MiniProfiler。Scott Hanselman 在他的博客中介绍了这个工具:http://www.hanselman.com/blog/NuGetPackageOfTheWeek9ASPNETMiniProfilerFromStackExchangeRocksYourWorld.aspx。
有关分析应用程序数据库活动的更多信息,请参见 Julie Lerman 的 MSDN 杂志文章,标题为“分析实体框架中的数据库活动”:http://msdn.microsoft.com/magazine/gg490349.aspx。
10 附录
10.1 A. 测试环境
10.1.1 环境 1
这个环境使用了 2 计算机设置,数据库与客户端应用程序不在同一计算机上,而是在单独的计算机上。计算机在同一机架中,因此网络延迟相对较低,但比单机环境更接近实际。
10.1.1.1 应用程序服务器
10.1.1.1.1 软件环境
- 操作系统名称:Windows Server 2008 R2 Enterprise SP1。
- Visual Studio 2010 — 旗舰版。
- Visual Studio 2010 SP1(仅用于某些比较)。
10.1.1.1.2 硬件环境
- 双处理器:Intel(R) Xeon(R) CPU L5520,2.27GHz,2261 Mhz,4 核 8 逻辑处理器。
- 24 GB Ram。
- 分成 4 个分区的 136 GB SCSI 驱动器。
10.1.1.2 DB 服务器
10.1.1.2.1 软件环境
- 操作系统名称:Windows Server 2008 R2 Enterprise SP1。
- SQL Server 2008 R2。
10.1.1.2.2 硬件环境
- 单处理器:Intel(R) Xeon(R) CPU L5520,2.27GHz,2261 Mhz,4 核 8 逻辑处理器。
- 8 GB Ram。
- 分成 4 个分区的 465 GB ATA 驱动器。
10.1.1.3 在这个环境中收集的测试指标
- 视图生成。
- 查询计划缓存。
- 禁用更改跟踪。
- 升级到 Dev10 SP1 和 Dev11 以缩短模型生成时间。
10.1.2 环境 2
这个环境使用单工作站。客户端应用程序和数据库在同一计算机上。
10.1.2.1 软件环境
- 操作系统名称:Windows Server 2008 R2 Enterprise SP1。
- SQL Server 2008 R2。
10.1.2.2 硬件环境
- 单处理器:Intel(R) Xeon(R) CPU L5520,2.27GHz,2261 Mhz,4 核 8 逻辑处理器。
- 8 GB Ram。
- 分成 4 个分区的 465 GB ATA 驱动器。
10.1.2.3 在这个环境中收集的测试指标
- 查询执行比较。
10.2 B. 查询性能比较测试
using System.Data;
using System.Data.Common;
usingSystem.Data.Entity.Infrastructure;
using System.Data.EntityClient;
using System.Data.Objects;
using System.Linq;
using NavisionDbContext;
using NavisionObjectContext;
using PerfBVTHarness;
namespace NavisionObjectContext
{
public partial class NorthwindEntities : ObjectContext
{
private static readonly Func<NorthwindEntities, string, IQueryable<Product>> productsForCategoryCQ = CompiledQuery.Compile(
(NorthwindEntities context, string categoryName) =>
context.Products.Where(p => p.Category.CategoryName == categoryName)
);
public IQueryable<Product> InvokeProductsForCategoryCQ(string categoryName)
{
return productsForCategoryCQ(this, categoryName);
}
}
}
namespace QueryComparison
{
public class QueryTypePerfComparison
{
private static string entityConnectionStr = @"metadata=res://*/NorthwindModel.csdl|res://*/NorthwindModel.ssdl|res://*/NorthwindModel.msl;provider=System.Data.SqlClient;provider connection string='data source=.\sqlexpress;initial catalog=NorthwindEF;integrated security=True;multipleactiveresultsets=True;App=EntityFramework'";
[Test("LinqQueryObjectContext",
Description = "Query for beverages and materialize results",
WarmupIterations = 10,
TestIterations = 1000)]
public void LINQIncludingContextCreation()
{
using (NorthwindEntities context = new NorthwindEntities())
{
var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
q.ToList();
}
}
[Test("LinqQueryNoTrackingObjectContext",
Description = "Query for beverages and materialize results - NoTracking",
WarmupIterations = 10,
TestIterations = 1000)]
public void LINQNoTracking()
{
using (NorthwindEntities context = new NorthwindEntities())
{
context.Products.MergeOption = MergeOption.NoTracking;
var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
q.ToList();
}
}
[Test("CompiledQuery",
Description = "Query for beverages and materialize results using a CompiledQuery",
WarmupIterations = 10,
TestIterations = 1000)]
public void CompiledQuery()
{
using (NorthwindEntities context = new NorthwindEntities())
{
var q = context.InvokeProductsForCategoryCQ("Beverages");
q.ToList();
}
}
[Test("ObjectQuery",
Description = "Query for beverages and materialize results using an ObjectQuery",
WarmupIterations = 10,
TestIterations = 1000)]
public void ObjectQuery()
{
using (NorthwindEntities context = new NorthwindEntities())
{
ObjectQuery<Product> products = context.Products.Where("it.Category.CategoryName = 'Beverages'");
products.ToList();
}
}
[Test("EntityCommand",
Description = "Query for beverages on an EntityCommand and materialize results by reading from a DataReader",
WarmupIterations = 10,
TestIterations = 1000)]
public void EntityCommand()
{
using (EntityConnection eConn = new EntityConnection(entityConnectionStr))
{
eConn.Open();
EntityCommand cmd = eConn.CreateCommand();
cmd.CommandText = "Select p From NorthwindEntities.Products As p Where p.Category.CategoryName = 'Beverages'";
using (EntityDataReader reader = cmd.ExecuteReader(CommandBehavior.SequentialAccess))
{
List<Product> productsList = new List<Product>();
while (reader.Read())
{
DbDataRecord record = (DbDataRecord)reader.GetValue(0);
// 通过访问每个字段和值对产品进行“具体化”。因为要具体化产品,我们没有任何嵌套数据读取器或记录。
int fieldCount = record.FieldCount;
// 将所有产品均视为 Product,即使它们是子类型 DiscontinuedProduct 也是如此。
Product product = new Product();
product.ProductID = record.GetInt32(0);
product.ProductName = record.GetString(1);
product.QuantityPerUnit = record.GetString(2);
product.UnitPrice = record.GetDecimal(3);
product.UnitsInStock = record.GetInt16(4);
product.UnitsOnOrder = record.GetInt16(5);
product.ReorderLevel = record.GetInt16(6);
productsList.Add(product);
}
}
}
}
[Test("ExecuteStoreQuery",
Description = "Query for beverages using ExecuteStoreQuery",
WarmupIterations = 10,
TestIterations = 1000)]
public void ExecuteStoreQuery()
{
using (NorthwindEntities context = new NorthwindEntities())
{
ObjectResult<Product> beverages = context.ExecuteStoreQuery<Product>(
@" SELECT P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued
FROM Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
WHERE (C.CategoryName = 'Beverages')"
);
beverages.ToList();
}
}
[Test("SqlQueryOnDatabase",
Description = "Query for beverages using SqlQuery on Database",
WarmupIterations = 10,
TestIterations = 1000)]
public void ExecuteStoreQuery()
{
using (DbContextNorthwindEntities context = new DbContextNorthwindEntities())
{
IEnumerable<NavisionDbContext.Product> beverages = context.Database.SqlQuery<Product>(
@" SELECT P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued
FROM Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
WHERE (C.CategoryName = 'Beverages')"
);
beverages.ToList();
}
}
[Test("SqlQueryOnDbSet",
Description = "Query for beverages using SqlQuery on Database",
WarmupIterations = 10,
TestIterations = 1000)]
public void ExecuteStoreQuery()
{
using (DbContextNorthwindEntities context = new DbContextNorthwindEntities())
{
DbSqlQuery<NavisionDbContext.Product> beverages = context.Products.SqlQuery (
@" SELECT P.ProductID, P.ProductName, P.SupplierID, P.CategoryID, P.QuantityPerUnit, P.UnitPrice, P.UnitsInStock, P.UnitsOnOrder, P.ReorderLevel, P.Discontinued
FROM Products AS P INNER JOIN Categories AS C ON P.CategoryID = C.CategoryID
WHERE (C.CategoryName = 'Beverages')"
);
beverages.ToList();
}
}
[Test("LinqQueryDbContext",
Description = "Query for beverages and materialize results",
WarmupIterations = 10,
TestIterations = 1000)]
public void LINQIncludingContextCreationDbContext()
{
using (DbContextNorthwindEntities context = new DbContextNorthwindEntities())
{
var q = context.Products.Where(p => p.Category.CategoryName == "Beverages");
q.ToList();
}
}
[Test("LinqQueryNoTrackingDbContext",
Description = "Query for beverages and materialize results - NoTracking",
WarmupIterations = 10,
TestIterations = 1000)]
public void LINQNoTrackingDbContext ()
{
using (DbContextNorthwindEntities context = new DbContextNorthwindEntities())
{
var q = context.Products.AsNoTracking().Where(p => p.Category.CategoryName == "Beverages");
q.ToList();
}
}
}
}
10.3 C. Navision 模型
Navision 数据库是一个用于演示 Microsoft Dynamics – NAV 的大型数据库。生成的概念模型包含 1005 个实体集和 4227 个关联集。在测试中使用的模型是“扁平的”— 尚未添加继承。
10.3.1 用于 Navision 测试的查询
在 Navision 模型中使用的查询列表包含 3 个类别的实体 SQL 查询:
10.3.1.1 查找
无聚合的简单查找查询
- 计数:16232
- 示例:
<Query complexity="Lookup">
<CommandText>Select value distinct top(4) e.Idle_Time From NavisionFKContext.Session as e</CommandText>
</Query>
10.3.1.2 SingleAggregating
具有多个聚合但没有小计的正常 BI 查询(单一查询)
- 计数:2313
- 示例:
<Query complexity="SingleAggregating">
<CommandText>NavisionFK.MDF_SessionLogin_Time_Max()</CommandText>
</Query>
其中 MDF_SessionLogin_Time_Max() 在模型中定义为:
<Function Name="MDF_SessionLogin_Time_Max" ReturnType="Collection(DateTime)">
<DefiningExpression>SELECT VALUE Edm.Min(E.Login_Time) FROM NavisionFKContext.Session as E</DefiningExpression>
</Function>
10.3.1.3 AggregatingSubtotals
具有聚合和小计的 BI 查询(通过 union all)
- 计数:178
- 示例:
<CommandText>
using NavisionFK;
function AmountConsumed(entities Collection([CRONUS_International_Ltd__Zone])) as
(
Edm.Sum(select value N.Block_Movement FROM entities as E, E.CRONUS_International_Ltd__Bin as N)
)
function AmountConsumed(P1 Edm.Int32) as
(
AmountConsumed(select value e from NavisionFKContext.CRONUS_International_Ltd__Zone as e where e.Zone_Ranking = P1)
)
----------------------------------------------------------------------------------------------------------------------
(
select top(10) Zone_Ranking, Cross_Dock_Bin_Zone, AmountConsumed(GroupPartition(E))
from NavisionFKContext.CRONUS_International_Ltd__Zone as E
where AmountConsumed(E.Zone_Ranking) > @MinAmountConsumed
group by E.Zone_Ranking, E.Cross_Dock_Bin_Zone
)
union all
(
select top(10) Zone_Ranking, Cast(null as Edm.Byte) as P2, AmountConsumed(GroupPartition(E))
from NavisionFKContext.CRONUS_International_Ltd__Zone as E
where AmountConsumed(E.Zone_Ranking) > @MinAmountConsumed
group by E.Zone_Ranking
)
union all
{
Row(Cast(null as Edm.Int32) as P1, Cast(null as Edm.Byte) as P2, AmountConsumed(select value E
from NavisionFKContext.CRONUS_International_Ltd__Zone as E
where AmountConsumed(E.Zone_Ranking) > @MinAmountConsumed))
}</CommandText>
<参数>
<Parameter Name="MinAmountConsumed" DbType="Int32" Value="10000" />
</Parameters>
</Query>
EntityFrame Work 5 性能注意事项(转自MSDN)的更多相关文章
- 实体框架 (EF) 入门 => 六、性能注意事项
这个还真是复杂,看了看微软的文档,有些根本就看不懂,有些能看懂,但对我这种菜鸟也不会去用. 无从下手啊,前面放了几个链接,挨个试试吧. 一.显式打开连接 这个我测试过,有些时候,需要我们显示打开连接, ...
- SAP CRM 性能小技巧
导言 本页面打算收集SAP CRM实施中可以用于避免性能问题的注意事项,重要的事项会由图标标识. 如果你有其他的技巧想要说出来,别犹豫! 性能注意事项 通用 缓存读取类访问,特别是在性能关键的地方,比 ...
- Android应用性能优化(转)
人类大脑与眼睛对一个画面的连贯性感知其实是有一个界限的,譬如我们看电影会觉得画面很自然连贯(帧率为24fps),用手机当然也需要感知屏幕操作的连贯性(尤其是动画过度),所以Android索性就把达到这 ...
- [译]Dynamics AX 2012 R2 BI系列-规划分析的注意事项
https://msdn.microsoft.com/en-us/library/gg731898.aspx 在开始实施AX的分析特性前,有很多事情要考虑.本文描述了你必须考虑的事情,和在 ...
- 转——Android应用开发性能优化完全分析
[工匠若水 http://blog.csdn.net/yanbober 转载请注明出处.] 1 背景 其实有点不想写这篇文章的,但是又想写,有些矛盾.不想写的原因是随便上网一搜一堆关于性能的建议,感觉 ...
- Android 应用开发性能优化完全分析
1 背景 其实有点不想写这篇文章的,但是又想写,有些矛盾.不想写的原因是随便上网一搜一堆关于性能的建议,感觉大家你一总结.我一总结的都说到了很多优化注意事项,但是看过这些文章后大多数存在一个问题就是只 ...
- 【转】Android应用开发性能优化完全分析
http://blog.csdn.net/yanbober/article/details/48394201 1 背景 其实有点不想写这篇文章的,但是又想写,有些矛盾.不想写的原因是随便上网一搜一堆关 ...
- Android应用开发性能优化完全分析
1 背景 其实有点不想写这篇文章的,但是又想写,有些矛盾.不想写的原因是随便上网一搜一堆关于性能的建议,感觉大家你一总结.我一总结的都说到了很多优化注意事项,但是看过这些文章后大多数存在一个问题就是只 ...
- 提升ReSharper和Visual Studio的性能
转载 作者:赵青青 出处:http://www.cnblogs.com/zhaoqingqing/ 文章目录[点击展开](?)[+] 提升性能 我们不断地确保ReSharper的正常 ...
随机推荐
- LeetCode——Flatten Binary Tree to Linked List
Given a binary tree, flatten it to a linked list in-place. For example, Given 1 / \ 2 5 / \ \ 3 4 6 ...
- 西门子PLC学习笔记8-(计时器)
计时器port这包括:信号输入.时间.复位信号.出口.[计时器剩余时间(BI二进制表示法.BCD码表示)其输出被存储MW] 定时器包括::S_PULSE(脉冲定时器).S_PEXT(延时脉冲定时器). ...
- C语言 ## __VA_ARGS__ 宏
在GNU C中,宏可以接受可变数目的参数,就象函数一样 可以把__VA_ARGS__看成是将...赋值给该宏 //注意这里不能在函数中调用abc() #include <stdio.h> ...
- 我的MYSQL学习心得(十二)
原文:我的MYSQL学习心得(十二) 我的MYSQL学习心得(十二) 我的MYSQL学习心得(一) 我的MYSQL学习心得(二) 我的MYSQL学习心得(三) 我的MYSQL学习心得(四) 我的MYS ...
- 在打包程序中自动安装SQL Server数据库 .
原文:在打包程序中自动安装SQL Server数据库 . 1.创建安装项目“Setup1”安装项目 在“文件”菜单上指向“添加项目”,然后选择“新建项目”. 在“添加新项目”对话框中,选择“项目类型” ...
- UVA 11525 Permutation(树状数组)
题目意思是说 给你一个数k 然后有k个si 问你1--k 的第n个全排列是多少 注意是 1 2 3...k的全排列 不是si的 N= 由观察得知(k-i)!就是k-i个数字的全排列种数 ...
- 使用SQL Server Driver for PHP解决PHP连接MSSQL乱码的问题
原文 使用SQL Server Driver for PHP解决PHP连接MSSQL乱码的问题 最近帮客户写了一个.net商城网站的发布接口,大家都知道.net一般都使用MSSQL数据库,但鱼丸不会. ...
- JS获取标签方法及兼容处理
document.getElementById('Id名'); // 所有浏览器 document.getElementsByTagName('标签名'); // 所有浏览器 document.ge ...
- CSS学习笔记:溢出文本省略(text-overflow)
原文:CSS学习笔记:溢出文本省略(text-overflow) 在CSS3中,text-overflow属性的基本语法如下: clip:表示不显示省略文本,简单的裁切. ellipsis:表示对象文 ...
- 命令行配置源和安装本地rpm包
因为Firefox的在写博客时提交代码会丢失缩进,所以打算安装Chrome来写博,还不错,学到了两条命令- [shell] sudo yum-config-manager --add-repo=htt ...