[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 和 .

众所周知，InterSystems IRIS的产品设计理念源于互操作性（Interoperable）、稳定性（Reliable）、直观（Intuitive）、可扩展性（Scalable），在云时代，InterSystems IRIS的云上操作与本地一样便捷，令用户体验有了明显提升。为了更高效地对InterSystems IRIS进行配置，我们还提供了哪些新特性？为了便捷地进行数据迁移，InterSystems IRIS最新版本提供了哪些解决方案？本期视频中，InterSystems中国销售工程师吕正之、马浩和WRC产品支持专家杨乐乐对此进行了解答。

假如在自动故障转移模式下，镜像集群中两个镜像都是实时同步的Failover角色，当备库因为主机故障或者网络隔离等因素导致不可用，那么主库就收不到备库的ACKs，这个时候我看官方文档的解释是，主库会在Qos时间超时后，撤销备库日志传输的Active状态，那么在这个Qos时间段里（默认是8秒），主库是不会提交任何新的日志，那么遇到那些需要写或者更新的应用，应用会不会卡住8秒不动？ 这对一个医院系统来说也是致命的。

希望哪位大神能为我解答一下，谢谢

translate

If in the automatic failover mode, the two images in the mirror cluster are both real-time synchronous failover roles. 
When the standby database is unavailable due to host failure or network isolation, 
the master database will not receive the acks of the standby database.

第九十章 SQL函数 LOG10

标量数值函数，它返回给定数值表达式的以 10 为底的对数。

大纲

{fn LOG10(expression)}

参数

• expression - 数值表达式。

LOG10 返回 NUMERIC 或 数据类型。如果表达式为 数据类型，则 返回 ；否则，它返回 。

描述

返回表达式的以 为底的对数值。LOG10 返回一个精度为 、小数位数为 的值。

只能用作 ODBC 标量函数（使用大括号语法）。

示例

以下示例返回整数的以 为底的对数：

SELECT {fn LOG10(5)} AS Log10

0.698970004336018805

以下嵌入式 SQL 示例返回整数 1 到 10 的以 为底的对数值：

/// d ##class(PHA.TEST.SQLFunction).Log10()
ClassMethod Log10()
{
	s a = 1
	while a < 11 {
		&sql(
			SELECT {fn LOG10(:a)} INTO :b
		)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE
			q 
		} else {
			w !,"Log-10 of ",a," = ",b
			s a = a + 1 
		}
	}
}

大家好!

InterSystems IRIS有一个叫做互操作性Interoperability的菜单。

它提供了轻松创建系统集成的机制（适配器、记录图、BPM、数据转换等），因此不同的系统可以轻松地连接起来。

在数据中继过程中可以包括各种操作，比如：为了连接那些通常不连接的系统，可以根据目的系统的规格要求来接收（或发送）数据。另外，在发送数据之前，可以从另一个系统获取和添加信息。以及，信息可以从数据库（IRIS或其他）获取和更新。

为此，我们会撰写一系列的文章，将讨论以下主题，同时看一下示例代码，以帮助你了解它是如何工作的，以及在用互操作性整合系统时需要什么样的开发。

* How it works 它是如何工作的
* What a Production is 什么是Production ?
* Message 消息
* Component Creation 组件的创建

* 1）Business Operations  业务操作

*2）Business Processes 业务流程
*3） Business Services 业务服务

  首先，介绍一下我们在这个系列中要使用的案例。

 一家经营着一个购物网站的公司，目前正在改变其产品信息的显示顺序，以配合季节的变化。 然而，有些商品无论在什么季节都能卖得很好，而有些商品却在意想不到的时候卖得很好，这与目前改变顺序的显示规则不相符。

第八十九章 SQL函数 LOG

返回给定数值表达式的自然对数的标量数值函数。

大纲

{fn LOG(expression)}

参数

• expression - 数值表达式。

LOG 返回 NUMERIC 或 数据类型。如果表达式为 数据类型，则 返回 ；否则，它返回 。

描述

返回表达式的自然对数（以 为底）。 LOG 返回一个精度为 、小数位数为 的值。

只能用作 ODBC 标量函数（使用大括号语法）。

示例

以下示例返回整数的自然对数：

SELECT {fn LOG(5)} AS Logarithm

1.609437912434100375

以下嵌入式 SQL 示例显示了整数 1 到 的 和 函数之间的关系：

