第五章 优化查询性能（三）

查询执行计划

可以使用解释或显示计划工具来显示SELECT、DECLARE、UPDATE、DELETE、TRUNCATE TABLE和一些INSERT操作的执行计划。这些操作统称为查询操作，因为它们使用SELECT查询作为其执行的一部分。InterSystems IRIS在准备查询操作时生成执行计划；不必实际执行查询来生成执行计划。

默认情况下，这些工具显示InterSystems IRIS认为的最佳查询计划。对于大多数查询，有多个可能的查询计划。除了InterSystems IRIS认为最佳的查询计划外，还可以生成和显示备用查询执行计划。

InterSystems IRIS提供以下查询计划工具：

• $SYSTEM.SQL.ExPlan()方法可用于生成和显示XML格式的查询计划以及备选查询计划(可选)。
• SQL EXPLAIN命令可用于生成XML格式的查询计划，还可以选择生成备选查询计划和SQL统计信息。所有生成的查询计划和统计信息都包含在名为Plan的单个结果集字段中。请注意，EXPLAIN命令只能与SELECT查询一起使用。
• 管理门户 - >系统资源管理器 - >SQL界面显示计划按钮。
• 管理门户 — >系统资源管理器 — >工具—>SQL性能工具。

对于生成的%PARALLEL和分片查询，这些工具显示所有适用的查询计划。

使用Explain()方法

InterSystems IRIS、IRIS for Health和HealthShare Health Connect的2021.1版本的预览版现已发布。

由于这是一个预览版，我们希望在下个月的通用版本发布之前了解您对这个新版本的体验。请通过开发者社区分享您的反馈，以便我们能够共同打造一个更好的产品。

InterSystems IRIS数据平台2021.1是一个扩展维护（EM）版本。自2020.1（上一个EM版本）以来，在持续交付（CD）版本中增加了许多重要的新功能和改进。请参考2020.2、2020.3和2020.4的发布说明，了解这些内容的概况。

这个版本的增强功能为开发人员提供了更大的自由度，可以用他们选择的语言构建快速和强大的应用程序，并使用户能够通过新的和更快的分析功能更有效地处理大量的信息。

通过InterSystems IRIS 2021.1，客户可以部署InterSystems IRIS Adaptive Analytics，这是一个附加产品，它扩展了InterSystems IRIS，为分析终端用户提供了更强大的易用性、灵活性、可扩展性以及效率，而不管他们选择何种商业智能（BI）工具。它能够定义一个利于分析的业务模型，并通过在后台自主构建和维护临时数据结构，透明地加速针对该模型运行分析查询时的工作负载。

这个版本中的其他重点新功能包括

第五章 优化查询性能（二）

使用索引

索引通过维护常见请求数据的排序子集，提供了一种优化查询的机制。 确定哪些字段应该被索引需要一些思考:太少或错误的索引和关键查询将运行太慢; 太多的索引会降低插入和更新性能(因为必须设置或更新索引值)。

什么索引

要确定添加索引是否会提高查询性能，请从管理门户SQL接口运行查询，并在性能中注意全局引用的数量。 添加索引，然后重新运行查询，注意全局引用的数量。 一个有用的索引应该减少全局引用的数量。 可以通过在WHERE子句或ON子句条件前使用%NOINDEX关键字来防止使用索引。

应该为联接中指定的字段(属性)编制索引。左外部联接从左表开始，然后查看右表；因此，应该为右表中的字段建立索引。在下面的示例中，应该为T2.f2编制索引：

   FROM Table1 AS T1 LEFT OUTER JOIN Table2 AS T2 ON T1.f1 = T2.f2

内部联接应该在两个ON子句字段上都有索引。

服务器操作系统频繁产生错误日志“生成了一个严重警告并将其发送到远程终结点。这会导致连接终止。TLS 协议所定义的严重错误代码是 10。Windows SChannel 错误状态是 10。” 想请问一下，这个错误信息是我们产品导致产生的问题吗？

第五章 优化查询性能（一）

