第八十七章 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

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

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

我就一个问题,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的单机镜像（有可能是同步也有可能是异步那种比如灾难恢复镜像）

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

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

无法下载老版本的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

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

第八十一章 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 
	}
}

第七十九章 SQL函数 $LIST（一）

返回列表中元素的列表函数。

大纲

$LIST(list[,position[,end]])

参数

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

描述

从列表中返回元素。返回的元素取决于使用的参数。

• $LIST(list) 将列表中的第一个元素作为文本字符串返回。
• $LIST(list,position) 将指定位置指示的元素作为文本字符串返回。位置参数必须计算为整数。
• $LIST(list,position,end) 返回一个“子列表”（编码的列表字符串），其中包含从指定开始位置到指定结束位置的列表元素。

此函数返回 类型的数据。

参数

list

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

在Linux上设置TZ环境变量

v2015.1的更新检查表建议在Linux平台上设置TZ环境变量，并指出了tzset的手册。建议这样做是为了提高Caché的时间相关功能的性能。你可以在下文找到更多关于这个的信息:

Linux TZ环境变量未被设置以及对Caché的影响

我的CentOS 7测试系统上的manpage（RHEL 6也是这样说的）有这样的说法。

"tzset()函数从TZ环境变量初始化tzname变量。   这个函数会被其他依赖时区的时间转换函数自动调用"。

那么，你如何设置TZ？它是如何影响Linux服务器上的时间的？让我们来看看我们能学到什么:

在最近的大规模基准测试活动中，我们看到过多的%sys CPU时间，对应用程序的扩展产生了负面影响。

问题

我们发现，由于TZ环境变量没有被设置，很多时间都花在了localtime()系统调用上。 我们创建了一个简单的测试程序来证实这一观察结果，设置了TZ与未设置TZ的时间差和所需的CPU资源都是惊人的。 我们发现，当TZ没有设置时，从localtime()继承使用stat()系统调用到/etc/local_time是成本很高。

第七十八章 SQL函数 $LENGTH

返回字符串中字符数或分隔子字符串数的字符串函数。

大纲

$LENGTH(expression[,delimiter])

参数

• expression - 目标字符串。它可以是数值、字符串文字、任何变量的名称或任何有效的表达式。
• delimiter - 可选 — 在目标字符串中划分不同子字符串的字符串。它必须是字符串文字，但可以是任意长度。括起来的引号是必需的。

$LENGTH 返回 数据类型。

描述

返回指定字符串中的字符数或指定字符串中的子字符串数，具体取决于使用的参数。

• $LENGTH(expression) 返回字符串中的字符数。如果表达式为空字符串 ('')，则 $LENGTH 返回 。如果表达式为 ，则 返回 。
• 返回字符串中子字符串的数量。 返回由指定分隔符相互分隔的子字符串的数量。此数字始终等于在表达式字符串中找到的分隔符实例的数量加一。

$LENGTH(expression) 和其他长度函数

和其他长度函数（、CHARACTER_LENGTH、 和

第七十七章 SQL函数 LENGTH

返回字符串表达式中字符数的字符串函数。

大纲

LENGTH(string-expression)

{fn LENGTH(string-expression)}

参数

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

LENGTH 返回 INTEGER 数据类型。

描述

返回一个整数，表示给定字符串表达式的字符数，而不是字节数。字符串表达式可以是字符串（从中删除尾随空格）或数字（ IRIS 将其转换为规范形式）。

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

LENGTH 和其他长度函数（、CHARACTER_LENGTH、 和 ）都执行以下操作：

• 返回字段的逻辑（内部数据存储）值的长度，而不是显示值，无论 设置如何。所有 SQL 函数始终使用字段的内部存储值。
• LENGTH 返回数字的规范形式的长度。规范形式的数字不包括前导零和尾随零、前导符号（单个减号除外）和尾随小数分隔符。 返回数字字符串的字符串长度。数字字符串不会转换为规范形式。
• 不排除字符串中的前导空格。可以使用 函数从字符串中删除前导空格。

在执行以下操作时， 与其他长度函数（、、 和

3.1 InterSystems IRIS内码与多语言支持

3.1.1 InterSystems IRIS内码与字符集转换

