.png)
第107章 SQL函数 $PIECE
返回由分隔符标识的子字符串的字符串函数。
大纲
$PIECE(string-expression,delimiter[,from[,to]])
参数
string-expression- 要从中提取子字符串的目标字符串。 表达式，可以是字段名、字符串字面值、数字或其他函数的结果。delimiter- 用于标识子字符串的分隔符。from- 可选-指定要从目标字符串返回的子字符串或子字符串范围的开头的整数。 子字符串由分隔符分隔，从1开始计数。 如果省略，则返回第一个子字符串。to- 可选-一个整数，指定从目标字符串返回的子字符串范围的结束子字符串。 必须与from连用。
描述
$PIECE从字符串表达式中返回指定的子字符串(PIECE)。
返回的子字符串取决于所使用的参数:
$PIECE(string-expression,delimiter)返回string-expression中的第一个子字符串。 如果delimiter出现在字符串表达式中，则这是在delimiter第一次出现之前的子字符串。 如果分隔符没有出现在字符串表达式中，则返回的子字符串为字符串表达式。
注意：下面内存设置数值仅限参考，具体内存数值的设置是否合适，依赖于更多实际使用情况决定。
主要需要设置下面几个内存相关配置：
(下面比例适用于服务器仅运行单实例InterSystems IRIS)
数据库缓存Database cache:
建议小于64G内存设置总内存50%，大于等于64G内存设置70%总内存
程序缓存routine cache:
建议设置1023MB
gmheap:
建议设置1048576KB(1024MB）
LockSize:
建议最少设置134217728 Bytes (128MB)，如果在系统日志中提示locksize相关错误或警报，应相应增加。
如果在一台服务器上安装了多个InterSystems IRIS 实例，那么要保证 所有InterSystems IRIS 运行实例的 Shared memory(database cache + routine cache + gmheap) 总值小于 Hugepage设定的值
hugePages :
建议设置值大于系统所有InterSystems IRIS 运行实例的 Shared memory(database cache + routine cache + gmheap) 总值再往上取整+1G。之后监控cache efficiency 调整设置大小。
此文章也是对问题 在不重建的情况下插入索引Inserting an index without reconstruction 的一种解释
在使用SQL语言对 InterSystems IRIS 中的表进行查询时，有时候会发现返回的结果与实际有出入，特别是使用count() 函数，或者select 查询时，返回的结果少于实际应返回的值。
这种情况往往是由于数据表格的索引值出了问题。
索引出问题的主要原因可能是：
- 表中先有数据，后创建的索引定义，并且定义之后没有重新生成索引。
- 对保存数据的global直接操作。如果是使用对象或者sql的方式操作数据，相应的索引都会自动更新，但是如果直接对global操作，则不会自动更新索引。
- 对保存索引的global直接操作。
要解决或者要检查是不是索引引发的问题，可以使用%ValidateIndices()函数，它有两种方式使用
$SYSTEM.OBJ.ValidateIndices(classname,idxList,autoCorrect,lockOption,multiProcess)
或者
##class(classname).%ValidateIndices(idxList,autoCorrect,lockOption,multiProcess)
两种使用方法最大的差别是：$SYSTEM.OBJ.
Docker 20.10.14（2022年3月23日发布）改变了赋予容器的Linux能力，其方式与InterSystems IRIS 2021.1（及以上）容器的Linux能力检查器不兼容。
在Linux上运行Docker 20.10.14的用户会发现，IRIS 2021.1+容器将无法启动，并且日志会错误地报告缺少所需的Linux能力。 比如说。
[ERROR] Required Linux capability cap_setuid is missing. [ERROR] Required Linux capability cap_dac_override is missing. [ERROR] Required Linux capability cap_fowner is missing. [ERROR] Required Linux capability cap_setgid is missing. [ERROR] Required Linux capability cap_kill is missing. [FATAL] Your IRIS container is missing one or more required Linux capabilities.
解决方案
遇到这个问题的用户需要调整传递给容器入口的命令行，以禁用对Linux功能的检查。
我想介绍一下我参加Globals竞赛的新项目。一个非常新的Globals浏览器视图
.png)
第106章 SQL函数 PI
返回pi常数值的标量数值函数。
大纲
{fn PI()}
{fn PI}
描述
PI不接受参数。
它返回数学常数pi作为数据类型NUMERIC，精度为19，刻度为18。
PI只能使用ODBC标量函数(花括号)语法调用。
请注意，参数括号是可选的。
描述
下面的例子都返回pi的值:
SELECT {fn PI()} AS ExactPi
3.141592653589793238
SELECT {fn PI} AS ExactPi
3.141592653589793238
使用 JDBC 链接 InterSystems ：
- 将IRIS jdbc 驱动拷贝到 安装文件夹/lib 下
- 自定义链接URL： jdbc:IRIS://ipAddress:superserverPort/namespace
- 自定义驱动器类名称： com.intersystems.jdbc.IRISDriver
.png)
然后就可以像其他关系型数据库使用的方式来使用Kettle。
第105章 SQL函数 %OID
返回 ID 字段的 OID 的标量函数。
大纲
%OID(id_field)
参数
id_field-ID字段或引用字段的字段名称。
描述
%OID 采用字段名称并返回对象的完整 OID（对象 ID）。该字段必须是 ID 字段或引用字段（外键字段）。在 id_field 中指定任何其他类型的字段会生成 SQLCODE -1 错误。
示例
以下示例显示了与引用字段一起使用的 %OID：
SELECT Name, Spouse, %OID(Spouse)
FROM Sample.Person
WHERE Spouse IS NOT NULL
以下嵌入式 SQL 示例显示了与引用字段一起使用的 %OID：
/// d ##class(PHA.TEST.SQLFunction).Oid()
ClassMethod Oid()
{
&sql(SELECT Name, Spouse, %OID(Spouse)
INTO :n,:s,:soid
FROM Sample.Person)
w !,"Name is:",n
w !,"Spouse name is:",s
w !,"Spouse OID is:",soid
}
DHC-APP>d ##class(PHA.TEST.SQLFunction).众所周知，InterSystems IRIS的产品设计理念源于互操作性（Interoperable）、稳定性（Reliable）、直观（Intuitive）、可扩展性（Scalable），在云时代，InterSystems IRIS的云上操作与本地一样便捷，令用户体验有了明显提升，除此之外，为了更高效地对InterSystems IRIS进行配置，我们还提供了哪些新特性？为了便捷地进行数据迁移，InterSystems IRIS最新版本提供了哪些解决方案？
4月12日，新一期“极客俱乐部”在线分享即将推出，InterSystems中国技术总监乔鹏将分享“InterSystems数据平台与三级等保”这一主题，聊聊数据平台如何保护信息安全，以及如何配置、管理数据平台，以满足三级等保要求。点击链接报名参会，或扫描下方二维码参会。
第104章 SQL函数 %ODBCOUT
以 ODBC 格式返回表达式的格式转换函数。
大纲
%ODBCOUT(expression)
%ODBCOUT expression
参数
expression- 要转换的表达式。字段名称、包含字段名称的表达式或以可转换数据类型（例如DATE或%List）返回值的函数。不能是流字段。
描述
%ODBCOUT 在通过字段或数据类型的 LogicalToOdbc 方法传递值后以 ODBC 格式返回表达式。 ODBC 格式是可以通过 ODBC 呈现数据的格式。当数据暴露给 ODBC/SQL 时使用这种格式。可用的格式对应于 ODBC 定义的格式。
%ODBCOUT 通常用于 SELECT 列表选择项。它可以在 WHERE 子句中使用，但不鼓励这种使用，因为使用 %ODBCOUT 会阻止在指定字段上使用索引。
应用 %ODBCOUT 将列标题名称更改为诸如“Expression_1”之类的值；因此，通常需要指定列名别名，如下面的示例所示。
%ODBCOUT 是否转换日期取决于日期字段或函数返回的数据类型。 %ODBCOUT 转换 CURDATE、CURRENT_DATE、CURTIME 和 CURRENT_TIME 值。它不转换 CURRENT_TIMESTAMP、GETDATE、GETUTCDATE、NOW 和 $HOROLOG 值。
第103章 SQL函数 %ODBCIN
以逻辑格式返回表达式的格式转换函数。
大纲
%ODBCIN(expression)
%ODBCIN expression
参数
expression- 要转换的表达式。
描述
%ODBCIN 在通过字段或数据类型的 OdbcToLogical 方法传递值后以逻辑格式返回表达式。逻辑格式是数据的内存格式（执行操作的格式）。
%ODBCIN 是一个 SQL 扩展。
示例
以下示例显示了同一字段的默认显示格式、%ODBCIN 和 %ODBCOUT 格式。
SELECT FavoriteColors,%ODBCIN(FavoriteColors) AS InVal,
%ODBCOUT(FavoriteColors) AS OutVal
FROM Sample.Person
以下示例在 WHERE 子句中使用 %ODBCIN：
SELECT Name,DOB,%ODBCOUT(DOB) AS Birthdate
FROM Sample.Person
WHERE DOB BETWEEN %ODBCIN('2000-01-01') AND %ODBCIN('2018-01-01')
亲爱的社区用户：
InterSystems社区会举办丰富的竞赛活动，项目提交后最重要的环节就是“投票”！
第102章 SQL函数 %OBJECT
标量函数，它打开一个流对象并返回相应的 oref。
大纲
%OBJECT(stream)
参数
stream- 作为流字段名称的表达式。
描述
%OBJECT 用于打开一个流对象并返回流字段的 oref（对象引用）。
流字段上的 SELECT 返回流字段的完全形成的 oid（对象 ID）值。流字段上的 SELECT %OBJECT 返回流字段的 oref（对象引用）。这在以下示例中显示，其中 Notes 和 Picture 都是流字段：
/// d ##class(PHA.TEST.SQLFunction).Object()
ClassMethod Object()
{
s myquery = "SELECT TOP 3 Title,Notes,%OBJECT(Picture) AS Photo FROM Sample.Employee"
s tStatement = ##class(%SQL.Statement).%New()
s qStatus = tStatement.%Prepare(myquery)
s rset = tStatement.%Execute()
while rset.%Next() {
w "String field: ",rset.Title,!
w "Stream field oid: ",rset.第101章 SQL函数 NVL
测试 NULL 并返回适当表达式的函数。
大纲
NVL(check-expression,replace-expression)
参数
check-expression- 要计算的表达式。replace-expression- 如果check-expression为NULL，则返回的表达式。
NVL 返回与检查表达式相同的数据类型。
描述
NVL 计算检查表达式并返回以下两个值之一：
- 如果
check-expression为NULL，则返回replace-expression。 - 如果
check-expression不为NULL，则返回check-expression。
参数 check-expression 和 replace-expression 可以具有任何数据类型。如果它们的数据类型不同，SQL 会将 replace-expression 转换为 check-expression 的数据类型，然后再进行比较。返回值的数据类型始终与 check-expression 的数据类型相同，除非 check-expression 为字符数据，此时返回值的数据类型为 VARCHAR2。
请注意，NVL 支持 Oracle 兼容性，并且与 ISNULL 函数相同。
第100章 SQL函数 NULLIF
如果两个表达式具有相同的值，则返回 NULL 的函数。
大纲
NULLIF(expression1,expression2)
参数
expression1- 表达式，可以是列名、数字或字符串文字、主变量或另一个标量函数的结果。expression2- 表达式，可以是列名、数字或字符串文字、主变量或另一个标量函数的结果。
NULLIF 返回与 expression1 相同的数据类型。
描述
如果 expression1 的值等于 expression2 的值，则 NULLIF 函数返回 NULL。否则，它返回 expression1 值。
NULLIF 等价于：
SELECT CASE
WHEN value1 = value2 THEN NULL
ELSE value1
END
FROM MyTable
NULL 处理函数比较
下表显示了各种 SQL 比较函数。如果逻辑比较测试为 True（A 与 B 相同），则每个函数返回一个值，如果逻辑比较测试为 False（A 与 B 不同），则返回另一个值。这些函数允许执行 NULL 逻辑比较。不能在实际相等（或不相等）条件比较中指定 NULL。
第九十九章 SQL函数 NOW
返回当前本地日期和时间的日期/时间函数。
大纲
NOW()
{fn NOW}
{fn NOW()}
描述
NOW 不接受任何参数。参数括号对于 ODBC 标量语法是可选的；它们对于 SQL 标准函数语法是必需的。
NOW 以时间戳的形式返回该时区的当前本地日期和时间；它会根据本地时间变体进行调整，例如夏令时。
NOW 可以返回 %TimeStamp 数据类型格式 (yyyy-mm-dd hh:mm:ss.ffff) 或 %PosixTime 数据类型格式（编码的 64 位有符号整数）的时间戳。以下规则确定返回的时间戳格式：
- 如果当前时间戳提供给数据类型为
%PosixTime的字段，则当前时间戳值以POSIXTIME数据类型格式返回。例如，WHERE PosixField=NOW()或INSERT INTO MyTable (PosixField) VALUES (NOW())。 - 如果当前时间戳提供给数据类型为
%TimeStamp的字段，则当前时间戳值以TIMESTAMP数据类型格式 (yyyy-mm-dd hh:mm:ss) 返回。它的 ODBC 类型是TIMESTAMP，LENGTH是16，PRECISION是19。小时以24小时格式表示。所有字段都保留前导零。
由麻省理工大学斯隆学院数字经济研究院Michael（Michael Schrage）主持，参与这次探讨的专家有人工智能布道师、数字化转型的先驱者、面临数字化转型挑战的传统公司，他们共同探讨了如何更迅速、更优质、更优价地获得切实可行的洞察，研讨涵盖了数字化转型面临的技术操作难点、投入产出性价比、数据科学家的角色、数据分析的类型、如何建设正确的基础设施和架构等等内容。面对越来越复杂的数据处理需求，这次研讨有一个观点值得借鉴：更大的数据量、种类和真实性实际上唤起了谦虚，而不是更大的信心。
有没有一个帮助类可以导入XML类并转化成UDL？谢谢！
David
第九十八章 SQL函数 MONTHNAME
返回日期表达式的月份名称的日期函数。
大纲
{fn MONTHNAME(date-expression)}
参数
date-expression- 计算结果为 日期整数、ODBC 日期或时间戳的表达式。此表达式可以是列名、另一个标量函数的结果或日期或时间戳字面量。
描述
MONTHNAME 将日期整数、$HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串或时间戳作为输入。
日期表达式时间戳可以是数据类型 %Library.PosixTime（编码的 64 位有符号整数），也可以是数据类型 %Library.TimeStamp (yyyy-mm-dd hh:mm:ss.fff)。
时间戳的时间部分不被评估，可以省略。
MONTHNAME 返回相应日历月的名称，从一月到十二月。返回值是一个字符串，最大长度为 15。
MONTHNAME 检查提供的日期是否有效。年份必须介于 0001 和 9999（含）之间、月份 01 至 12 以及适合该月的日期（例如，02/29 仅在闰年有效）。如果日期无效，MONTHNAME 会发出 SQLCODE -400
月份名称默认为全长美式英语月份名称。要更改这些月份名称值，请使用带有 MONTH_NAME 选项的 SET OPTION 命令。
使用 DATENAME 函数可以返回相同的月份名称信息。
这篇文章是前面文章[首次使用InterSystems IRIS] 互操作性: 它是如何工作的？的延续。
在上一篇文章中，解释了互操作性菜单如何用于系统集成。
在本文中，我想解释如何用互操作菜单开发系统集成。
首先，您想创建什么样的业务流程？ 请一边思考，一边开始以下内容。
- Production（生产）
- 消息
- 组件
- 业务服务
- 业务流程
- 业务运营
Production被定义和用作指定系统集成所需的组件及存储组件的配置，这些配置通过管理门户界面使用（内部被存储为生产的类定义）。
例如，假设您正在创建一个业务服务，该服务定期处理放置在指定目录中的文件。 在这种情况下，有必要准确配置要监测的目录和要处理的文件。 一个生产就是预先准备好用于存储这些配置。
这些配置取决于发送和接收数据的组件所使用的适配器。
适配器是用于简化与外部系统连接的类，有些是协议特定的，如 Mail/File/SOAP/FTP/HTTP/SQL/TCP，有些是标准特定的，如 HL7。
有关适配器的更多信息，请参阅文档（protocol-specific adapters and adapters related to EDI documentation）
由于我们将必要的组件定义为Production，“启动Production”将启动系统集成，而“停止Production”将停止系统集成。
这篇文章的目的是为了说明如何使用互操作菜单实现系统集成。
图片左侧窗口是接受外部系统发送信息的窗口。
信息接收方式种类很多，如定时监控指定目录来读取文件，定期查询数据库，输入且等待信息输出，或直接调用其他应用程序系统传送信息。
在系统集成配置中创建IRIS 互操作性菜单，接收到存储在一个对象中的信息被称为一条消息message（以下统称为消息）。消息被发送到组件component （以下统称为组件）中做后续处理。
使用所有接收到的信息或仅使用其中的一部分就能用来创建消息。
假设您要将信息中包含的消息发送给外部系统。这种情况下，需要将该消息发送给负责请求外网处理的组件（图右侧）。接收到消息的组件会请求外部系统对其进行处理。
此外，假设一条消息需要人工审查、数据转换或附加数据。这种情况下，消息会被发送到图表中间的业务流程管理组件（BPM），该组件负责协调处理业务流程。
消息用于在每个组件之间发送和接收数据。当发送或接收消息时，消息会被自动存储在数据库中。
由于消息存储在数据库中，因此在数据转换前后可以检查其差异性。在操作期间，或过程中间重新开始（重新发送），可以检查作为问题根源的消息。在开发、测试和操作的每个阶段可以验证正在使用的消息状态。
HI 开发者们,
我们在bilibili 发布了新的视频！
大家好，欢迎来到2022年3月开发者社区更新!
我们最近在InterSystems社区对开发者们的体验做了一些改进:
- 全新的社区内容搜索功能
- 综合社区数据
- 链接你的脸书账号
- 帖子页面更新：标签、作者块、草稿突出显示
下面让我们仔细看看。
第九十七章 SQL函数 MONTH
日期函数，它将月份作为日期表达式的整数返回。
大纲
MONTH(date-expression)
{fn MONTH(date-expression)}
描述
date-expression- 表达式，它是列的名称、另一个标量函数的结果，或者是日期或时间戳文字。
描述
MONTH 返回一个指定月份的整数。月份整数是针对 日期整数、$HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串或时间戳计算的。
日期表达式时间戳可以是数据类型 %Library.PosixTime（编码的 64 位有符号整数），也可以是数据类型 %Library.TimeStamp (yyyy-mm-dd hh:mm:ss.fff)。
日期字符串的月份 (mm) 部分必须是 1 到 12 范围内的整数。前导零在输入时是可选的。输出时抑制前导零和尾随零。
date-expression 的日期部分经过验证，并且必须包含 1 到 12 范围内的月份以及指定月份和年份的有效日期值。否则，将生成 SQLCODE -400 错误
date-expression 的时间部分未经验证，可以省略。
请注意，MONTH 可以作为 ODBC 标量函数（使用大括号语法）或作为 SQL 通用函数调用。
$SYSTEM.SQL.Functions.主要问题： 默认安装后，有没有默认用户名，密码？远程jdbc连接报错，麻烦解答一下，谢谢 [InterSystems IRIS JDBC] Communication link failure: Access Denied [08S01][461] Access Denied
创建用户： addgroup iris useradd -g iris -d "/home/iris" -m -s "/bin/bash" iris passwd iris
安装过程： root@baec-ThinkPad-E480:/data/IRIS_Community-2021.2.0.651.0-lnxubuntu1804x64# ./irisinstall
Your system type is 'Ubuntu LTS (x64)'.
Enter instance name
Enter a destination directory for the new instance. Directory: /data
Select installation type.
在这个一小时的互动课程中，用户可以参与了涉及多个Docker容器的复合应用程序的开发。此外，学员们还学习如何创建数据转换和业务规则，使用业务流程设计器来建立病人护理的逻辑，并使用Spark和PMML将业务操作与机器学习模型连接起来。
赶快来参加我们的线上课程吧：
https://learning.intersystems.com/course/view.php?id=1662&ssoPass=1
.png)
