#Caché

发布职位 关注
1 关注者 · 991 帖子

  

InterSystems Caché 是一个多模型 DBMS 和应用服务器。

查看此处提供的更多详细信息。

文档。

发布职位 关注
文章 姚 鑫 · 七月 17, 2022 4m read

第八章 使用嵌入式 Python （五）

第八章 使用嵌入式 Python （五）

通过引用传递参数

用 ObjectScript 编写的方法中的参数可以通过值或引用传递。在下面的方法中，签名中第二个和第三个参数前面的 ByRef 关键字表示它们打算通过引用传递。

ClassMethod SandwichSwitch(bread As %String, ByRef filling1 As %String, ByRef filling2 As %String)
{
    set bread = "whole wheat"
    set filling1 = "almond butter"
    set filling2 = "cherry preserves"
}

从 调用方法时，在参数前放置一个句点以通过引用传递它，如下所示：

USER>set arg1 = "white bread"
 
USER>set arg2 = "peanut butter"
 
USER>set arg3 = "grape jelly"
 
USER>do ##class(User.EmbeddedPython).SandwichSwitch(arg1, .arg2, .arg3)
 
USER>write arg1
white bread
USER>write arg2
almond butter
USER>write arg3
cherry preserves
#Caché ##嵌入式 Python
0
0 133
文章 姚 鑫 · 七月 16, 2022 4m read

第七章 使用嵌入式 Python （四）

第七章 使用嵌入式 Python （四）

弥合 ObjectScript 和嵌入式 Python 之间的差距

由于 ObjectScript 和 Python 语言之间的差异，将需要了解一些有助于弥合语言之间差距的信息。

在 ObjectScript 方面， 类允许从 ObjectScript 使用 。

在 方面， 模块允许使用 Python 中的 。在 中，键入 以获取其方法和函数的列表。

使用 Python 内置函数

包在 解释器启动时自动加载，它包含语言的所有内置标识符，例如基对象类和所有内置数据类型类、异常类、函数和常量。

可以将此包导入 ObjectScript 以访问所有这些标识符，如下所示：

set builtins = ##class(%SYS.Python).Import("builtins")

函数实际上是内置模块的一个方法，因此现在可以在 中使用此函数：

USER>do builtins.print("hello world!")
hello world!

然后可以使用 命令检查内置对象，因为它是一个 对象，所以它使用内置包的 方法来获取该对象的字符串表示形式。例如：

出于同样的原因，可以使用 方法创建 列表。

#Caché ##嵌入式 Python
0
0 155
文章 姚 鑫 · 七月 15, 2022 5m read

第六章 使用嵌入式 Python （三）

第六章 使用嵌入式 Python （三）

从 ObjectScript 调用嵌入式 Python 代码

使用 Python 库

嵌入式 Python 让可以轻松访问数以千计的有用库。通常称为“包”，它们需要从 Python 包索引 (PyPI) 安装到 /mgr/python 目录中，然后才能使用。

例如， 是一个用于生成 和图形的开源库。以下命令使用软件包安装程序 irispip 在 系统上安装 ：

在基于 的系统上，使用：

$ pip3 install --target /InterSystems/IRIS/mgr/python reportlab

安装包后，可以使用 %SYS.Python 类的 方法在 代码中使用它。

给定一个文件位置，以下 方法 创建一个示例 PDF 文件并将其保存到该位置。

Class Demo.PDF
{

ClassMethod CreateSamplePDF(fileloc As %String) As %Status
{
    set canvaslib = ##class(%SYS.Python).Import("reportlab.pdfgen.canvas")
    set canvas = canvaslib.Canvas(fileloc)
    do canvas.drawImage("C:\Sample\isc.png", 150, 600)
    do canvas.drawImage("C:\Sample\python.png", 150, 200)
    do canvas.setFont("Helvetica-Bold", 24)
    do canvas.drawString(25, 450, "InterSystems IRIS & Python. Perfect Together.")
    do canvas.save()
}

}
#Caché ##嵌入式 Python
0
0 234
文章 姚 鑫 · 七月 14, 2022 3m read

第五章 使用嵌入式 Python （二）

第五章 使用嵌入式 Python （二）

在 Python 脚本文件 (.py) 中

还可以使用 irispython 命令执行 Python 脚本。

考虑 Windows 系统上的文件 ，其中包含以下代码：

# print the members of the Fibonacci series that are less than 10
print('Fibonacci series:')
a, b = 0, 1
while a < 10:
    print(a, end=' ')
    a, b = b, a + b

# import the iris module and show the classes in this namespace
import iris
print('\nInterSystems IRIS classes in this namespace:')
status = iris.cls('%SYSTEM.OBJ').ShowClasses()
print(status)

可以从命令行运行 ，如下所示：

C:\InterSystems\IRIS\bin>set IRISUSERNAME = <username>

C:\InterSystems\IRIS\bin>set IRISPASSWORD = <password>