InterSystems IRIS的内码是UTF-16，因此它支持Unicode多语言字符集。对于其它字符编码，例如UTF-8、GB18030、Big 5，它会自动进行转码。例如对于简体中文，它将GB18030输入数据转换为UTF-16，或者将UTF-16数据转换为GB18030输出。

第七十六章 SQL函数 LEN

返回字符串表达式中字符数的字符串函数。

大纲

LEN(string-expression)

参数

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

LEN 返回 INTEGER 数据类型。

描述

注意： 函数是 函数的别名。

SELECT len("yaoxin")  

6

第七十五章 SQL函数 LEFT

标量字符串函数，返回从字符串表达式的开始(最左位置)开始的指定数量的字符。

大纲

{fn LEFT(string-expression,count)}

参数

• string-expression - 字符串表达式，它可以是列的名称、字符串字面值或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型(如CHAR或VARCHAR)。
• - 整数，指定从字符串表达式的起始位置返回的字符数。

描述

LEFT返回从字符串开始的指定字符数。 不填充字符串; 如果指定的字符数大于字符串中的字符数，则返回该字符串。 如果传递给任何一个参数一个值，左返回。

只能用作ODBC标量函数(使用花括号语法)。

示例

以下示例返回 表中每个名称的最左边的七个字符：

SELECT Name,{fn LEFT(Name,7)}AS ShortName
     FROM Sample.Person

以下嵌入式 SQL 示例显示了 LEFT 如何处理比字符串本身长的计数：

/// d ##class(PHA.TEST.SQLCommand).Left()
ClassMethod Left()
{
	&sql(
		SELECT Name,{fn LEFT(Name,40)}
		INTO :a,:b
		FROM Sample.Person
	)
	if SQLCODE'=0 {
		w !,"Error code ",SQLCODE 	
	} else {
		w !,a,"=original",!,b,"=LEFT 40" }
}

万能的社区我在cache中创建一个视图时遇到了麻烦，其查询方式为:

SELECT column1, column2, column 3
    FROM  table
    WHERE
        (column1, columnn 2) IN (SELECT c1, c2 FROM table2 GROUP BY c1)
    ORDER BY column1

我认为问题出在where子句上，因为它不能取两列: .

具体错误信息为: [SQLCODE: <-1>:<Invalid SQL statement>] [%msg: < ) expected, , found^ (column1,>]

请问如何解决? 谢谢！

第七十四章 SQL函数 LEAST

从一系列表达式中返回最小值的函数。

大纲

LEAST(expression,expression[,...])

参数

• expression - 解析为数字或字符串的表达式。 将这些表达式的值相互比较，并返回最小值。 表达式可以是字段名、文字、算术表达式、主机变量或对象引用。 最多可以列出140个逗号分隔的表达式。

描述

LEAST从逗号分隔的表达式序列中返回最小值。 表达式按从左到右的顺序求值。 如果只提供一个表达式，则LEAST返回该值。 如果任何表达式为, 返回。

如果所有表达式值都解析为规范数，则按数值顺序对它们进行比较。 如果引用的字符串包含规范格式的数字，则按数字顺序对其进行比较。 但是，如果引用的字符串包含非规范格式的数字(例如，、或'+4')，则将其作为字符串进行比较。 字符串比较按排序顺序逐字符执行。 任何字符串值都大于任何数字值。

空字符串大于任何数字值，但小于任何其他字符串值。

如果返回值是一个数字，将以规范格式返回它(删除前导和末尾的零，等等)。 如果返回值是一个字符串，将不改变返回值，包括任何开头或结尾的空格。

LEAST返回逗号分隔的一系列表达式中的最小值。 返回逗号分隔的一系列表达式中的最大值。 COALESCE返回逗号分隔的一系列表达式中的第一个非值。

返回值数据类型

第七十三章 SQL函数 LCASE

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

大纲

LCASE(string-expression)

{fn LCASE(string-expression)}

参数

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

描述

LCASE将大写字母转换为小写字母用于显示。 它对非字母字符没有影响。 它保留没有改变的标点符号以及前导和末尾的空格。

LCASE不强制将数字解释为字符串。 将数字转换为规范形式，删除前导和后导零。 SQL不将数字字符串转换为规范形式。

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

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

示例

下面的例子以小写字母返回每个人的名字:

SELECT TOP 10 Name,{fn LCASE(Name)} AS LowName
     FROM Sample.Person

