第三章 SQL命令 ALTER USER

修改用户密码。

大纲

ALTER USER user-name IDENTIFY BY password

ALTER USER user-name IDENTIFIED BY password

参数

描述

ALTER USER命令允许更改用户的密码。可以随时更改自己的密码。要更改其他用户的密码，必须拥有%Admin_Secure:USE系统权限。

IDENTIFY BY和IDENTIFIED BY关键字是同义词。

user-name必须是已存在的用户。 指定一个不存在的用户将生成一个带有%msg的SQLCODE -400错误，如下所示:ERROR #838: User badname does not exist。可以通过调用$SYSTEM.SQL.Security.UserExists()方法来确定用户是否存在。

作为分隔标识符指定的用户名可以是SQL保留字，可以包含逗号(，)、句号(.)、插入符号(^)和两个字符的箭头序列(->)。 它可以以除星号(*)以外的任何有效字符开头。

密码可以是字符串字面值

第二章 SQL命令 ALTER TABLE（二）

删除列限制

DROP COLUMN可以删除指定为逗号分隔列表的多个列定义。每个列出的列名后面必须紧跟其RESTORY或CASCADE(如果未指定，则默认为RESTRICE)和%DELDATA或%NODELDATE(如果未指定，则默认为%NODELDATA)选项。

默认情况下，删除列定义不会从数据映射中删除存储在该列中的任何数据。 要同时删除列定义和数据，请指定%DELDATA选项。

删除列定义并不删除相应的列级特权。 例如，授予用户在该列上插入、更新或删除数据的权限。 这将产生以下后果:

• 如果删除了一个列，然后添加了另一个同名的列，那么用户和角色将在新列上拥有与旧列相同的特权。
• 删除列后，不可能撤销该列的对象特权。

由于这些原因，通常建议在删除列定义之前使用REVOKE命令从列中撤销列级特权。

RESTRICT关键字(或无关键字):如果列出现在索引中，或者定义在外键约束或其他唯一约束中，则不能删除该列。 为该列尝试DROP COLUMN失败，并出现SQLCODE -322错误。 默认为RESTRICT。

CASCADE关键字:如果该列出现在索引中，该索引将被删除。 可能有多个索引。 如果列出现在外键中，则将删除外键。 可能有多个外键。

如果列在COMPUTECODE或COMPUTEONCHANGE子句中使用，则不能删除该列。

转载自Forester 报告：

InterSystems是一个高性能的数据平台，具有强大的支持和可靠性。InterSystems的IRIS数据平台支持关系型、对象型、文档型、键值型、立方体和多维数组，但它没有原生的图形功能。该平台不需要整合多种技术栈，从而减少了代码、系统资源和维护。客户用它来支持客户分析、物联网、支持AI/ML的应用程序、风险分析和垂直特定的用例，如医疗保健应用程序和洞察力。InterSystems的愿景侧重于一个统一的平台，以支持各种应用和洞察力。该解决方案在性能、分析、搜索和交易方面得分很高。参考客户对InterSystems很满意；一个客户说："他们的客户支持总是超级好。"另一个客户说他们 "在一个关键任务的应用中使用了10多年，对性能和功能以及可靠性总体上很满意。" 

Forester 报告原文下载：https://reprints2.forrester.com/#/assets/2/1735/RES161621/report

第一章 SQL命令 ALTER TABLE（一）

修改表。

大纲

ALTER TABLE table alter-action

where alter-action is one of the following:
     ADD  [(] add-action {,add-action} [)] |
     DROP [COLUMN ] drop-column-action {,drop-column-action} |
     DROP drop-action |
     DELETE drop-action |
     ALTER [COLUMN] field alter-column-action |
     MODIFY modification-spec {,modification-spec}
     RENAME table

add-action ::= 
     [CONSTRAINT identifier]
     [(] FOREIGN KEY (field-commalist) 
          REFERENCES table (field-commalist)
          [ON DELETE ref-action] [ON UPDATE ref-action] 
          [NOCHECK]  [)]
  

第0讲 前言

自我介绍

大家好，我简单的自我介绍一下，我是姚鑫，

为什么开这次的课程

