第十八章 维护本地数据库（三）

截断数据库

截断数据库会将数据库末尾的可用空间返回到底层文件系统。数据库在压缩后通常会被截断，这会将可用空间移动到数据库的末尾。

截断数据库时，指定数据库的目标大小。如果在数据库末尾有足够的可用空间，则该操作会删除足够的空间以将数据库减小到目标大小；如果没有，它会删除所有可以删除的内容。 （要了解数据库的可用空间到底有多少，请压缩数据库；无需完成显示当前总可用空间和末尾数量的操作。）

注意：此功能不适用于具有原始卷的数据库。

1. 导航到数据库页面（系统操作 > 数据库）。
2. 单击要截断的数据库的名称。这会将带到其数据库详细信息页面。
3. 单击页面顶部功能区上的截断。这将显示“截断数据库”对话框，其中显示所选数据库的名称、位置和当前大小（以兆字节 (MB) 为单位）。
4. 输入目标文件大小 (MB)，它必须小于当前大小，然后单击确定。输入 0 从文件末尾删除所有可能的可用空间。

注意：用于截断目的的可用空间不同于用于存储数据的可用空间。如果某些控制结构不用于数据存储，则可以在截断期间删除它们。这可能会导致报告的可用空间有所不同。

对数据库进行碎片整理

对数据库进行碎片整理会重新排列数据库中的全局块，以使包含给定全局数据的所有块都按连续顺序排列。该操作不会按顺序放置全局中的大字符串块或指针块，但它确实将它们定位在连续区域中。

背景Background 

大多数网站都有一个 "Fav.ico "文件，用于设置网页的图标。大多数用户有多个环境，开发、测试和生产环境。通常情况下，你很难一眼就看出你在哪个环境中。如果能直观地通过图标看到你所处的版本和环境，可以提供更好的用户体验。在这个例子中，所有的实例都被命名为 "ENSEMBLE"。注意，这是在2022.1上使用的IRIS FOR HEALTH。 

默认图标是 IR

在这篇文章中，我们将把标识改为类似于以下的内容：

图标文件

图标文件安装在你的安装文件夹csp/broker/portal中 

1. 创建一个名为Archive的文件夹放在该文件夹中 
2. 复制并粘贴ISC_IRIS_icon.ico到这个文件夹，对旧图标进行备份 
3. 使用一个图标编辑器。我使用了在线创建和编辑ICO文件| RedKetchup，因为它很容易使用，并且有简单的文本选项。 
4. 将.ico文件复制到你的本地文件，并打开它（Icon-> Open）

5. 采取铅笔工具。清除任何旧的字母（提示：改变铅笔大小可以更容易操作）。

6. Click test. Set colour. Play around with the font. DON'T FORGET TO PRESS APPLY 

7. 保存图标. 

8.

Hi 大家好!

我经常会看到CSP 应用提示一些没有什么意义的错误信息，比如：

第十七章 维护本地数据库（二）

数据库详细信息页面显示有关任何数据库的详细信息。要从管理门户访问此信息：

1. 显示数据库页面（系统操作 > 数据库）。
2. 单击要查看更多详细信息的数据库的名称。

数据库详细信息页面的顶部是一排按钮，可让执行各种数据库操作：

• Mount / Dismount — 安装或卸载数据库。新状态一直有效，直到明确更改它或重新启动/停止 IRIS；要永久卸载数据库，必须将其从配置中删除。
• Compact - 将分布在整个数据库中的可用空间移动到其末端。
• Truncate截断 — 将数据库末尾的可用空间返回到底层文件系统。
• 碎片整理 — 重新定位全局块，使代表给定全局的块处于连续序列中。

该页面还包括特定于所选数据库的信息，这些信息被组织成一个 General Information 表和一个 Database Size 表：

一般信息

现在有一个需求。想将intersystems系统产生的alerts.log文件的内容保存到一个表中。有什么工具或者API 能自动格式化log文件到DB吗，还是需要手动解析log文件然后在存储到DB中。

第十六章 维护本地数据库（一）