InterSystems SQL自动使用查询优化器创建在大多数情况下提供最佳查询性能的查询计划。该优化器在许多方面提高了查询性能，包括确定要使用哪些索引、确定多个AND条件的求值顺序、在执行多个联接时确定表的顺序，以及许多其他优化操作。可以在查询的FROM子句中向此优化器提供“提示”。本章介绍可用于评估查询计划和修改InterSystems SQL将如何优化特定查询的工具。

InterSystems IRIS®Data Platform支持以下优化SQL查询的工具：

• SQL Runtime Statistics用于生成查询执行的运行时性能统计信息
• 索引分析器，用于显示当前命名空间中所有查询的各种索引分析器报告。这显示了InterSystems SQL将如何执行查询，可以全面了解索引是如何使用的。此索引分析可能表明应该添加一个或多个索引以提高性能。
• 查询执行计划：显示SQL查询(查询计划)的最佳(默认)执行计划，并可选地显示该SQL查询的备用查询计划以及统计信息。用于显示查询计划的工具包括SQL EXPLAIN命令、$SYSTEM.SQL.ExPlan()方法以及管理门户和SQL Shell中的各种Show Plan工具。查询计划和统计数据是在准备查询时生成的，不需要执行查询。

亲爱的社区开发者们：

本周进入 InterSystems 开发者工具编程大赛 投票时间（4月19日-25日）！ 来为你心目中基于InterSystems IRIS而构建的最佳方案投票吧！

🔥 投票入口: 点击投票 🔥

如何投票？有哪些最新信息值得了解一下?

第四章 缓存查询（二）

运行时计划选择

运行时计划选择(RTPC)是一个配置选项，它允许SQL优化器利用运行时(查询执行时)的离群值信息。运行时计划选择是系统范围的SQL配置选项。

当RTPC被激活时，准备查询包括检测查询是否包含具有离群值的字段上的条件。如果PREPARE检测到一个或多个异常值字段条件，则不会将查询发送到优化器。相反，SQL会生成一个运行时计划选择存根。在执行时，优化器使用此存根选择要执行的查询计划：忽略离群值状态的标准查询计划，或针对离群值状态进行优化的替代查询计划。如果有多个异常值条件，优化器可以从多个备选运行时查询计划中进行选择。

如果您已在Open Exchange 发布了应用，大赛期间，您可以登录 Open Exchange, 打开applications。

打开你希望提交给大赛的应用，点击 Apply for Contest.

确保状态是 'Published'.

接下来您的应用会进入审查阶段，如果符合参赛要求，便会被列在 参赛区 进行展示，投票开始后可以接受投票。

近日，InterSystems极客俱乐部举办了线上直播“InterSystems Caché系统运维培训”，这是系列视频之一。InterSystems中国资深售前顾问吕正之讲解了“InterSystems Caché架构、备份与恢复”。

近日，InterSystems极客俱乐部举办了线上直播“InterSystems Caché系统运维培训”，这是系列视频之一。InterSystems中国资深售前顾问马浩讲解了“InterSystems Caché系统监控和性能数据采集”。

请问是否有人有一个使用CDS文件的IRIS / Ensemble实际例子以及一、两个样本CDS文件作为参考。谢谢。

近日，InterSystems极客俱乐部举办了线上直播“InterSystems Caché系统运维培训”，这是系列视频之一。InterSystems中国资深售前顾问祝麟讲解了“InterSystems Caché系统安全”。

在医院信息化建设中，如何打通医院的各个系统，给患者提供连续、无缝的良好体验，集成平台发挥着重要作用。而集成平台方案如何适应现在的多云时代、需要具备什么样的特性、如何与多云环境更好地结合以便为医院的信息化建设带来更多的便利？面对这一系列问题，InterSystems中国业务拓展经理李岩为您解读InterSystems集成平台方案的特点和优势，以及构建在VMware云方案上的最佳实践，让您了解云环境下集成平台方案的新特性和优势。

有人有将NonStop SQLMP与IRIS连接的经验吗？