首先Caché，M这门技术相对比较冷门，资料方面都是英文，没有系统的相关资料，记得刚入职时学习的东西都是很基础的，稍微有一些复杂的结构变化，就不知道如何下手。之后，群里的小伙伴总有人问我，希望我出一个系统的Caché视频，这件事我也酝酿了很久，目的就是帮助到更多的同学，让每个小伙伴在日后的工作学习中能更加的得心应手。遇到困难或问题时，大家可以随时在群里咨询，群里的氛围很和谐，有很多热心的大佬，不会说有那种自己觉得简单的问题，不好意思问，没人回答的情况。只要你觉得是个问题就可以发出来。

因为这段时间比较忙，准备的比较仓促，可能有一些内容会有遗漏，大家有啥想法可以群里留言，会后可以答疑，大家可以提出来，一起探讨一下，后续的会准备的更加充分一些。

课程特点

• 本次课程什么时候讲完什么时候结束。
• 全方位无死角覆盖所有知识点，讲解详细，上手容易。
• 内容实际，实用性强，每个知识点都可以找到对应的参考实例。

受众

• 0基础刚接触Caché的同学。
• 有一定接触，但是对一些细节和概念不清楚的同学。
• 想掌握更多编程细节的同学。

效果

• 可以掌握Caché编程所有的知识点，避免对一些冷门只是无从下手。
• 对于一门技术而言，只有对其了解足够深入，才能用最浅，通俗的话语将其描述出来。做到深入浅出就是本次课程的一个主要目标

请教一下，我使用两个iris实例搭建了镜像，再将数据库同步后，备机出现了数据库无法激活的问题，报错：Database could not be activated because Write Daemon could not update mirror block。该如何解决

第一章 SQL中使用的符号

SQL中用作运算符等的字符表

符号表

每个符号的名称后跟其ASCII十进制代码值。

第153章 Storage关键字 - SqlRowIdProperty

指定SQL RowId属性。

大纲

<SqlRowIdProperty>prop</SqlRowIdProperty>

值

该元素的值是一个SQL标识符。

描述

此元素仅由从早期InterSystems产品迁移的类使用。

默认值

<SqlRowIdProperty>元素的默认值为空字符串。

第154章 Storage关键字 - SqlTableNumber

指定内部SQL表号。

大纲

<SqlTableNumber>123</SqlTableNumber>

值

该元素的值是一个表号。

描述

此元素仅由从早期InterSystems产品迁移的类使用。

默认值

<SqlTableNumber>元素的默认值为空字符串。

第155章 Storage关键字 - State

指定用于串行对象的数据定义。

大纲

<State>state</State>

值

此元素的值是此存储定义中的数据定义的名称。

描述

对于串行(嵌入式)类，此关键字指示使用哪个数据定义来定义对象的序列化状态(序列化时对象属性的排列方式)。这也是默认数据定义，默认结构生成器将向其添加未存储的属性。

默认值

<State>元素的默认值为空字符串。

第156章 Storage关键字 - StreamLocation

指定流属性的默认存储位置。

大

第149章 Storage关键字 - IdFunction

指定使用默认存储为持久类分配新ID值的系统函数。

大纲

<IdFunction>increment</IdFunction>

值

这个元素的值可以是increment(使用$increment函数)或sequence(使用$sequence函数)。

描述

如果持久化类不使用IdKey来确定对象ID值，则该元素允许指定用于分配ID值的函数($increment函数或$sequence函数)。

如果类使用$increment函数，则通过对<IdLocation>元素中定义的全局位置中存储的值进行递增来创建新的id。

如果类使用$sequence函数，它可能会保留id块，以便在快速数据摄入的情况下获得更快的速度。 如果没有使用所有保留的ID，则可能导致ID号之间的空白。 当随后的数据被吸收时，这些空白可能会也可能不会被填补。 一个副作用是，具有较高ID的类的实例不一定比具有较低ID的类的实例更新。 此外，在<IdLocation>元素中定义的全局位置上的值与当前分配的任何id都不直接相关。

默认值

<IdFunction>元素的默认值是使用类定义创建的类的递增值。

