第七章 操作位和位串（三）

操作位串

要创建新的位串，请使用 $bit 函数将所需位设置为 1：

kill bitstring
 
set $bit(bitstring, 3) = 1
 
set $bit(bitstring, 6) = 1
 
set $bit(bitstring, 11) = 1

使用 $bit 将现有位串中的位设置为 1：

set $bit(bitstring, 5) = 1

使用 $bit 将现有位串中的位设置为 0：

set $bit(bitstring, 5) = 0

由于位串中的第一位是位 1，因此尝试设置位 0 会返回错误：

set $bit(bitstring, 0) = 1
 
SET $BIT(bitstring, 0) = 1
^
<VALUE OUT OF RANGE>

测试位是否已设置

要测试是否在现有位串中设置了位，还可以使用 $bit 函数：

write $bit(bitstring, 6)
1
write $bit(bitstring, 5)
0

如果测试未明确设置的位，则 $bit 返回 0：

write $bit(bitstring, 4)
0
write $bit(bitstring, 55)
0

显示位

要显示位串中的位，请使用 $bitcount 函数获取位串中位的计数，然后遍历位：

for

Hi 社区,

这是海外工程师做的一个纯浏览器的代码编辑器CloudStudio. 欢迎大家下载试用：

GitHub 下载：

https://github.com/SeanConnelly/CloudStudio

InterSystems 应用市场下载：https://openexchange.intersystems.com/package/CloudStudio

到Discord 讨论区：https://discord.gg/ZnvdMywsjP
 

Docker 支持与在线Demo：

要求

已安装 git 和 Docker desktop .

安装

Clone/git 把 repo 导入任何本地目录

git https://github.com/rcemper/Dataset-OEX-reviews.git

启动IRIS容器:

docker-compose up -d --build

如何测试

http://localhost:42773/cloudstudio/CloudStudio.Index.cls

或使用在线Demo 

Demo 视频：https://www.youtube.com/watch?v=Am6QAvrPPPg

第六章 操作位和位串（二）

将位序列存储为整数

如果要将一系列布尔参数传递给方法，一种常见的方法是将它们作为编码为单个整数的位序列传递。

例如，Security.System.ExportAll() 方法用于从 IRIS 实例中导出安全设置。如果查看此方法的类引用，将看到它的定义如下：

classmethod ExportAll(FileName As %String = "SecurityExport.xml", 
ByRef NumExported As %String, Flags As %Integer = -1) as %Status

第三个参数 Flags 是一个整数，其中每个位代表一种可以导出的安全记录。

