第139章 SQL函数 TIMESTAMPDIFF

一个标量日期/时间函数，它返回指定日期部分的两个时间戳之间差异的整数计数。

大纲

{fn TIMESTAMPDIFF(interval-type,startdate,enddate)}

参数

• interval-type - 返回值将表示的时间/日期间隔类型。
• startdate - 时间戳值表达式。
• enddate - 将与 startdate 进行比较的时间戳值表达式。

描述

TIMESTAMPDIFF 函数返回指定日期部分间隔（秒、天、周等）的两个给定时间戳之间的差异（即，从另一个中减去一个时间戳）。返回的值是一个 INTEGER，即两个时间戳之间的这些间隔数。 （如果 enddate 早于 startdate，则 TIMESTAMPDIFF 返回负 INTEGER 值。）

开始日期和结束日期是时间戳。这些时间戳可以是 %Library.TimeStamp 数据类型格式 (yyyy-mm-dd hh:mm:ss.ffff) 或 %Library.PosixTime 数据类型格式（编码的 64 位有符号整数）。

第138章 SQL函数 TIMESTAMPADD

一个标量日期/时间函数，它返回一个新的时间戳，该时间戳是通过将指定日期部分的多个间隔添加到时间戳来计算的。

大纲

{fn TIMESTAMPADD(interval-type,integer-exp,timestamp-exp)}

参数

• interval-type - integer-exp 表示的时间/日期间隔类型，指定为关键字。
• integer-exp - 要添加到 timestamp-exp 的整数值表达式。
• timestamp-exp - 时间戳值表达式，将增加 integer-exp 的值。

描述

TIMESTAMPADD 函数通过将指定的日期部分增加指定的单位数来修改日期/时间表达式。例如，如果 interval-type 是 SQL_TSI_MONTH 并且 integer-exp 是 5，则 TIMESTAMPADD 将 timestamp-exp 增加五个月。还可以通过为 integer-exp 指定负整数来减少日期部分。

TIMESTAMPADD 返回与输入timestamp-exp 数据类型相同的时间戳。此时间戳可以是 %Library.TimeStamp 数据类型格式 (yyyy-mm-dd hh:mm:ss.ffff) 或 %Library.PosixTime 数据类型格式（编码的 64 位有符号整数）。

第137章 SQL函数 TAN

标量数值函数，返回角度的正切（以弧度为单位）。

大纲

{fn TAN(numeric-expression)}

参数

• numeric-expression - 一个数值表达式。这是一个以弧度表示的角度。

TAN 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 TAN 返回 DOUBLE；否则，它返回 NUMERIC。

描述

TAN 接受任何数值并返回其切线。如果传递 NULL 值，TAN 返回 NULL。 TAN 将非数字字符串视为数值 0。

TAN 返回一个精度为 36、比例为 18 的值。

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

可以使用 DEGREES 函数将弧度转换为度数。可以使用 RADIANS 函数将度数转换为弧度。

示例

以下示例显示了 TAN 的效果。

SELECT {fn TAN(0.52)} AS Tangent 


0.572561830251668415

第136章 SQL函数 SUBSTRING

字符串函数，它从任何数据类型的数据（包括流数据）中返回一个子字符串。

大纲

SUBSTRING(string-expression,start[,length])

SUBSTRING(string-expression FROM start [FOR length])

{fn SUBSTRING(string-expression,start[,length])}

参数

• string-expression - 要从中派生子字符串的字符串表达式。表达式，可以是列名、字符串文字或另一个标量函数的结果。字段可以是任何数据类型：字符串（例如 CHAR 或 VARCHAR）、数字或数据类型为 %Stream.GlobalCharacter 或 %Stream.GlobalBinary 的数据流字段。
• start - 一个整数，它指定 string-expression 中开始子字符串的位置。 string-expression 中的第一个字符位于位置 1。如果起始位置高于字符串的长度，则 SUBSTRING 返回一个空字符串 。如果起始位置小于 1（零或负数），则子字符串从位置 1 开始，但子字符串的长度会减少起始位置。
• length - 可选 — 一个整数，指定要返回的子字符串的长度。如果未指定长度，则默认返回字符串的其余部分。

