第104章 SQL函数 %ODBCOUT

以 ODBC 格式返回表达式的格式转换函数。

大纲

%ODBCOUT(expression)

%ODBCOUT expression

参数

• expression - 要转换的表达式。字段名称、包含字段名称的表达式或以可转换数据类型（例如 DATE 或 %List）返回值的函数。不能是流字段。

描述

%ODBCOUT 在通过字段或数据类型的 方法传递值后以 格式返回表达式。 格式是可以通过 呈现数据的格式。当数据暴露给 时使用这种格式。可用的格式对应于 定义的格式。

通常用于 列表选择项。它可以在 WHERE 子句中使用，但不鼓励这种使用，因为使用 会阻止在指定字段上使用索引。

应用 将列标题名称更改为诸如之类的值；因此，通常需要指定列名别名，如下面的示例所示。

是否转换日期取决于日期字段或函数返回的数据类型。 转换 CURDATE、、 和 值。它不转换 、、、 和 值。

示例

以下示例显示了同一字段的默认显示格式、 和 格式。

SELECT FavoriteColors,%ODBCIN(FavoriteColors) AS InVal,
%ODBCOUT(FavoriteColors) AS OutVal
FROM Sample.Person

Hey 开发者们，

投票周开始了！

来为你最欣赏的应用投上一票吧！InterSystems开发者竞赛：Globals!

🔥 为你最欣赏的应用投票： 点此投票 🔥

如何投票？请看以下细节。

第103章 SQL函数 %ODBCIN

以逻辑格式返回表达式的格式转换函数。

大纲

%ODBCIN(expression)

%ODBCIN expression

参数

• expression - 要转换的表达式。

描述

%ODBCIN 在通过字段或数据类型的 OdbcToLogical 方法传递值后以逻辑格式返回表达式。逻辑格式是数据的内存格式（执行操作的格式）。

是一个 扩展。

示例

以下示例显示了同一字段的默认显示格式、%ODBCIN 和 格式。

SELECT FavoriteColors,%ODBCIN(FavoriteColors) AS InVal,
%ODBCOUT(FavoriteColors) AS OutVal
FROM Sample.Person

以下示例在 WHERE 子句中使用 ：

亲爱的社区用户：

InterSystems社区会举办丰富的竞赛活动，项目提交后最重要的环节就是“投票”！

第102章 SQL函数 %OBJECT

标量函数，它打开一个流对象并返回相应的 oref。

大纲

%OBJECT(stream)

参数

• stream - 作为流字段名称的表达式。

描述

%OBJECT 用于打开一个流对象并返回流字段的 （对象引用）。

流字段上的 返回流字段的完全形成的 （对象 ID）值。流字段上的 SELECT %OBJECT 返回流字段的 （对象引用）。这在以下示例中显示，其中 和 都是流字段：

/// 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.Notes,!
		w "Stream field oref: ",rset.Photo,!!
	}
	w !,"End of data"
}

第101章 SQL函数 NVL

测试 NULL 并返回适当表达式的函数。

大纲

NVL(check-expression,replace-expression)

参数

• check-expression - 要计算的表达式。
• replace-expression - 如果 check-expression 为 NULL，则返回的表达式。

返回与检查表达式相同的数据类型。

描述

计算检查表达式并返回以下两个值之一：

• 如果 为 ，则返回 。
• 如果 不为 ，则返回 check-expression。

参数 和 可以具有任何数据类型。如果它们的数据类型不同，SQL 会将 转换为 的数据类型，然后再进行比较。返回值的数据类型始终与 的数据类型相同，除非 为字符数据，此时返回值的数据类型为 VARCHAR2。

请注意， 支持 兼容性，并且与 ISNULL 函数相同。

日期和时间显示转换

某些检查表达式数据类型需要从逻辑模式转换为 ODBC 模式或显示模式。例如 和 数据类型。如果的值不是同一个数据类型，这个值不能在ODBC模式或模式下转换，会产生错误：； - 用于 数据类型。例如，不能在 ODBC 模式或 模式下执行；它发出。要在 模式或显示模式下执行此语句，必须将值转换为适当的数据类型。这导致日期

