第四章 缓存查询（一）

系统自动维护已准备好的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()方法)或第一次执行(调用)时创建缓存查询。

它们列在命名空间的管理门户常

关于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都会分析所有行。

指定的ExtentSize可以小于或大于实际行数。但是，ExtentSize不应显著超过当前表数据中的实际行数。指定ExtentSiz

第三章 优化表（一）

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

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

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

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

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

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

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

可以

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

验证索引

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

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

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

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

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

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

%Validat

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

位图索引

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

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

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

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

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

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

位图索引操作

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

此表中的每一行都有一个系统分配的RowID号(一组递增的整

圆满结束！

所有的专题会议都已经播出了。当然，我们全部102部预录制的专题会议现在可以点播了，您可以随意观看，即使您错过了现场问答的机会。

说到现场问答，我们已经举办了6次现场会议，您也可以观看。我之前写过一篇单独的博客文章，题目是如何让您的问题会帮助我们做得更好。

智能工厂启动包

今天备受关注的亮点之一是Intersystems IRIS智能工厂启动包在OpenExchange上发布。为此，我们的合作伙伴ITVisors和他们的客户Vlisco与我们的Joe Lichtenberg一起举办了一场精彩的会议“MFG001：介绍适用于制造业的InterSystems IRIS智能工厂启动包”。

容器和Kubernetes平台

今天我们宣布了一个高度安全的新版IRIS容器，名为“iris-lockeddown”，这个容器非常适合在Kubernetes中使用加固型pod安全策略的团队。说到Kubernetes，Steve Lubars演示了我们新的InterSystems Kubernetes Operator，它让您可以很轻松地在Kubernetes 中部署IRIS集群。而Luca Ravazzolo则演示了如何用CPF合并文件配置您的IRIS实例，特别是如何自动化进行镜像配置。还有其他一些有趣的问题。

以上精彩内容尽在对话Ontario Systems公司企业架构师J

我们刚刚结束了第二天的专题会议，会议内容精彩纷呈！虽然大家无法同时观看多个平行会议，但是线上会议有一个优势，那就是您可以根据自己的需要回看错过的内容！

在昨天的博客文章（第一天会议亮点）中，我介绍了大部分值得关注的公告，如 InterSystems IRIS Adaptive Analytics 和FHIR加速器服务等。所以，今天我想更宽泛地讨论一些战略主题。

运营和系统管理

现在，越来越多的客户业务已经运行在云端，也有越来越多的人开始在本地部署现代部署策略。Mark Bolinsky今天主持了两场背靠背会议：CL003 云存储策略和CL004 云备份策略，为使用云端生产工作的用户带来了很多技术细节。我们新推出的系统警报和监控（SAM）模块也得到了不错的反馈。相关内容请查看DEV007 系统警报和监控和CL005 分布式部署。另一个另广大开发者兴奋的消息是，集群监控现在可以轻松实现。在此感谢所有参与并提出问题的与会者！

安全性

在安全性方面，InterSystems一直受到客户和分析师的高度好评，不过大多数人会认为这样做是为了保持自身产品的安全。这当然是我们的一个目标，但是我们还添加了许多新的安全特性。今天的SEC000 OCSP装订就是一个典型的例子。虽然OCSP（在线证书状态协议）可提供更强的安全性，但也会影响浏览器性能。使用OCSP装订功能后，服务器会检

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

定义索引

使用带有索引的Unique、PrimaryKey和IdKey关键字

与典型的SQL一样，InterSystems IRIS支持惟一键和主键的概念。 InterSystems IRIS还能够定义IdKey，它是类实例(表中的行)的唯一记录ID。 这些特性是通过Unique、PrimaryKey和IdKey关键字实现的:

• Unique -在索引的属性列表中列出的属性上定义一个唯一的约束。 也就是说，只有这个属性(字段)的唯一数据值可以被索引。 唯一性是根据属性的排序来确定的。 例如，如果属性排序是精确的，则字母大小写不同的值是唯一的; 如果属性排序是SQLUPPER，则字母大小写不同的值不是唯一的。 但是，请注意，对于未定义的属性，不会检查索引的惟一性。 根据SQL标准，未定义的属性总是被视为唯一的。
• PrimaryKey -在索引的属性列表中列出的属性上定义一个主键约束。
• IdKey -定义一个唯一的约束，并指定哪些属性用于定义实例(行)的唯一标识。 IdKey总是具有精确的排序规则，即使是数据类型为string时也是如此。

这些关键字的语法出现在下面的例子中:

Class MyApp.SampleTable Extends %Persistent [DdlAllowed]
{
  Property Prop1 As %String;
 

在使用过程中，碰到对接一些国内编码例如：GBK2312等系列的编码格式，碰到这类情况，应该如何处理？各位有没有好的解决方式？期待解答交流！

Hi 社区开发者们，告诉大家一个好消息！InterSystems IRIS®数据平台已入驻AWS Quick Start，今后可在AWS上快速部署高可用的生产环境。

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

概述

索引是由持久类维护的结构，InterSystems IRIS®数据平台可以使用它来优化查询和其他操作。

可以在表中的字段值或类中的相应属性上定义索引。(还可以在多个字段/属性的组合值上定义索引。)。无论是使用SQL字段和表语法还是类属性语法定义相同的索引，都会创建相同的索引。当定义了某些类型的字段(属性)时，InterSystems IRIS会自动定义索引。可以在存储数据或可以可靠派生数据的任何字段上定义附加索引。InterSystems IRIS提供了几种类型的索引。可以为同一字段(属性)定义多个索引，为不同的目的提供不同类型的索引。

无论是使用SQL字段和表语法，还是使用类属性语法，只要对数据库执行数据插入、更新或删除操作，InterSystems IRIS就会填充和维护索引(默认情况下)。可以覆盖此默认值(通过使用%NOINDEX关键字)来快速更改数据，然后作为单独的操作生成或重新生成相应的索引。可以在用数据填充表之前定义索引。还可以为已经填充了数据的表定义索引，然后作为单独的操作填充(构建)索引。

InterSystems IRIS在准备和执行SQL查询时使用可用的索引。默认情况下，它选择使用哪些索引来优化查询性能。 可以根据需要覆盖此默认值，以防止对特定查询或所有查询使用一个或多个索引。

索引属性

每个索引都有一个唯一的名称。此名称用

第一章 SQL性能优化简介

InterSystems SQL支持几个特性来优化InterSystems IRIS®数据平台的SQL性能。

表定义优化

SQL性能从根本上取决于良好的数据架构。 将数据划分为多个表并在这些表之间建立关系对于高效的SQL是必不可少的。

描述了以下优化表定义的操作。 这些操作要求定义表，但不要求用数据填充表:

• 数据存储策略：可以选择使用%Storage.Persistent、%Storage.SQL或自定义存储来存储数据。
• 全局变量命名策略：可以使用USEEXTENTSET参数为数据和索引查找操作指定更短、更高效的散列全局名称。
• 索引：可以为一个表字段或一组字段定义索引。可以定义几种不同类型的索引：标准索引、位图索引、位图索引和位图范围索引。SQL优化使用定义的索引而不是数据值本身来访问查询、更新或删除操作的特定记录。

表数据优化

根据对表中典型数据的分析，可以执行以下操作来优化表访问：

• Tune Table：检查典型的表数据并生成ExtentSize(行数)、选择性(具有特定值的行的百分比)和BlockCount元数据。查询优化器使用此信息来确定最有效的查询执行计划。
• 选择性和异常值选择性：确定某个字段具有特定值的行的百分比，以及某个值是否为异常值，该值明显比该字段的其他值更常见。

查询优化

在几乎所有情况下，用嵌入式SQL编写的查询的执行速度

第十三章 使用动态SQL（五）

从结果集中返回特定的值

要从查询结果集中返回特定的值，必须一次一行遍历结果集。 要遍历结果集，请使用%Next()实例方法。 (对于单一值，结果对象中没有行，因此%Next()返回0，而不是错误。) 然后，可以使用%Print()方法显示整个当前行的结果，或者检索当前行的指定列的值。

%Next()方法获取查询结果中下一行的数据，并将该数据放入结果集对象的data属性中。 %Next()返回1，表示它位于查询结果中的某一行上。 %Next()返回0，表示它位于最后一行(结果集的末尾)之后。 每次调用%Next()返回1个增量%ROWCOUNT; 如果游标定位在最后一行之后(%Next()返回0)，%ROWCOUNT表示结果集中的行数。

如果SELECT查询只返回聚合函数，每个%Next()设置%ROWCOUNT=1。 第一个%Next()返回1并设置%SQLCODE=0和%ROWCOUNT=1，即使表中没有数据; 任何随后的%Next()返回0，并设置%SQLCODE=100和%ROWCOUNT=1。

从结果集中获取一行后，可以使用以下任何一种方式显示该行的数据:

• rset.%Print()返回查询结果集中当前行的所有数据值。
• rset.%GetRow()和rset.getrows()以编码列表结构的元素形式从查询结果集中返回一行的数据值。
• rs

第二十一章 导入和导出SQL数据

在InterSystems IRIS®Data Platform Management Portal中，有用于导入和导出数据的工具：

• 从文本文件导入数据
• 将数据导出到文本文件

这些工具使用动态SQL，这意味着查询是在运行时准备和执行的。可以导入或导出的行的最大大小为3,641,144个字符。

还可以使用%SQL.Import.Mgr类导入数据，使用%SQL.Export.Mgr类导出数据。

从文本文件导入数据

可以将数据从文本文件导入到合适的InterSystems IRIS类中。执行此操作时，系统将在表中为该类创建并保存新行。该类必须已经存在并且必须编译。要将数据导入到此类中，请执行以下操作：

1. 从管理门户中选择系统资源管理器，然后选择SQL。使用页面顶部的切换选项选择一个命名空间；这将显示可用命名空间的列表。

2. 在页面顶部，单击向导下拉列表，然后选择数据导入。

3. 在向导的第一页上，从指定外部文件的位置开始。对于导入文件所在的位置，请单击要使用的服务器的名称。

4. 然后输入文件的完整路径和文件名。

5. 对于选择架构名称，单击要向其中导入数据的InterSystems IRIS包。

6. 对于选择表名，单击将包含新创建的对象的类。

7. 然后单击下一步。

8. 在向导的第二页上，单击将包含导入数据的列。

9. 然后单击下一步。

10. 在向导的第三

如果看了前一篇InterSystems IRIS医疗行业版创建FHIR服务器，应该您已经搭建好了FHIR服务器和FHIR资源仓库。除了使用FHIR REST API来操作这个FHIR服务器，您还可以更直观地看看它的价值 - 使用SMART on FHIR应用。这次，基于上次建好的FHIR服务器，我们用10分钟把一个SMART on FHIR运行起来。

SMART on FHIR背景

SMART是Substitutable Medical Applications and Reusable Technology的缩写，它的目标是创建可以被替换、可以复用的医疗应用，简单说就是希望医疗应用可以像我们的手机应用一样：不喜欢当前的天气应用，那么就换一个。SMART，这个起于2011年的哈佛和波士顿儿童医院的合作项目，在2013年注意到并快速采用了FHIR，成就了今天的SMART on FHIR。

不再需要处理数据持久化、数据模型标准化等问题，SMART on FHIR应用相当的轻量级，因此也容易快速开发。它主要借助FHIR API和OAuth认证，连接到FHIR服务器上操作数据。SMART on FHIR应用都是Web应用，它可以独立运行，也可以嵌入到任何现有应用中，例如TrakCare（InterSystems的EMR产品）和HealthShare Personal Communit

InterSystems IRIS，IRIS for Health和IRIS Studio的2020.4版本现已正式发布。

InterSystems IRIS Data Platform 2020.4使开发、部署和管理增强型应用和业务流程变得更加容易，从而弥合了数据和应用孤岛。它具有许多新功能，包括

增强了应用程序和接口开发人员的能力，包括：

• 支持Java SE 11 LTS，在使用Oracle OpenJDK和AdoptOpenJDK时均可支持
• 支持JDBC的连接池
• 分段式虚拟文档路由规则中新的 "foreach "组件

增强了数据库和系统管理员的能力，包括:

• ICM现在支持部署系统警报和监测(SAM)和InterSystems API Manager(IAM)
• 对常见管理任务的SQL语法的扩展
• 简化InterSystems报表的部署

InterSystems IRIS for Health 2020.4包含了InterSystems IRIS 2020.4的所有增强功能。此外，这个版本还包

• 增强对FHIR的支持，包括对FHIR配置文件的支持
• 支持RMD IHE 的Profile
• HL7迁移工具中的DataGate支持  

关于这些功能的更多细节可以在产品文档中找到:

• InterSystems IRIS 202

第十九章 存储和使用流数据（BLOBs和CLOBs）

Intersystems SQL支持将流数据存储为Intersystems Iris ®DataPlatform数据库中的 BLOBs（二进制大对象）或 CLOBs（字符大对象）的功能。

流字段和SQL

Intersystems SQL支持两种流字段：

• 字符流 Character streams，用于大量文本。
• 二进制流 Binary streams，用于图像，音频或视频。

BLOBs and CLOBs

Intersystems SQL支持将BLOBs（二进制大对象）和CLOBs（字符大对象）存储为流对象的功能。 BLOBs用于存储二进制信息，例如图像，而CLOBs用于存储字符信息。 BLOBs和CLOBs可以存储多达4千兆字节的数据（JDBC和ODBC规范所强加的限制）。

在各种方面，诸多方面的操作在通过ODBC或JDBC客户端访问时处理字符编码转换（例如Unicode到多字节）：BLOB中的数据被视为二进制数据，从未转换为二进制数据另一个编码，而CLOB中的数据被视为字符数据并根据需要转换。

如果二进制流文件（BLOB）包含单个非打印字符$CHAR(0)，则被认为是空二进制流。它相当于""空二进制流程值：它存在（不是null），但长度为0。

定义流数据字段

Intersystems SQL支持流字段的各种数据类型名称

第十八章 定义和使用存储过程

本章介绍如何在IntersystemsIRIS®数据平台上定义和使用Intersystems SQL中的存储过程。它讨论了以下内容：

• 存储过程类型的概述
• 如何定义存储过程
• 如何使用存储过程如
• 何列出存储过程及其参数。

概述

SQL例程是可执行的代码单元，可以由SQL查询处理器调用。 SQL例程有两种类型：功能和存储过程。从支持FunctionName（）语法的任何SQL语句中调用函数。存储过程只能由CALL语句调用。函数接受某些输入定向参数并返回单个结果值。存储过程接受某些输入，输入输出和输出参数。存储过程可以是用户定义的函数，返回单个值。 CALL语句也可以调用函数。

与大多数关系数据库系统一样，Intersystems Iris允许创建SQL存储过程。存储过程（SP）提供存储在数据库中的可调用可调用的程序，并且可以在SQL上下文中调用（例如，通过使用呼叫语句或通过ODBC或JDBC）。

与关系数据库不同，Intersystems Iris使可以将存储过程定义为类的方法。实际上，存储过程只不过是SQL可用的类方法。在存储过程中，可以使用基于对象的全系列Intersystems的功能。

• 可以通过查询数据库将存储过程定义为返回单个结果集数据集的查询。
• 可以将存储过程定义为可以用作用户定义函数的函数过程，返回单个值。
• 可以将存储过程定义为可以修改数

第十七章 使用触发器

本章介绍如何在Intersystems SQL中定义触发器。触发器是响应某些SQL事件执行的代码行。本章包括以下主题：

定义触发器

有几种方法可以为特定表定义触发器：

• 在将投影到SQL表的持久性类定义中包含触发定义。例如，MyApp.person类的此定义包括Loggevent触发器的定义，在每个成功的数据插入到MyApp.person表之后，将在每个成功的数据插入后调用：

Class MyApp.Person Extends %Persistent [DdlAllowed]
{
    // ... Class Property Definitions

    Trigger LogEvent [ Event = INSERT, Time = AFTER ]
    {
        // Trigger code to log an event 
    }
 }

• 使用SQL创建触发命令创建触发器。这在相应的持久性类中生成触发对象定义。 SQL触发器名称按照标识符命名约定进行操作。 IntersystemsIris®数据平台使用SQL触发名称生成相应的触发类实体名称。

必须拥有％create_trigger管理级别权限来创建触发器。必须具有删除触发器的％drop_trigger管理级别权限。

类的最大用户定义触发器数为200。

注意：Int

第十六章 导入SQL Code

本章介绍如何将SQL代码从文本文件导入Intersystems SQL。导入SQL代码时，IntersystemsIris®数据平台使用动态SQL准备并执行每行SQL。如果遇到无法解析的代码行，则SQL导入跳过该行代码并继续准备和执行后续行，直到它到达文件的末尾。所有SQL代码导入操作导入到当前名称空间。

SQL导入主要用于导入数据定义语言（DDL）命令（例如Create Table），并使用Insert，Update和Delete命令填充表。 SQL导入确实准备并执行SELECT查询，但不创建结果集。

SQL导入可用于导入Intersystems SQL代码。它也可以用于代码迁移，从其他供应商导入SQL代码（FDBMS，Informix，Interbase，MSSQLServer，MySQL，Oracle，Sybase）。来自其他供应商的代码被转换为Intersystems SQL代码并执行。 SQL导入无法将所有SQL命令导入Intersystems SQL。它导入与SQL标准的Intersystems Iris实现兼容的那些命令和条款。不兼容的功能通常被解析，但忽略了。

SQL导入可以成功准备一个SQL查询 - 在适当的情况下创建相应的缓存查询 - 但它不会执行查询。

通过从％system.sql.schema类中调用相应的方法，执行SQL代

第十五章 使用管理门户SQL接口（二）

过滤模式内容

Management Portal SQL界面的左侧允许查看模式(或匹配筛选器模式的多个模式)的内容

1. 通过单击SQL interface页面顶部的Switch选项，指定希望使用的名称空间。 这将显示可用名称空间的列表，可以从中进行选择。
2. 应用筛选器或从模式下拉列表中选择模式。

可以使用Filter字段通过输入搜索模式来筛选列表。 可以在一个模式或多个模式中筛选模式，或筛选表/视图/过程名(项)。 搜索模式由模式名、点(.)和项目名组成——每个名称由文字和通配符的某种组合组成。字面值不区分大小写。 通配符是:

• 星号(*)表示0个或多个任意类型的字符。
• 下划线(_)表示任意类型的单个字符。
• 撇号(')倒装前缀，意为“不”(除了)。
• 反斜杠(\)转义字符:\_表示字面上的下划线字符。

例如，S*返回所有以S S*开头的模式。 Person返回所有以S. *开头的模式中的所有Person项。 Person*返回所有模式中以Person开头的所有项。 可以使用逗号分隔的搜索模式列表来选择满足所列模式(或逻辑)中的任何一种的所有项。 例如,* .Person * *。 Employee*选择所有模式中的所有Person和Employee项。

若要应用筛选器搜索模式，请单击refresh按钮或按Tab键。

过滤器搜索模式将一直有效，

第十五章 使用管理门户SQL接口（一）

本章介绍如何在InterSystems IRIS®数据平台管理门户上执行SQL操作。 管理门户界面使用动态SQL，这意味着在运行时准备和执行查询。 Management Portal界面旨在帮助针对小型数据集开发和测试SQL代码。 它不打算用作在生产环境中执行SQL的接口。

管理门户还提供了各种配置SQL的选项。

有关使用管理门户的一般信息，请选择左上角的Help按钮。 通过使用左上角的Contact按钮，可以从管理门户向InterSystems Worldwide Response Center (WRC)报告有关InterSystems软件的问题。

管理门户SQL工具

InterSystems IRIS允许使用SQL工具从InterSystems IRIS管理门户检查和操作数据。 此操作的起点是Management Portal System Explorer选项。 从这里选择SQL选项。 这将显示SQL接口，它允许:

• 执行SQL查询—编写和执行SQL命令。 可以对现有的表和数据执行SQL查询，创建表，或插入、更新或删除表数据。 可以编写SQL代码直接转化为一个文本框(包括选择、插入、更新、删除、创建表和其他SQL语句),检索语句的SQL历史文本框,拖拽一个表到文本框来生成一个查询(SELECT语句),或构成一个查询(SELECT语句

着手书写“数据应用方案分享”系列文章的初衷是，希望从终端用户的视角阐述我们所期待的数据应用方式及其可能为医疗领域带来的获益，为医学信息工作者提供参考。在这个系列中，笔者会以临床常见疾病和流程为例，用真实的数据录入、获取、展现和使用场景说明需求；尤其是如何细致、精准的构建数据源头，以确保现代医学信息技术“有数可用”、“数用必达”。其中肯定有思虑不周全或逻辑不严谨之处，望各位读者按需审阅，取其精华、弃其糟粕。此外，本系列更多在于探讨数据应用的“可能性”，而非“可行性”。文中部分图片尚处于设想模拟阶段，并非真实系统图片，请知悉。

第十四章 使用SQL Shell界面（三）

SQL元数据、查询计划和性能指标

显示元数据

SQL Shell支持M或Metadata命令以显示有关当前查询的元数据信息。

对于每个结果集项目，此命令列出以下元数据：列名称（SQL字段名称），键入（ODBC数据类型整数代码），PRE（精度或最大长度），比例（最大分数数字），NULL（BOOLEAN：1 = NULL允许，0 =不允许空值），标签（标题标签，请参阅列别名），表（SQL表名称），架构（架构名称），CTYPE（客户端数据类型，请参阅％SQL.statementColumn ClientType属性）。

SHOW STATEMENT

可以执行查询，然后发出show语句或显示st以显示准备好的SQL语句。默认情况下，必须执行查询。可以避免通过设置executemode =延迟执行查询，从而发出查询，然后发出show语句sql shell命令。

显示声明信息包含实现类(缓存查询名称),参数(一个以逗号分隔的实际参数值,如上面条款和WHERE子句文字值),和语句文本(文字文本的SQL命令,包括字母大小写和参数值)。

EXPLAIN and Show Plan

有两种方式显示SQL查询的查询计划; 如果需要，两者都可以显示备用的查询计划。

• EXPLAIN：前言用解释命令选择SELECT查询。例如：

SQL]USER>>EXPLAI

第十四章 使用SQL Shell界面（二）

存储和调用SQL语句

通过数据回调

SQL Shell自动将在终端会话期间发出的每个成功的SQL语句存储在本地缓存中，并为其分配一个顺序号。这些数字用于在当前Terminal过程中重新调用以前的SQL语句。 SQL Shell仅将数字分配给成功的SQL语句。如果在准备SQL语句期间发生错误，则不会分配任何编号。这些数字分配不是特定于名称空间的。以下是可用的数字调用命令：

• ＃：可以使用＃列出所有先前缓存的SQL语句及其分配的编号。
• #n：可以通过在SQL Shell提示符下指定#n来调用并执行先前的SQL语句，其中n是SQL Shell分配给该语句的整数。
• ＃0：可以通过在SQL Shell提示符下指定＃0来调用并执行最近准备的SQL语句。 ＃0调用最近准备的SQL语句，而不必调用最近执行的SQL语句。因此，调用和执行SQL语句对＃0调用哪个SQL语句没有影响。

通过数字调用SQL语句不会为该语句分配新的数字。 SQL Shell在终端会话的持续时间内顺序分配数字；退出并重新进入SQL Shell或更改名称空间不会影响数字分配或先前分配的数字的有效性。

要删除所有号码分配，请使用#CLEAR并在显示的提示符下确认此操作。这将删除所有先前的号码分配，并从1重新开始号码分配。

通过名字回调

可以选择为SQL语句分配名称，然后按名称重新调用

第十四章 使用SQL Shell界面（一）

执行SQL的其他方式

可以使用$SYSTEM.SQL.Execute() 方法从Terminal命令行执行一行SQL代码，而无需调用SQL Shell。以下示例显示如何在终端提示下使用此方法：

DHC-APP>SET result=$SYSTEM.SQL.Execute("SELECT TOP 5 name,dob,ssn FROM Sample.Person")
 
DHC-APP>DO result.%Display()
Name    DOB     SSN
yaoxin  54536   111-11-1117
xiaoli          111-11-1111
姚鑫    63189   111-11-1112
姚鑫    63189   111-11-1113
姚鑫    50066   111-11-1114
 
5 Rows(s) Affected

如果SQL语句包含错误，则Execute（）方法成功完成；否则，该方法无效。 ％Display（）方法返回错误信息，例如：

USER>DO result.%Display()

[SQLCODE: <-29>:<Field not found in the applicable tables>]
[%msg: < Field 'GAME' not found in th

2021年3月23日 – 提醒：镜像Dejournaling的潜在数据完整性问

InterSystems 已经纠正了一个缺陷，该缺陷在极少数情况下会导致非主镜像成员的数据不一致问题。此缺陷影响到InterSystems产品的所有发布版本。

如果发生该缺陷，则会在镜像系统的正常运行中悄然发生。该缺陷的结果是，镜像成员未能删除数据库日志的子集，然后导致镜像成员之间的数据不一致。这对故障转移和异步成员都有影响。虽然这个缺陷遇到的可能性非常小，但InterSystems建议所有使用镜像的客户都要获得修正，并使用DataCheck验证镜像数据库的一致性。有关可能触发该缺陷的具体情况以及将遇到该缺陷的风险降至最低的步骤的更多详细信息，请联系全球响应中心（WRC）。

该缺陷的更正被确定为 SML2898、HYY2434 和 HYY2435，并将包含在所有未来的产品版本中，包括 Caché 和 Ensemble 2018.1.5 以及 InterSystems IRIS 和 InterSystems IRIS for Health 2019.1.2 和 2020.1.1。这些更正也可通过InterSystems全球响应中心（WRC）的Ad hoc分发版本获得。

如果您对这个提醒有任何疑问，请联系 Worldwide Response Center。

现已推出三套新的维护版本：

• Caché  2018.1.5, Ensemble 2018.1.5, and HSAP 2018.1.5
• InterSystems IRIS 2019.1.2, IRIS for Health 2019.1.2, and HealthShare Health Connect 2019.1.2
• InterSystems IRIS 2020.1.1, IRIS for Health 2020.1.1, and HealthShare Health Connect 2020.1.1

安装包和容器版本可从以下网站下载  WRC Software Distribution site。

这些都是维护版本，在广泛的领域内有许多更新。  有关这些版本中的修正信息，请参考该版本的文档，其中包括发行说明和升级检查表、发行变更列表，以及类参考资料和全套指南、参考资料、教程和文章。所有的文档都可以通过以下方式获得 docs.intersystems.com 。

在这些版本中也加入了新的平台支持。  特别是，Ubuntu 20.04 LTS的支持已经添加到所有版本中，IBM AIX 7.1和7.2对System p-64的支持已经添加到2019.1.2中（并且已经在2020.1中），而对Linux的ARM64支持已经添加到2020.1.1中。  详情请参见