如果可能的话，我需要一些参考或技巧，实际上是与JDBC驱动程序连接的，以便互连并解决许多各种各样的问题，例如：

一些查询（不是很多）有空获取，可以正常工作，但没有要获取的内容，而且确定Select 语句是正确的。

我对EnsLib.HTTP.GenericOperation类进行了操作。此操作发送以下json消息：

<HTTPMessage xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://www.w3.org/2001/XMLSchema">

<Stream>

大家好，

我正在创建WS做服务器用，但是当我要求WSDL时，提示错误因为找不到类。
我添加了以下说明：

set ^SYS("Security","CSP","AllowClass","MiProyecto.MiClaseWS","%SOAP.WebServiceInfo")=1 
set ^SYS("Security","CSP","AllowClass","MiProyecto.MiClaseWS","%SOAP.WebServiceInvoke")=1

我已经在WS安全配置中创建了一个入口

在“应用程序角色”选项卡中，我配置了％All权限

（图像中的命名空间“Samples”是出于安全原因）

如果我以以下方式调用服务，则http：// localhost：57772 / myproject / ws / MyProject.MiClassWS.cls？ WSDL提示以下错误：

Not Found
The requested URL /miproyecto/ws/MiProyecto.MiClaseWS.cls was not found on this server.

但是，另一方面，如果我执行以下命令，它可以正常工作： https：// localhost：57772 / csp / sample / MiProyecto.MiClaseWS.cls？wsdl 。

第四章 缓存查询（一）

系统自动维护已准备好的SQL语句(“查询”)的缓存。这允许重新执行SQL查询，而无需重复优化查询和开发查询计划的开销。缓存查询是在准备某些SQL语句时创建的。准备查询发生在运行时，而不是在编译包含SQL查询代码的例程时。通常，PREPARE紧跟在SQL语句的第一次执行之后，但在动态SQL中，可以准备查询而不执行它。后续执行会忽略PREPARE语句，转而访问缓存的查询。要强制对现有查询进行新的准备，必须清除缓存的查询。

所有SQL调用都会创建缓存查询，无论是在ObjectScript例程中调用还是在类方法中调用。

• 动态SQL、ODBC、JDBC和$SYSTEM.SQL.DDLImport()方法在准备查询时创建缓存查询。管理门户执行SQL接口、InterSystems SQL Shell和%SYSTEM.SQL.Execute()方法使用动态SQL，因此使用准备操作来创建缓存查询。

它们列在命名空间(或指定方案)的Management Portal常规缓存查询列表、每个正在访问的表的Management Portal Catalog Details缓存查询列表以及SQL语句列表中。动态SQL遵循本章中介绍的缓存查询命名约定。

• 类查询在准备(%PrepareClassQuery()方法)或第一次执行(调用)时创建缓存查询。

使用SQLServer2008进行网关连接，驱动名，URL和jar包地址都正确，出现服务器版本不支持的问题

现在有windows上的 编译好的nginx 可以做为iris 的web 服务器吗？ ngx_http_csp_module_sa.c  , cspapi.h  这两个文件在哪下载？

关于WebService接口采用适配器为

Parameter ADAPTER;

有方式可以获取到调用方的IP地址等信息吗？

第三章 优化表（二）

调整表计算值

调优表操作根据表中的代表性数据计算和设置表统计信息:

• ExtentSize，它可能是表中的实际行数(行数)，也可能不是。
• 表中每个属性(字段)的选择性。 可以选择性地阻止单个属性的选择性计算。
• 属性的离群选择性，其中一个值比其他值出现得更普遍。 有效的查询可以利用离群值优化。
• 标识某些属性特征的每个属性的注释。
• 每个属性的平均字段大小。
• 表的SQL Map Name、BlockCount和Source of BlockCount。

区段大小和行计数

从管理门户运行Tune Table工具时，ExtentSize是表中当前行的实际计数。默认情况下，GatherTableStats()方法还将实际行数用作ExtentSize。当表包含大量行时，最好对较少的行执行分析。可以使用SQL tune table命令并指定%SAMPLE_PERCENT来仅对总行的一定百分比执行分析。在针对包含大量行的表运行时，可以使用此选项来提高性能。此%SAMPLE_PERCENT值应该足够大，以便对代表性数据进行采样。如果ExtentSize<1000，则无论%SAMPLE_PERCENT值如何，TUNE TABLE都会分析所有行。

