第九章 设置结构化日志记录（一）

IRIS 支持结构化日志记录。

创建多个日志，每个日志用于不同的目的。从以前的产品迁移过来的客户可以像过去一样利用这些日志，但现在还可以将所有日志信息导入一个单一的、中央的、机器可读的日志文件——结构化日志。然后可以将此文件与第三方分析工具一起使用。

本文概述了结构化日志中的信息，展示了日志示例，并描述了如何启用结构化日志记录。

结构化日志中可用的信息

当启用结构化日志记录时，系统会将相同的数据写入结构化日志，它也会写入其他日志（无论哪个）。例如，系统将相同的行写入messages.log 和结构化日志。

启用结构化日志记录后，结构化日志包含以下所有信息：

Python 已成为世界上使用最广泛的编程语言（来源：https://www.tiobe.com/tiobe-index/），SQL 作为数据库语言继续引领潮流。 Python 和 SQL 一起工作以提供 SQL 单独无法提供的新功能不是很好吗？毕竟，Python 拥有超过 380,000 个已发布的库（来源：https://pypi.org/），它们具有非常有趣的功能，可以在 Python 中扩展您的 SQL 查询。本文详细介绍了如何使用嵌入式 Python 在 InterSystems IRIS 数据库中创建新的 SQL 存储过程。

用作示例的 Python 库

本文将使用两个非常有用的库：Geopy 和 Chronyk。

Geopy 是一个用于将地理编码（地址和地理坐标的限定）应用于地址数据的库。有了它，就可以从街道名称中获取邮局格式的邮政编码和完整地址。非常有用，因为许多记录都有地址。

Bitmap索引是指对某个，或者某几个字段建立的bit map(位图映射)。如果是对整个表的记录，也就是表的%ID做位图映射，得到的特殊的bitmap索引在IRIS/Caché里被称为Bitmap Extent。

建立Bitmap Extent索引的目的就是加快COUNT(*)的执行。提高了多少呢？ 下面两个显示的是最简单的全表查询花费的时间：

• 不使用Bitmap Extent : 1.3810s
• 使用Bitmap Extent： 0.0038

相差有几百倍。

第十四章 使用SQL Shell界面（二）

存储和调用SQL语句

通过数据回调

SQL Shell自动将在终端会话期间发出的每个成功的SQL语句存储在本地缓存中，并为其分配一个顺序号。这些数字用于在当前Terminal过程中重新调用以前的SQL语句。 SQL Shell仅将数字分配给成功的SQL语句。如果在准备SQL语句期间发生错误，则不会分配任何编号。这些数字分配不是特定于名称空间的。以下是可用的数字调用命令：

第八章 解释SQL查询计划（二）

SQL语句的详细信息

有两种方式显示SQL语句的详细信息:

• 在SQL Statements选项卡中，通过单击左侧列中的Table/View/Procedure Name链接选择一个SQL Statement。
  这将在单独的选项卡中显示SQL语句详细信息。
  该界面允许打开多个选项卡进行比较。
  它还提供了一个Query Test按钮，用于显示SQL Runtime Statistics页面。
• 从表的Catalog Details选项卡(或SQL Statements选项卡)中，通过单击右边列中的Statement Text链接选择一个SQL语句。
  这将在弹出窗口中显示SQL语句详细信息。

可以使用“SQL语句详细信息”显示来查看查询计划，并冻结或解冻查询计划。

第十一章 发送和接收IBM WebSphere MQ消息

InterSystems IRIS为IBM WebSphere MQ提供了一个接口，可以使用该接口在InterSystems IRIS和IBM WebSphere MQ的消息队列之间交换消息。要使用此接口，必须能够访问IBM WebSphere MQ服务器，并且IBM WebSphere MQ客户端必须与InterSystems IRIS在同一台计算机上运行。

该接口由%Net.MQSend和%Net.MQRecv类组成，这两个类都是%Net.abstractMQ的子类。这些类使用由InterSystems IRIS在所有合适的平台上自动安装的动态链接库。(这是Windows上的MQInterface.dll；其他平台的文件扩展名不同。)。反过来，InterSystems IRIS动态链接库需要IBM WebSphere MQ动态链接库。

该界面仅支持发送和接收文本数据，不支持二进制数据。

第二十九章 SQL命令 DISTINCT

指定仅返回不同值的SELECT子句。

大纲

SELECT [DISTINCT [BY (item {,item2})] ]  |  [ALL]
  select-item {,select-item2}

参数

• DISTINCT - 可选-返回组合选择项值唯一的行。
• DISTINCT BY (item {,item2}) - 可选-返回按(项)值唯一的行的选择项值。
• ALL - 可选-返回结果集中的所有行。默认设置。

描述

可选DISTINCT子句出现在SELECT关键字之后、可选TOP子句和第一个SELECT-ITEM之前。

第六十章 SQL命令 JOIN（二）

单向外部联接

IRIS支持单向外部联接：左外部联接和右外部联接。

使用标准的“inner”联接时，当一个表的行链接到第二个表的行时，第一个表中找不到第二个表中对应行的行将从输出表中排除。

使用单向外联接时，即使第二个表中没有匹配项，第一个表中的所有行也会包括在输出表中。使用单向外连接，第一个表会从第二个表中取出相关信息，但不会因为第二个表中缺少匹配项而牺牲自己的行。

例如，如果查询首先列出Table1并创建一个左外部联接，那么它应该能够看到Table1中的所有行，即使它们在Table2中没有对应的记录。

第一章 SQL谓词的概述（一）

描述计算结果为真或假的逻辑条件。

使用谓词

谓词是一个条件表达式，其计算结果为布尔值(true或false)。

谓词可以如下使用:

第十二章 SQL聚合函数 VARIANCE, VAR_SAMP, VAR_POP

返回数据集统计方差的聚合函数。

第四十五章 SQL函数 DATEPART

日期/时间函数，返回表示日期/时间表达式指定部分的值的整数。

第七十四章 SQL函数 LEAST

从一系列表达式中返回最小值的函数。

大纲

LEAST(expression,expression[,...])

参数

• expression - 解析为数字或字符串的表达式。
  将这些表达式的值相互比较，并返回最小值。
  表达式可以是字段名、文字、算术表达式、主机变量或对象引用。
  最多可以列出140个逗号分隔的表达式。

描述

LEAST从逗号分隔的表达式序列中返回最小值。
表达式按从左到右的顺序求值。
如果只提供一个表达式，则LEAST返回该值。
如果任何表达式为NULL, LEAST返回NULL。

第105章 SQL函数 %OID

返回 ID 字段的 OID 的标量函数。

大纲

%OID(id_field)

参数

• id_field - ID 字段或引用字段的字段名称。

描述

%OID 采用字段名称并返回对象的完整 OID（对象 ID）。该字段必须是 ID 字段或引用字段（外键字段）。在 id_field 中指定任何其他类型的字段会生成 SQLCODE -1 错误。

示例

以下示例显示了与引用字段一起使用的 %OID：

第133章 SQL函数 STRING

将表达式转换并连接成字符串的函数。

大纲

STRING(string1[,string2][,...][,stringN])

参数

• string - 表达式，可以是字段名称、字符串文字、数字或另一个函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。如果指定了字段名称，则使用逻辑值。

描述

STRING 将一个或多个字符串转换为 STRING 格式，然后将这些字符串连接成一个字符串。不执行大小写转换。

STRING 在字符串转换之前将数字转换为其规范形式。因此，它执行算术运算，从数字中删除前导和尾随零以及前导加号。