<IdFunction>元素的默认值是使用DDL CREATE TABLE语句创建的类的序列。

第150章 Storage关键字 - IdLocation

指定

SAM - 设置和添加非 IRIS 目标指标的技巧和提示

SAM（系统警报和监视）以“功能齐全”的 docker-compose 容器集的形式提供，只要启动就可以开始以默认的仪表板监视 IRIS 实例。 使用初始配置就可以很好地了解 SAM 功能并开始对 IRIS 系统进行基本监视。 但是，当开始监视多个系统并收集大量指标数据时，需要更改一些默认设置。 为了从 SAM 获取更多价值，您还会想要添加来自其他数据源（目标）的指标。 以下技巧将帮助您在生产环境中部署 SAM，从多个目标收集指标并将这些指标组合到您自己的仪表板和图表中。 此外，您还将看到一些可能有助于探索 SAM 容器和应用程序的命令。

*注意：*我应该指出，其中一些技巧和提示可能不是最佳做法；这更像是一个日志，记录了我第一次如何配置 SAM 来监视相同系统上的多个服务器和非 IRIS 目标的基准。 如果您有建议，请在评论中指教 ;) 所以，记住本帖可能会随着时间的推移而有所变化，让我们开始吧；

在下面的技巧中，有重启 docker 以及启动和停止 SAM 的操作。 请通读这些技巧，确定哪些适合您，然后按照下面的相同顺序执行。

1. 确保有足够的空间用于 SAM 数据库

默认情况下，docker 容器将文件存储在根 (/) 文件系统。 SAM 不需要很多 CPU 或内存资源；但是，指标收集将占用空间。

指标需要的

Object Script(二)

• 特殊符号

ObjectScript没有定义任何保留字：你可以自由地使用任何字作为标识符（如变量名）。为了达到这个目的，ObjectScript使用了一组内置的命令以及特殊的字符（比如函数名的"$"前缀），以便将标识符与其他语言元素区分开来。

第145章 XData关键字 - XMLNamespace

指定XData块所属的XML名称空间。

用法

要指定XData块所属的XML名称空间，请使用如下语法:

XData name [ XMLNamespace = "namespaceURL" ] { }

其中namespaceURL是XML名称空间的URI。 注意，这一项是用双引号括起来的。

详情

该关键字指定XData块所属的XML名称空间。

默认

如果省略这个关键字，则该XData块的内容不属于任何名称空间。

示例

XData MyXData [ XMLNamespace = "http://www.mynamespace.org" ]
{
}

第146章 Storage关键字 - DataLocation

指定该类的数据存储位置。

大纲

<DataLocation>^Sample.PersonD</DataLocation>

值

element的值是一个全局变量名称，具有可选的前导下标。

描述

一个表达式，它是存储该类数据的位置。 通常这将是一个全局变量引用，如^User.PersonD。 全局变量引用还可以包含一个或多个前导下标。 例如, ^User.Data("Person")。