第135章 SQL函数 SUBSTR

返回从指定字符串表达式派生的子字符串的字符串函数。

大纲

SUBSTR(string-expression,start[,length])

参数

• string-expression - 要从中派生子字符串的字符串表达式。表达式可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。
• start - 一个整数，它指定子字符串在字符串表达式中的开始位置。正的起始位置指定从字符串开头开始的字符数。 string-expression1 中的第一个字符位于位置 1。负起始位置指定从字符串末尾算起的字符数。如果 start 为 0（零），则将其视为 1。
• length - 可选 — 一个正整数，指定要返回的子字符串的长度。此值指定子字符串在起始位置右侧结束长度字符。如果省略，则子字符串从字符串表达式的开头到结尾。如果长度为 0 或负数， 返回 NULL。

描述

因为 start 可以是负数，所以可以从原始字符串的开头或结尾获取子字符串。

作为参数传递给 SUBSTR 的浮点数通过截断小数部分转换为整数。

• 如果 start 为 0、–0 或 1，则返回的子字符串从字符串的第一个字符开始。
• 如果 start 是负数，则返回的子字符串从字符串末尾开始该数量的字符，-1 表示字符串的最后一个字符。

第134章 SQL函数 STUFF

字符串函数，用于替换字符串中的子字符串。

大纲

STUFF(string,start,length,substring)

参数

• string - 作为子字符串替换目标的字符串表达式。
• start - 替换的起点，指定为正整数。从字符串开头开始的字符数，从 1 开始计数。允许的值为 0 到字符串的长度。要追加字符，请指定 0 的开头和 0 的长度。空字符串或非数字值被视为 0。
• length - 要替换的字符数，指定为正整数。要插入字符，请将长度指定为 0。要在开始后替换所有字符，请指定大于现有字符数的长度。空字符串或非数字值被视为 0。
• substring - 一个字符串表达式，用于替换由其起始点和长度标识的子字符串。可以比它替换的子字符串更长或更短。可以是空字符串。

描述

STUFF 用另一个子字符串替换一个子字符串。它标识要替换为位置和长度的子字符串，并将其替换为子字符串。

此函数提供与 Transact-SQL 实现的兼容性。

替换子字符串可能比原始值长或短。要删除原始值，子字符串可以是空字符串 ('')。

起始值必须在字符串的当前长度范围内。您可以通过指定起始值 0 将子字符串附加到字符串的开头。空字符串或非数字值被视为 0。

为 start、length 或 substring 参数指定 NULL 将返回 NULL。

STUFF 不能将 %Stream.

第133章 SQL函数 STRING

将表达式转换并连接成字符串的函数。

大纲

STRING(string1[,string2][,...][,stringN])

参数

• string - 表达式，可以是字段名称、字符串文字、数字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。如果指定了字段名称，则使用逻辑值。

描述

STRING 将一个或多个字符串转换为 STRING 格式，然后将这些字符串连接成一个字符串。不执行大小写转换。

STRING 在字符串转换之前将数字转换为其规范形式。因此，它执行算术运算，从数字中删除前导和尾随零以及前导加号。

如果字符串参数之一为 NULL，则 STRING 返回 NULL。如果字符串参数之一是空字符串 ('')，则 STRING 将连接其他参数。 STRING 保留空格。

可以使用 %SQLSTRING 函数转换数据值以进行区分大小写的字符串比较，或使用 %SQLUPPER 函数转换数据值以进行不区分大小写的字符串比较。

示例

在以下嵌入式 SQL 示例中，STRING 将三个子字符串连接成一个字符串。该示例显示了空格、空字符串和 NULL 的处理：

/// d ##class(PHA.TEST.

第132章 SQL函数 STR

将数字转换为字符串的函数。

大纲

STR(number[,length[,decimals]])

参数