可以在管理Portal (System Operations > databases)的“数据库”页面查看和维护本地数据库。 在此页面，可以查看到以下信息:

• 数据库一般信息 Databases General Information-所有数据库的概述信息。
• 数据库空闲空间信息 Databases Free Space Information - 所有数据库的空闲空间信息
• 数据库详细信息页 Database Details Page -个别数据库的特定信息。 还可以通过维护操作增加该页面的可用空间。

本节中描述的大多数信息和操作也可以使用^DATABASE命令行实用程序找到并执行。

数据库的一般信息

数据库页面（系统操作 > 数据库）包含所有本地数据库的列表。对于每个本地数据库，会看到以下信息：

本地数据库信息

• Name - 数据库名称。

• Directory - 分配给数据库可以增长的最大大小，以 GB 为单位。

• Max Size (GB) - 分配给数据库可以增长的最大大小，以 GB 为单位。

• Size (MB) - 当前分配的数据库大小，以兆字节为单位。

  注意：此字段衡量数据库的逻辑大小。因此，此处报告的大小可能低于数据库的物理大小，特别是对于 IRISTEM 数据库。

[toc]

第十五章 配置工作队列管理器类别

工作队列管理器使能够以编程方式将工作分配给多个并发进程，以提高性能。

当使用工作队列管理器初始化一组辅助job时，可以指定提供辅助job的类别。 类别是一个独立的worker job。 例如，假设为系统提供的SQL类别分配了最多8个worker。 然后，假设为与构建DeepSee仪表板相关的进程创建了一个类别，并为该类别分配最多4个worker。 如果在给定的时间内SQL池中的所有工作线程都被占用，DeepSee类别中的工作线程仍然可以立即处理工作项。

系统提供了两个不能删除的类别：Default 和 SQL。默认情况下，这些类别的最大工作线程数是动态的，相当于系统可用内核数的两倍。

工作队列管理器类别页面使能够创建、修改和删除工作队列管理器类别，如以下部分所述。所做的任何更改都会反映在配置参数文件 iris.cpf 中。

创建工作队列管理器类别

从工作队列管理器类别页面，可以创建新类别。

类别名称必须是唯一的并且区分大小写。此外，类别名称只能包含字母、数字、破折号、下划线和句点，并且最多包含 64 个字符。

要创建新类别，请执行以下操作：

1. 导航到系统管理 > 配置 > 系统配置 > WQM 类别。

2. 单击创建类别。

3. 在类别名称字段Category name中，键入类别的名称。

第十三章 配置任务管理器电子邮件设置

可以将任务管理器设置为在任务完成时发送电子邮件通知，在任务管理器电子邮件设置页面（系统管理 > 配置 > 其他设置 > 任务管理器电子邮件），可以配置通知设置：

• SMTP 服务器和端口

发送 SMTP（简单邮件传输协议）邮件服务器的地址和端口

• SSL Config

如果要使用 SSL/TLS 加密电子邮件，则要使用的 SSL 配置。如果实例上没有 SSL 配置，或者想创建一个新配置，请参阅创建或编辑 TLS 配置。如果您不选择 SSL 配置，则不会使用 SSL/TLS。

• SMTP 验证用户和密码

仅对 SMTP 服务器的 SMTP 身份验证需要。有关详细信息，请参阅 RFC 2554。如果不提供条目，则 SMTP 用户名和密码将设置为 NULL。

• Sender

仅对 SMTP 服务器的 SMTP 身份验证需要。有关详细信息，请参阅 RFC 2554。

• Reply To

收件人应回复的电子邮件地址

• Success Subject

成功的任务消息的格式化主题行。请参阅下面的“主题和消息的参数”部分。

• Success Message

任务运行成功后发送的格式化消息

• Failure Subject

失败的任务消息的格式化主题行

• Failure Message

任务失败后发送的格式化消息

注意：还可以通过新选项卡类中的 %SYS.Task.

InterSystems 有解析log文件的工具或者API吗？

社区开发者们，大家好！