第100章 SQL函数 NULLIF

如果两个表达式具有相同的值，则返回 NULL 的函数。

大纲

NULLIF(expression1,expression2)

参数

• expression1 - 表达式，可以是列名、数字或字符串文字、主变量或另一个标量函数的结果。
• expression2 - 表达式，可以是列名、数字或字符串文字、主变量或另一个标量函数的结果。

返回与 相同的数据类型。

描述

如果 的值等于 的值，则 NULLIF 函数返回 。否则，它返回 值。

等价于：

SELECT CASE 
WHEN value1 = value2 THEN NULL
ELSE value1
END
FROM MyTable

NULL 处理函数比较

下表显示了各种 SQL 比较函数。如果逻辑比较测试为 （ 与 相同），则每个函数返回一个值，如果逻辑比较测试为 （ 与 不同），则返回另一个值。这些函数允许执行 逻辑比较。不能在实际相等（或不相等）条件比较中指定 。

第九十九章 SQL函数 NOW

返回当前本地日期和时间的日期/时间函数。

大纲

NOW()

{fn NOW}
{fn NOW()}

描述

NOW 不接受任何参数。参数括号对于 ODBC 标量语法是可选的；它们对于 SQL 标准函数语法是必需的。

以时间戳的形式返回该时区的当前本地日期和时间；它会根据本地时间变体进行调整，例如夏令时。

可以返回 %TimeStamp 数据类型格式 (yyyy-mm-dd hh:mm:ss.ffff) 或 数据类型格式（编码的 位有符号整数）的时间戳。以下规则确定返回的时间戳格式：

1. 如果当前时间戳提供给数据类型为 %PosixTime 的字段，则当前时间戳值以 POSIXTIME 数据类型格式返回。例如， 或 。
2. 如果当前时间戳提供给数据类型为 的字段，则当前时间戳值以 数据类型格式 () 返回。它的 ODBC 类型是 ， 是 ， 是 。小时以 小时格式表示。所有字段都保留前导零。例如， 或 。
3. 如果在没有上下文的情况下提供当前时间戳，则以 数据类型格式返回当前时间戳值。例如。

要更改默认日期时间字符串格式，请使用带有各种日期和时间选项的 命令。

可以使用 或 函数更改时间戳、日期和时间的数据类型。

精度的小数秒

默认情况下， 不返回小数秒的精度。它不支持精确参数。

由麻省理工大学斯隆学院数字经济研究院Michael（Michael Schrage）主持，参与这次探讨的专家有人工智能布道师、数字化转型的先驱者、面临数字化转型挑战的传统公司，他们共同探讨了如何更迅速、更优质、更优价地获得切实可行的洞察，研讨涵盖了数字化转型面临的技术操作难点、投入产出性价比、数据科学家的角色、数据分析的类型、如何建设正确的基础设施和架构等等内容。面对越来越复杂的数据处理需求，这次研讨有一个观点值得借鉴：更大的数据量、种类和真实性实际上唤起了谦虚，而不是更大的信心。

有没有一个帮助类可以导入XML类并转化成UDL？谢谢！

David

第九十八章 SQL函数 MONTHNAME

返回日期表达式的月份名称的日期函数。

大纲

{fn MONTHNAME(date-expression)}

参数

• date-expression - 计算结果为 日期整数、ODBC 日期或时间戳的表达式。此表达式可以是列名、另一个标量函数的结果或日期或时间戳字面量。

描述

MONTHNAME 将日期整数、$HOROLOG 或 值、 格式日期字符串或时间戳作为输入。

日期表达式时间戳可以是数据类型 （编码的 64 位有符号整数），也可以是数据类型 。

时间戳的时间部分不被评估，可以省略。

MONTHNAME 返回相应日历月的名称，从一月到十二月。返回值是一个字符串，最大长度为 15。

检查提供的日期是否有效。年份必须介于 0001 和 9999（含）之间、月份 至 以及适合该月的日期（例如， 仅在闰年有效）。如果日期无效， 会发出 错误。