请注意，此处需要 函数来纠正由系统计算限制引起的非常小的差异。在上面的示例中， 被任意设置为 12 位十进制数字。

/// d ##class(PHA.TEST.SQLFunction).Log()
ClassMethod Log()
{
	s a = 1
	while a < 11 {
		&sql(
			SELECT {fn LOG(:a)} INTO :b
		)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE 
			q 
		} else {
			w !,"Logarithm of ",a," = ",b 
		}
		&sql(
			SELECT ROUND({fn EXP(:b)},12) INTO :c
		)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE
			q 
		} else {
			w !,"Exponential of log ",b," = ",c
			s a = a + 1 
		}
	}
}

亲爱的社区开发者们，大家好！

欢迎积极参与新一轮InterSystems开发者竞赛！

🏆 InterSystems开发者竞赛：Globals 🏆

竞赛时间: 2022年3月21日-4月10日

奖金总额: $10,000

第八十八章 SQL函数 $LISTTOSTRING

从列表创建字符串的列表函数。

大纲

$LISTTOSTRING(list[,delimiter])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript 函数从现有列表中提取列表。
• - 可选 — 插入以分隔子字符串的分隔符。分隔符可以是一个或多个字符，指定为带引号的字符串。要连接不带分隔符的子字符串，请指定空字符串 。如果不指定分隔符，则默认为逗号 (,) 字符。

描述

$LISTTOSTRING 采用 列表并将其转换为字符串。在结果字符串中，列表的元素由分隔符分隔。

列表以不使用分隔符的编码格式表示数据。因此，列表可以包含所有可能的字符，并且非常适合位串数据。 将此列表转换为带有分隔元素的字符串。它留出一个指定的字符（或字符串）作为分隔符。可以使用 函数处理这些分隔元素。

注意：此处指定的分隔符不得出现在源数据中。 不区分用作分隔符的字符和用作数据字符的相同字符。

可以使用 $LISTTOSTRING 从串行容器字段中检索字段值作为分隔字符串。在以下示例中， 是一个串行容器字段。它包含列表元素 Home_Street

IRIS Healthtoolkit Service 软件即服务

轻松实现HL7v2 转 FHIR, CDA 转 FHIR, FHIR 转 HL7v2 即服务.

这个项目的目标是提供 REST API 可以轻松转化不同的医疗行业格式。 在Rest body 发布需要的格式，在答案中获得新的格式。

• InterSystems 消息转换公有云服务: https://aws.amazon.com/marketplace/pp/prodview-q7ryewpz75cq2

• 视频（油管） : https://youtu.be/lr2B7zSFkds

安装

克隆这个 repository

git clone https://github.com/grongierisc/iris-healthtoolkit-service.git

Docker

docker-compose up --build -d

使用

• 访问 : http://localhost:32783/swagger-ui/index.html

谈到开发体验，什么最重要？如何为客户提供更好的开发体验？InterSystems IRIS的最新版本有哪些新特性极大优化了用户的开发体验？这是本月“极客聊吧”的话题，我们计划通过上、下两期视频探讨这一话题。在第一期视频中（点击查看），InterSystems中国销售工程师吕正之、马浩和WRC产品支持专家杨乐乐针对以下两点分享了他们的观点：（1）开发语言的多样性与对FHIR的支持； （2）开发平台的前瞻性：对Smart Data Fabric架构的支持。

第八十七章 SQL函数 $LISTSAME

比较两个列表并返回布尔值的列表函数。

大纲

$LISTSAME(list1,list2)

参数

• list1 - 计算结果为有效列表的表达式。
• list2 - 计算结果为有效列表的表达式。

描述

$LISTSAME 比较两个列表的内容，如果列表相同则返回 。如果列表不相同，则 返回 。 逐个元素地比较两个列表。对于两个相同的列表，它们必须包含相同数量的元素，并且 中的每个元素必须与 中的相应元素匹配。

使用它们的字符串表示来比较列表元素。 比较区分大小写。 $LISTSAME 按从左到右的顺序逐个元素地比较两个列表。因此， 在遇到第一个不匹配的列表元素对时返回值 ；它不检查后续项目以确定它们是否是有效的列表元素。

此函数返回 类型的数据。

参数

list (list1 and list2)