如果您使用InterSystems技术开发了自己的网络应用，现在想在客户端进行验证码验证，以确定用户真实性使其更加安全。有一些现代框架可以解决验证码的问题，然而它们中的大多数需要互联网接入来生成代码，有时实施起来很复杂。考虑到图像识别已经非常成熟，您可以参考本文为基本例子。这就是为什么现在倾向于看到更多的模式识别验证码而不是单纯的阅读验证码。(例如，点击所有有店面的图片）。如果你需要更复杂的东西，请继续开发，改进这个代码并分享它。 继续阅读以了解如何使用这个基本的例子:

Demo.Captcha class

使用这个类，你可以在一个物理目录上创建验证码图像文件，以便在你的应用程序上显示。请注意，创建图像的目录必须是可用的，以便你的Web应用程序访问这些图像。要创建验证码图像，请调用以下方法，将完整的文件名作为一个参数:

创建 image 文件

InterSystems正在招聘Technical Specialist（Implementation），欢迎您的自荐、推荐。

InterSystems正在招聘Technical Specialist（Product Support），欢迎您的自荐、推荐。

我们正在招聘Support Facilitator，欢迎您的自荐、推荐。

第五章 操作位和位串

有时可能希望在基于数据平台的应用程序中存储一系列相关的布尔值。可以创建许多布尔变量，也可以将它们存储在数组或列表中。或者可以使用称为“位串”的概念，它可以定义为位序列，首先呈现最低有效位。位串允许您以非常有效的方式存储此类数据，无论是在存储空间还是处理速度方面。

位串可以以两种方式之一存储，作为压缩字符串或整数。如果在没有上下文的情况下听到术语“位串”，则表示位序列存储为压缩字符串。本文向介绍了这两种类型的位串，然后介绍了一些可用于操作它们的技术。

将位序列存储为位串

存储位序列的最常见方式是在位串中，这是一种特殊的压缩字符串。除了节省存储空间外，还可以使用 ObjectScript 系统函数有效地操作位串。

这样的系统函数是 $factor，它将整数转换为位串。我们可以通过执行以下语句将整数 11744 转换为位串：

set bitstring = $factor(11744)

要查看位串内容的表示，可以使用 zwrite 命令：

zwrite bitstring
bitstring=$zwc(128,4)_$c(224,45,0,0)/*$bit(6..9,11,12,14)*/

起初它看起来很神秘，但在输出的末尾，会看到一条注释，其中显示了已设置的实际位的列表：6、7、8、9、11、12 和 14。位串中的位 1表示 2^0，位 2 表示 2^1，依此类推

安装Arbiter

为了将自动故障转移扩展到尽可能广泛的故障情况，InterSystems建议你为每个镜像配置一个仲裁机。

要充当仲裁者，系统必须有一个正在运行的ISCAgent进程。由于ISCAgent是与InterSystems IRIS一起安装的，任何承载一个或多个InterSystems IRIS实例的系统都符合这一要求，可以被配置为仲裁者而无需进一步准备；但是，承载一个或多个故障转移或DR异步镜像成员的系统不应该被配置为该镜像的仲裁者。

没有托管InterSystems IRIS实例的系统可以通过安装Arbiter方式的作为仲裁者。请从InterSystems公司下载适合你的仲裁者系统平台的ISCAgent安装包，然后，安装ISCAgent。

注意：Arbiter的版本要和InterSystems IRIS安装版本保持一致。

在Windows上安装Arbiter

在Windows系统上，只需执行安装文件，例如ISCAgent-2020.1.0.540.0-win_x64.exe。

在Linux上安装Arbiter

[root@arbiterhost home]# gunzip ISCAgent-2020.1.0.540.0-lnxrhx64.tar.gz
[root@arbiterhost home]# tar -xf ISCAgent-2020.1.0.540.

第四章 锁定和并发控制（四）

避免死锁

增量锁定具有潜在危险，因为它可能导致称为死锁的情况。当两个进程各自对已被另一个进程锁定的变量断言增量锁定时，就会出现这种情况。因为尝试的锁是增量的，所以现有的锁不会被释放。结果，每个进程在等待另一个进程释放现有锁的同时挂起。

举个例子：

1. 进程 A 发出此命令：lock + ^MyGlobal(15)
2. 进程 B 发出此命令：lock + ^MyOtherGlobal(15)
3. 进程 A 发出此命令：lock + ^MyOtherGlobal(15)

此 LOCK 命令不返回；进程被阻塞，直到进程 B 释放这个锁。

4. 进程 B 发出此命令：lock + ^MyGlobal(15)

此 LOCK 命令不返回；进程被阻塞，直到进程 A 释放这个锁。但是，进程 A 被阻塞，无法释放锁。现在这些进程都在等待对方。

有几种方法可以防止死锁：

• 始终包含 timeout 参数。
• 对于发出增量 LOCK 命令的顺序，请遵循严格的协议。只要所有进程都遵循相同的锁名称顺序，就不会发生死锁。一个简单的协议是按排序顺序添加锁。
• 使用简单锁定而不是增量锁定；也就是说，不要使用 + 运算符。如前所述，对于简单锁定，LOCK 命令首先释放进程持有的所有先前锁定。 （然而，在实践中，简单的锁定并不经常使用。

第三章 锁定和并发控制（三）

升级锁

使用升级锁来管理大量锁。当锁定数组的节点时，它们是相关的，特别是当将多个节点锁定在同一下标级别时。

当给定进程在同一数组中的给定下标级别创建了超过特定数量（默认为 1000）的升级锁时， 将删除所有单独的锁名称并用新锁替换它们。新锁位于父级，这意味着数组的整个分支被隐式锁定。示例（如下所示）演示了这一点。

应用程序应在合适的情况下尽快释放特定子节点的锁（与非升级锁完全相同）。当释放锁时， 会减少相应的锁计数。当的应用程序移除足够多的锁时，会移除父节点上的锁。第二小节显示了一个示例。

锁升级示例

假设有 1000 个^MyGlobal("sales","EU",salesdate) 形式的锁，其中 salesdate 表示日期。锁表可能如下所示：

注意 Owner 19776 的条目（这是拥有锁的进程）。 ModeCount 列指示这些是共享的、升级的锁。

当同一进程试图创建另一个相同形式的锁时， 会升级它们。它会移除这些锁并用名称为 ^MyGlobal("sales","EU") 的单个锁替换它们。现在锁表可能如下所示：

ModeCount 列表明这是一个共享的升级锁，它的计数是 1001。

请注意以下关键点：

• ^MyGlobal("sales","EU") 的所有子节点现在都被隐式锁定，遵循数组锁定的基本规则。

第二章 锁定和并发控制（二）

关于零超时的说明

如上所述，如果您将 timeout 指定为 0， 会添加锁。但是，如果使用零超时锁定父节点，并且已经在子节点上锁定，则忽略零超时并使用内部 1 秒超时。

删除锁

要删除默认类型的锁，请使用 LOCK 命令，如下所示：

LOCK -lockname

如果执行此命令的进程拥有具有给定名称的锁（默认类型），则此命令将删除该锁。或者，如果进程拥有多个锁（默认类型），此命令将删除其中一个。

或者删除另一种类型的锁：

LOCK -lockname#locktype

其中 locktype 是一串锁类型代码。

LOCK 命令的其他基本变体

为了完整起见，本节讨论 LOCK 命令的其他基本变体：使用它来创建简单的锁并使用它来删除所有锁。这些变化在实践中并不常见。

创建简单的锁

对于 LOCK 命令，如果省略 + 运算符，LOCK 命令首先会删除该进程持有的所有现有锁，然后尝试添加新锁。在这种情况下，锁称为简单锁而不是增量锁。一个进程可以拥有多个简单的锁，如果该进程使用如下语法同时创建它们：

 LOCK (^MyVar1,^MyVar2,^MyVar3)

简单的锁在实践中并不常见，因为通常需要持有多个锁并在代码的不同步骤中获取它们。因此使用增量锁更实用。

但是，如果简单锁适合，请注意，可以在创建简单锁时指定 locktype 和 timeout 参数。

各位：请教一下如何使用代码从一个已有的模板类修改类名后复制一个新的类出来。

第一章 锁定和并发控制（一）

任何多进程系统的一个重要特征是并发控制，即防止不同进程同时更改特定数据元素的能力，从而导致损坏。 提供了一个锁管理系统。本文提供了一个概述。

此外，%Persistent 类提供了一种控制对象并发访问的方法，即 %OpenId() 的并发参数和该类的其他方法。这些方法最终使用本文讨论的 ObjectScript LOCK 命令。所有持久对象都继承这些方法。同样，系统会自动对 INSERT、UPDATE 和 DELETE 操作执行锁定（除非指定 %NOLOCK 关键字）。

%Persistent 类还提供方法 %GetLock()、%ReleaseLock()、%LockId()、%UnlockId()、%LockExtent() 和 %UnlockExtent()。

介绍

基本的锁定机制是 LOCK 命令。此命令的目的是延迟一个进程中的活动，直到另一个进程发出可以继续进行的信号。

锁本身并不能阻止活动行为。锁定仅按约定起作用：它要求相互竞争的进程都使用相同的锁定名称实现锁定。例如，下面描述了一个常见的场景：

1. 进程 A 发出 LOCK 命令， 创建一个锁（默认情况下，一个独占锁）。通常，进程 A 然后对global中的节点进行更改。详细信息是特定于应用程序的。
2. 进程 B 发出具有相同锁名称的 LOCK 命令。因为存在一个现有的排他锁，所以进程 B 暂停。

Hi 开发者们，
你或许已经知道了，今年InterSystems全球峰会线下会议再次开启！我们非常期待能在现场见到诸位！ 

然而，并不是所有的开发者社区成员都有机会参加（我也是！）所以我们决定制作一个很酷的视频收集来自社区成员们问候🎥 
无论身在何方，让我们一同以虚拟方式来参加这次伟大的盛会吧！🌏 

⬆️要求：您录制一句2-3秒的短视频，视频内容是向我们的社区成员说 “Hi From your country (来自XX的问候，英语视频最佳）”，然后将视频上传至 这里 ，这样，我们可以把来自各地的许多视频剪辑在一起，在2022年全球峰会上展示。您也可以通过开发者社区联系我，将视频直接分享给我。

截止日期：美东时间6月18日（周五）

期待见到你！

问：

我有一个专有的JSON，需要转换为SDA并保存到一个SDA文件。

如何将json转化为SDA并写入文件？

谢谢

第九章 其他参考资料（二）

特殊变量 (SQL)

系统提供的变量。

$HOROLOG
$JOB
$NAMESPACE
$TLEVEL
$USERNAME
$ZHOROLOG
$ZJOB
$ZPI
$ZTIMESTAMP
$ZTIMEZONE
$ZVERSION

SQL直接支持许多对象脚本特殊变量。这些变量包含系统提供的值。只要可以在SQL中指定文字值，就可以使用它们。

SQL特殊变量名不区分大小写。大多数可以使用缩写来指定。

在找 HealthShare Patient Index 的相关视频和资料，求分享，谢谢

这篇文章是上一篇文章的延续https://cn.community.intersystems.com/post/首次使用intersystems-iris-互操作性-一个production是什么？

在上一篇文章：https://cn.community.intersystems.com/post/首次使用intersystems-iris-互操作性-一个production是什么？  我们查验了什么是Production. 我们运行了示例代码，并在Visual Trace 页面查验了如何将流动消息的内容引入进Production中。

本文将回顾消息messages的概念和定义，和消息如何在系统集成所需的开发内容中用于组件之间发送和接收数据。

• Production生产http://[https://cn.community.intersystems.com/post/首次使用intersystems-iris-互操作性-一个production是什么？  
• Message消息
• Components组件
  
  • Business Services业务服务
  • Business Processes业务流程
  • Business Operations业务操作

在创建 一个Message消息之前，让我们回顾一个案例研究。

第八章 其他参考资料（一）

默认用户名和密码(SQL)

IRIS® 数据平台提供了用于登录数据库和开始使用的默认用户名和密码。默认用户名为“_SYSTEM”(大写)，密码为“sys”。

SQLCODE错误代码(SQL)

执行大多数 SQL操作都会发出SQLCODE值。发出的SQLCODE值为0、100和负整数值。

• SQLCODE=0表示SQL操作成功完成。对于SELECT语句，这通常意味着从表中成功检索数据。但是，如果SELECT执行聚合操作(例如：SELECT SUM(Myfield))，则聚合操作成功，即使myfield中没有数据，也会发出SQLCODE=0；在这种情况下，SUM返回NULL，%ROWCOUNT=1。
• SQLCODE=100表示SQL操作成功，但没有找到可操作的数据。发生这种情况的原因有很多。对于SELECT，这些包括：指定表不包含数据；表不包含满足查询条件的数据；或者行检索已到达表的最后一行。对于UPDATE或DELETE，它们包括：指定的表不包含数据；或者表不包含满足WHERE子句条件的数据行。在这些情况下，%ROWCOUNT=0。
• SQLCODE=-n表示错误。负整数值指定发生的错误类型。SQLCODE=-400是通用的致命错误代码。

字段约束(SQL)

字段约束指定管理字段允许的数据值的规则。

这是一个在InterSystems IRIS中用python和objectscript建立的对比测试。

测试目的是比较在python和objectscript中从BP到BO来回发送一千条请求/消息的速度。

更多信息，请访问 https://github.com/LucasEnard/benchmark-python-objectscript。

重要提示 : 这里用的是python, graph objectscipt和objectscript从一个BP到一个BO来回发送1000条消息的时间，单位是秒。

字符串信息是由十个字符串变量组成。

对象信息由十个对象变量组成，每个对象都是它自己的int、float、str和List（str）。

行中函数的时间是列中函数的x倍 :

孕产妇风险可以通过一些医学界众所周知的参数来测量。这样，为了帮助医学界和计算机系统，特别是人工智能，科学家Yasir Hussein Shakir发布了一个非常有用的数据集，用于训练检测/预测孕产妇风险的机器学习（ML）算法。这份出版物可以在最大和最知名的ML数据库Kaggle上找到，网址是 https://www.kaggle.com/code/yasserhessein/classification-maternal-healt….

关于数据集

由于缺乏怀孕期间和怀孕后的孕产妇保健信息，许多孕妇死于怀孕问题。这在农村地区和新兴国家的中下层家庭中更为常见。在怀孕期间，应时刻注意观察，以确保婴儿的正常成长和安全分娩 (来源: https://www.kaggle.com/code/yasserhessein/classification-maternal-healt…).

数据是通过基于物联网的风险监测系统，从不同的医院、社区诊所、孕产妇保健机构收集而来。

• Age（年龄）: 妇女怀孕时的年龄，以岁为单位。
• SystolicBP （收缩压）: 血压的最高值（mmHg），这是怀孕期间的另一个重要属性。
• DiastolicBP（舒张压）: 血压的较低值（mmHg），这是怀孕期间的另一个重要属性。

肾脏疾病可以从一些医学界熟知的参数中发现。这样，为了帮助医学界和计算机系统，特别是人工智能，科学家Akshay Singh发表了一个非常有用的数据集，用于训练肾脏疾病检测/预测方面的机器学习（ML)算法。这份出版物可以在最大和最知名的ML数据库Kaggle上找到，网址是https://www.kaggle.com/datasets/akshayksingh/kidney-disease-dataset&#12…;

关于数据集

该肾脏疾病数据集有以下元数据信息（来源：https://www.kaggle.com/datasets/akshayksingh/kidney-disease-dataset):

• 它有400行，有25个特征，如红细胞、足部水肿、糖等等。
• 其目的是对病人是否患有慢性肾脏病进行分类。
• 分类是基于一个名为 "classification "（分类）的属性，属性值是 "ckd"（慢性肾脏病）或 "notckd"（不是慢性肾脏病）。
• 数据集作者对数据集进行了清洗，包括将文本映射为数字和其他一些变化。在清洗之后，数据集作者做了一些EDA（探索性数据分析），然后将数据集分为训练和测试两部分，并在上面应用模型。据观察，最初的分类结果并不令人满意。因此，数据集的作者没有放弃有Nan（非数）值的行，而是用lambda函数将其替换为每一列的模式。

第五章 管理全局变量（一）

管理门户提供管理全局变量的工具，系统类提供执行某些相同任务的方法。本章介绍如何使用这些工具。

一般建议

与ObjectScript命令SET、MERGE、KILL和其他命令一样，这里描述的工具提供了直接访问操作全局变量的权限。如果通过全局访问删除或修改，则会绕过所有对象和SQL完整性检查，并且没有撤消选项。因此，在执行这些任务时要非常小心，这一点很重要。(查看和导出不会影响数据库，并且是安全活动。)

使用本章中介绍的工具时，请确保以下事项：

• IRIS使用哪些全局变量。并不是所有这些都被视为“系统”全局变量-也就是说，即使没有选中“系统”复选框，它们中的一些也是可见的。其中一些全局变量存储代码，包括的代码。
• 确保知道应用程序使用哪些全局变量。

即使应用程序从不执行任何直接全局访问，应用程序也会使用全局变量。请记住，如果创建持久类，则它们的数据和任何索引都存储在全局变量中，全局变量的名称基于类名(默认情况下)。

“全局变量”页简介

管理门户包括全局页面，该页面允许管理全局。在此页上，可以执行以下操作：

• 在该全局的行中选择View以检查它。
• 在该全局的行中选择编辑以对其进行修改。
• 选择导出以导出全局变量。
• 选择导入以导入全局变量。
• 选择删除以删除全局变量。
• 选择查找以查找全局变量中的值。

此页还包括用于查看例程和类的选项；此处不讨论这些选项。

SUTA培训是InterSystems专为SUTA有效期客户提供的原厂产品技术服务，具体包括产品的基础管理、编程管理、高级管理和开发培训等。即日起2022 SUTA培训报名启动，本年度为针对InterSystems数据平台产品的线上培训，一共6期12个课程，其中每期两个课程，时间安排在周五下午半天（6月24日—8月5号），6期培训总时长共计三天。点击此处报名，或者扫描下图中的二维码报名，在您的报名信息经过审核后，我们会与您进一步沟通线上培训细节。快来报名吧！

第七章 日期和时间构造

验证和转换 ODBC 日期、时间或时间戳。

大纲

{d 'yyyy-mm-dd'}
{d nnnnnn}

{t 'hh:mm:ss[.fff]'}
{t nnnnn.nnn}

{ts 'yyyy-mm-dd [hh:mm:ss.fff]'}
{ts 'mm/dd/yyyy [hh:mm:ss.fff]'}
{ts nnnnnn}

描述

这些构造采用 ODBC 日期、时间或时间戳格式的整数或字符串，并将其转换为相应的 IRIS 日期、时间或时间戳格式。他们执行数据输入以及值和范围检查。

{d 'string'}

{d 'string'}日期构造验证 ODBC 格式的日期。如果日期有效，它将以 IRIS $HOROLOG 日期格式存储（逻辑模式）作为 1840-12-31 的整数计数值。 IRIS 不附加默认时间值。要支持早于 1840-12-31 的日期，必须在表中定义数据类型为 %Library.Date(MINVAL=-nnn) 的日期字段，其中 MINVAL 是从 1840-12-31 倒数的负天数（第 0 天）最大为 -672045 (0001-01-01)。

• 小于 -672045 (0001-01-01) 或大于 2980013 (9999-12-31) 的整数会生成 SQLCODE -400 <VALUE OUT OF RANGE>错误。

第六章 数据类型（五）

数据类型的整数代码

在查询元数据和其他上下文中，为列定义的数据类型可以作为整数代码返回。 CType（客户端数据类型）整数代码列在 %SQL.StatementColumn clientType 属性中。

ODBC 和 JDBC 使用 xDBC 数据类型代码 (SQLType)。 ODBC 数据类型代码由 %SQL.Statement.%Metadata.columns.GetAt() 方法返回，如上例所示。 SQL Shell 元数据还返回 ODBC 数据类型代码。 JDBC 代码与 ODBC 代码相同，除了时间和日期数据类型的表示。

在检查我们的^pButtons（在IRIS中改名为^SystemPerformance）性能监控工具的文档时，一位客户告诉我。"我理解所有内容，但我希望它能更简单......更容易定义配置文件，管理它们等等"。

在这次会议之后，我认为尝试为其提供一些更简单的人机界面是一个不错的试验。

这方面的第一步是在现有的pButtons例程上包裹一个基于类的API。

我还能够添加一些更多的 "功能"，比如显示当前正在运行的配置文件，它们剩余的运行时间，以前运行的进程等等。

下一步是在这个API的基础上添加一个REST API类。

有了这个工件（pButtons REST API），人们就可以在上面建立一个比较时髦的用户界面。

举个🌰： -

第五章 数据类型（四）

Strings

%Library.String 数据类型支持的最大字符串长度为 3,641,144 个字符。通常，极长的字符串应分配为 %Stream.GlobalCharacter 数据类型之一。

因为 IRIS 支持 xDBC 协议 50 和更高版本，所以没有强制执行 ODBC 或 JDBC 字符串长度限制。如果 IRIS 实例和 ODBC 驱动程序支持不同的协议，则使用两个协议中较低的一个。实际使用的协议记录在 ODBC 日志中。

请注意，默认情况下 IRIS 建立系统范围的 ODBC VARCHAR 最大长度为 4096；此 ODBC 最大长度是可配置的。

列表结构

IRIS 支持列表结构数据类型 %List（数据类型类 %Library.List）。这是一种压缩的二进制格式，不会映射到 SQL 的相应本机数据类型。在其内部表示中，它对应于数据类型 VARBINARY，默认 MAXLEN 为 32749。 IRIS 支持列表结构数据类型 %ListOfBinary（数据类型类 %Library.ListOfBinary）对应于数据类型 VARBINARY，默认 MAXLEN 为 4096。

因此，动态 SQL 不能在 WHERE 子句比较中使用 %List 数据。也不能使用 INSERT 或 UPDATE 来设置 %List 类型的属性值。