月份名称默认为全长美式英语月份名称。要更改这些月份名称值，请使用带有 选项的 命令。

使用 函数可以返回相同的月份名称信息。可以使用 检索月份名称或月份名称缩写与其他日期元素。要返回与月份对应的整数，请使用 或 。

也可以使用 方法调用从 ObjectScript 调用此函数：

$SYSTEM.SQL.Functions.MONTHNAME(date-expression)

示例

以下示例均返回字符串

这篇文章是前面文章[首次使用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 或 值、ODBC 格式日期字符串或时间戳计算的。

日期表达式时间戳可以是数据类型 （编码的 64 位有符号整数），也可以是数据类型 (yyyy-mm-dd hh:mm:ss.fff)。

日期字符串的月份 () 部分必须是 到 范围内的整数。前导零在输入时是可选的。输出时抑制前导零和尾随零。

的日期部分经过验证，并且必须包含 到 12 范围内的月份以及指定月份和年份的有效日期值。否则，将生成 错误 。

的时间部分未经验证，可以省略。

请注意， 可以作为 ODBC 标量函数（使用大括号语法）或作为 SQL 通用函数调用。

$SYSTEM.SQL.Functions.MONTH(date-expression)

可以使用以下 SQL 函数返回日期时间字符串的元素：、MONTH、（或 ）、、 和 。使用 或 函数可以返回相同的元素。可以使用 返回日期元素。

主要问题： 默认安装后，有没有默认用户名，密码？远程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 : IRIS

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

第九十六章 SQL函数 MOD

注：IRIS可用，非IRIS版本不可用。

标量数值函数，返回一个数除以另一个数的模数（余数）。

大纲

MOD(dividend,divisor)

{fn MOD(dividend,divisor)}

参数

• dividend - 数字，它是除法的分子（除数）。
• divisor - 数字，它是除法的分母（除数）。

MOD 返回 数据类型，除非被除数是数据类型 。如果 为 ，则 返回 。

描述

返回除数除数的数学余数（模数）。

可以指定为标准标量函数或带有大括号语法的 ODBC 标量函数。

• 如果被除数和除数为正数，则返回正数模数或零。
• 如果被除数和除数都是负数，则返回负模数或零。
• 如果被除数或除数为 NULL，则返回 NULL。
• 如果除数为 ，它将生成带有 错误的 。
• 如果除数大于被除数，则返回被除数。

（任一语法形式）报告的精度与算术表达式除数/除数的精度报告相同。

ANSI 运算符优先级

具有单个负操作数的 函数的行为取决于 配置设置：

• 如果未应用 ，则带有负操作数的 MOD 的行为与 模运算符相同。两者都返回短计数（达到下一个倍数所需的数量），而不是模数。例如， 返回模数 ； 返回短计数 。如果被除数为负，短计数为正值或零。如果除数为负，则短计数为负值或零。
• 如果应用了 （IRIS 2019.1 及后续版本的默认设置），带有负操作数的

当我们在一个命名空间中运行数据清除时，数据库的大小和空间并没有改变。  我想，像Oracle一样，它留下的空白空间是可以被缓存使用的，但有没有办法看到这些空间有多少是可用的？  今天我增加了系统可用的磁盘大小，因为我们已经达到了关键的低磁盘空间，然而，随着清理的进行，我们应该有几百GB的可用空间在数据库内使用。  那么，只要数据库中有足够的可用空间用于写入数据，允许系统耗尽可用的磁盘空间是否安全？When we run data purges in a namespace, the size and space of the DB does not change.  I assume like Oracle it leaves white space that is usable by cache, but is there a way to see how much of this space is available?

卓越是什么？是思维方式，理念，还是结果？ 在InterSystems，我们用行动来定义卓越。

第九十五章 SQL函数 MINUTE

返回日期时间表达式的分钟的时间函数。

大纲

{fn MINUTE(time-expression)}

参数

• time-expression - 作为列名、另一个标量函数的结果或字符串或数字文字的表达式。它必须解析为日期时间字符串或时间整数，其中基础数据类型可以表示为 %Time、%TimeStamp 或 。

描述

MINUTE 返回一个整数，指定给定时间或日期时间值的分钟数。为 $HOROLOG 或 值、ODBC 格式日期字符串或时间戳计算分钟。

时间表达式时间戳可以是数据类型 （编码的 64 位有符号整数），也可以是数据类型 (yyyy-mm-dd hh:mm:ss.fff)。

要更改默认时间格式，请使用 命令。

请注意，可以提供时间整数（经过的秒数），但不能提供时间字符串 ()。必须提供日期时间字符串 ()。

日期时间字符串的时间部分必须是有效时间。否则，将生成 SQLCODE -400 错误 。分钟 () 部分必须是 到 范围内的整数。前导零在输入时是可选的；前导零在输出上被抑制。可以省略日期时间字符串的秒 () 部分，但仍返回分钟部分。

日期时间字符串的日期部分未经过验证。

当分钟部分为或时， 返回零分钟。如果没有提供时间表达式，或者完全省略时间表达式的分钟部分(, , , or )，也会返回零分钟。

可以使用 或 返回相同的时间信息。

Business Process rules 中 如何获得消息类型, session Id 等信息

第九十四章 SQL函数 %MINUS

将数字转换为规范整理格式，然后反转符号的整理函数。

大纲

%MINUS(expression)

%MINUS expression

参数

• expression - 表达式，可以是列名、数字或字符串文字、算术表达式或另一个函数的结果，其中基础数据类型可以表示为任何字符类型。

描述

%MINUS 将数字或数字字符串转换为规范形式，反转符号，然后以数字排序规则返回这些表达式值。

%MINUS 和 在功能上是相同的，只是 %MINUS 反转了符号。它为解析为正数的任何数字添加减号前缀，并从解析为负数的任何数字中删除减号。零从不签名。

一个数字可以包含前导零和尾随零、多个前导加号和减号、一个小数点指示符 () 和 指数指示符。在规范形式中，执行所有算术运算，扩展指数，将符号解析为单个前导减号或无符号，并去除前导零和尾随零。

可以使用或不使用封闭字符串分隔符来指定数字文字。如果字符串包含非数字字符， 会在第一个非数字字符处截断数字，并以规范形式返回数字部分。非数字字符串（任何以非数字字符开头的字符串）返回为 。%MINUS 也将 作为 返回。

是一个 SQL 扩展，用于 SQL 查找查询。

可以使用 类的 Collation()

第九十三章 SQL函数 LTRIM

字符串函数，它返回一个删除了前导空格的字符串。

大纲

LTRIM(string-expression)

{fn LTRIM(string-expression)}

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

描述

LTRIM 从字符串表达式中删除前导空格，并将字符串作为 VARCHAR 类型返回。如果 为 ，则 返回 。如果 是一个完全由空格组成的字符串，则 返回空字符串 。

留下尾随空格；要删除尾随空格，请使用 。要删除任何类型的前导和/或尾随字符，请使用 TRIM。要使用前导空格或其他字符填充字符串，请使用 。要创建一串空白，请使用 。

请注意， 可用作 ODBC 标量函数（使用大括号语法）或 SQL 通用函数。

示例

以下嵌入式 SQL 示例从字符串中删除了五个前导空格。它留下五个尾随空白：

ClassMethod Ltrim()
{
	s a = "     Test string with 5 leading and 5 trailing spaces.     "
	&sql(
		SELECT {fn LTRIM(:a)} INTO :b
	)
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,"Before LTRIM",!,"start:",a,":end"
		w !,"After LTRIM",!,"start:",b,":end" 
	}
}