列表是包含一个或多个元素的编码字符串。可以使用 SQL 函数或 ObjectScript 函数创建列表。可以使用 SQL 函数或 ObjectScript 函数将分隔字符串转换为列表。可以使用 SQL 函数或 ObjectScript 函数从现有列表中提取列表。

以下是有效列表的示例：

• $LISTBUILD('a','b','c')：一个三元素列表。
• $LISTBUILD('a','','c')

第八十六章 SQL函数 $LISTLENGTH

返回指定列表中元素数量的列表函数。

大纲

$LISTLENGTH(list)

参数

• list- 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。您可以使用 SQL 或 ObjectScript 函数从现有列表中提取列表。

描述

$LISTLENGTH 返回列表中元素的数量。

此函数返回 SMALLINT 类型的数据。

示例

以下嵌入式 SQL 示例返回 ，因为列表中有 3 个元素：

/// d ##class(PHA.TEST.SQLFunction).ListLength()
ClassMethod ListLength()
{
	s a = $lb("Red", "Blue", "Green")
	&sql(
		SELECT $LISTLENGTH(:a) INTO :b
	)
	if SQLCODE '= 0 {
		w !,"Error code;",SQLCODE 
	} else {
		w !,"The number of elements is ",b 
	}
}

DHC-APP> d ##class(PHA.TEST.SQLFunction).ListLength()
 
The number of elements is 3

第八十五章 SQL函数 $LISTGET

返回列表中的元素或指定默认值的列表函数。

大纲

$LISTGET(list[,position[,default]])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript 函数从现有列表中提取列表。
• - 可选 — 解释为指定列表中的位置的表达式。
• - 可选 — 如果列表元素具有未定义的值，则该表达式提供要返回的值。

描述

将指定列表中的请求元素作为标准字符串返回。如果位置参数的值引用不存在的成员或标识具有未定义值的元素，则返回指定的默认值。

函数与 函数的单参数和双参数形式相同，只是在导致 $LIST 返回空字符串的条件下， 返回默认值。

此函数返回 类型的数据。

可以使用 从串行容器字段中检索字段值。在以下示例中， 是一个串行容器字段，其第三个元素是 Home_State：

SELECT Name,$LISTGET(Home,3) AS HomeState
FROM Sample.Person

参数

list

包含一个或多个元素的编码字符串。可以使用 SQL 函数或 ObjectScript 函数创建列表。

第八十四章 SQL函数 $LISTFROMSTRING

从字符串创建列表的列表函数。

大纲

$LISTFROMSTRING(string[,delimiter])

参数

• string - 要转换为 列表的字符串。此字符串包含一个或多个元素，由分隔符分隔。分隔符不会成为生成的列表的一部分。
• delimiter - 可选 — 用于分隔字符串中的子字符串（元素）的分隔符。将分隔符指定为带引号的字符串。如果未指定分隔符，则默认为逗号 (,) 字符。

描述

$LISTFROMSTRING 接受一个包含分隔元素的带引号的字符串并返回一个列表。列表以不使用分隔符的编码格式表示数据。因此，列表可以包含所有可能的字符，并且非常适合位串数据。使用 ObjectScript 和 SQL $LIST 函数处理列表。

参数

string

字符串文字（用单引号括起来）、数字或计算结果为字符串的变量或表达式。此字符串可以包含一个或多个子字符串（元素），由分隔符分隔。字符串数据元素不得包含分隔符（或字符串），因为分隔符不包含在输出列表中。

delimiter

用于在输入字符串中分隔子字符串的字符（或字符串）。它可以是数字或字符串文字（括在单引号中）、变量的名称或计算结果为字符串的表达式。

通常，定界符是在字符串数据中从不使用的指定字符，但仅用作分隔子字符串的定界符。定界符也可以是多字符串，其中的各个字符可以在字符串数据中使用。

来自奥兰多的报道，Epic公司的医生Jackie Gerhart博士在HIMSS22上讨论了电子病历的庞大研究数据库及其发现如何形成个人服务。

新冠疫情的发生证明了随时获取数据的重要性。在未知的病毒海洋中，全人群的分析有助于为公共卫生官员、医疗服务供应商和患者提供洞察力。 

现在，在Epic公司从事临床信息学工作的医生Jackie Gerhart说，这家全球领先的电子病历厂商正在希望帮助临床医生使用数据来形成个性化患者服务。 

