第二十一章 导入和导出SQL数据

在InterSystems IRIS®Data Platform Management Portal中，有用于导入和导出数据的工具：
- 从文本文件导入数据
- 将数据导出到文本文件

这些工具使用动态SQL，这意味着查询是在运行时准备和执行的。可以导入或导出的行的最大大小为3,641,144个字符。

还可以使用%SQL.Import.Mgr类导入数据，使用%SQL.Export.Mgr类导出数据。

从文本文件导入数据

可以将数据从文本文件导入到合适的InterSystems IRIS类中。执行此操作时，系统将在表中为该类创建并保存新行。该类必须已经存在并且必须编译。要将数据导入到此类中，请执行以下操作：
1. 从管理门户中选择系统资源管理器，然后选择SQL。使用页面顶部的切换选项选择一个命名空间；这将显示可用命名空间的列表。
2. 在页面顶部，单击向导下拉列表，然后选择数据导入。

3. 在向导的第一页上，从指定外部文件的位置开始。对于导入文件所在的位置，请单击要使用的服务器的名称。

第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 相同的数据类型。

描述

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

第148章 SQL函数 $TRANSLATE

执行逐字符替换的字符串函数。

大纲

$TRANSLATE(string,identifier[,associator])

参数

• string - 目标字符串。它可以是字段名称、文字、主机变量或 SQL 表达式。
• identifier - 要在字符串中搜索的字符。它可以是字符串或数字文字、主变量或 SQL 表达式。
• associator - 可选 — 与标识符中的每个字符对应的替换字符。它可以是字符串或数字文字、主变量或 SQL 表达式。

描述

$TRANSLATE 函数在返回值字符串中执行逐字符替换。它一次处理一个字符的字符串参数。它将字符串中的每个字符与标识符参数中的每个字符进行比较。如果 $TRANSLATE 找到匹配项，它会记下该字符的位置。

第十六章 导入SQL Code

本章介绍如何将SQL代码从文本文件导入Intersystems SQL。导入SQL代码时，IntersystemsIris®数据平台使用动态SQL准备并执行每行SQL。如果遇到无法解析的代码行，则SQL导入跳过该行代码并继续准备和执行后续行，直到它到达文件的末尾。所有SQL代码导入操作导入到当前名称空间。

SQL导入主要用于导入数据定义语言（DDL）命令（例如Create Table），并使用Insert，Update和Delete命令填充表。 SQL导入确实准备并执行SELECT查询，但不创建结果集。

第七十八章 SQL函数 $LENGTH

返回字符串中字符数或分隔子字符串数的字符串函数。

大纲

$LENGTH(expression[,delimiter])

参数

• expression - 目标字符串。它可以是数值、字符串文字、任何变量的名称或任何有效的表达式。
• delimiter - 可选 — 在目标字符串中划分不同子字符串的字符串。它必须是字符串文字，但可以是任意长度。括起来的引号是必需的。

$LENGTH 返回 SMALLINT 数据类型。

第十一章 SQL隐式联接（箭头语法）

InterSystems SQL提供了一个特殊的–>运算符，作为从相关表中获取值的快捷方式，而在某些常见情况下无需指定显式的JOIN即可。可以使用此箭头语法代替显式联接语法，也可以将其与显式联接语法结合使用。箭头语法执行左外部联接。

箭头语法可用于类的属性或父表的关系属性的引用。其他类型的关系和外键不支持箭头语法。不能在ON子句中使用箭头语法（–>）。

属性引用

可以使用- >操作符作为从“引用表”获取值的简写。
例如，假设定义了两个类:Company:

第七十一章 SQL命令 SELECT（三）

列别名

指定SELECT-ITEM时，可以使用AS关键字指定列名的别名：

SELECT Name AS PersonName, DOB AS BirthDate, ...

列别名在结果集中显示为列标题。指定列别名是可选的；始终提供默认值。列别名以指定的字母大小写显示；但是，当在ORDER BY子句中引用时，它不区分大小写。C别名必须是有效的标识符。C别名可以是分隔的标识符。使用带分隔符的标识符允许列别名包含空格、其他标点符号或作为SQL保留名称。例如，SELECT Name AS "Customer Name" or SELECT Home_State AS "From"。

