Special Variables (SQL)

特殊变量 (SQL)

系统提供的变量.

$HOROLOG
$JOB
$NAMESPACE
$TLEVEL
$USERNAME
$ZHOROLOG
$ZJOB
$ZPI
$ZTIMESTAMP
$ZTIMEZONE
$ZVERSION

复制

SQL直接支持许多对象脚本特殊变量.这些变量包含系统提供的值.只要可以在SQL中指定文字值,就可以使用它们.

SQL特殊变量名不区分大小写.大多数可以使用缩写来指定.

Variable	Name	Abbreviation	Data Type Returned Use
$HOROLOG	$H	%String/VARCHAR	当前进程的本地日期和时间
$JOB	$J	%String/VARCHAR	当前进程的 job ID
$NAMESPACE	none	%String/VARCHAR	当前命名空间名称
$TLEVEL	$TL	%Integer/INTEGER		current transaction nesting level
$USERNAME	none	%String/VARCHAR	当前进程的用户名
$ZHOROLOG	$ZH	%Numeric/NUMERIC(21,6)	自InterSystems IRIS启动后经过的秒数
$ZJOB	$ZJ	%Integer/INTEGER	当前进程的job状态
$ZPI	none	%Numeric/NUMERIC(21,18)	数值常量PI
$ZTIMESTAMP	$ZTS	%String/VARCHAR	协调世界时间格式的当前日期和时间
$ZTIMEZONE	$ZTZ	%Integer/INTEGER	当地时区与GMT的偏移量
$ZVERSION	$ZV	%String/VARCHAR	IRIS的当前版本

示例

SELECT TOP 5 Name,$H
FROM Sample.Person

复制

以下示例仅在时区位于大陆内时才返回结果集：

SELECT TOP 5 Name,Home_State
FROM Sample.Person
WHERE $ZTIMEZONE BETWEEN -480 AND 480

复制

字符串操作(SQL)

字符串操作函数和运算符.

SQL 支持多种类型的字符串操作：

• 字符串可以通过长度、字符位置或子字符串值进行操作.
• 字符串可以通过指定的分隔符或分隔符字符串来操作.
• 字符串可以通过模式匹配和单词感知搜索来测试.
• 特殊编码的字符串（称为列表）包含嵌入的子字符串标识符,而不使用分隔符.各种 $LIST 函数对这些与标准字符串不兼容的编码字符串进行操作.唯一的例外是 $LISTGET 函数和 $LIST 的单参数和双参数形式,它们将编码字符串作为输入,但将单个元素值作为标准字符串输出.

SQL 支持字符串函数、字符串条件表达式和字符串运算符.

ObjectScript 字符串操作区分大小写.字符串中的字母可以转换为大写、小写或混合大小写.字符串排序规则可以区分大小写,也可以不区分大小写;默认情况下,SQL 字符串排序规则是不区分大小写的 SQLUPPER. SQL 提供了许多字母大小写和排序规则函数和运算符.

当为数字参数指定字符串时,大多数 SQL 函数执行以下字符串到数字的转换： 非数字字符串转换为数字 0;将数字字符串转换为规范数字;并且混合数字字符串在第一个非数字字符处被截断,然后转换为规范数字.

字符串连接

以下函数将子字符串连接成字符串：

• CONCAT：连接两个子字符串,返回一个字符串.
• STRING：连接两个或多个子字符串,返回单个字符串.
• XMLAGG：连接列的所有值,返回单个字符串.
• LIST：连接列的所有值,包括逗号分隔符,返回单个字符串.
• 连接运算符 (||) 也可用于连接两个字符串.

字符串长度

以下函数可用于确定字符串的长度：

• CHARACTER_LENGTH 和 CHAR_LENGTH：返回字符串中的字符数,包括尾随空格. NULL 返回 NULL.
• LENGTH：返回字符串中的字符数,不包括尾随空格. NULL 返回 NULL.
• $LENGTH：返回字符串中的字符数,包括尾随空格. NULL 返回为 0.

Truncation and Trim

以下函数可用于截断或修剪字符串.截断限制字符串的长度,删除超出指定长度的所有字符.Trim从字符串中删除前导和/或尾随空格.

• Truncation: CONVERT, %SQLSTRING, and %SQLUPPER.
• Trimming: TRIM, LTRIM, and RTRIM.

子串搜索

以下函数在字符串中搜索子字符串并返回字符串位置：

• POSITION：按子字符串值搜索,找到第一个匹配项,返回子字符串开始的位置.
• CHARINDEX：按子字符串值搜索,找到第一个匹配项,返回子字符串开始的位置.可以指定起点.
• $FIND：按子串值搜索,找到第一个匹配项,返回子串结束的位置.可以指定起点.
• INSTR：按子字符串值搜索,找到第一个匹配项,返回子字符串开始的位置.可以指定起点和子串出现.

以下函数在字符串中按位置或分隔符搜索子字符串并返回子字符串：

• $EXTRACT：按字符串位置搜索,返回由开始位置或开始和结束位置指定的子字符串.从字符串的开头搜索.
• SUBSTRING：按字符串位置搜索,返回由开始位置或开始和长度指定的子字符串.从字符串的开头搜索.
• SUBSTR：按字符串位置搜索,返回由起始位置或起始和长度指定的子字符串.从字符串的开头或结尾搜索.
• $PIECE：按分隔符搜索,返回第一个分隔的子字符串.可以指定起点或默认为字符串的开头.
• $LENGTH：按分隔符搜索,返回分隔子串的数量.从字符串的开头搜索.
• $LIST：在特殊编码的列表字符串上按子字符串计数搜索.它通过子串计数定位子串并返回子串值.从字符串的开头搜索.
• 包含运算符 ([) 也可用于确定子字符串是否出现在字符串中.
• %STARTSWITH 比较运算符将指定的字符与字符串的开头进行匹配.

子串搜索和替换

以下函数在字符串中搜索子字符串并将其替换为另一个子字符串.

• REPLACE：按字符串值搜索,用新的子字符串替换子字符串.从字符串的开头搜索.
• STUFF：按字符串位置和长度搜索,用新的子字符串替换子字符串.从字符串的开头搜索.

字符类型和 Word-Aware 比较

%PATTERN 比较运算符将字符串与指定的字符类型模式匹配.