Hi 亲爱的社区开发者们，福利来了！

在Global Masters，我们为 Expert, Ambassador and VIP levels（专家级、大使级和VIP级）的用户提供了更多奖励！

Apple AirPods

希望你们喜欢新奖品！

此外，你可以在奖励列表中看到"解锁获奖" 项目，根据提示完成相应目标后，便可解锁并申请奖品。

IRIS相比Caché在部署上的一个进步是支持docker。即便不是云部署， 使用docker也带来非常多的便利。 尤其是在开发测试环节，由于docker的使用更便捷，除非要模拟客户的环境或者做规定的性能测试，我在测试中基本已经不再使用本机的实例或者虚机。IRIS的联机文档有详细的IRIS docker安装使用指导，本文只是一个简单的，快速上手的在测试环境安装IRIS docker的简单步骤，尤其适合初学者。

注意Windows上docker可能会遇到这样那样的问题，因此通常还是推荐在Linux或者Mac OS上使用。正式的生产环境的IRIS docker container也是不支持Windows系统的。

Referrence

• First Look: InterSystems Products in Docker Containers
• Running an InterSystems IRIS Container: Docker Run ExamplesRunning an InterSystems IRIS Container: Docker Run Examples

##1. 在操作系统上安装Docker环境

第三章 优化表（一）

要确保InterSystems IRIS®Data Platform上的InterSystems SQL表的最高性能，可以执行多种操作。优化可以对针对该表运行的任何查询产生重大影响。本章讨论以下性能优化注意事项：

• ExtentSize、Selective和BlockCount用于在用数据填充表之前指定表数据估计；此元数据用于优化未来的查询。
• 运行tune Table来分析填充表中的代表表数据；生成的元数据用于优化未来的查询。
• 优化表计算的值包括扩展大小、选择性、异常值选择性、平均字段大小和块计数
• 导出和重新导入优选表统计数据

扩展大小、选择性和块数(ExtentSize, Selectivity, and BlockCount)

当查询优化器决定执行特定SQL查询的最有效方式时，它会考虑以下三种情况：

• 查询中使用的每个表的ExtentSize行计数。
• Selectivity为查询使用的每列计算的DISTINCT值的百分比。
• 查询使用的每个SQL映射的块计数。

为了确保查询优化器能够做出正确的决策，正确设置这些值非常重要。

• 在用数据填充表之前，可以在类(表)定义期间显式设置这些统计信息中的任何一个。
• 在用代表性数据填充表之后，可以运行tune Table来计算这些统计数据。
• 运行TuneTable之后，可以通过指定显式值来覆盖计算的统计信息。

如图  dll放在 

我调用的方式如下 

期待能够在ensemble里面能便捷的调用dll，各种语言开发的dll，至少能支持c#生成的dll，

你好，

smp里面如何添加数据库 只能用command添加吗？没有在portal里看到添加数据库这个功能。

还想请问要把Excel的数据import到IRIS应该用什么方式去操作？

第二章 定义和构建索引（五）

验证索引

可以使用以下任一方法验证索引

• $SYSTEM.OBJ.ValidateIndices()验证表的索引，还验证该表的集合子表中的任何索引。
• %Library.Storage.%ValidateIndices()验证表的索引。集合子表索引必须使用单独的%ValidateIndices()调用进行验证。

这两种方法都会检查指定表的一个或多个索引的数据完整性，并可以选择更正发现的任何索引完整性问题。他们分两步执行索引验证：

1. 确认为表(类)中的每一行(对象)正确定义了索引实体。
2. 遍历每个索引，对于索引的每个条目，确保表(类)中有一个值和匹配的条目。

