文章目录


第五十五章 SQL函数 ​​%EXTERNAL​​

以显示格式返回表达式的格式转换函数。

大纲

%EXTERNAL(expression)

%EXTERNAL expression

参数

  • ​​expression​​​ - 要转换的表达式。字段名、包含字段名的表达式或返回值为可转换数据类型(如​​DATE​​​或​​%LIST​​)的函数。不能是流字段。

描述

​​%EXTERNAL​​​将表达式转换为显示格式，与当前选择模式(显示模式)无关。显示格式表示​​VARCHAR​​​数据类型的数据，无论字段或数据类型​​LogicalToDisplay​​方法执行什么数据转换。

​​%EXTERNAL​​​通常用于选择列表​​SELECT-ITEM​​​。它可以在​​WHERE​​​子句中使用，但不建议这样使用，因为使用​​%EXTERNAL​​会阻止在指定字段上使用索引。

应用​​%EXTERNAL​​​会将列标题名称更改为诸如“​​Expression_1​​”之类的值；因此，通常需要指定列名别名，如以下示例所示。

​​%EXTERNAL​​​是否转换日期取决于日期字段或函数返回的数据类型。​​%EXTERNAL​​​转换​​CURDATE​​​、​​CURRENT_DATE​​​、​​CURTIME​​​和​​CURRENT_TIME​​​值。它不转换​​CURRENT_TIMESTAMP​​​、​​GETDATE​​​、​​GETUTCDATE​​​、​​NOW​​​和​​$HOROLOG​​值。

当​​%EXTERNAL​​​将​​%List​​​结构转换为显示格式时，显示的列表元素似乎由空格分隔。这个“空格”实际上是两个非显示字符​​CHAR(13)​​​和​​CHAR(10)​​。

​​%EXTERNAL​​​是一个​​SQL​​扩展。

无论当前选择模式是什么，要将表达式转换为​​LOGICAL​​格式，请使用​​%INTERNAL​​函数。

无论当前选择模式是什么，要将表达式转换为​​ODBC​​格式，请使用​​%ODBCOUT​​函数。

示例

下面的动态​​SQL​​示例以当前选择模式格式返回Date of Birth (DOB)数据值，并使用​​%EXTERNAL​​函数返回相同的数据。

为了演示的目的，在这个程序中，​​%SelectMode​​值在每次调用时都是随机确定的:

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"
}
DHC-APP>d ##class(PHA.TEST.SQLCommand).External()
Select mode DISPLAY
DOB     ExtDOB
04/25/1990      04/25/1990

01/02/2014      01/02/2014
01/02/2014      01/02/2014
01/28/1978      01/28/1978

5 Rows(s) Affected
End of data

DHC-APP>d ##class(PHA.TEST.SQLCommand).External()
Select mode LOGICAL
DOB     ExtDOB
54536   04/25/1990

63189   01/02/2014
63189   01/02/2014
50066   01/28/1978

5 Rows(s) Affected
End of data
DHC-APP>d ##class(PHA.TEST.SQLCommand).External()
Select mode ODBC
DOB     ExtDOB
1990-04-25      04/25/1990

2014-01-02      01/02/2014
2014-01-02      01/02/2014
1978-01-28      01/28/1978

5 Rows(s) Affected
End of data

下面的例子展示了这个函数的两种语法形式;

它们在其他方面是相同的。

它们指定了​​%List​​字段的​​%EXTERNAL​​(显示格式)、​​%INTERNAL​​(逻辑格式)和​​%ODBCOUT​​ (ODBC格式):

SELECT TOP 10 %EXTERNAL(FavoriteColors) AS ExtColors,
              %INTERNAL(FavoriteColors) AS IntColors,
              %ODBCOUT(FavoriteColors) AS ODBCColors
FROM Sample.Person

第五十五章 SQL函数 %EXTERNAL_显示格式

以下示例将出生日期(DOB)和四舍五入出生日期(DOB)值转换为​​%EXTERNAL​​​(​​DISPLAY​​格式):

SELECT %EXTERNAL(DOB) AS DOB,
       %INTERNAL(ROUND(DOB,-3)) AS DOBGroup,
       %EXTERNAL(ROUND(DOB,-3)) AS RoundedDOB
FROM Sample.Person
GROUP BY (ROUND(DOB,-3))
ORDER BY DOBGroup

第五十五章 SQL函数 %EXTERNAL_数据库_02