[toc]

第九十二章 SQL函数 LPAD

字符串函数，它返回一个左填充到指定长度的字符串。

大纲

LPAD(string-expression,length[,padstring])

参数

• string-expression - 字符串表达式，可以是列名、字符串文字、主机变量或另一个标量函数的结果。可以是可转换为 VARCHAR 数据类型的任何数据类型。字符串表达式不能是流。
• length - 一个整数，指定返回的字符串中的字符数。
• - 可选 — 由一个字符或一串字符组成的字符串，用于填充输入字符串表达式。 padstring 字符或字符附加到 string-expression 的左侧，以提供创建长度字符的输出字符串所需的尽可能多的字符。 可以是字符串文字、列、主机变量或另一个标量函数的结果。如果省略，则默认为空格字符。

描述

用前导填充字符填充字符串表达式。它返回填充到长度字符数的字符串的副本。如果字符串表达式的长度超过 个字符，则返回字符串被截断为 个字符。

如果 为 ，则 LPAD 返回 。如果 是空字符串 返回一个完全由填充字符组成的字符串。返回的字符串是 类型。

可用于针对链接表的查询。

不会删除前导或尾随空格；它填充字符串，包括任何前导或尾随空格。要在填充字符串之前删除前导或尾随空格，请使用 LTRIM、 或 。