我们很自豪地宣布我们的InterSystems开发者社区已经达到了几个令人惊喜的里程碑：

📝 10,000 帖子

👥 11,000 注册用户

👁 5,000,000 浏览量

社区开发者们，大家好！

我来给大家介绍一下全新的“关于我们”页面！

📍 community.intersystems.com/about

在上面，你可以找到关于我们开发者社区的一般信息、有趣的统计数据、有用的链接等等。

来看看吧！也许你会学到一些新东西，即使你已经成为会员很长时间了。

欢迎了解2022年7月社区的最新动态！

最近我们进行了很多有趣的提升，以优化你在InterSystems开发者社区的体验：

📌 社交网络通知功能

📌 改进了订阅设置

📌 全新的“关于我们”页面

📌 更友好的“会员”页面

我们来详细看看这些改进！

第十二章 配置数据库（四）

重定位本地数据库

要将本地数据库的 IRIS.DAT 文件移动到不同的目录，必须执行以下操作：

1. 记下当前的数据库目录。可以从本地数据库页面（系统管理 > 配置 > 系统配置 > 本地数据库）查看此信息。
2. 彻底关闭实例，例如使用 iris stop 命令。
3. 将 IRIS.DAT 文件和流目录从当前数据库目录复制到所需位置

重要提示：如果数据库目录中有 iris.lck 文件，请不要移动数据库。这意味着数据库仍在使用中，移动它可能会导致无法预料的问题。

注意： 不支持在配置数据库目录时使用符号链接，并建议为新的数据库位置选择完全解析的物理路径。

4. 在文本编辑器中打开实例的 iris.cpf 文件。该文件通常位于安装目录中。

5. 在 [Databases] 部分下方找到数据库的名称。用新路径替换旧目录路径，然后保存 iris.cpf。

6. 启动 IRIS 实例，并查看本地数据库页面以确认目录已设置为新位置。如果数据库是镜像的，则需要激活并赶上它。

7. 删除旧的数据库目录。

重要提示：重定位本地数据库目录后，还必须更新任何远程访问数据库的系统（例如 ECP 应用程序服务器）。在每个远程系统上，将远程数据库目录更新到新位置，如远程数据库中所述。

删除本地数据库

要删除本地数据库，请单击相应行中的删除链接。

# 第十一章 配置数据库（三）

## 编辑本地数据库的属性

显示的信息取决于数据库是否被镜像。本节确定以下字段：

### 部分编辑非镜像本地数据库属性

单击非镜像数据库的名称可查看以下数据库属性并更改其中一些属性。 （“创建本地数据库”部分描述了其中的许多字段。）

- `Name `
- `Directory` 目录（此设置必须始终反映 `IRIS.DAT` 数据库文件的位置）
- `Encrypted`加密（无法更改）
- `Mirrored` 已镜像 — 单击添加到 `Mirrormirror_name` 链接以将数据库添加到其中 `IRIS` 实例是主要故障转移成员的镜像。 （仅当实例是镜像中的主实例时，此选项才可用。）
- `Block Size (Bytes)`块大小（字节）（无法更改）
- `Size` 大小 (MB) — 共有三种大小设置，如下所示：
  - `Change Current` 修改数据库的当前大小。
  - `Expansion` 扩展设置在需要时扩展数据库的数量；默认（和推荐）设置为零 (`0`) 表示当前大小的 `12%` 或 `10` MB，以较大者为准。使用当前大小的 `12%` 时，扩展大小不会大于 1GB。
  - `Maximum` 最大值指定数据库可以增长到的最大大小，以兆字节为单位；默认设置为零 (`0`) 表示没有最大值。

第十章 配置数据库（二）

本地数据库

“本地数据库”页面显示关于系统上的数据库的以下信息:

• Name—数据库名称。
• Mirror——如果数据库是镜像的，则镜像的名称;
• Directory - IRIS.DAT 文件的位置。
• Size 大小 (MB) — 以 MB 为单位的数据库大小。
• Status 状态 — 指定数据库是挂载、卸载还是卸载；如果已挂载，则指定它是否具有只读或读写权限。
• Resource Name资源名称 — 控制对数据库的访问的数据库资源的名称；
• Encrypted — 指定数据库是否加密；
• Journal 指定数据库是否被记录；

