第五十五章 SQL函数 %EXTERNAL
以显示格式返回表达式的格式转换函数。
大纲
%EXTERNAL(expression)
%EXTERNAL expression
参数
expression - 要转换的表达式。字段名、包含字段名的表达式或返回值为可转换数据类型(如DATE或%LIST)的函数。不能是流字段。
描述
将表达式转换为显示格式,与当前选择模式(显示模式)无关。显示格式表示VARCHAR数据类型的数据,无论字段或数据类型方法执行什么数据转换。
通常用于选择列表。它可以在WHERE子句中使用,但不建议这样使用,因为使用会阻止在指定字段上使用索引。
应用会将列标题名称更改为诸如“”之类的值;因此,通常需要指定列名别名,如以下示例所示。
是否转换日期取决于日期字段或函数返回的数据类型。转换CURDATE、、和值。它不转换、、、和值。
当将结构转换为显示格式时,显示的列表元素似乎由空格分隔。这个“空格”实际上是两个非显示字符和。
是一个扩展。
无论当前选择模式是什么,要将表达式转换为LOGICAL格式,请使用函数。
无论当前选择模式是什么,要将表达式转换为格式,请使用函数。
示例
下面的动态示例以当前选择模式格式返回Date of Birth (DOB)数据值,并使用函数返回相同的数据。
为了演示的目的,在这个程序中,值在每次调用时都是随机确定的:
ClassMethod External()
{
s tStatement = ##class(%SQL.Statement).%New()
s tStatement.%SelectMode = $RANDOM(3)
if tStatement.%SelectMode = 0 {w "Select mode LOGICAL",! }
elseif tStatement.%SelectMode=1 {w "Select mode ODBC",! }
elseif tStatement.%SelectMode=2 {w "Select mode DISPLAY",! }
s myquery = 2
s myquery(1) = "SELECT TOP 5 DOB,%EXTERNAL(DOB) AS ExtDOB "
s myquery(2) = "FROM Sample.Person"
s qStatus = tStatement.%Prepare(.myquery)
s rset = tStatement.%Execute()
d rset.%Display()
w !,"End of data"
}