C:\InterSystems\IRIS\bin>set IRISNAMESPACE = USER

C:\InterSystems\IRIS\bin>irispython \python\test.py
Fibonacci series:
0 1 1 2 3 5 8
InterSystems IRIS classes in this namespace:
User.Company
User.Person
1
#Caché ##嵌入式 Python
0
0 160
文章 姚 鑫 · 七月 13, 2022 3m read

第四章 使用嵌入式 Python（一）

第四章 使用嵌入式 Python （一）

嵌入式 Python 允许使用 Python 作为编程 IRIS 应用程序的本机选项。

预备知识

使用嵌入式 所需的 版本取决于运行的平台。

在 Microsoft Windows 上， 安装工具包安装正确版本的 Python（当前为 ），仅用于嵌入式 。如果在开发机器上并希望将 用于一般用途，建议从 下载并安装相同的版本。

许多基于 UNIX 的操作系统都安装了 。如果需要安装，请使用包管理器为操作系统推荐的版本，例如：

  • macOS：使用 Homebrew 安装 Python 3.9
  • :
  • :

如果收到“无法加载 ”的错误，这意味着没有安装 Python，或者系统上安装了意外版本的 。使用上述方法之一安装或重新安装。

在基于 的系统上，可能希望使用 命令安装 包。如果尚未安装 ，请使用系统的包管理器安装包 。

要防止在运行 时出现 错误，请启用 。在管理门户中，，选择 ，然后选中启用服务框。

运行嵌入式 Python

本节详细介绍了运行 的几种方法：

从Python Shell

可以从终端会话或命令行启动 。

从终端启动 Python Shell

通过调用 类的 方法，从 终端会话启动 。这将以交互模式启动 解释器。终端会话中的用户和命名空间被传递给 。

通过键入命令 退出 。

#Caché #SQL
0
0 306
文章 姚 鑫 · 七月 12, 2022 6m read

第三章 嵌入式Python概述（三）

第三章 嵌入式Python概述（三）

使用 SQL

IRIS 中的类被投影到 SQL，除了使用类方法或直接全局访问之外，还允许使用查询访问数据。 iris 模块为提供了两种从 运行 语句的不同方式。

以下示例使用 运行 语句以查找类名称以“%Net.LDAP”开头的所有类定义，返回一个包含每个名称和超类的结果集每个班级。在这里，系统类 将 投影为同名表。

>>> rs = iris.sql.exec("SELECT Name, Super FROM %Dictionary.ClassDefinition WHERE Name %STARTSWITH '%Net.LDAP'")

以下示例使用 准备 查询对象，然后执行查询，将“%Net.LDAP”作为参数传入：

>>> stmt = iris.sql.prepare("SELECT Name, Super FROM %Dictionary.ClassDefinition WHERE Name %STARTSWITH ?")
>>> rs = stmt.execute("%Net.LDAP")

无论哪种情况，都可以按如下方式遍历结果集，并且输出相同：

>>> for idx, row in enumerate(rs):                                              
...     print(f"[{idx}]: {row}")                                                
...
[0]: ['%Net.LDAP.Client.EditEntry', '%RegisteredObject']
[1]: ['%Net.LDAP.Client.Entries', '%RegisteredObject,%Collection.AbstractIterator']
[2]: ['%Net.LDAP.Client.Entry', '%RegisteredObject,%Collection.AbstractIterator']
[3]: ['%Net.LDAP.Client.PropList', '%RegisteredObject']
[4]: ['%Net.LDAP.Client.Search.Scope', '%Integer']
[5]: ['%Net.LDAP.Client.Session', '%RegisteredObject']
[6]: ['%Net.LDAP.Client.StringList', '%RegisteredObject']
[7]: ['%Net.LDAP.Client.ValueList', '%RegisteredObject,%Collection.AbstractIterator']
#Caché ##嵌入式 Python
1
0 179
文章 姚 鑫 · 七月 11, 2022 4m read

第二章 嵌入式Python概述（二）

第二章 嵌入式Python概述（二）

从 Python 调用 IRIS API

如果使用的是嵌入式 Python 并且需要与 IRIS 交互，可以使用 Python shell 中的 模块，或者使用 编写的 类中的方法。要遵循本节中的示例，可以使用 命令 从终端会话启动 。

当启动终端会话时，将被放置在 的 命名空间中，将看到提示 USER>。但是，如果从 加载了示例类，则需要在 命名空间中才能访问它们。

在终端中，更改为 命名空间，然后启动 ，如下所示：

USER>set $namespace = "SAMPLES"
SAMPLES>do ##class(%SYS.Python).Shell()

Python 3.9.5 (default, Jul 19 2021, 17:50:44) [MSC v.1927 64 bit (AMD64)] on win32
Type quit() or Ctrl-D to exit this shell.
>>>

当从终端会话启动 时，Python shell 继承与终端相同的上下文，例如，当前命名空间和用户。局部变量不被继承。

使用类