大家好! 对于那些参加了2021年虚拟峰会的体验实验室的人来说，你可能还记得其中一个实验室会议是围绕Kubernetes进行的。我们现在已经将该实验室转换为完全线上按需使用。你可以启动一个小型的虚拟机集群，并按照练习来管理你的Kubernetes集群，将InterSystems IRIS容器部署到其中，并观察它在摧毁一个吊舱时的自我修复性质。

如果你有兴趣，这是一个很好的Kubernetes介绍。请看这里: 用InterSystems IRIS 和 Kubernetes实现高可用

第九十一章 SQL函数 LOWER

将字符串表达式中的所有大写字母转换为小写字母的大小写转换函数。

大纲

LOWER(string-expression)

参数

• string-expression - 要将其字符转换为小写的字符串表达式。表达式可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

描述

LOWER 函数将大写字母转换为小写字母以供显示。这是 UPPER 函数的逆函数。 LOWER 对非字母字符没有影响。它保留不变的标点符号、数字以及前导和尾随空格。

不强制将数字解释为字符串。 SQL 将数字转换为规范形式，删除前导零和尾随零。指定为字符串的数字不会转换为规范形式，并保留前导零和尾随零。

函数也可用于将大写字母转换为小写字母。

LOWER 对排序没有影响。 %SQLUPPER 函数是 SQL 中为不区分大小写的排序规则转换数据值的首选方法。

示例

以下示例以小写字母返回每个人的姓名：

SELECT Name,LOWER(Name) AS LowName
     FROM Sample.Person

也适用于 （非 ）字母字符，如以下嵌入式 SQL 示例所示，它将希腊字母从大写转换为小写：

/// d ##class(PHA.TEST.SQLFunction).Lower()
ClassMethod Lower()
{
	s a = $c(920, 913, 923, 913, 931, 931, 913)
	&sql(
		SELECT LOWER(:a)
			INTO :b
		FROM Sample.Person
	)
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,a,!,b 
	}
}

REST是一种架构风格，而不是一种格式。尽管REST经常使用HTTP来传输消息，使用JSON来传递数据，但你也可以用XML或纯文本来传递数据。REST利用了现有的网络标准，如HTTP、URL、XML和JSON。

虽然它可以使用XML来描述数据，但它更常使用JSON，这是一个轻量级的数据封装器。

InterSystems REST服务

InterSystems REST服务由以下组件组成：

规范类（%REST.Spec的一个子类）：这个类包含了REST服务的OpenAPI 2.0规范（Swagger）。InterSystems支持几个扩展属性，你可以在规范中使用。

调度类（%CSP.REST的一个子类）：这个类负责接收HTTP请求并在实现类中调用合适的方法。

实现类（%REST.Impl的子类）：这个类定义了实现REST调用的方法。

Web应用程序：它通过InterSystems Web Gateway提供对REST服务的访问。

使用API 管理工具创建REST服务 - 基于 OpenAPI 2.0规范

/api/mgmnt/

可以使用/api/mgmnt服务来创建、更新和删除REST服务。

1. 使用/api/mgmnt创建 .disp .impl 和 .