Gerhart在HIMSS22会议上与《医疗保健IT新闻》坐下来讨论了Epic广泛的病人数据库、Epic研究结果以及其即将推出的 "我的病人的最佳护理（Best Care for My Patient "工具如何向临床医生展示全国各地的最有效实践。

问： 作为一名医生，你是如何帮助Epic形成产品的？

答： 我们的作用是，第一，帮助软件的研究和开发；第二，新的面向未来的项目，使得相关的数据和分析可以在护理节点或未来的研究中使用。  

然后，我们还与我们目前的医疗机构合作，确保他们得到真正好的客户经验。例如，你可能在不同的头条新闻中看到，临床医生不喜欢他们的电子病历，或者就像众所周知的，"哦，我的上帝，我还得在晚上做这个。

我就一个问题,InterSystems IRIS 怎么用，我就想创建一个数据库（也不知道是不是cache），然后通过jdbc url 连接，找了一个星期的文档，不知道jdbc url 是什么，完全靠猜，别跟我说文档，没有一个靠谱的

第八十三章 SQL函数 $LISTFIND

列表函数，用于在指定列表中搜索请求的值。

大纲

$LISTFIND(list,value[,startafter])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。可以使用 SQL 或 ObjectScript 函数从现有列表中提取列表。
• - 包含搜索元素的表达式。一个字符串。
• - 可选 — 解释为列表位置的整数表达式。搜索从该位置之后的元素开始。0和 –1 是有效值； 从不返回元素。零是默认值。

描述

在指定列表中搜索请求值的第一个实例。搜索从 参数指示的位置之后的元素开始。如果省略 参数，则 假定 值为 并从第一个元素（元素 ）开始搜索。如果找到该值，则 返回匹配元素的位置。如果未找到该值，则 返回 。如果 参数的值引用不存在的列表成员，则 函数也将返回 。

此函数返回 类型的数据。

示例

以下嵌入式 SQL 示例返回 ，即请求字符串第一次出现的位置：

/// d ##class(PHA.TEST.SQLFunction).ListFind()
ClassMethod ListFind()
{
	s a = $lb("Red","Blue","Green")
	&sql(
		SELECT $LISTFIND(:a, 'Blue') INTO :b
	)
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,"The position is ",b 
	}
}

因为最近再研究Cache，发现Cache安装程序官方上找不到了，又从一个帖子上看到Cache安装程序在WRC上面有，话说这个WRC账号是不是类似于Oracle的MOS账号？

我从官网机器人那得到指示给support@intersystems.com发邮件，可能是因为塑料英语，石沉大海了。另外我想问问这个账号是不是只对那些买了产品或服务的客户单位公开？

请哪位大神为我指点迷津，谢谢

现在我们院区也遇到这样一个问题。关于cache的高可用架构现有有两个方案：

1.选择双节点的完全无共享架构的自动转移镜像集群外加一个灾难恢复镜像

2.就像你提问的那种，两台主机先做Rose HA用一套双活存储实现高可用，然后再弄一台服务器做Rose HA的单机镜像（有可能是同步也有可能是异步那种比如灾难恢复镜像）

现在想问问如果单纯考虑切换时候对业务的影响，如果切换的中断时长什么的，用哪个最好啊？第二种方案真有很多单位用么？

希望有大神能替我解答一下，谢谢。

谈到开发体验，什么最重要？如何为客户提供更好的开发体验？InterSystems IRIS的最新版本有哪些新特性极大优化了用户的开发体验？这是本月“极客聊吧”聚焦的话题，我们将通过上、下两期视频进行探讨。在本期视频中，InterSystems中国销售工程师吕正之、马浩和WRC产品支持专家杨乐乐针对以下两点进行了分享：（1）开发语言的多样性与对FHIR的支持；（2）探讨开发平台的前瞻性：对Smart Data Fabric架构的支持。

无法下载老版本的cache，请问哪位可以分享下安装包

第八十二章 SQL函数 $LISTDATA

列表函数，指示指定元素是否存在并具有数据值。

大纲

$LISTDATA(list[,position])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。您可以使用 SQL 或 ObjectScript 函数从现有列表中提取列表。
• - 可选 — 指定列表中元素的整数表达式。

描述

$LISTDATA 检查列表中请求元素中的数据。如果位置参数指示的元素在列表中并且具有数据值，则 返回值 1。如果元素不在列表中或没有数据值，则 返回值 0。

此函数返回 类型的数据。

参数

list