在从属类(父-子关系中的子类)中使用{%%PARENT}代替全局或局部变量名也是有效的。 例如,{%%PARENT}(Chil

Object Script(一)

• 概况

ObjectScript是一种用于在InterSystems IRIS数据平台上快速开发编程语言，它是面向对象的弱类型脚本语言，非常适用于各种应用，包括业务逻辑、应用集成和数据处理。

在这里，我将主要介绍ObjectScript的命令脚本，类，方法和Routine等使用方式和语法规范。如有任何疑问，可在InterSystems开发者社区进行深入讨论。

• IDE选择

可以使用InterSystems IRIS内置的Studio或Visual Studio Code（需要安装Object Script扩展）来查看和编辑代码。这里我们使用InterSystems IRIS内置Studio来做示例。

如果你已安装InterSystems IRIS或者InterSystems HS 等任何InterSystems产品，找到右下角的图标 ，单击鼠标右键,点击Studio，如下图所示：

输入用户名和密码(用户名：superuser 密码：安装时自己设置的密码)，即可进入到Studio开发环境，如下图所示：

• Terminal

可以直接打开InterSystems IRIS的终端尝试执行ObjectScript的简单指令。通过右下角的图标 ，单击鼠标右键,点击Term

第141章 触发器关键字 - UpdateColumnList

指定一个或多个列，其修改将导致SQL触发触发器。 仅对TSQL可用。

用法

要指定其修改触发触发器的列，请使用以下语法:

Trigger name [ Event = sqlevent, UpdateColumnList = updatecolumnlist ]  {    //implementation }

其中updatecolumnlist是一个列名或用逗号分隔的列名列表，用括号括起来。

详情

该关键字指定一个或多个列，其修改将触发触发器。 注意，此关键字仅对TSQL可用。

第142章 XData关键字 - Internal

指定这个XData块是否是内部的(不在类文档中显示)。 注意，类文档目前根本没有显示XData。

用法

要指定这个XData块是内部的，请使用以下语法:

XData name [ Internal ]  { }

否则，忽略该关键字或将Not放在该关键字之前。

详情

类文档中不显示内部类成员。 如果希望用户看到一个类而不是它的所有成员，则此关键字非常有用。

注意，类文档目前根本没有显示XData块。

第143章 XData关键字 - MimeType

指定XData块的MIME类型。

用法

要指定XData块的MIME类型，请使用如下语法:

XData name [ MimeTyp

第137章 触发器关键字 - OldTable

指定存储受事件影响的行或语句的旧值的转换表的名称。

用法

要指定存储旧值的转换表的名称，请使用以下语法:

Trigger name [ Event = sqlevent, OldTable = oldtable, NewTable = newtable ] {    //implementation }

其中oldtable是此命名空间中的SQL表的名称。

详情

每个触发器都可以通过转换表(由旧表和新表关键字指定)访问受事件影响的行或语句的旧值和新值。

默认

默认值为空字符串。

第138章 触发器关键字 - Order

在同一个EVENT和TIME有多个触发器的情况下，指定触发器应该触发的顺序。

用法

要指定此触发器的触发顺序，相对于具有相同EVENT和TIME的其他触发器，请使用以下语法:

Trigger name [ Event = sqlevent, Order = n, Time = time ] {    //implementation }

其中n为整数。

详情

在同一个EVENT和TIME有多个触发器的情况下，该关键字指定触发器应该触发的顺序。

默认

默认值为0。

第139章 触发器关键字 - SqlName

指定用于此触发器的SQL名称。

用法

要覆盖此触发器的默认SQL名称，请使用以下语法:

Trigger

第133章 触发器关键字 - Foreach

控制触发器何时被触发。

用法

Trigger name [ Event = sqlevent, Foreach = foreach ]  {    //implementation }

其中foreach是下列值之一:

• row — 该触发器由触发语句影响的每一行触发。 注意，TSQL不支持行级触发器，因此Language关键字的设置必须是objectscript。
• row/object — 此触发器由受触发语句或通过对象访问进行的更改影响的每一行触发。请注意，TSQL不支持行级触发器，因此Language关键字的设置必须为objectscript。

这个选项定义了一个统一触发器，之所以这么叫，是因为它是由通过SQL或对象访问发生的数据更改触发的。 (相比之下，与其他触发器相比，如果在通过对象访问发生更改时使用相同的逻辑，则需要实现回调，如%OnDelete()。)

• statement — 整个语句只触发一次触发器。 ObjectScript和TSQL都支持语句级触发器; 即Language关键字的设置分别为objectscript或tsql。

详情

控制何时触发触发器。

默认

如果省略此关键字，则触发器为行级触发器。

例外

TSQL不支持行级触发器。

第134章 触发器关键字 - Internal

指定此触发器定义是否为内

第129章 查询关键字 - WebMethod

指定这个类查询是否为web方法。 仅应用于定义为web服务或web客户端的类。

用法

要指定这个查询是一个web方法，请使用以下语法:

Query name(formal_spec) As classname [ WebMethod ] {    //implementation }

否则，忽略该关键字或将Not放在该关键字之前。

详情

这个关键字指定这个类查询是否是一个web方法，是否可以通过SOAP协议调用。

默认

如果忽略此关键字，则无法以web方法调用查询。

生成的类

当你将这个关键字添加到类查询并编译类时，类编译器会生成两个额外的类:

• Package.OriginalClass.QueryName
• Package.OriginalClass.QueryName.DS

Package.OriginalClass是包含web方法的类，QueryName是类查询的名称。

例如，假设从类ROBJDemo.QueryWS开始。 ，然后向它添加一个名为MyQuery的类查询。 当你将WebMethod关键字添加到该类查询并编译它时，类编译器会生成以下额外的类:

• ROBJDemo.QueryWS.MyQuery
• ROBJDemo.QueryWS.MyQuery.DS

不要修改或直接使用这些生成的类;它们仅供内部使用。

WSDL

第125章 查询关键字 - SqlName

覆盖投影SQL存储过程的默认名称。 仅当此查询被投影为SQL存储过程时应用。

用法

要覆盖查询投射为SQL存储过程时使用的默认名称，请使用以下语法:

Query name(formal_spec) As classname [ SqlProc, SqlName = sqlname ] {    //implementation }

其中sqlname是SQL标识符。

详解

如果将此查询投影为一个SQL存储过程，则使用此名称作为存储过程的名称。

默认

如果忽略此关键字，查询名称将用作SQL过程名称。

第126章 查询关键字 - SqlProc

指定查询是否可以作为SQL存储过程调用。

用法

要指定查询可以作为SQL存储过程调用，请使用以下语法:

Query name(formal_spec) As classname [ SqlProc ] {    //implementation }

否则，忽略该关键字或将Not放在该关键字之前。

详情

该关键字指定是否可以作为SQL存储过程调用查询。

默认

如果忽略此关键字，则无法将查询作为SQL存储过程调用。

第127章 查询关键字 - SqlView

指定是否将此查询投影为SQL视图。

用法

要指定查询投影为SQL视图，请使用以下语法:

Query name(formal_spec) A

这是一个IRIS 2020.2上的代码示例，并非InterSystems 官方支持！

本demo基于原始类描述 is based on the raw class descriptions.
使用的数据类是Address, Person, Employee, Company
如果要做更有吸引力的 demo, 可以添加 JSONtoString by ID的方法

用ZPM安装后从终端启动：After installation with ZPM just run from Terminal

USER>do ##class(rcc.ONAPI.demo).Run()
Adjust Parameters
host[127.0.0.1]:
port[51773]:
namespace[USER]:
user[_SYSTEM]:
pwd[SYS]:
timeout[5]:
****** connected ********

下一步, 你会得到一系列可能的Demo动作。you get a list of possible demo actions.
没有输入就意味着没有动作No input means no action.
菜单会一直循环直到退出The menu loops until you exit.

Populate Person by:100
     100

这些API虽然在IRIS 2020.1中已经实现了，但没有被放在官方文档里。

这都是直接从Class Reference中提取的，我只是收集了它来创建第一个概述。

ObjectScript的本地API遵循其他语言平台上使用的API。它从一个静态API开始，允许用户使用Iris Connection连接到IRIS命名空间，无论是本地还是远程。连接接口允许用户实例化IRIS本地API类（%Net.DB.Iris）。然后，该实例可用于访问IRIS全局数组，管理事务，调用例程或类中实现的函数和方法，以及实例化远程迭代器。

%Net.DB.DataSource

该类实现了IRIS Native API for Object Script DataSource接口。
目前，该接口仅包含 CreateConnection 方法

CreateConnection 方法接受 url, port, namespace, user, 和 pwd 等参数. 这些参数的信息请参考 %Net.DB.Connection 。CreateConnection() 返回 %Net.DB.Connection的实例

我有一个CSP页面，当我把大量的文本（例如：10000个字符）放到一个提交的表单的一个字段中时，会出现 "414 error - Request-URI Too Long"。该表格是用POST方法提交的。

根据我做的一些实验，似乎一个URL的最大尺寸是8200个字符左右。

官方的限制是什么，是否有办法增加它？我在文档中搜索了一下，但没有找到任何东西。

第121章 查询关键字 - Private

指定查询是否为私有查询。

用法

要指定此查询为私有查询，请使用以下语法：

Query name(formal_spec) As classname [ Private ] {    //implementation }

否则，请省略此关键字或将该词放在该关键字之前。

详解

私有类成员只能由同一类(或其子类)的其他成员使用。请注意，其他语言通常使用单词Protected来描述这种可见性，使用单词Private来表示从子类不可见。

默认

如果省略此关键字，则此查询不是私有的。

第122章 查询关键字 - SoapBindingStyle

指定此查询用作Web方法时使用的绑定样式或SOAP调用机制。仅适用于定义为Web服务或Web客户端的类。

用法

要覆盖查询使用的默认绑定样式(当它用作Web方法时)，请使用以下语法：

Query name(formal_spec) As classname [ WebMethod, SoapBindingStyle = soapbindingstyle ] {    //implementation }

其中soapbindingstyle为下列值之一：

• document - 此Web方法使用文档式调用。

使用这种绑定样式，SOAP消息被格式化为文档，并且通常只有一个部分。

在SOAP消息中，<B

亲爱的社区开发者们，大家好！

欢迎积极参与新一轮InterSystems开发者竞赛！

🏆 InterSystems开发者竞赛：InterSystems IRIS Analytics 🏆

竞赛时间：2021年8月23日-9月12日

奖金总额: $8,750

登录页面即可参赛: https://contest.intersystems.com

第117章 属性关键字 - Transient

指定属性是否存储在数据库中。仅适用于持久类。

用法

要指定属性不存储在数据库中，请使用以下语法：

Property name As classname [ Transient ];

否则，请省略此关键字或将该词放在该关键字之前。

详情

对于持久化类，指定属性不存储在数据库中。

请注意， IRIS验证瞬态属性的方式与验证其他属性的方式相同。例如，当保存对象时，系统会验证其所有属性，包括所有临时属性。

在子类中，可以将非瞬态属性标记为瞬态Transient，但不能反过来。

默认

如果省略此关键字，则属性不是瞬态Transient的。

第118章 查询关键字 - ClientName

此查询的客户端投影使用的别名。

用法

要在将查询投影到客户端语言时覆盖查询的默认名称，请使用以下语法:

Query name(formal_spec) As classname [ ClientName = clientname ] {    //implementation }

其中clientname是在客户端语言中使用的名称。

详情

当查询被投影到客户端语言时，此关键字允许定义查询的替代名称。如果查询名称包含客户端语言中不允许的字符，这尤其有用。

默认

如果省略此关键字，查询名称将用作客户端名称。

第119章 查询关键字 - Final

指定此

第113章 属性关键字 - SqlComputeOnChange

此关键字控制何时重新计算属性。仅适用于触发的计算属性。

用法

要指定何时重新计算属性，请使用以下语法:

Property name As classname [ SqlComputed, SqlComputeCode=sqlcomputecode, SqlComputeOnChange = propertynames ];

其中sqlcomputecode在SqlComputeCode中描述，propertyname是单个属性名或以逗号分隔的属性名列表。该值还可以包括值%%INSERT或%%UPDATE。

请注意，必须使用实际的属性名，而不是SqlFieldname给出的值。

详解

此关键字仅适用于触发的计算属性；对于其他属性，它将被忽略。(触发的计算属性是一个属性，其SqlComputed为真，并且指定了SqlComputeCode，但是其computed和Transient都为假)

此关键字控制重新计算此属性的条件。重新计算可能源于:

• 对任何指定属性的修改。
• 触发器事件的发生。

如果关键字的值为%%INSERT或%%UPDATE，则分别调用INSERT或UPDATE，指定字段(属性)值的事件触发计算。

• 使用%%INSERT，当一行被插入到表中时， IRIS计算字段值。 IRIS调用SQLComputeC

当前医院面临更多互联互通需求，如预约挂号与分级诊疗、检验结果共享、医联体信息化、监管数据上报、临床辅助决策支持等，都需要对多源数据进行集成与整合。医疗机构内部和跨机构数据交换与共享，对互联互通提出新的要求。HL7 FHIR是国际上医疗行业实现数据交换和信息共享的标准之一，正在快速得到医疗行业广泛关注。InterSystems中国技术总监乔鹏在视频中分享了FHIR标准与国际互联互通的一些实践经验。