• number - 解析为数字的表达式。它可以是字段名称、数字或其他函数的结果。如果指定了字段名称，则使用逻辑值。
• length - 可选 — 一个整数，指定所需输出字符串的总长度，包括所有字符（数字、小数点、符号、空格）。默认值为 10。
• decimals - 可选 — 一个整数，指定要包含的小数点右侧的位数。默认值为 0。

描述

STR 将数字转换为 STRING 格式，根据长度和小数的值截断数字。长度参数必须足够大以包含数字的整个整数部分，并且，如果指定小数，则该小数位数加 1（用于小数点）。如果长度不够大，则 STR 将返回一个星号 (*) 字符串，该字符串等于长度。

STR 在字符串转换之前将数字转换为其规范形式。因此，它执行算术运算，从数字中删除前导和尾随零以及前导加号。

如果 number 参数为 NULL，则 STR 返回 NULL。如果 number 参数是空字符串 ('')，则 STR 返回空字符串。 STRING 保留空格。

示例

在以下嵌入式 SQL 示例中，STR 将数字转换为字符串：

/// d ##class(PHA.TEST.SQLFunction).

第131章 SQL函数 SQUARE

返回数字平方的标量数值函数。

大纲

SQUARE(numeric-expression)

参数

• numeric-expression - 解析为数值的表达式。

SQUARE 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 SQUARE 返回 DOUBLE；否则，它返回 NUMERIC。

描述

SQUARE 返回数值表达式的平方。如果传递 NULL 值，SQUARE 返回 NULL。

SQUARE 返回的精度和小数位数与 SQL 乘法运算符返回的相同。

示例

以下嵌入式 SQL 示例返回整数 0 到 10 的平方：

/// d ##class(PHA.TEST.SQLFunction).Square()
ClassMethod Square()
{
	s a = 0
	while a < 11 {
		&sql(
			SELECT SQUARE(:a) INTO :b
		)
		if SQLCODE '= 0 {
			w !,"Error code ",SQLCODE 
		} else {
			w !,"The square of ",a," = ",b
			s a = a + 1 
		}
	}
}

DHC-APP>d ##class(PHA.TEST.

第130章 SQL函数 SQRT

返回给定数值表达式的平方根的数值函数。

大纲

SQRT(numeric-expression)

{fn SQRT(numeric-expression)}

参数

• numeric-expression - 解析为计算平方根的正数的表达式。

SQRT 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 SQRT 返回 DOUBLE；否则，它返回 NUMERIC。

描述

SQRT 返回 numeric-expression 的平方根。 numeric-expression 必须是正数。负数值表达式（-0 除外）会生成 SQLCODE -400 错误。如果传递 NULL 值，SQRT 返回 NULL。

SQRT 返回一个精度为 36、小数位数为 18 的值。

SQRT 可以指定为常规标量函数或 ODBC 标量函数（使用大括号语法）。

示例

以下示例显示了两种 SQRT 语法形式。两者都返回 49 的平方根：

SELECT SQRT(49) AS SRoot,{fn SQRT(49)} AS ODBCSRoot

7	7

以下嵌入式 SQL 示例返回整数 0 到 10 的平方根：

/// d ##class(PHA.TEST.SQLFunction).

第129章 SQL函数 %SQLUPPER

将值排序为大写字符串的排序规则函数。

大纲

%SQLUPPER(expression[,maxlen]) 

%SQLUPPER expression

参数

• expression - 字符串表达式，可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。表达式可以是子查询。
• maxlen - 可选 — 一个整数，指定整理后的值将被截断为 maxlen 的值。请注意， maxlen 包括附加的前导空格。您可以用双括号将 maxlen 括起来以抑制文字替换：((maxlen))。

描述

SQLUPPER 是默认排序规则。

%SQLUPPER 将表达式转换为排序为（不区分大小写）大写字符串的格式。 %SQLUPPER 将所有字母字符转换为大写，从字符串中去除尾随空格（空格、制表符等），然后在字符串开头添加一个前导空格。这个附加的空格会导致 NULL 和数值被整理为字符串。

SQL 在将数字传递给函数之前将数值转换为规范形式（删除前导零和尾随零、扩展指数等）。 SQL 不会将数字字符串转换为规范形式。