要从 访问 类，请使用 模块来实例化要使用的类。然后，可以像访问

#Caché
0
0 147
文章 姚 鑫 · 七月 10, 2022 5m read

第一章 嵌入式Python概述（一）

第一章 嵌入式Python概述（一）

嵌入式 Python 允许将 Python 与 IRIS 数据平台的本地编程语言 ObjectScript 一起使用。当使用嵌入式 在 类中编写方法时， 源代码与编译后的 代码一起编译为在服务器上运行的目标代码。与使用网关或 的 相比，这允许更紧密的集成。还可以导入 包，无论它们是自定义的还是公开的，并在 代码中使用它们。 对象是 中的一等公民，反之亦然。

  • 使用来自 ObjectScript 的 Python 库 - 此方案假设 开发人员，并且希望利用 开发人员社区可用的众多 库的强大功能。
  • 从 调用 — 此方案假定您是一名 开发人员，对 IRIS 不熟悉，并且想知道如何访问 。
  • 一起使用 和 — 这个场景假设在一个由 ObjectScript 和 开发人员组成的混合团队中，并且想知道如何一起使用这两种语言。

将需要 或更高版本的正在运行的 实例，以及取决于操作系统的一些先决条件。还需要知道如何访问终端，即 IRIS 命令行工具。

本文档中的一些示例使用来自 上 存储库的类：https://github.com/intersystems/Samples-Data。 建议创建一个名为 的专用命名空间并将样本加载到该命名空间中。如果想查看或修改示例代码，则需要设置集成开发环境 ()。推荐使用 。

#Caché #SQL
0
0 313
文章 姚 鑫 · 七月 10, 2022 7m read

第二十三章 使用 %Status 值

第二十三章 使用 %Status 值

许多类使用 %Status 数据类型类来表示状态信息，并且它们的方法返回表示成功或错误的 %Status 值（状态）。如果状态表示一个错误（或多个错误），则状态值还包括有关错误的信息。

还可以返回自己的状态值。

本文讨论状态值以及如何使用它们。

使用状态值的基础知识