As关键字不是必需的，但使查询文本更易于阅读。因此，以下也是有效的语法：

FHIR® SQL Builder或 Builder 是 InterSystems IRIS 医疗版数据平台 的一个组件。它是一种复杂的投射工具，用于将 InterSystems IRIS 医疗版数据平台FHIR 存储库中的数据创建为自定义的 SQL 模式，而无需将数据移动到单独的 SQL 存储库中。 Builder 专门设计用于与 InterSystems IRIS 医疗版数据平台中的 FHIR 存储库和多模型数据库配合使用。

第144章 SQL函数 TO_DATE（二）

一年中的某一天（DDD 格式）

可以使用 DDD 将一年中的某一天（自 1 月 1 日以来经过的天数）转换为实际日期。格式字符串 DDD YYYY 必须与由整数天数和四位数年份组成的相应 date_string 配对。 （与 DDD 一起使用时，两位数的年份必须指定为 RR（而不是 YY）。）格式字符串 DDD 默认为当前年份。经过的天数必须是 1 到 365 范围内的正整数（如果 YYYY 是闰年，则为 366）。四位数年份必须在标准 日期范围内：1841 到 9999。DDD 和 YYYY 格式元素可以按任意顺序指定；它们之间的分隔符是强制性的。以下示例显示了这一年中的一天的用法：

第三十章 SQL函数 CONCAT

标量字符串函数，它返回作为连接两个字符表达式的结果的字符串。

大纲

{fn CONCAT(string-expression1,string-expression2)}

参数

• string-expression1, string-expression2 - 要连接的字符串表达式。表达式可以是列名、字符串文字、数字或另一个标量函数的结果，其中底层数据类型可以表示为任何字符类型(如CHAR或VARCHAR)。

描述

连接两个字符串以返回连接的字符串。可以使用连接运算符(||)执行完全相同的操作。

可以连接数字或数字字符串的任意组合；连接结果是一个数字字符串。SQL在连接之前将数字转换为规范形式(指数被扩展，前导零和尾随零被删除)。在连接之前，数字字符串不会转换为规范形式。

可以将前导空格或尾随空格连接到字符串。将空值连接到字符串会产生空值；这是行业范围内的SQL标准。

第五十四章 SQL命令 INSERT（三）

SQLCODE错误

默认情况下，INSERT是要么全有要么全无的事件：要么完全插入行，要么根本不插入行。 IRIS返回一个状态变量SQLCODE，指示插入是成功还是失败。要将行插入到表中，插入操作必须满足所有表、字段名和字段值要求，如下所示。

三部曲中的第四部，有人是《银河系漫游指南》的粉丝吗？

如果你希望为旧的 MUMPS 应用程序注入新的生命，请按照以下步骤将 global 映射到类，并将所有这些漂亮的数据公开给 Objects 和 SQL。

第十三章 使用动态SQL（七）

SQL元数据

动态SQL提供以下类型的元数据：
- 在“准备”之后，描述查询类型的元数据。
- 在“准备”之后，描述查询中选择项的元数据（“列”和“扩展列信息”）。
- 在准备之后，描述查询参数的元数据：参数，：var参数和常量。 （语句参数，形式参数和对象）
- 执行之后，描述查询结果集的元数据。在执行Prepare操作（％Prepare（），％PrepareClassQuery（）或％ExecDirect（））之后，可以使用％SQL.StatementMetadata属性值。
- 可以直接为最新的％Prepare（）返回％SQL.Statement元数据属性。
- 可以返回包含％SQL.StatementMetadata属性的oref的％SQL.Statement％Metadata属性。这使可以返回多个准备操作的元数据。

定义 Stored Procedures

可以使用以下方式定义stored procedures

1. 使用DDL定义存储过程
2. 使用类方法定义存储过程

使用DDL定义存储过程

CREATE PROCEDURE 可以创建一个查询，它总是作为一个存储过程被预测。一个查询可以返回一个单一的结果集。