也适用于(非ascii)字母字符，如下面的嵌入式SQL示例所示，它将希腊字母从大写转换为小写:

/// d ##class(PHA.TEST.SQLCommand).LCase()
ClassMethod LCase()
{
	s a = $CHAR(920,913,923,913,931,931,913)
	&sql(
		SELECT LCASE(:a) INTO :b 
	)
	if SQLCODE'=0 {
		w !,"Error code ",SQLCODE 
	} else {
		w !,a,!,b 
	}
}

第七十二章 SQL函数 LAST_IDENTITY

返回最后插入、更新、删除或读取的行的标识的标量函数。

大纲

LAST_IDENTITY()

描述

LAST_IDENTITY函数返回%ROWID局部变量值。在嵌入式或中将局部变量设置为一个值。动态SQL、SQL Shell或管理门户SQL界面未将局部变量设置为值。动态SQL改为设置对象属性。

函数不接受任何参数。请注意，参数括号是必需的。

返回受当前进程影响的最后一行的标识字段值。如果表没有标识字段，则返回受当前进程影响的最后一行的行ID(%ROWID)。返回值为数据类型INTEGER。

• 对于嵌入式SQL INSERT、UPDATE、或语句，返回最后修改的行的或值。
• 对于嵌入式SQL基于游标的语句，返回检索到的最后一行的或值。但是，如果基于游标的语句包括关键字或子句，则不会更改；它将返回其先前的值(如果有)。
• 对于嵌入式SQL单行(非游标)语句，不会更改。返回先前的值(如果有)。

在进程启动时，返回。在新的之后，返回。

如果没有行受操作影响，则不会更改；返回其先前的值(如果有)。在新的之后，调用返回，但调用会生错误。

示例

以下示例使用两个嵌入式SQL程序返回。第一个示例创建一个新表，第二个示例使用数据填充该表，然后对数据执行基于游标的SELECT，并为每个操作返回。

请按显示的顺序运行这两个嵌入式SQL程序。

第七十一章 SQL函数 LAST_DAY

日期函数，它为日期表达式返回一个月的最后一天的日期。

大纲

LAST_DAY(date-expression)

参数

• date-expression - 表达式，它是列的名称、另一个标量函数的结果或日期或时间戳文字。

描述

LAST_DAY以整数形式返回指定月份的最后一天，格式为$HOROLOG。 计算闰年差异，包括世纪日调整:是闰年，和不是闰年。

日期表达式可以是一个日期整数、一个或值、一个ODBC格式的日期字符串或一个时间戳。

日期表达式时间戳可以是数据类型%Library.PosiTime(编码的64位有符号整数)或数据类。

字符串的时间部分是可选的。

指定无效日期时，返回0(显示模式为12/31/1840)：日或月为零；大于12的月；或大于当年该月天数的日。年份必须在到之间。

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

  WRITE $SYSTEM.SQL.Functions.LASTDAY("2018-02-22"),!
  WRITE $SYSTEM.SQL.Functions.LASTDAY(64701)

示例

以下示例将该月的最后一天作为日期整数返回。该值是显示为整数还是日期字符串取决于当前的SQL显示模式设置。

