上表中为 DDL 和 IRIS 数据类型表达式显示的语法是为 SQL.SystemDataTypes
配置的默认映射。对于提供的系统数据类型和用户数据类型,有单独的映射表可用。
要查看和修改当前数据类型映射,请转到管理门户,选择系统管理、配置、SQL 和对象设置、系统 DDL 映射。
将数据类型从 DDL 映射到 IRIS 时,常规参数和函数参数遵循以下规则:
%#
格式标识。例如: VARCHAR(%1)
映射到:
%String(MAXLEN=%1)
因此,DDL 数据类型为:
VARCHAR(10)
映射到:
%String(MAXLEN=10)
MAXVAL
、MINVAL
和 SCALE
参数。例如: DECIMAL(%1,%2)
映射到:
%Numeric(MAXVAL=<|'$$maxval^%apiSQL(%1,%2)'|>,
MINVAL=<|'$$minval^%apiSQL(%1,%2)'|>,
SCALE=%2)
DDL
数据类型 DECIMAL
采用参数 Precision (%1)
和 Scale (%2)
,但IRIS 数据类型 %Numeric
没有精度参数。因此,要将 DECIMAL
转换为 %Numeric
,必须将 Precision
参数转换为适当的 %Numeric
参数,在这种情况下,通过将IRIS 函数格式、maxval
和 minval
应用于 DECIMAL
提供的参数。特殊的 <|'xxx'|>
语法(如上所示)指示 DDL 处理器进行参数替换,然后使用提供的值调用函数。 <|'xxx'|>
表达式随后被函数调用返回的值替换。
考虑这个具有实际值的示例,可能存在精度为 4 位、小数位数为 2 的 DECIMAL
数据类型:
DECIMAL(4,2)
映射到:
%Numeric(MAXVAL=<|'$$maxval^%apiSQL(4,2)'|>,
MINVAL=<|'$$minval^%apiSQL(4,2)'|>,
SCALE=2)
计算为:
%Numeric(MAXVAL=99.99,MINVAL=-99.99,SCALE=2)
MAXLEN
最大长度的数据值的自动截断。当一个操作可以返回多个不同的值,并且这些值可能具有不同的数据类型时,IRIS 将返回值分配给具有最高优先级的数据类型。例如,NUMERIC
数据类型可以包含所有可能的 INTEGER
数据类型值,但 INTEGER
数据类型不能包含所有可能的 NUMERIC
数据类型值。因此 NUMERIC
具有更高的优先级(更具包容性)。
例如,如果 CASE
语句有一个数据类型为 INTEGER
的可能结果值,以及一个数据类型为 NUMERIC
的可能结果值,则无论采用这两种情况中的哪一种,实际结果始终为 NUMERIC
类型。
数据类型的优先级如下,从最高(包括最多)到最低:
LONGVARBINARY
LONGVARCHAR
VARBINARY
VARCHAR
GUID
TIMESTAMP
DOUBLE
NUMERIC
BIGINT
INTEGER
DATE
TIME
SMALLINT
TINYINT
BIT
%Library.DataType
超类包含特定数据类型的类。这些数据类型类提供了 Normalize()
方法来将输入值规范化为数据类型格式,并提供 IsValid()
方法来确定输入值是否对该数据类型有效,以及各种模式转换方法,例如 LogicalToDisplay( )
和 DisplayToLogical()
。
以下示例显示了%TimeStamp
数据类型的 Normalize()
方法:
/// d ##class(PHA.TEST.SQLFunction).NormalizeValidate()
ClassMethod NormalizeValidate()
{
s indate = 64701
s tsdate = ##class(%Library.TimeStamp).Normalize(indate)
w "%TimeStamp date: ",tsdate
}
DHC-APP>d ##class(PHA.TEST.SQLFunction).NormalizeValidate()
%TimeStamp date: 2018-02-22 00:00:00
/// d ##class(PHA.TEST.SQLFunction).NormalizeValidate2()
ClassMethod NormalizeValidate2()
{
s indate = "2018-2-22"
s tsdate = ##class(%Library.TimeStamp).Normalize(indate)
w "%TimeStamp date: ",tsdate
}
DHC-APP> d ##class(PHA.TEST.SQLFunction).NormalizeValidate2()
%TimeStamp date: 2018-02-22 00:00:00
以下示例显示了 %TimeStamp
数据类型的 IsValid()
方法:
/// d ##class(PHA.TEST.SQLFunction).NormalizeValidate3()
ClassMethod NormalizeValidate3()
{
s datestr = "July 4, 2018"
s stat = ##class(%Library.TimeStamp).IsValid(datestr)
if stat = 1 {
w datestr," is a valid %TimeStamp",!
} else {
w datestr," is not a valid %TimeStamp",!
}
}
DHC-APP> d ##class(PHA.TEST.SQLFunction).NormalizeValidate3()
July 4, 2018 is not a valid %TimeStamp
/// d ##class(PHA.TEST.SQLFunction).NormalizeValidate4()
ClassMethod NormalizeValidate4()
{
s leapdate = "2016-02-29 00:00:00"
s noleap = "2018-02-29 00:00:00"
s stat = ##class(%Library.TimeStamp).IsValid(leapdate)
if stat = 1 {
w leapdate," is a valid %TimeStamp",!
} else {
w leapdate," is not a valid %TimeStamp",!
}
s stat = ##class(%Library.TimeStamp).IsValid(noleap)
if stat = 1 {
w noleap," is a valid %TimeStamp",!
} else {
w noleap," is not a valid %TimeStamp",!
}
}
DHC-APP> d ##class(PHA.TEST.SQLFunction).NormalizeValidate4()
2016-02-29 00:00:00 is a valid %TimeStamp
2018-02-29 00:00:00 is not a valid %TimeStamp
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。