因为 %SQLUPPER 将空格附加到所有值，所以它将 NULL 值作为空格进行整理，字符串长度为 1

第128章 SQL函数 %SQLSTRING

将值排序为字符串的排序规则函数。

大纲

%SQLSTRING(expression[,maxlen])

%SQLSTRING expression

参数

• expression - 字符串表达式，可以是列名、字符串文字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。表达式可以是子查询。
• maxlen - 可选 — 一个正整数，指定整理后的值将被截断为 maxlen 的值。请注意， maxlen 包括附加的前导空格。可以用双括号将 maxlen 括起来以抑制文字替换：((maxlen))。

描述

%SQLSTRING 将表达式转换为按（区分大小写）字符串排序的格式。 %SQLSTRING 从字符串中去除尾随空格（空格、制表符等），然后在字符串的开头添加一个前导空格。这个附加的空格强制将 NULL 和数值作为字符串进行整理。从数字中删除前导零和尾随零。

因为 %SQLSTRING 将空格附加到所有值，所以它将 NULL 值整理为空格，字符串长度为 1。 %SQLSTRING 将任何仅包含空格（空格、制表符等）的值整理为 SQL 空字符串('')。当 %SQLSTRING 将空格附加到空（零长度）字符串时，它会将空格加上空字符串的内部表示形式 $CHAR(0) 进行整理，从而导致字符串长度为 2。

第127章 SQL函数 SPACE

返回一串空格的字符串函数。

大纲

SPACE(count)

{fn SPACE(count)}

参数

• count - 整数表达式，指定要返回的空格数。

描述

SPACE 返回一个空格字符串 count 个空格长。如果 count 是数字字符串、十进制数或混合数字字符串， 会将其解析为其整数部分。如果 count 是负数或非数字字符串将其解析为 0。

要从字符串中删除空格，请使用 LTRIM（前导空格）或 RTRIM（尾随空格）。

注意：不应将 SPACE 函数与 SPACE 归类类型混淆。 SPACE 排序规则在一个值前面添加一个空格，强制将其作为字符串进行评估。为了建立 SPACE 归类，CREATE TABLE 提供了一个 %SPACE 归类关键字，ObjectScript 提供了 %SYSTEM.Util 类的 Collation() 方法。

示例

以下嵌入式 SQL 示例返回名称字段长度的空格字符串：