如上所述，许多 类中的方法返回一个状态以指示成功或错误。例如，%Library.Persistent中的%Save()` 方法返回一个状态。对于任何此类方法，请务必获取返回值。然后检查状态，然后适当地继续。基本工具如下：

  • 要检查状态是表示成功还是错误，请使用以下任一方法：

    • $$$ISOK 和 $$$ISERR 宏，在包含文件 %occStatus.inc 中定义。此包含文件在所有对象类中自动可用。
    • 和 方法，它们在终端（不能使用宏）中特别方便。

  • 要显示错误详细信息，请使用 $SYSTEM.OBJ.DisplayError() 或 。这些方法彼此等效。他们将输出写入当前设备。

  • 要获取包含错误详细信息的字符串，请使用 。

示例

/// d ##class(PHA.TEST.AdvancedConcepts).Status()
ClassMethod Status()
{
	s object = ##class(Sample.Person).%New()
	s object.Name = "yao,xin"
	s tSC = object.%Save()
	if $$$ISERR(tSC) {
		d $SYSTEM.OBJ.DisplayError(tSC)
		q
	}
}
#Caché
0
0 146
文章 姚 鑫 · 七月 8, 2022 2m read

第二十二章 安全自定义 Web 应用程序登录

第二十二章 安全自定义 Web 应用程序登录

除了推荐的 REST 应用程序支持之外，产品还支持两种类型的传统 Web 应用程序：CSP 和 。在配置使用 和 的自定义登录页面时，遵循推荐的协议很重要。这些协议提供了更高的安全性，并最大限度地减少了升级到新产品或版本时的不兼容性。

关于创建自定义 CSP 登录页面

创建自定义 登录页面：

  1. 创建 %CSP.Login 页面的子类。
  2. 要自定义应用程序的行为，请覆盖子类的 Draw 方法，以便页面看起来像想要的那样。其中包括修改登录页面外观的方法和修改安全令牌页面外观的方法（如果使用双因素身份验证）：
  • 登录页面方法——、DrawHEAD、DrawSTYLE、
  • 安全令牌 (ST) 页面方法 — 、

请注意， 和 DrawSTTitle 方法调用 DrawTitleSection 方法。

  1. 在应用程序中根据需要调用子类。

重要提示：创建自定义登录页面时，必须使用 的子类。在 应用程序中创建登录页面的其他方法可能会导致各种问题。 如果编写了不使用 子类的自定义登录页面，并且应用了来自任何用于升级或保护实例的更改，那么登录页面可能会失败而没有错误消息。例如，用户可能会尝试使用有效的用户名和密码登录，但他们的登录将在没有任何明显原因的情况下失败。这种情况可能表明需要更改自定义登录以使用所需的方法。

关于创建自定义 登录页面

#Caché #SQL
0
0 145
公告 Michael Lei · 十二月 30, 2021

第三方合作伙伴产品展示：InterSystems IRIS的“新”监控工具

亲爱的女士们和先生们，在上个月，我改进了我的工具Caché监视器......但首先：名字

选择Caché Monitor这个名字是为了反映该工具与Caché数据库的紧密结合。我想，在可预见的未来，Intersystems Caché这个既定名称很可能会被InterSystems IRIS数据平台完全取代。因此，重塑品牌的步骤成为必要。为了在未来不那么紧密地与一个产品名称联系在一起，我们选择了一个更加中立的新名字: SQL Data Lens

不管叫什么名字，实现与Intersystems产品最紧密的整合仍然是我们的目标。持续的发展也反映在版本号的延续上。上一个版本是Caché Monitor 2.96，下一个版本是SQL Data Lens 3.0。

但这不仅仅是重新命名，而且还集成了许多新的功能，例如

  • 一个很大的进步是，SQL Data Lens现在是基于Java Runtime Environment 11的，有了它，就可以改善对HiDPI的支持。在操作系统层面上配置了系统规模因素，支持每台显示器的DPI!
  • 但也集成了一个新的现代的Flat 外观和Feel 集成，在亮Light和暗Dark两种模式下。
#Caché #InterSystems IRIS
4
0 398
文章 姚 鑫 · 七月 7, 2022 4m read

第二十一章 使用工作队列管理器（四）

第二十一章 使用工作队列管理器（四）

分离和附加工作队列

通常，初始化一组工作程序，将工作项排队，然后等待工作程序完成工作项。但是，可能会遇到工作人员作业完成工作项所需的时间比预期更长的情况，或者无法将单个进程专门用于等待。因此，工作队列管理器使能够将工作队列与进程分离，然后将工作队列附加到同一进程或不同的进程。

例如，假设队列引用了初始化的工作队列。还假设向工作队列中添加了几个工作项。在调用 Wait() 或 WaitForComplete() 来确定正在处理的工作的状态之前，可以使用以下方法：

Detach()

method Detach(ByRef token As %String, timeout As %Integer=86400) as Status 从初始化工作队列时创建的对象引用中分离工作队列对象。 Detach() 方法使任何正在进行的工作能够继续并保留工作队列的当前状态。

token 参数表示一个安全令牌，可以使用它随后将工作队列附加到另一个进程。 timeout 参数是可选的，它指示系统保留分离的工作队列对象的时间量（以秒为单位）。超时期限过后，系统会删除与工作队列关联的所有工作人员作业和信息。超时的默认值为 1 天。

调用 Detach() 方法后，对分离对象引用的大多数调用都会返回错误。

#Caché #SQL
0
0 126
文章 姚 鑫 · 七月 6, 2022 4m read

第二十章 使用工作队列管理器（三）

第二十章 使用工作队列管理器（三）

管理类别

一个类别是一个独立的worker jobs池。当初始化一组worker jobs时，可以指定提供worker的类别。如果集合中的任何worker jobs在执行work项时请求额外的worker jobs，则新的worker jobs来自同一类别。

例如，假设系统提供的 SQL 类别分配了最多 8 个worker。然后，假设与BusinessIntelligence相关的流程创建了一个类别，并将最多四个worker分配给该类别。如果 SQL 池中的所有worker在给定时间都参与了工作，则 BusinessIntelligence 类别中的worker可能仍然可以立即处理工作项。

系统包括两个不能删除的类别： 和 。 SQL 类别适用于系统执行的任何 SQL 处理，包括查询的并行处理。当在未指定类别的情况下初始化一组worker jobs时，默认类别提worker jobs。

每个类别都具有影响该类别中每个工作队列的行为的属性。这些属性是：

DefaultWorkers

当创建此类别中的工作队列且未指定worker job 计数时，这将成为工作队列中worker job 的数量。此属性的默认值是核心数。

MaxActiveWorkers

在此类别的job服务请求池中保留的活动worker job的最大数量。

#Caché #SQL
0
0 165
文章 姚 鑫 · 七月 5, 2022 5m read

第十九章 使用工作队列管理器（二）

第十九章 使用工作队列管理器（二）

基本工作流程

可以通过执行以下步骤来使用工作队列管理器：

  1. 将ObjectScript 代码划分为工作单元，这些工作单元是满足特定要求的类方法或子例程。
  2. 创建一个工作队列，它是 %SYSTEM.WorkMgr 类的一个实例。为此，请调用 %SYSTEM.WorkMgr 类的 %New() 方法。该方法返回一个工作队列。

可以指定要使用的并行worker jobs的数量，也可以使用默认值，这取决于机器和操作系统。此外，如果已创建类别，则可以指定应从中获取job的类别。

创建工作队列时，工作队列管理器会创建以下工件：

  • 包含有关工作队列的信息的全局变量，例如工作队列在哪个命名空间中运行
  • 工作队列必须处理的序列化工作单元的位置和事件队列
  • 在工作队列完成处理工作单元时创建的完成事件的位置和事件队列
  1. 将工作单元（也称为工作项）添加到工作队列。为此，可以调用 Queue() 或 QueueCallback() 方法。作为参数，传递类方法（或子例程）的名称和任何相应的参数。

对添加到队列的项目立即开始处理。

如果队列中的项目多于队列可用的worker jobs，则job会竞争清空队列。例如，如果有 100 个项目和四个job，则每个job从队列的头部移除一个项目，处理它，然后返回到队列的头部以移除并处理另一个项目。这种模式一直持续到队列为空。

#Caché #SQL
0
0 156
文章 姚 鑫 · 七月 4, 2022 7m read

第十八章 使用工作队列管理器（一）

第十八章 使用工作队列管理器（一）

工作队列管理器是的一项功能，使能够通过以编程方式将工作分配给多个并发进程来提高性能。在引入工作队列管理器之前，可能已经使用 JOB 命令在应用程序中启动多个进程并使用自定义代码管理这些进程（以及任何导致的故障）。工作队列管理器提供了一个高效且直接的 API，使能够卸载流程管理。

代码在多个地方内部使用工作队列管理器。可以将它用于自己的需求，如以下部分中的高级描述。

背景

计算机硬件开发的最新创新趋向于高性能、多处理器或多核架构。与此同时，内存和网络设备的速度也只是慢慢地提高了。 开发了工作队列管理器以响应这些趋势并根据以下原则：

  • 硬件资源，包括 CPU 和 I/O、内存和网络设备，都是固定的。
  • 必须尽可能高效地使用硬件资源，以最大限度地提高其执行业务任务的速度。
  • 为了实现最大效率，工作队列管理器必须改善在执行ObjectScript 代码时可能出现的 CPU 利用率不足的问题。
  • 解决 CPU 利用率不足的方法包括排队和优先级划分。

尽管整个数据平台旨在尽可能高效地利用系统中的硬件资源，但该平台的工作队列管理器功能专门设计用于利用现代硬件配置中可用的额外 CPU 资源。工作队列管理器有两个关键用途：

  • 提供一个框架，使能够将大型编程任务分解成更小的块，以便在多个并发进程中执行。通过一次使用多个 CPU，工作队列管理器显着减少了处理大型工作负载所需的时间。
#Caché #SQL
0
0 159
文章 Jingwei Wang · 七月 4, 2022 11m read

IRIS/HealthConnect 高可用机制

高可用性（HA）指的是使系统或应用程序在很高比例的时间内保持运行，最大限度地减少计划内和计划外的停机时间。

维持系统高可用性的主要机制被称为故障转移。在这种方法下，一个故障的主系统被一个备份系统所取代；也就是说，生产系统故障转移到备份系统上。许多HA配置还提供了灾难恢复（DR）的机制，即在HA机制无法保持系统的可用性时，也能及时恢复系统的可用性。

本文简要讨论了可用于基于InterSystems IRIS的应用程序的HA策略机制，提供了HA解决方案的功能比较，并讨论了使用分布式缓存的故障转移策略。

操作系统级别的集群HA

在操作系统层面上提供的一个常见的HA解决方案是故障转移集群，其中主要的生产系统由一个（通常是相同的）备用系统补充，共享存储和一个跟随活动成员的集群IP地址。在生产系统发生故障的情况下，备用系统承担生产工作量，接管以前在故障主系统上运行的程序和服务。备用机必须能够处理正常的生产工作负载，只要恢复故障主机所需的时间就可以了。也可以选择让备用机成为主机，一旦主机恢复，故障主机将成为备用机。

InterSystems IRIS的设计可以轻松地与所支持的平台的故障转移集群技术相结合（如InterSystems支持的平台中所述）。

#Caché #InterSystems IRIS for Health #高可用性
0
0 282
文章 姚 鑫 · 七月 3, 2022 5m read

第十七章 进程内存

第十七章 进程内存

介绍

进程使用许多不同的资源来实现其目标。其中包括部分或全部 CPU 周期、内存、外部存储、网络带宽等。这篇文章是关于内存使用的。具体来说，它处理为数据存储分配的内存，例如：

  • 公共和私有变量

当第一次为它们分配值时，它们被分配了内存空间。在局部数组的情况下，局部变量名称加上所有下标的值的组合引用单个变量值。

除了包含极长字符串的变量外，变量会占用与 $STORAGE 相关的空间。包含极长字符串的变量以不同方式存储，并且不占用 $STORAGE 中的空间。

  • 对象实例

每当实例化一个对象时，都会分配空间来保存对象的当前内容以及它所引用的对象。删除最后一个对象引用时返回该空间。

  • 本地 I/O 缓冲区

将与该进程正在使用的设备相关联的 I/O 缓冲区存储在进程空间中。

管理进程空间

进程从用于上述实体的初始内存池开始。当应用程序创建它们时，它们会消耗池中的内存；当应用程序删除它们时，它们的内存将返回到池中。例如，当一个例程开始执行时，总是会创建消耗一些内存的局部变量；当例程返回并且这些变量超出范围时，这些变量使用的内存将被返回并可供重用。

当应用程序需要内存，并且进程在其内存池中没有足够大（连续）的可用内存区域来满足需求时，该进程会从底层操作系统请求额外的内存块以添加到其池中。稍后，如果该内存块完全未使用，它将返回给操作系统。

#Caché #SQL
0
0 155
文章 姚 鑫 · 七月 2, 2022 5m read

第十六章 字符串本地化和消息字典（二）

第十六章 字符串本地化和消息字典（二）

XML 消息文件

XML 消息文件是消息字典的导出。这也是希望导入的任何消息的必需格式。

只要有可能，XML 消息文件应该使用 UTF-8 编码。但是，在某些情况下，开发人员或翻译人员可能会使用本地平台编码，例如 shift-jis，以便于编辑 XML 消息文件。无论 文件使用何种编码，应用程序的语言环境都必须支持它，并且它必须能够表达该语言的消息。

消息文件可能包含一种语言和多个域的消息。

Element

元素是 XML 消息文件的顶级容器，每个文件只有一个 元素。

元素有一个必需的属性，Language。 属性的值是一个全小写的 代码，用于标识文件的语言。它由一个或多个部分组成：主要语言标签（例如 或 ）可选地后跟连字符 () 和次要语言标签（ 或 ）。

在以下示例中，此语言为（英语）。

<?xml version="1.0" encoding="utf-8" ?>
<MsgFile Language="en">
   <MsgDomain Domain="sample">
       <Message Id="source">Source</Message>
       <Message Id="menu">Samples Menu</Message>
   </MsgDomain>
</MsgFile>
#Caché #SQL
0
0 121
文章 姚 鑫 · 七月 1, 2022 4m read

第十五章 字符串本地化和消息字典（一）

第十五章 字符串本地化和消息字典（一）

本文概述了字符串本地化，并描述了如何导出、导入和管理消息字典。

字符串本地化

当本地化应用程序的文本时，会创建一种语言的文本字符串清单，然后当应用程序区域设置不同时，建立约定以另一种语言替换这些消息的翻译版本。

支持以下本地化字符串的过程：

  1. 开发人员在他们的代码中包含可本地化的字符串（在REST 应用程序或商业智能模型中）。

这种机制各不相同，但最常见的机制是 $$$Text 宏。代替硬编码的文字字符串，开发人员包含 $$$Text 宏的实例，为宏参数提供如下值：

  • 默认字符串
  • 此字符串所属的域（将字符串分组为域时，本地化更易于管理）
  • 默认字符串的语言代码
write "Hello world"

替换为

write $$$TEXT("Hello world","sampledomain","en-us")
  1. 编译代码时，编译器会在消息字典中为 $$$Text 宏的每个唯一实例生成条目。

消息字典是全局的，因此可以在管理门户中轻松查看（例如）。有一些类方法可以帮助完成常见任务。

  1. 开发完成后，发布工程师导出该域或所有域的消息字典。

结果是一个或多个 XML 消息文件，其中包含原始语言的文本字符串。

  1. 发布工程师将这些文件发送给翻译人员，请求翻译版本。

  2. 翻译人员使用他们喜欢的任何 XML 创作工具来处理 XML 消息文件。

#Caché #SQL
0
0 184
文章 姚 鑫 · 六月 30, 2022 2m read

第十四章 信号（四）- 多进程任务示例

第十四章 信号（四）- 多进程任务示例

可根据此思想进行多任务启动查询汇总数据。

原理

  • 利用job机制开启后台进程。
  • 利用loop循环减少进程的数量等于开启进程的数量，判断多进程任务是否完成。

  1. 创建表并插入1000W条数据，统计Moeny字段总金额

  2. 创建demo代码如下。

Class Demo.SemaphoreDemo Extends %RegisteredObject
{

///  Do ##class(Demo.SemaphoreDemo).Sample(5)
ClassMethod Sample(pJobCount = 3)
{
	k ^yx("Amt"),^yxAmt
	
	 /* 1.启动信号 */
    s mSem = ##class(Demo.Sem).%New()
    If ('($isobject(mSem))) 
    {
		q "启动失败"
    }
    
    /* 2. 初始化信号量为0 */
    d mSem.Init(0)
    
    s t1 = $zh
    
    /* 3. 按指定数量，启动后台任务 */
    for i = 1 : 1 : pJobCount
    {
        j ..Task(i)
    }
    
    w "启动job时间："_ ($zh - t1),!
	
    /* 4. 等待后台任务完成 */
    s tCount = i,tSC = 0
    /* 后台任务完成的判断条件是：减少的信号量=总后台任务数 */
    while (tSC < tCount)
    {
        s tSC = tSC + mSem.Decrement(tCount, 10)
    }
    
    w "完成时间："_ ($zh - t1),!
    
    
	s moneyAmt = 0

		
	s data = ""
	for {
		s data = $o(^yxAmt(data))
		q:(data = "")
		s moneyAmt = moneyAmt + ^yxAmt(data)
	}
	d mSem.Delete()
    w "总金额" _ moneyAmt,!
    
    w "汇总时间："_ ($zh - t1),!
	q
}

ClassMethod Task(i)
{
    s tSem = ##class(Demo.Sem).%New()
	s moneyAmt = 0
	for j = (i * 100000) + 1 : 1 : (i + 1) * 100000 {
		s money = $li(^M.YxPersonD(j), 3)
		s moneyAmt = moneyAmt + money
	}
	s ^yxAmt("moneyAmt" _ i) = moneyAmt
	s ^yx("Amt") = $i(^yx("Amt"))
    d tSem.Open(##class(Demo.Sem).Name())
    d tSem.Increment(1)
    d tSem.%Close()
	q moneyAmt
}
}
#Caché #SQL
0
0 123
文章 姚 鑫 · 六月 29, 2022 10m read

第十三章 信号（三）- 示例演示

第十三章 信号（三）- 示例演示

运行示例

Main、Producer 和 Consumer 这三个类中的每一个都有自己的 方法，最好在各自的终端窗口中运行它们。每次运行时，它都会显示它为日志生成的消息。一旦用户通过提供它正在等待的输入来响应 类， 的 方法将终止删除信号量。然后，用户可以通过键入命令查看所有进程的合并日志文件的显示

  Do ##class(Semaphore.Util).ShowLog()

注意：以下所有示例都假定所有类都已在命名空间中编译。

示例 1 - 创建和删除信号量

最简单的例子演示了信号量的创建和销毁。它使用 类。请执行下列操作：

  1. 打开一个终端窗口。
  2. 输入命令——
Do ##class(Semaphore.Main).Run()
  1. 该方法创建信号量。如果成功，将看到消息“输入任何字符以终止运行方法”。按下 Enter 键。该方法显示信号量的初始化值，将其删除，然后退出。
  2. 通过发出命令显示日志文件

按照上述步骤在终端窗口中显示的消息示例如下

示例 2——创建信号量并连续递增它

这个例子展示了生产者在工作，以及从两个进程中捕获日志消息。

  1. 打开两个单独的终端窗口。称它们为“A”和“B”。
  2. 在窗口 A 中，键入以下命令，但不要在末尾键入 ENTER 键 -
Do ##class(Semaphore.Main).Run()
#Caché #SQL
0
0 165
文章 姚 鑫 · 六月 27, 2022 7m read

第十二章 信号（二）- 生产者消费者示例

第十二章 信号（二）- 生产者消费者示例

下面是一系列使用信号量实现生产者/消费者场景的类。 “主”进程初始化信号量并等待用户指示活动已全部完成。生产者在循环中随机增加一个信号量值，更新之间的延迟可变。消费者尝试在随机时间从信号量中删除随机数量，也是在循环中。该示例由 5 个类组成：

  • Main – 初始化环境并等待信号量上的活动完成的类。
  • Counter – 实现信号量本身的类。它记录它的创建以及由于信号量在等待列表中而发生的任何回调。
  • Producer – 一个类，其主要方法增加信号量值。增量是一个随机选择的小整数。完成增量后，该方法会在下一个增量之前延迟一小段随机数秒。
  • Consumer 消费者——这是对生产者的补充。此类的主要方法尝试将信号量减少一个随机选择的小整数。它将递减请求添加到其等待列表中，等待时间也是随机选择的秒数。
  • Util - 这个类有几个方法被示例的其他类使用。几种方法解决了为所有活动维护公共日志的问题；其他人解决了多个消费者和多个生产者的命名问题。

注意：组成这些类的代码特意写得简单。尽可能地，每个语句只完成一个动作。这应该使用户更容易和更直接地修改示例。

Class: Semaphore.Main

此类建立演示环境。它调用实用程序类来初始化日志和名称索引工具。

#Caché #SQL
0
0 167
文章 Weiwei Gu · 六月 27, 2022 6m read

Globals 是管理数据的魔剑 ： 第一部分

Globals，这些存储数据的魔剑，已经存在了一段时间，但是没有多少人能够有效地使用它们，也没有多少人知道这个超级武器。

如果你把Globals的东西用在它们真正能发挥作用的地方，其结果可能是惊人的，要么是性能的提高，要么是整体解决方案的大幅简化 (1, 2).

Globals提供了一种特殊的存储和处理数据的方式，它与SQL表完全不同。它们在1966年首次出现在 M(UMPS)编程语言中， 该语言最初用于医学数据库。现在它仍然以同样的方式被使用，但也被其他一些以可靠性和高性能为首要任务的行业所采用：金融、交易等。

后来M(UMPS)演变为 Caché ObjectScript (COS). COS是由InterSystems公司开发的，作为M的一个超集. 其原始语言仍然被开发者社区所接受，并在一些实现中保持活力。在网络上有几个活跃的网址，比如：MUMPS Google group, Mumps User's group), effective ISO Standard等等

现代基于Globals的数据库支持交易、日志、复制、分区等。这意味着它们可以被用来构建现代的、可靠的、快速的分布式系统。

Gloabls并不将你限制于关系模型的范围内。它们让你可以自由地创建为特定任务优化的数据结构。对于许多应用来说，合理地使用好的Globals就如一颗真正的银子弹头，它所提供的速度是传统关系型应用的开发者所梦寐以求的。

作为一种存储数据的方法，globals可以在许多现代编程语言中使用，包括高级和低级语言。因此，本文将特别关注Globals本身，而不是它们曾经来自的语言。

#Caché #Global Masters #InterSystems IRIS #Node.js #关系表 #性能 #新手
1
1 391
文章 姚 鑫 · 六月 26, 2022 7m read

第十一章 信号（一）- 概念

第十一章 信号（一） - 概念

背景

维基百科对信号量有这样的定义：“在计算机科学中，特别是在操作系统中，信号量是一种变量或抽象数据类型，用于控制多个进程在并行编程或多用户环境中对公共资源的访问。”信号量不同于互斥体（或锁）。互斥锁最常用于管理竞争进程对单个资源的访问。当一个资源有多个相同的副本并且这些副本中的每一个都可以由单独的进程同时使用时，就会使用信号量。

考虑一个办公用品商店。它可能有几台复印机供其客户使用，但每台复印机一次只能由一个客户使用。为了控制这一点，有一组键可以启用机器并记录使用情况。当客户想要复印文件时，他们向职员索取钥匙，使用机器，然后归还钥匙，并支付使用费。如果所有机器都在使用，客户必须等到钥匙归还。保存键的位置用作信号量。

该示例可以进一步推广到包括不同类型的复印机，也许可以通过它们可以制作的副本的大小来区分。在这种情况下，将有多个信号量，如果复制者在复制的大小上有任何重叠，那么希望复制共同大小的客户将有两个资源可供提取。

介绍

信号量是共享对象，用于在进程之间提供快速、高效的通信。每个信号量都是类 %SYSTEM.Semaphore 的一个实例。信号量可以建模为一个共享变量，它包含一个 64 位非负整数。信号量上的操作在共享它的所有进程中以同步的方式更改变量的值。按照惯例，值的变化会在共享信号量的进程之间传递信息。

#Caché #SQL
0
0 212
文章 Michael Lei · 六月 26, 2022 5m read

跟踪数据更改 - 审计日志 - 下篇

在前一篇文章中，我已经演示了一种简单的方法来记录数据的变化。在这个时候，我改变了负责记录审计数据的 "审计抽象类 "和记录审计日志的数据结构。

我已经将数据结构改为父子结构，其中将有两个表来记录 "交易 "和在该交易中改变的 "字段的值"。

看一下新的数据模型:

看看从 "审计类 "改变的代码吧:

Class Sample.AuditBase [ Abstract ]
{ Trigger SaveAuditAfter [ CodeMode = objectgenerator, Event = INSERT/UPDATE, Foreach = row/object, Order = 99999, Time = AFTER ]
{
          #dim %compiledclass As %Dictionary.CompiledClass
          #dim tProperty As %Dictionary.CompiledProperty
          #dim tAudit As Sample.Audit           Do %code.WriteLine($Char(9)_"; get username and ip adress")
          Do %code.
#Caché #InterSystems IRIS for Health #对象数据模型 #ObjectScript
0
0 290
文章 Michael Lei · 六月 26, 2022 1m read

以程序化的方式检查审计设置

下面的代码允许用户查看其实例的审计设置。通过运行类方法 "test "来运行该代码。:


class objectscript.checkAudit Extends %RegisteredObject
{
classmethod test() {
w "Checking for Auditing...",!
Set SYSOBJ = ##class(Security.System).%OpenId("SYSTEM")
If +SYSOBJ = 0 Set SYSOBJ = ##class(Security.System).%New()
i SYSOBJ.AuditEnabled {
w "Security Auditing is enabled for the following services",!
s rs=##class(%ResultSet).%New("Security.Events:ListAllSystem")
s sc=rs.Execute()  If $$$ISERR(sc) Do DisplayError^%apiOBJ(sc) Quit
while rs.%Next() {
d:rs.Data("Enabled")="Yes" rs.%Print()
}
d rs.Close()

        s rs=##class(%ResultSet).%New("Security.Events:ListAllUser")
        s sc=rs.Execute()  If $$$ISERR(sc) Do DisplayError^%apiOBJ(sc) Quit
        while rs.%Next() {
            d:rs.Data("Enabled")="Yes" rs.%Print()
        }
        d rs.Close()
    }
}
#Caché #Code Snippet #ObjectScript
0
0 135