创建本地数据库

要创建本地数据库，请导航到本地数据库页面（系统管理 > 配置 > 系统配置 > 本地数据库）。

1. 单击创建新数据库以打开数据库向导。

2. 在文本框中输入数据库名称。数据库名称必须：

• 尚未在 IRIS 实例中使用
• 长度在 1 到 30 个字符之间
• 以字母字符或下划线开头；其余部分可以包括字母数字字符、破折号或下划线

3. 首次使用特定浏览器在 IRIS 实例中创建本地数据库时，必须

• 输入数据库目录的名称，在这种情况下，包含 IRIS.DAT 文件的目录在确认后将在 c:\InterSystems\mgr 中创建
• 单击文件夹图标浏览到现有目录，在这种情况下，将在该目录中创建 IRIS.

我想通过表面表里面的字段找到这个表对应的实体类的属性，有什么高效的方式吗？

实质的需求是，我查询一个表的时候，这个表的字段很多，我需要通过值定位到哪些字段符合。

目前 cache 架构如上图所示，有部分 csp 接口查询速度不稳定，数据量并不大，每次查询返回也就几十个个病人数据，有时 1-4秒，有时十分慢差不多10几秒；在终端直接执行接口对应方法速度又很快。请问怎么逐步排查、定位问题出在哪一部分？有哪些工具、手段或者 cache 参数可以监控？

Hi,

我无法连接到本地网络浏览器.