以下两个示例都返回数字(对应于

第七十章 SQL函数 $JUSTIFY

在指定宽度内右对齐值的函数，可以选择舍入到指定的小数位数。

大纲

$JUSTIFY(expression,width[,decimal])

参数

• expression - 要右对齐的值。它可以是数字值、字符串文字或解析为数字或字符串的表达式。
• width - 表达式要在其中右对齐的字符数。正整数或计算结果为正整数的表达式。
• decimal - 可选-小数位数。正整数或计算结果为正整数的表达式。将表达式中的小数位数四舍五入或填充到此值。如果指定DECIMAL，会将表达式视为数字。

描述

返回在指定宽度内右对齐的表达式指定的值。可以包括小数参数以在宽度内小数对齐数字。

• $JUSTUST(expression,width)：双参数语法在宽度内右对齐表达式。它不执行任何表达式转换。该表达式可以是数字字符串，也可以是非数字字符串。
• ：3参数语法将表达式转换为规范数字，将小数位四舍五入或零填充为小数，然后在宽度内右对齐生成的数值。如果表达式是非数字字符串或NULL，会将其转换为0，填充，然后右对齐。

$JUSTIFY识别当前区域设置的字符。 它根据需要添加或删除DecimalSeparator字符。 字符取决于区域设置; 通常，美式格式的语言环境使用句号()，欧式格式的语言环境使用逗号()。 要为区域设置确定

好人不需要规则。

神秘博士

要成为日期和时间的主人并不是一件容易的事，在任何编程语言中，这总是一个问题，有时会让人感到困惑，我们将澄清并提出一些提示，使这项任务尽可能简单。

坐上TARDIS，我将把你变成一个时间领主。

第六十九章 SQL函数 JSON_OBJECT

将数据作为JSON对象返回的转换函数。

大纲

JSON_OBJECT(key:value [,key:value][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• key:value - 键：值对或逗号分隔的键：值对列表。键是由单引号分隔的用户指定的文字字符串。值可以是列名、聚合函数、算术表达式、数字或字符串文字或文字NULL。
• ABSENT ON NULL - 可选-指定如何在返回的JSON对象中表示空值的关键字短语。(缺省值)表示带有单词(未引号)的(缺少)数据。在上缺失将从对象中省略数据；当为且不保留占位符逗号时，它将删除对。此关键字短语对空字符串值没有影响。

描述

接受逗号分隔的键：值对列表(例如，)，并返回包含这些值的JSON对象。可以指定任何单引号字符串作为键名；不强制任何命名约定或对键名进行唯一性检查。可以为值指定列名或其他表达式。

可以在语句中与其他类型的SELECT-Items结合使用。可以在可以使用SQL函数的其他位置指定，例如在子句中。

返回的对象格式如下：

{ "key1" : "value1" , "key2" : "value2" , "key3" : "value3" }

第六十八章 SQL函数 JSON_ARRAY

以JSON数组形式返回数据的转换函数。

大纲

JSON_ARRAY(expression [,expression][,...] [NULL ON NULL | ABSENT ON NULL])

参数

• expression - 表达式或逗号分隔的表达式列表。这些表达式可以包括列名、聚合函数、算术表达式、文字和文字NULL。
• ABSENT ON NULL - 可选-指定如何在返回的JSON数组中表示空值的关键字短语。(缺省值)表示带有单词(未引号)的(缺少)数据。在上不存在将从数组中省略空数据；它不会保留占位符逗号。此关键字短语对空字符串值没有影响。

描述

接受表达式或(更常见的)逗号分隔的表达式列表，并返回包含这些值的数组。可以在语句中与其他类型的结合使用。可以在可以使用SQL函数的其他位置指定，例如在子句中。

返回的数组格式如下：

[ element1 , element2 , element3 ]

Json_array以字符串(用双引号括起来)或数字形式返回每个数组元素值。数字以规范格式返回。数字字符串以文字形式返回，用双引号括起来。所有其他数据类型(例如，或)都作为字符串返回。

不支持将星号()语法作为指定表中所有字段的方式。它支持COUNT(*)聚合函数。

返回的数组列被标记为表达式(默认情况下)；可以为指定列别名。

第六十七章 SQL函数 ISNUMERIC

测试有效数字的数值函数。

大纲

ISNUMERIC(check-expression)

参数

• check-expression - 要计算的表达式。

ISNUMERIC返回SMALLINT数据类型。

描述

计算并返回下列值之一：

• 如果check表达式是有效数字，则返回1。有效数字可以是数字表达式，也可以是表示有效数字的字符串。
  • 数值表达式首先转换为规范形式，解析多个前导符号；因此，诸如+-+34这样的数值表达式是有效的数字。
  • 在求值之前不会转换数字字符串。数字字符串最多只能有一个前导符号才能计算为有效数字。带有尾随小数点的数字字符串的计算结果为有效数字。
• 如果check-expression不是有效数字，则返回0。任何包含非数字字符的字符串都不是有效数字。具有多个前导符号的数字字符串(如)不会被计算为有效数字。编码列表始终返回0，即使其元素是有效数字也是如此。空字符串返回0。
• 如果为，则返回。返回。

如果科学记数法指数大于308(308-(整数数))，会生成，指数超出范围错误。例如，和都会生成此错误代码。如果小于或等于的指数数字字符串返回1，则大于的指数数字字符串返回0。

函数与ObjectScript 函数非常相似。但是，当输入值为NULL时，这两个函数返回不同的值。

示例