/// d ##class(PHA.TEST.SQLFunction).Space()
ClassMethod Space()
{
	&sql(
		SELECT SPACE(LENGTH(name))
			INTO :a
		FROM Sample.Person
	)
	if SQLCODE '= 0 {
		w !

第126章 SQL函数 SIN

标量数值函数，返回角度的正弦值（以弧度为单位）。

大纲

{fn SIN(numeric-expression)}

参数

• numeric-expression - 数值表达式。这是一个以弧度表示的角度。

SIN 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，则 SIN 返回 DOUBLE；否则，它返回 NUMERIC。

描述

SIN 接受任何数值并将其正弦作为浮点数返回。如果传递一个 NULL 值，SIN 返回 NULL。 SIN 将非数字字符串视为数值 0。

SIN 返回一个精度为 19、小数位数为 18 的值。

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

可以使用 DEGREES 函数将弧度转换为度数。可以使用 RADIANS 函数将度数转换为弧度。

示例

以下示例显示了 SIN 的效果：

SELECT {fn SIN(0.52)} AS Sine

0.496880137843736714

第125章 SQL函数 SIGN

返回给定数值表达式符号的数值函数。

大纲

SIGN(numeric-expression)

{fn SIGN(numeric-expression)}

参数

• numeric-expression - 要为其返回符号的数字。

SIGN 返回 SMALLINT 数据类型。

描述

SIGN 返回以下内容：

• -1 如果 numeric-expression 小于零。
• 如果 numeric-expression 为零，则为 0（零）：0、+0 或 -0。
• 如果 numeric-expression 大于零，则为 1。
• 如果 numeric-expression 为 NULL，或者它是非数字字符串，则为 NULL。

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

SIGN 在确定其值之前将数值表达式转换为规范形式。例如，SIGN(-+-+3) 和 SIGN(-3+5) 都返回 1，表示一个正数。

注意：两个负号（连字符）是内嵌注释指示符。因此，指定两个连续负号的 SIGN 参数必须显示为用引号括起来的数字字符串。

示例

以下示例显示了 SIGN 的效果：

SELECT SIGN(-49) AS PosNeg

-1

SELECT {fn SIGN(-0.0)} AS PosNeg

0

SELECT SIGN(-+-16.

第124章 SQL函数 SECOND

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

大纲

{fn SECOND(time-expression)}

参数

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

描述

SECOND 返回一个从 0 到 59 的整数，也可能返回小数秒。秒数是针对 $HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串（没有时间值）或时间戳计算的。

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

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

必须提供时间戳字符串 (yyyy-mm-dd hh:mm:ss) 或 $HOROLOG 字符串。 $HOROLOG 字符串可以是完整的日期时间字符串 (63274,37279) 或只是 $HOROLOG (37279) 的时间整数部分。不能提供时间字符串 (hh:mm:ss)；无论实际秒数如何，这始终返回 0。

日期时间字符串的时间部分必须是有效时间。

第123章 SQL函数 SEARCH_INDEX

从索引的 Find() 方法返回一组值的函数。

大纲

SEARCH_INDEX([[schema_name.]table-name.]index-name[,findparam[,...])

参数

• table-name - 可选 — 为其定义了 index-name 的现有表的名称。不能是一个视图。表的 schema_name 是可选的。如果省略，则搜索 FROM 子句中指定的所有表。
• index-name - 要搜索的索引。现有索引的索引映射的 SqlName。
• findparam - 可选 — 要传递给索引的 Find() 方法的参数或逗号分隔的参数列表。

描述

SEARCH_INDEX 调用 index-nameFind() 方法并返回一组值。可以选择将参数传递给此 Find() 方法。例如，SEARCH_INDEX(Sample.Person.NameIDX) 调用 Sample.Person.NameIDXFind() 方法。

SEARCH_INDEX 可以与 WHERE 子句中的 %FIND 谓词一起使用，以提供对象的 oref，该对象提供封装一组值的抽象表示。这些值通常是查询运行时调用的方法返回的行 ID。 SEARCH_INDEX 调用索引的 Find() 方法来返回这个

第122章 SQL函数 RTRIM

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

大纲

RTRIM(string-expression)

{fn RTRIM(string-expression)}

参数

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

描述

RTRIM 从字符串表达式中去除尾随空格，并将字符串作为 VARCHAR 类型返回。如果 string-expression 为 NULL，则 RTRIM 返回 NULL。如果 string-expression 是一个完全由空格组成的字符串，则 RTRIM 返回空字符串 ('')。

无论要裁剪的输入表达式的数据类型是什么，RTRIM总是返回数据类型VARCHAR。

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

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

示例

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

/// d ##class(PHA.TEST.SQLFunction).

第121章 SQL函数 RPAD

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

大纲

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

参数

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

描述

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

如果 string-expression 为 NULL，则 RPAD 返回 NULL。如果 string-expression 为空字符串 ('') ，则 RPAD 返回一个完全由填充字符组成的字符串。返回的字符串是 VARCHAR 类型。

第120章 SQL函数 ROUND

以指定位数舍入或截断数字的数值函数。

大纲

ROUND(numeric-expr,scale[,flag])

{fn ROUND(numeric-expr,scale[,flag])}

参数

• numeric-expr - 要四舍五入的数字。一个数值表达式。
• scale - 计算结果为整数的表达式，该整数指定要舍入到的位数，从小数点开始计数。可以是零、正整数或负整数。如果 scale 是小数， 会将其四舍五入为最接近的整数。
• flag - 可选 — 一个布尔标志，指定是舍入还是截断 numeric-expr：0=round, 1=truncate。默认值为 0。

ROUND 返回与 numeric-expr 相同的数据类型。

描述

此函数可用于将数字舍入或截断为指定的小数位数。

ROUND 将 numeric-expr 舍入或截断以缩放位置，从小数点开始计数。舍入时，数字 5 始终向上舍入。在 ROUND 循环或截断操作后删除尾随零。不返回前导零。

• 如果 scale 为正数，则在小数点右侧的该位数处进行舍入。如果 scale 等于或大于小数位数，则不会发生舍入或零填充。
• 如果 scale 为零，则舍入到最接近的整数。换句话说，在小数点右边的零位处进行舍入；所有小数位和小数点本身都被删除。
• 如果 scale 为负数，则在小数点左侧的该位数处进行舍入。

问题： 通过JDBC连接Oracle19C数据报错 "ORA-28040: No matching authentication protocal"

解决 : 1、在数据库服务器上找到sqlnet.ora文件，一般在oracle安装目录app/oracle/product/19.0.0.0/db_1/network/admin/sqlnet.ora

2、如果有进行修改，没有直接创建

3、slqnet.ora文件新增或修改以下 SQLNET.ALLOWED_LOGON_VERSION_SERVER=8 SQLNET.ALLOWED_LOGON_VERSION_CLIENT=8

4、注意事项： ① 如果没有sqlnet.ora文件可以直接创建 vi sqlnet.ora ② 如果有不能直接vi 需要使sed -a 命令追加，否则会导致ora文件乱码 ③ 添加参数后新无需重启数据库或者监听，但是需要修改用户密码，否则会报错

5、修改用户名密码

sqlplus / as sysdba

alter user 用户名 identified by 新密码;

第119章 SQL函数 RIGHT

标量字符串函数，它从字符串表达式的末尾（最右边的位置）返回指定数量的字符。

大纲

{fn RIGHT(string-expression,count)}

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。
• count - 整数，指定从 string-expression 的结束（最右边）位置返回的字符数。

描述

RIGHT 从字符串表达式的末尾（最右边的位置）返回 count 个字符。如果为任一参数传递 NULL 值，RIGHT 将返回 NULL。

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

示例

以下示例返回 Sample.Person 表中每个名称最右边的两个字符：

SELECT Name,{fn RIGHT(Name,2)}AS MiddleInitial
     FROM Sample.Person

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

/// d ##class(PHA.TEST.SQLFunction).

第118章 SQL函数 REVERSE

标量字符串函数，它以相反的字符顺序返回一个字符串。

大纲

REVERSE(string-expression)

参数

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

描述

REVERSE 返回字符顺序颠倒的字符串表达式。例如 'Hello World!' 返回为 '!dlroW olleH'。这是一个简单的字符串顺序反转，没有额外的处理。

返回的字符串是数据类型 VARCHAR，与输入值的数据类型无关。数字转换为规范形式，数字字符串在反转之前不会转换为规范形式。

前导和尾随空白不受反转的影响。

反转 NULL 值会导致 NULL。

注意：因为 REVERSE 总是返回一个 VARCHAR 字符串，所以某些类型的数据在反转时会变得无效：

• 反向列表不再是有效列表，无法从存储格式转换为显示格式。
• 反转日期不再是有效日期，并且无法从存储格式转换为显示格式。

示例

以下示例反转 Name 字段值。在这种情况下，这会导致名称按中间名首字母排序：

SELECT Name,REVERSE(Name) AS RevName
FROM Sample.

第117章 SQL函数 REPLICATE

将字符串重复指定次数的字符串函数。

大纲

REPLICATE(expression,repeat-count)

参数

• expression - 要重复的字符串表达式。
• repeat-count - 重复的次数，以整数表示。

描述

注意：REPLICATE 函数是 REPEAT 函数的别名。提供 REPLICATE 是为了与 TSQL 兼容。有关详细信息，请参阅重复。

第116章 SQL函数 REPLACE

字符串函数，用于替换字符串中的子字符串。

大纲

REPLACE(string,oldsubstring,newsubstring)

参数

• string - 作为子字符串搜索目标的字符串表达式。
• oldsubstring - 字符串中要匹配的子字符串。
• newsubstring - 用于替换 oldsubstring 的子字符串。

描述

REPLACE 在字符串中搜索子字符串并替换所有匹配项。匹配区分大小写。如果找到匹配项，它将用 newsubstring 替换 oldsubstring 的每个实例。替换子串可能比它替换的子串长或短。如果找不到子字符串，则 REPLACE 将原样返回原字符串。

无论字符串的数据类型如何，REPLACE 返回的值始终是数据类型 VARCHAR。这允许替换操作，例如 REPLACE(12.3,'.','_')。

REPLACE 不能对字符串、oldsubstring 或 newsubstring 参数使用 %Stream.GlobalCharacter 字段。尝试这样做会生成 SQLCODE -37 错误。

空字符串是字符串值。因此，可以将空字符串用于任何参数值。但是，请注意 ObjectScript 空字符串作为 NULL 传递给 SQL。

NULL 不是 SQL 中的数据值。

各位开发者们好,

欢迎在我们的 Bilibili 频道观看新视频：

第115章 SQL函数 REPEAT

将字符串重复指定次数的字符串函数。

大纲

REPEAT(expression,repeat-count)

{fn REPEAT(expression,repeat-count)}

参数

• expression - 要重复的字符串表达式。
• repeat-count - 重复的次数，以整数表示。

描述

REPEAT 返回一串重复计数的表达式实例，连接在一起。

如果表达式为 NULL，则 REPEAT 返回 NULL。如果 expression 是空字符串，则 REPEAT 返回一个空字符串。

如果重复计数是小数，则仅使用整数部分。如果重复计数为 0，则 REPEAT 返回一个空字符串。如果重复计数是负数、NULL 或非数字字符串，则 REPEAT 返回 NULL。

示例

以下示例显示了 REPEAT 的两种形式。两个示例都返回字符串“BANGBANGBANG”：

SELECT REPEAT('BANG',3) AS Tripled

BANGBANGBANG

SELECT {fn REPEAT('BANG',3)} AS Tripled

BANGBANGBANG

第114章 SQL函数 RADIANS

将度数转换为弧度的数值函数。

大纲

RADIANS(numeric-expression)

{fn RADIANS(numeric-expression)}

参数

• numeric-expression - 以度为单位的角度度量。解析为数值的表达式。

RADIANS 返回 NUMERIC 或 DOUBLE 数据类型。如果 numeric-expression 是数据类型 DOUBLE，RADIANS 返回 DOUBLE；否则，它返回 NUMERIC。

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

描述

RADIANS 以度为单位进行角度测量，并以弧度返回相应的角度测量。如果传递 NULL 值，RADIANS 将返回 NULL。

返回值的默认精度为 36，默认小数位数为 18。

可以使用 DEGREES 函数将弧度转换为度数。

示例

以下嵌入式 SQL 示例以 30 度为增量返回与从 0 到 365 的度值对应的弧度等效值：

/// d ##class(PHA.TEST.SQLFunction).

第113章 SQL函数 QUARTER

日期函数，它将一年中的季度作为日期表达式的整数返回。

大纲

{fn QUARTER(date-expression)}

参数

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

描述

QUARTER 返回一个从 1 到 4 的整数。季度是针对 日期整数、$HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串或时间戳计算的。

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

四个季度的时间段如下：

QUARTER 基于日期时间字符串的月份部分。但是，所有日期表达式都经过验证，并且必须包含 1 到 12 范围内的月份以及指定月份和年份的有效日期值。

第111章 SQL函数 PREDICT

IntegratedML 函数，它应用指定的训练模型来预测提供的每个输入行的结果。

大纲

PREDICT(model-name )

PREDICT(model-name USE trained-model-name )

PREDICT(model-name WITH feature-columns-clause )

PREDICT(model-name USE trained-model-name WITH feature-columns-clause )

描述

PREDICT 是一个 IntegratedML 函数，可用作 SELECT 选择项以返回将经过训练的机器学习模型应用于指定查询的结果。