如果这两种方法中的任何一种发现不一致，它都可以有选择地更正索引结构和/或内容。它可以验证标准索引、位图索引、位图范围索引和位片索引，并可选择对其进行校正。默认情况下，这两种方法都会验证索引，但不会更正索引。

如果满足以下条件，%ValidateIndices()只能用于更正(生成)读写活动系统上的索引：如上所述，使用了SetMapSelecability()；%ValidateIndices()参数必须包括AUTOCORRECT=1和lockOption>0。由于%ValidateIndices()速度明显较慢，因此%BuildIndices()是在活动系统上构建索引的首选方法。

第二章 定义和构建索引（四）

位片索引

当数字数据字段用于某些数值运算时，位片索引用于该字段。位片索引将每个数值数据值表示为二进制位串。位片索引不是使用布尔标志来索引数值数据值(如在位图索引中那样)，而是以二进制值表示每个值，并为二进制值中的每个数字创建一个位图，以记录哪些行的该二进制数字具有1。这是一种高度专门化的索引类型，可以显著提高以下操作的性能：

• SUM、COUNT或AVG Aggregate计算。(位片索引不用于COUNT(*)计算。)。位片索引不用于其他聚合函数。
• 指定的字段 TOP n ... ORDER BY field
• 在范围条件运算中指定的字段，WHERE field > n 或 WHERE field BETWEEN lownum AND highnum、

SQL优化器确定是否应该使用定义的位片索引。通常，优化器仅在处理大量(数千)行时才使用位片索引。

可以为字符串数据字段创建位片索引，但位片索引将这些数据值表示为规范数字。换句话说，任何非数字字符串(如“abc”)都将被索引为0。这种类型的位片索引可用于快速计数具有字符串字段值的记录，而不计算那些为空的记录。

在下面的例子中，Salary是位片索引的候选项:

SELECT AVG(Salary) FROM SalesPerson

第二章 定义和构建索引（三）

位图索引

位图索引是一种特殊类型的索引，它使用一系列位串来表示与给定索引数据值相对应的一组ID值。

位图索引具有以下重要功能：

• 位图是高度压缩的：位图索引可以比标准索引小得多。这大大减少了磁盘和缓存的使用量。
• 位图操作针对事务处理进行了优化：与使用标准索引相比，可以在表中使用位图索引，而不会降低性能。
• 位图上的逻辑操作(counting、AND和OR)经过优化以获得高性能。
• SQL引擎包括许多可以利用位图索引的特殊优化。

位图索引的创建取决于表的唯一标识字段的性质：

• 如果表的ID字段定义为具有正整数值的单个字段，则可以使用此ID字段为字段定义位图索引。此类型的表使用系统分配的唯一正整数ID，或使用IdKey定义自定义ID值，其中IdKey基于类型为%Integer且MINVAL>的单个属性，或类型%Numeric型且Scale=0且MINVA>0。
• 如果表的ID字段未定义为具有正整数值的单个字段(例如，子表)，则可以定义采用正整数的%BID(位图ID)字段作为代理ID字段；这允许为该表中的字段创建位图索引。

受下列限制，位图索引的操作方式与标准索引相同。 索引值将被整理，可以在多个字段的组合上建立索引。

位图索引操作

位图索引的工作方式如下。 假设Person表，其中包含一些列:

开发者们现在可以下载一套InterSystems ObjectScript扩展插件，并开始使用微软的Visual Studio Code IDE编写应用程序。我们培训部门的新VS Code资源指南提供了大量开发人员入门需要的内容，包括：

连接到InterSystems实例：安装和使用VS Code的ObjectScript扩展
VS Code开发应用程序文档：
使用开源社区。
   播客集: 在VS代码中编写ObjectScript (20m)
   开发者社区文章。如何报告问题
   Github Repository。InterSystems语言服务器
   Github Repository。InterSystems服务器管理器
   Github Repository。VS代码的InterSystems ObjectScript扩展 
了解IDE。
    微软文档。Visual Studio代码 - 入门
    微软视频。Visual Studio代码入门 (5m)

更多详情欢迎访问：https://learning.intersystems.com/course/view.php?id=1678&ssoPass=1