我想打开(http://localhost:57772/csp/sys/UtilHome.csp) 现实：

Caché Server Pages Version 2018.1.6.717.0
Server Availability Error

Server is currently unavailable

如果我调用 CSP.log 得到以下报错:

Access Denied
    Diagnostic
    Failed to connect to 'LOCAL' - Reason: 0 (Connection successfully made but server not responding) (No Retry)

请帮帮我，谢谢！

我需要在当前命名空间下创建一系列的只读类，并限制除_system之外的所有用户都只有读取权限，无法在studio中编译，请问我应该如何操作呢？
我的目的是可以在工程的项目分支中管理这些类，并通过发布方式持续升级这部分类文件。
但是这些类的内部逻辑有可能会需要维护人员能够知晓其中的功能和实现方式，所以不能通过MakeDeployed来解决这个问题
我现在知道可以通过设置database的读写属性来解决这个问题，但是这样就需要额外新建一个database并maping到当前命名空间下。采取这种方式处理时有一个重大的缺点，即在执行代码发布过程中，需要停库，并且停库时间可能会在半个小时左右，这个我无法接受。

一致性检查的任务——integrity check在业务低峰期直接运行吗？A-B（mirror）环境中，运行这个任务来检查一致性是两边都要运行吗？在管理锁的时候，我直接将锁remove会有啥后果？

第九章 配置数据库（一）

数据库是使用数据库向导创建的 IRIS.DAT 文件。 IRIS数据库保存称为全局变量的多维数组中的数据和称为例程的可执行内容，以及类和表定义。 全局变量和例程包括方法、类、网页、SQL、BASIC和JavaScript文件

注意：在 Windows 系统上，不要对 IRIS.DAT 数据库文件使用文件压缩。 （通过右键单击 Windows 资源管理器中的文件或文件夹并选择属性，然后选择高级，然后压缩内容以节省磁盘空间来压缩文件；压缩后，文件夹名称或文件名在 Windows 资源管理器中呈现为蓝色。）如果压缩IRIS.DAT 文件，它所属的实例将无法启动，并出现误导性错误。

IRIS 数据库根据需要动态扩展（假设有可用空间），但可以指定最大大小。如果使用默认的 8KB 块大小，数据库可以增长到 32 TB。

可以动态更改大多数数据库配置；可以在系统运行时创建和删除数据库以及修改数据库属性。

注意：这些主题描述了使用管理门户手动配置数据库的过程。 IRIS 还包含可用于自动化数据库配置的编程工具。可以使用新选项卡类中的 Config.Databases 来创建和配置数据库；还可以使用 ^DATABASE 命令行实用程序配置数据库。

亲爱的开发者们！

到了展示互操作性技术的时候了！来参加我们最新的竞赛吧！

🏆 InterSystems开发者大赛：以互操作性技术为可持续发展构建解决方案 🏆

时间: 8月29日-9月19日（北京时间）

奖金更高: $13,500 – 请留意，奖金分配跟以往有所不同！

2022年8月22日，中国 北京 —— 致力于帮助客户解决最关键的可扩展性、互操作性和速度问题的创新数据技术提供商InterSystems今日宣布在中国推出InterSystems IRIS医疗版互联互通套件2.0版，更好地满足用户对数据利用的需求。

第八章 配置命名空间（三）

Routine Mappings

可以在覆盖命名空间例程的默认数据库映射的例程级别向命名空间添加映射：

1. 导航到命名空间页面（系统管理 > 配置 > 系统配置 > 命名空间），然后单击要在其中映射全局的命名空间行中的常规映射。
2. 在常规映射页面中，单击新建。
3. 选择例程所在的 Routine database location 数据库。
4. 输入例程名称。映射时例程不必存在（也就是说，它可以是计划创建的例程的名称）。
5. 单击确定。

注意：新映射行的第一列中显示的 >> 表示已打开映射进行编辑。

6. 要将映射保存在 cpf 文件中，请单击保存更改。

例如，使用前面的测试命名空间映射示例，如果计划在机场数据库（在 FlightSchedule 命名空间中）中创建一个计划例程（例如 BOSZZairline），并且希望它对 TravelAgent 命名空间中的用户可用，请导航到 Routine Mappings 页面（在 TravelAgent 命名空间行中），然后单击 New Routine Mapping。输入如下例程映射对话框中所示的信息：

• Include files
• Other routines
• Classes
• Tables
• Globals

根据需要使用额外的例程、包和全局映射，以确保这些项目在目标命名空间中可用。

第七章 配置命名空间（二）

将全局、例程和包映射添加到命名空间

除了可以访问映射数据库中的全局变量和例程之外，还可以映射来自相同或不同系统上的其他数据库的全局变量、例程和类包。这允许对可以存在于任何地方的数据进行简单引用，并且是命名空间的主要特征。可以映射整个全局变量或全局变量；此功能允许数据轻松跨磁盘。

注意：映射按字母顺序排序；如果指定了下标，则按名称和下标排序。

单击适当的选项开始映射：

• Global Mappings
• Routine Mappings
• Package Mappings
• Mapping Data to All Namespaces

以下是映射如何在示例航空公司预订应用程序中工作的示意图：

数据和程序存储在数据库数据库中，即物理存储位置，并由名称空间引用，即逻辑引用。

重要提示：如果存在与本地内容具有相同标识符的映射内容（例如包、类、全局或例程名称），则映射内容将可见，而不是本地内容。因此，应该尽可能具体地使用映射，以防止映射远离现有内容。 在命名内容和创建映射时，请务必遵循标识符规则和准则，以避免任何不必要的冲突。

Mappings

可以在全局和全局下标级别将新全局映射添加到命名空间，以覆盖命名空间全局变量的默认数据库映射：

1. 导航到命名空间页面（系统管理 > 配置 > 系统配置 > 命名空间）并单击要在其中映射全局的命名空间行中的全局映射。

第六章 配置命名空间（一）

命名空间是虚拟工作空间中的数据和程序的集合。在命名空间中，可以定义各种组或人员需要的全局变量Global。例如，如果审计部门需要使用存在于不同系统或不同目录中的某些全局变量Global，可以设置一个单一的命名空间来引用网络上的所有会计全局变量和数据库。

IRIS 带有以下预定义的命名空间：

• %SYS — 系统管理信息和实用程序。 -USER — 安装时为空。通常用于应用程序开发。

可以在管理门户的命名空间页面上执行以下过程来配置命名空间，可以通过在主页上依次选择系统管理、配置、系统配置和命名空间来导航到该页面：

• 创建/修改命名空间
• 重命名命名空间或修改默认映射
• 将全局、例程和包映射添加到命名空间
• 删除命名空间

注意：上面列出的主题描述了使用管理门户手动配置命名空间的过程。 IRIS 还包含对自动化命名空间配置有用的编程工具。可以在新选项卡类中使用 Config.Namespaces 来创建和配置命名空间。

配置命名空间的另一种方法是将 CreateNamespace、ModifyNamespace 或 DeleteNamespace 操作与配置合并结合使用。配置合并允许通过应用声明性合并文件来自定义 IRIS 实例，该文件指定要应用于该实例的设置和操作。

单个 IRIS 实例中命名空间数量的绝对限制为 2048。命名空间表的大小是自动的且不可配置。

第五章 配置系统信息

IRIS 将系统范围的配置信息存储在称为配置参数文件 (CPF) 的文件中。该文件是一个重要工具，因为它包含IRIS 实例的大部分可配置设置。每个实例都部署了一个默认 CPF，它位于安装目录中。可以直接在文本编辑器中修改 CPF，也可以从管理门户或终端间接修改。在 UNIX® 和 Linux 上，还可以通过指定配置合并文件在部署期间自定义 CPF IRIS 使用该文件在实例首次启动之前更新默认 CPF。

对于任何新安装的实例，必须更改几个启动设置，以及应该查看的其他设置。本节讨论最初要考虑的这些设置：

内存和启动设置

当第一次安装 IRIS 时，应该查看和调整内存分配以及其他配置设置。在确定 IRIS 实例使用内存的方式时，必须采取三个主要操作，如下所示：

• 使用内存和启动页面（系统管理 > 配置 > 系统配置 > 内存和启动）为数据库和例程缓存分配内存。

• 设置 IRIS 进程可以使用的最大内存

• 配置通用内存堆（也称为共享内存堆）的大小，这决定了 IRIS 可用于例程和数据库缓存之外的其他用途的内存；

重要提示：首次安装 IRIS 时，数据库和例程缓存内存分配设置为自动，在此情况下， IRIS 为数据库缓存（全局缓冲区）分配总物理内存的 25%。

此设置不适用于生产用途。

Hi 社区的朋友们，大家好!

有时我们需要以编程方式自动将CSV数据从文件或者UR网址L导入到InterSystems IRIS。我们希望创建具有适当数据类型的类并导入数据。

我在Open Exchange上发布了一个模块csvgen，它正是这样做的。

如果你只需要将CSV文件导入IRIS，你可以这么做:

USER>do ##class(community.csvgen).Generate("/usr/data/titanic.csv",,"Data.Titanic")

Class name: Data.Titanic
Header: PassengerId INTEGER,Survived INTEGER,Pclass INTEGER,Name VARCHAR(250),Sex VARCHAR(250),Age INTEGER,SibSp INTEGER,Parch INTEGER,Ticket VARCHAR(250),Fare MONEY,Cabin VARCHAR(250),Embarked VARCHAR(250)
Records imported: 891
USER>

或者你的CSV文件在互联网上, 例如GitHub上面的新冠疫情数据 你可以这样获得数据:

USER>d ##class(community.csvgen).GenerateFromURL("https://raw.githubusercontent.com/CSSEGISandData/COVID-19/master/csse_covid_19_data/csse_covid_19_daily_reports/05-29-2020.csv",",","Data.Covid19")

Class name: Data.Covid19
Header: FIPS INTEGER,Admin2 VARCHAR(250),Province_State VARCHAR(250),Country_Region VARCHAR(250),Last_Update DATE,Lat MONEY,Long_ DOUBLE,Confirmed INTEGER,Deaths INTEGER,Recovered INTEGER,Active INTEGER,Combined_Key VARCHAR(250),Incidence_Rate DOUBLE,Case-Fatality_Ratio DOUBLE
Records imported: 3522
USER>