包含一个或多个元素的编码字符串。可以使用 SQL 函数或 ObjectScript $LISTBUILD 函数创建列表。可以使用 SQL 函数或 ObjectScript 函数将分隔字符串转换为列表。可以使用 SQL $LIST 函数或 ObjectScript 函数从现有列表中提取列表。

position

如果省略 参数， 将计算第一个元素。如果 参数的值为 ，则相当于指定列表的最后一个元素。如果 参数的值引用了一个不存在的列表成员，则 返回 。

这篇文章的目的是为了说明如何使用互操作菜单实现系统集成。

图片左侧窗口是接受外部系统发送信息的窗口。

信息接收方式种类很多，如定时监控指定目录来读取文件，定期查询数据库，输入且等待信息输出，或直接调用其他应用程序系统传送信息。

在系统集成配置中创建IRIS 互操作性菜单，接收到存储在一个对象中的信息被称为一条消息message（以下统称为消息）。消息被发送到组件component （以下统称为组件）中做后续处理。

使用所有接收到的信息或仅使用其中的一部分就能用来创建消息。

假设您要将信息中包含的消息发送给外部系统。这种情况下，需要将该消息发送给负责请求外网处理的组件（图右侧）。接收到消息的组件会请求外部系统对其进行处理。

此外，假设一条消息需要人工审查、数据转换或数据附加。这种情况下，消息会被发送到图表中间的业务流程管理组件（BPM），该组件负责协调处理流程。

消息用于在每个组件之间发送和接收数据。当发送或接收消息时，消息会被自动存储在数据库中。

由于消息存储在数据库中，因此在数据转换前后可以检查其差异性。在操作期间，或过程中间重新开始（重新发送），可以检查作为问题根源的消息。在开发、测试和操作的每个阶段可以验证正在使用的消息状态。

一个简单的系统集成图将分为三个部分（业务服务、业务流程和业务操作），如下图所示。

第八十一章 SQL函数 $LISTBUILD

从字符串构建列表的列表函数。

大纲

$LISTBUILD(element [,...])

参数

• element - 任何表达式，或逗号分隔的表达式列表

描述

$LISTBUILD 接受一个或多个表达式，并为每个表达式返回一个包含一个元素的列表。

以下函数可用于创建列表：

• $LISTBUILD，它从多个字符串创建一个列表，每个元素一个字符串。
• $LISTFROMSTRING，它从包含多个分隔元素的单个字符串创建一个列表。
• $LIST，从现有列表中提取子列表。

与其他 SQL 列表函数一起使用：、$LISTDATA、、、、 和 。

注意： 和其他 函数使用优化的二进制表示来存储数据元素。出于这个原因，等效性测试可能无法对某些 数据按预期工作。在其他情况下可能被视为等效的数据可能具有不同的内部表示。例如， 不等于 。

出于同样的原因， 返回的列表字符串值不应用于使用分隔符的字符搜索和解析函数，例如 和 $LENGTH 的两个参数形式。由 创建的列表中的元素不使用字符分隔符进行标记，因此可以包含任何字符。

示例

以下嵌入式 SQL 示例采用三个字符串并生成一个三元素列表：

DHC-APP>d ##class(PHA.TEST.SQLFunction).Lb()
RedWhiteBlue length 3

第八十章 SQL函数 $LIST（二）

示例

在以下嵌入式 SQL 示例中，两个 WRITE 语句都返回“Red”，即列表中的第一个元素。第一个默认写入第一个元素，第二个写入第一个元素，因为位置参数设置为 1：

/// d ##class(PHA.TEST.SQLFunction).Li4()
ClassMethod Li4()
{
	s a = $lb("Red", "Blue", "Green")
	&sql(SELECT $LIST(:a), $LIST(:a,1)
		INTO :b,:c )
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,"The one-arg sublist is ",b
		w !,"The two-arg sublist is ",c }
}

DHC-APP>d ##class(PHA.TEST.SQLFunction).Li4()
 
The one-arg sublist is Red
The two-arg sublist is Red

以下嵌入式 SQL 示例返回列表中的第二个元素：

/// d ##class(PHA.TEST.SQLFunction).Li5()
ClassMethod Li5()
{
	s a = $lb("Red", "Blue", "Green")
	&sql(
		SELECT $LIST(:a,2)
		INTO :b 
	)
	if SQLCODE '= 0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,"The second element is ",b 
	}
}