搜索​​​​

比较不同的商业智能技术是非常有趣的。我很好奇它们在功能、开发工具、速度和可用性方面有什么不同。 在这个应用程序中，我选择了一个有欧洲各国水状况的数据集。这是一个开源的数据集，包含1991年到2017年的观测数据。 团队和我决定使用IRIS BI、Tableau、PowerBI和InterSystems Reports（由Logi Reports驱动）在这个BI数据集的基础上制作一个模型 对于前端，我们通过Embedded Python在PythonFlask中制作了一个网页界面。 顺便说一下，其结果可以在这个网页上看到：http://atscale.teccod.com:8080/ 你可以看看demo stand (演示台)，因为从资源库部署一个容器可能需要多至20分钟的时间。大量的python包，后面会有更多的原因。 主页面 数据 事实上，数据似乎很小，期间只有17年 :) 因此，在现有的基础上，我想延续数据集，为此使用了一个神经网络。使用同样的嵌入式Python，使用了Tensorflow，这个包下载后占据了511MB，不要惊讶 实际上，这也是容器部署时间长的原因--为神经网络下载了很多包，相当多的相关包，安装时间很长。不过会有一篇关于神经网络和Integrated ML（一体化机器学习）的单独文章，我很快会发表。 我还要说的是，预测的结果被输入到同一个数据库，所以你可以通过BI工具看到数据集。但是预测只针对法国的一条河，请仔细看一下。因为我们只有足够的力量计算一件事。完整的预测会花很长的时间。 数据立方体 数据立方体是在IRIS中制作的，同时立方体也是在Adaptive Analytics（由AtScale驱动）中制作的。因此，IRIS的BI仪表盘是在IRIS上建立的，其余的工具（Logi、PowerBI、Tableau）从AtScale上获取数据。 仪表板 实际上商业智能系统是以多种形式呈现的。 这是在python中的Dash。 我们喜欢的IRIS BI InterSystems报告（由Logi报告提供）。 PowerBI Tableau 样例 完成 对于所介绍的所有BI系统，源文件都可以在资源库中找到。你可以看到报告和仪表盘是如何工作的，并在你未来的项目中使用它们。 通过它们，你可以直观地看到一个特定的系统是如何工作的，也可以了解一个特定的系统有哪些开发工具。 我们没时间来制作一个页面，让你可以输入各种参数和条件，使用神经网络的可能值进行计算。这里有一些先决条件，有一个实施神经网络的例子，以及在其帮助下所做的预测，这些都是在嵌入式Python中实现的。神经网络已被训练，启动脚本也是可用的，位于 https://github.com/teccod/water-conditions-Europe/blob/main/iris/src/PythonFlask/pages/ml/ml_run.py文件夹中。 谢谢你阅读这篇文章，我在等待评论和反馈。很快就会有一篇关于在嵌入式Python和IntegratedML（一体化机器学习）中比较神经网络的文章，我将把它附在这篇文章中。

在本文中，我们将使用基于分布式存储的 Kubernetes 部署来构建一个 IRIS 的高可用配置，而不使用“传统的”IRIS Mirror。 这种部署将能够容忍与基础架构相关的故障，如节点、存储和可用区故障。 所描述的方法可以大大降低部署的复杂性，代价是 RTO的略微延长。 图 1 - 传统镜像与采用分布式存储的 Kubernetes 本文的所有源代码均可在 https://github.com/antonum/ha-iris-k8s 下载TL;DR 假设您有一个正在运行的 3 节点集群，并且您对 Kubernetes 有一定了解 – 请继续： kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/master/deploy/longhorn.yaml kubectl apply -f https://github.com/antonum/ha-iris-k8s/raw/main/tldr.yaml 如果您不确定上面两行有什么作用，或者没有可执行这些命令的系统，请跳转至“高可用性要求”部分。 我们将在后面详细介绍。 第一行安装 Longhorn - 开源分布式 Kubernetes 存储。 第二行安装 InterSystems IRIS ，将基于 Longhorn 的卷用于 Durable SYS。 等待所有 pod 进入运行状态。 kubectl get pods -A 您现在应该能通过 http://<IRIS Service Public IP>:52773/csp/sys/%25CSP.Portal.Home.zen（默认密码为“SYS”）访问 IRIS 管理门户，并通过以下命令访问 IRIS 命令行： kubectl exec -it iris-podName-xxxx -- iris session iris 模拟故障 现在开始制造一些混乱。 但在操作之前，先尝试将一些数据添加到数据库中，并确保当 IRIS 重新上线后数据仍然存在。 kubectl exec -it iris-6d8896d584-8lzn5 -- iris session iris USER>set ^k8stest($i(^k8stest))=$zdt($h)_" running on "_$system.INetInfo.LocalHostName() USER>zw ^k8stest ^k8stest=1 ^k8stest(1)="01/14/2021 14:13:19 running on iris-6d8896d584-8lzn5" 我们的“混乱工程”从这里开始： # Stop IRIS - Container will be restarted automatically kubectl exec -it iris-6d8896d584-8lzn5 -- iris stop iris quietly # Delete the pod - Pod will be recreated kubectl delete pod iris-6d8896d584-8lzn5 # "Force drain" the node, serving the iris pod - Pod would be recreated on another node kubectl drain aks-agentpool-29845772-vmss000001 --delete-local-data --ignore-daemonsets --force # Delete the node - Pod would be recreated on another node # well... you can't really do it with kubectl. Find that instance or VM and KILL it. # if you have access to the machine - turn off the power or disconnect the network cable. Seriously! 高可用性要求 我们正在构建可以容忍以下故障的系统： 容器/VM 内的 IRIS 实例。 IRIS – 级别故障。 pod/容器故障。 个别集群节点暂时不可用。 一个典型的例子是可用区临时下线。 个别集群节点或磁盘的永久性故障。 基本上，是我们刚才在“模拟故障”部分中尝试实现的场景。 如果发生上述任何一种故障，系统应该在没有任何人工干预的情况下保持在线，并且没有数据丢失。 从技术上说，数据持久性的保证是有限制的。 IRIS 本身可以根据应用程序内的日志循环和事务使用情况提供：https://docs.intersystems.com/irisforhealthlatest/csp/docbook/Doc.View.cls?KEY=GCDI_journal#GCDI_journal_writecycle。无论如何，我们讨论的是低于两秒的 RPO（恢复目标时间）。 系统的其他组件（Kubernetes API 服务、etcd 数据库、LoadBalancer 服务、DNS 等等）不在讨论范围内，它们通常由 Azure AKS 或 AWS EKS 等托管 Kubernetes 服务管理，因此我们假定它们已经高度可用。 换一个角度看 – 我们负责处理个别的计算和存储组件故障，并假设其余故障由基础设施/云提供商处理。 架构 在谈到 InterSystems IRIS 的高可用性时，传统的建议是使用镜像。 使用镜像时，有两个始终在线的 IRIS 实例同步复制数据。 每个节点都维护一个完整的数据库副本，如果主节点宕机，用户将重新连接到备份节点。 本质上，在镜像方法中，IRIS 负责计算和存储的冗余。 利用部署在不同可用区的Mirror，镜像方法提供了容忍计算和存储故障所需的冗余，并且实现了只有几秒的出色 RTO（目标恢复时间或系统在故障后重新上线所需的时间）。 您可以在以下网址找到在 AWS 云上部署 IRIS Mirror的模板：https://community.intersystems.com/post/intersystems-iris-deployment%C2%A0guide-aws%C2%A0using-cloudformation-template Mirror的缺点是设置、执行备份/恢复程序比较复杂，而且缺少对安全设置和本地非数据库文件的复制。 Kubernetes 等容器编排器通过部署对象提供计算冗余，在出现故障时会自动重启有故障的 IRIS Pod/容器。 所以在 Kubernetes 架构图上只能看到一个 IRIS 节点在运行。 我们没有让另一个 IRIS 节点始终保持运行，而是将计算可用性外包给 Kubernetes。 Kubernetes 将确保当原始 pod 因任何原因发生故障时，重新创建 IRIS pod。 图 2 故障转移方案 到目前为止还不错... 如果 IRIS 节点发生故障，Kubernetes 就会创建一个新节点。 根据集群的情况，发生计算故障后，让 IRIS 重新上线需要 10 到 90 秒的时间。 相对于Mirror只需要几秒即可恢复，这确实有些退步，但如果万一发生中断时您可以容忍这一点，那么回报就是复杂度大大降低。 无需配置镜像。 无需担心安全设置和文件复制。 说实话，如果您在容器内登录，在 Kubernetes 中运行 IRIS，您甚至不会注意到您正在高可用环境中运行。 一切都像单实例 IRIS 部署一样。 等等，那存储呢？ 我们还要处理数据库... 无论我们想象到什么样的故障转移方案，我们的系统都应该确保数据持久性。 Mirror依赖于 IRIS 节点本地的计算。 如果节点故障或只是暂时不可用 – 该节点的存储也会变得如此。 这就是IRIS 需要在Mirror配置内解决 IRIS 层面的数据复制的原因。 我们需要的存储不仅能在容器重启后保留数据库的状态，而且能针对节点或整个网段（可用区）宕机等事件提供冗余。 就在几年前，这个问题还没有简单的答案。 不过从上图可以猜到 – 我们现在有了这样的答案。 它称为分布式容器存储。 分布式存储将多个基础主机卷抽象成一个联合存储，供 k8s 集群的每个节点使用。 在本文中，我们使用 Longhorn https://longhorn.io；它免费、开源且相当容易安装。 但是您也可以看看其他提供相同功能的产品，例如 OpenEBS、Portworx 和 StorageOS。 Rook Ceph 是另一个可以考虑的 CNCF 孵化项目。 在高端领域 – 有企业级存储解决方案，如 NetApp、PureStorage 等。 分步指南 在 TL;DR 部分中，我们一次性安装了整套系统。 附录 B 将指导您完成逐步安装和验证过程。 Kubernetes 存储 让我们往回退一步，从总体上谈谈容器和存储，以及 IRIS 如何融入其中。 默认情况下，容器内的所有数据都是暂时的。 当容器消亡时，数据也会消失。 在 docker 中，可以使用卷的概念。 本质上，它允许将主机操作系统上的目录公开给容器。 docker run --detach --publish 52773:52773 --volume /data/dur:/dur --env ISC_DATA_DIRECTORY=/dur/iconfig --name iris21 --init intersystems/iris:2020.3.0.221.0 在上面的示例中，我们启动了 IRIS 容器，并使主机本地的“/data/dur”目录可以被“/dur”挂载点上的容器访问。 所以，容器在该目录内存储的任何内容都会保留下来，并可在下次容器启动时使用。 在 IRIS 方面，我们可以通过指定 ISC_DATA_DIRECTORY 来指示 IRIS 将所有需要在容器重启后存活的数据存储在特定目录中。 Durable SYS 是您可能需要在文档 https://docs.intersystems.com/irisforhealthlatest/csp/docbook/Doc.View.cls?KEY=ADOCK#ADOCK_iris_durable_running 中查找的 IRIS 功能的名称 在 Kubernetes 中，语法有所不同，但概念是相同的。 以下是 IRIS 的基本 Kubernetes 部署。 apiVersion: apps/v1 kind: Deployment metadata: name: iris spec: selector: matchLabels: app: iris strategy: type: Recreate replicas: 1 template: metadata: labels: app: iris spec: containers: - image: store/intersystems/iris-community:2020.4.0.524.0 name: iris env: - name: ISC_DATA_DIRECTORY value: /external/iris ports: - containerPort: 52773 name: smp-http volumeMounts: - name: iris-external-sys mountPath: /external volumes: - name: iris-external-sys persistentVolumeClaim: claimName: iris-pvc 在上面的部署规范中，“volumes”部分列出了存储卷。 可以在容器外部通过“iris-pvc”等 persistentVolumeClaim 访问它们。 volumeMounts 在容器内公开了此卷。 “iris-external-sys”是将卷挂载绑定到特定卷的标识符。 在现实中，我们可能有多个卷，此名称即用来区分各个卷。 如果您愿意，还可以叫它“steve”。 我们已经熟悉的环境变量 ISC_DATA_DIRECTORY 指示 IRIS 使用一个特定挂载点来存储所有需要在容器重启后存活的数据。 现在，我们来看一下持久卷声明 iris-pvc。 apiVersion: v1 kind: PersistentVolumeClaim metadata: name: iris-pvc spec: storageClassName: longhorn accessModes: - ReadWriteOnce resources: requests: storage: 10Gi 相当直接。 请求 10 GB，只能在一个节点上以读/写方式挂载，使用“longhorn”存储类。 storageClassName: longhorn 在这里实际上很关键。 我们看一下我的 AKS 集群上可用的存储类： kubectl get StorageClass NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE azurefile kubernetes.io/azure-file Delete Immediate true 10d azurefile-premium kubernetes.io/azure-file Delete Immediate true 10d default (default) kubernetes.io/azure-disk Delete Immediate true 10d longhorn driver.longhorn.io Delete Immediate true 10d managed-premium kubernetes.io/azure-disk Delete Immediate true 10d 默认安装了 Azure 的几个存储类，还有一个来自于 Longhorn，是我们在第一个命令中安装的： kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/master/deploy/longhorn.yaml 如果在持久卷声明定义中注释掉 #storageClassName: longhorn，则将使用当前标记为“default”的存储类，它是一个常规 Azure 磁盘。 为了说明为什么需要分布式存储，让我们重复本文开头所述的没有 longhorn 存储的“混乱工程”实验。 前两种情况（停止 IRIS 和 删除 Pod）将成功完成，系统将恢复到运行状态。 尝试耗尽或终止节点将使系统进入故障状态。 #forcefully drain the node kubectl drain aks-agentpool-71521505-vmss000001 --delete-local-data --ignore-daemonsets kubectl describe pods ... Type Reason Age From Message ---- ------ ---- ---- ------- Warning FailedScheduling 57s (x9 over 2m41s) default-scheduler 0/3 nodes are available: 1 node(s) were unschedulable, 2 node(s) had volume node affinity conflict. 基本上，Kubernetes 会尝试重启集群上的 IRIS pod，但最初启动该 pod 的节点不可用，另外两个节点存在“卷节点相关性冲突”。 对于这种存储类型，卷只在最初创建它的节点上可用，因为它基本上与节点主机上可用的磁盘绑定。 使用 longhorn 作为存储类时，“强制耗尽”和“节点终止”实验均会成功，并且 IRIS pod 很快会恢复运行。 为了实现这一目标，Longhorn 控制了集群的 3 个节点上的可用存储，并将数据复制到全部三个节点上。 如果其中一个节点永久不可用，Longhorn 会迅速修复集群存储。 在我们的“节点终止”场景中，系统立即使用其余的两个卷副本在其他节点上重启 IRIS pod。 然后，AKS 提供一个新节点来替换丢失的节点，一旦准备就绪，Longhorn 就会介入，并在新节点上重建所需数据。 一切都是自动的，不需要您参与。 图 3 Longhorn 在替换的节点上重建卷副本。 更多有关 k8s 部署的信息 我们看一下部署的其他几个方面： apiVersion: apps/v1 kind: Deployment metadata: name: iris spec: selector: matchLabels: app: iris strategy: type: Recreate replicas: 1 template: metadata: labels: app: iris spec: containers: - image: store/intersystems/iris-community:2020.4.0.524.0 name: iris env: - name: ISC_DATA_DIRECTORY value: /external/iris - name: ISC_CPF_MERGE_FILE value: /external/merge/merge.cpf ports: - containerPort: 52773 name: smp-http volumeMounts: - name: iris-external-sys mountPath: /external - name: cpf-merge mountPath: /external/merge livenessProbe: initialDelaySeconds: 25 periodSeconds: 10 exec: command: - /bin/sh - -c - "iris qlist iris | grep running" volumes: - name: iris-external-sys persistentVolumeClaim: claimName: iris-pvc - name: cpf-merge configMap: name: iris-cpf-merge 策略: 重建Recreate, 副本replicas: 1 告诉 Kubernetes 在任何给定时间都应该保持一个且只能有一个 IRIS pod 实例运行。 这对应于我们的“删除 pod”场景。 livenessProbe 部分确保 IRIS 始终在容器内正常运行并应对“IRIS 下线”情况。 initialDelaySeconds 允许 IRIS 启动有一定的宽限期。 如果 IRIS 需要相当长的时间来启动部署，您可能需要增加该值。 IRIS 的 CPF MERGE配置文件合并 功能允许您在容器启动时修改配置文件 iris.cpf 的内容。 请参见 https://docs.intersystems.com/irisforhealthlatest/csp/docbook/DocBook.UI.Page.cls?KEY=RACS_cpf#RACS_cpf_edit_merge 了解相关内容。 在本示例中，我将使用 Kubernetes Config Map 管理合并文件 https://github.com/antonum/ha-iris-k8s/blob/main/iris-cpf-merge.yaml 的内容。这里我们调整了 IRIS 实例使用的全局缓冲区和 gmheap 值，但是您在 iris.cpf 文件中找到的一切都是可修改的。 您甚至可以使用 CPF Merge 文件中的“PasswordHash”字段更改默认 IRIS 密码。 更多信息请参见：https://docs.intersystems.com/irisforhealthlatest/csp/docbook/Doc.View.cls?KEY=ADOCK#ADOCK_iris_images_password_auth 除了持久卷声明 https://github.com/antonum/ha-iris-k8s/blob/main/iris-pvc.yaml 部署 https://github.com/antonum/ha-iris-k8s/blob/main/iris-deployment.yaml 和采用 CPF Merge 内容的 ConfigMap https://github.com/antonum/ha-iris-k8s/blob/main/iris-cpf-merge.yaml，我们的部署还需要一个将 IRIS 部署暴露给公网的服务：https://github.com/antonum/ha-iris-k8s/blob/main/iris-svc.yaml kubectl get svc NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE iris-svc LoadBalancer 10.0.18.169 40.88.123.45 52773:31589/TCP 3d1h kubernetes ClusterIP 10.0.0.1 <none> 443/TCP 10d iris-svc 的外部 IP 可用于通过 http://40.88.123.45:52773/csp/sys/%25CSP.Portal.Home.zen 访问 IRIS 管理门户。 默认密码为“SYS”。 备份/恢复和存储扩展 Longhorn 提供了基于 Web 的 UI 来配置和管理卷。 使用 kubectl 标识 pod、运行 longhorn-ui 组件和建立端口转发： kubectl -n longhorn-system get pods # note the longhorn-ui pod id. kubectl port-forward longhorn-ui-df95bdf85-gpnjv 9000:8000 -n longhorn-system Longhorn UI 将可通过 http://localhost:9000 访问 图 4 Longhorn UI 除了高可用性，大多数 Kubernetes 容器存储解决方案还提供了方便的备份、快照和恢复选项。 细节是特定于实现的，但通常的惯例是备份与 VolumeSnapshot 关联。 对于 Longhorn 来说就是这样。 根据您的 Kubernetes 版本和提供商，您可能还需要安装卷快照工具 https://github.com/kubernetes-csi/external-snapshotter “iris-volume-snapshot.yaml”是此类卷快照的示例。 在使用它之前，您需要在 Longhorn 中配置备份到 S3 存储桶或 NFS 卷。 https://longhorn.io/docs/1.0.1/snapshots-and-backups/backup-and-restore/set-backup-target/ # Take crash-consistent backup of the iris volume kubectl apply -f iris-volume-snapshot.yaml 对于 IRIS，建议在获取备份/快照之前执行外部冻结，之后再解冻。 有关详细信息，请参见：https://docs.intersystems.com/irisforhealthlatest/csp/documatic/%25CSP.Documatic.cls?LIBRARY=%25SYS&CLASSNAME=Backup.General#ExternalFreeze 要增加 IRIS 卷的大小，请调整 IRIS 使用的持久卷声明（文件“iris-pvc.yaml”）中的存储请求。 ... resources: requests: storage: 10Gi #change this value to required 然后，重新应用 pvc 规范。 当卷连接到正在运行的 Pod 时，Longhorn 无法实际应用此更改。 请在部署中暂时将副本数更改为零，以便增加卷大小。 高可用性 – 概述 在文章开头，我们为高可用性设置了一些标准。 下面来说明我们如何通过此架构来实现： 故障域 自动缓解方式 容器/VM 内的 IRIS 实例。 IRIS – 级别故障。 部署运行情况探测将在 IRIS 故障时重启容器 pod/容器故障。 部署重新创建 pod 个别集群节点暂时不可用。 一个典型的例子是可用区下线。 部署在其他节点上重新创建 pod。 Longhorn 使数据在其他节点上可用。 个别集群节点或磁盘的永久性故障。 同上，并且 k8s 集群自动缩放器会将受损节点替换为新节点。 Longhorn 在新节点上重建数据。 Zoombie和其他要考虑的事项 如果您熟悉在 Docker 容器中运行 IRIS，则可能已经使用了“--init”标志。 docker run --rm -p 52773:52773 --init store/intersystems/iris-community:2020.4.0.524.0 此标志的目标是防止形成“僵尸进程”。 在 Kubernetes 中，可以使用“shareProcessNamespace: true”（安全注意事项适用）或在您自己的容器中使用“tini”。 使用 tini 的 Dockerfile 示例： FROM iris-community:2020.4.0.524.0 ... # Add Tini USER root ENV TINI_VERSION v0.19.0 ADD https://github.com/krallin/tini/releases/download/${TINI_VERSION}/tini /tini RUN chmod +x /tini USER irisowner ENTRYPOINT ["/tini", "--", "/iris-main"] 从 2021 年开始，InterSystems 提供的所有容器映像都默认包括 tini。 您可以通过调整一些参数来进一步减少“强制耗尽节点/终止节点”场景下的故障切换时间。 Longhorn Pod 删除策略 https://longhorn.io/docs/1.1.0/references/settings/#pod-deletion-policy-when-node-is-down 和 kubernetes 基于 taint 的逐出：https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/#taint-based-evictions 免责声明 作为 InterSystems 员工，我必须在这里说明：本文使用 Longhorn 作为 Kubernetes 分布式块存储的示例。 InterSystems 不会对个别存储解决方案或产品进行验证或发布官方支持声明。 您需要测试和验证是否有任何特定存储解决方案符合您的需求。 分布式存储与节点本地存储相比，性能特征可能有很大差别。 特别是在写入操作方面，数据必须写入到多个位置才会被认为处于持久状态。 请确保测试您的工作负载，并了解您的 CSI 驱动程序具有的特定行为和选项。 基本上，InterSystems 不会验证和/或认可具体的存储解决方案（如 Longhorn），就像我们不会验证单个硬盘品牌或服务器硬件制造商一样。 我个人认为 Longhorn 很容易使用，而且开发团队在项目的 GitHub 页面上响应迅速且乐于助人。https://github.com/longhorn/longhorn 结论 Kubernetes 生态系统在过去几年有了长足的发展，通过使用分布式块存储解决方案，您现在可以构建一个高可用性配置来维持 IRIS 实例、集群节点甚至是可用区故障。 您可以将计算和存储高可用性外包给 Kubernetes 组件，这样与传统 IRIS 镜像相比，系统的配置和维护都大为简化。 同时，此配置可能无法提供与镜像配置相同的 RTO 和存储级别性能。 在本文中，我们使用 Azure AKS 作为托管的 Kubernetes 和 Longhorn 分布式存储系统，构建了一个高可用性 IRIS 配置。 你可以探索多种替代方案，如 AWS EKS、用于托管 K8s 的 Google Kubernetes Engine、StorageOS、Portworx 和 OpenEBS 作为分布式容器存储，甚至 NetApp、PureStorage、Dell EMC 等企业级存储解决方案。 附录 A. 在云中创建 Kubernetes 集群 来自公共云提供商之一的托管 Kubernetes 服务是创建此设置所需的 k8s 集群的简单方法。 Azure 的 AKS 默认配置可以直接用于本文所述的部署。 创建一个新的 3 节点 AKS 集群。 其他所有设置都保持默认。 图 5 创建 AKS 集群 在您的计算机上本地安装 kubectl：https://kubernetes.io/docs/tasks/tools/install-kubectl/ 使用本地 kubectl 注册 AKS 集群 图 6 使用 kubectl 注册 AKS 集群 之后，您可以回到文章开头，并安装 longhorn 和 IRIS 部署。 在 AWS EKS 上安装更复杂一些。 您需要确保您的节点组中的每个实例都已安装 open-iscsi。 sudo yum install iscsi-initiator-utils -y 在 GKE 上安装 Longhorn 需要额外步骤，请参见此处：https://longhorn.io/docs/1.0.1/advanced-resources/os-distro-specific/csi-on-gke/ 附件 B. 分步安装 第 1 步 – Kubernetes 集群和 kubectl 您需要 3 节点 k8s 集群。 附录 A 介绍了如何在 Azure 上获得一个这样的集群。 $ kubectl get nodes NAME STATUS ROLES AGE VERSION aks-agentpool-29845772-vmss000000 Ready agent 10d v1.18.10 aks-agentpool-29845772-vmss000001 Ready agent 10d v1.18.10 aks-agentpool-29845772-vmss000002 Ready agent 10d v1.18.10 第 2 步 – 安装 Longhorn kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/master/deploy/longhorn.yaml 确保“longhorn-system”命名空间中的所有 pod 都处于运行状态。 这可能需要几分钟。 $ kubectl get pods -n longhorn-system NAME READY STATUS RESTARTS AGE csi-attacher-74db7cf6d9-jgdxq 1/1 Running 0 10d csi-attacher-74db7cf6d9-l99fs 1/1 Running 1 11d ... longhorn-manager-flljf 1/1 Running 2 11d longhorn-manager-x76n2 1/1 Running 1 11d longhorn-ui-df95bdf85-gpnjv 1/1 Running 0 11d 有关详细信息和故障排除，请参见 Longhorn 安装指南 https://longhorn.io/docs/1.1.0/deploy/install/install-with-kubectl 第 3 步 – 克隆 GitHub 仓库 $ git clone https://github.com/antonum/ha-iris-k8s.git $ cd ha-iris-k8s $ ls LICENSE iris-deployment.yaml iris-volume-snapshot.yaml README.md iris-pvc.yaml longhorn-aws-secret.yaml iris-cpf-merge.yaml iris-svc.yaml tldr.yaml 第 4 步 – 逐个部署和验证组件 tldr.yaml 文件将部署所需的所有组件捆绑在一起。 这里我们将逐个进行安装，并单独验证每一个组件的设置。 # If you have previously applied tldr.yaml - delete it. $ kubectl delete -f https://github.com/antonum/ha-iris-k8s/raw/main/tldr.yaml # Create Persistent Volume Claim $ kubectl apply -f iris-pvc.yaml persistentvolumeclaim/iris-pvc created $ kubectl get pvc NAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE iris-pvc Bound pvc-fbfaf5cf-7a75-4073-862e-09f8fd190e49 10Gi RWO longhorn 10s # Create Config Map $ kubectl apply -f iris-cpf-merge.yaml $ kubectl describe cm iris-cpf-merge Name: iris-cpf-merge Namespace: default Labels: <none> Annotations: <none> Data ==== merge.cpf: ---- [config] globals=0,0,800,0,0,0 gmheap=256000 Events: <none> # create iris deployment $ kubectl apply -f iris-deployment.yaml deployment.apps/iris created $ kubectl get pods NAME READY STATUS RESTARTS AGE iris-65dcfd9f97-v2rwn 0/1 ContainerCreating 0 11s # note the pod name. You’ll use it to connect to the pod in the next command $ kubectl exec -it iris-65dcfd9f97-v2rwn -- bash irisowner@iris-65dcfd9f97-v2rwn:~$ iris session iris Node: iris-65dcfd9f97-v2rwn, Instance: IRIS USER>w $zv IRIS for UNIX (Ubuntu Server LTS for x86-64 Containers) 2020.4 (Build 524U) Thu Oct 22 2020 13:04:25 EDT # h<enter> to exit IRIS shell # exit<enter> to exit pod # access the logs of the IRIS container $ kubectl logs iris-65dcfd9f97-v2rwn ... [INFO] ...started InterSystems IRIS instance IRIS 01/18/21-23:09:11:312 (1173) 0 [Utility.Event] Private webserver started on 52773 01/18/21-23:09:11:312 (1173) 0 [Utility.Event] Processing Shadows section (this system as shadow) 01/18/21-23:09:11:321 (1173) 0 [Utility.Event] Processing Monitor section 01/18/21-23:09:11:381 (1323) 0 [Utility.Event] Starting TASKMGR 01/18/21-23:09:11:392 (1324) 0 [Utility.Event] [SYSTEM MONITOR] System Monitor started in %SYS 01/18/21-23:09:11:399 (1173) 0 [Utility.Event] Shard license: 0 01/18/21-23:09:11:778 (1162) 0 [Database.SparseDBExpansion] Expanding capacity of sparse database /external/iris/mgr/iristemp/ by 10 MB. # create iris service $ kubectl apply -f iris-svc.yaml service/iris-svc created $ kubectl get svc NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE iris-svc LoadBalancer 10.0.214.236 20.62.241.89 52773:30128/TCP 15s 第 5 步 – 访问管理门户 最后使用服务的外部 IP http://20.62.241.89:52773/csp/sys/%25CSP.Portal.Home.zen 连接到 IRIS 的管理门户，用户名 _SYSTEM，密码 SYS。 您第一次登录时将被要求更改密码。

如下图，系统表或代码中是否有相关方法可直接解析BP中的swith分支内容，实现接口的自动统计相关功能另：当前版本是否有已封装的页面，方便用户操作查看消息等功能 您好，对于BPL中的成分，由于其在代码中以XML记录，可以通过解析该类中xdata中的xml代码段，基于xml文本提取出switch标签中的内容进行解析可以获得其中的内容，可参考https://docs.intersystems.com/irisforhealth20222/csp/docbook/Doc.View.cls?KEY=GOBJ_xdata 但需要理解的是，基于静态代码分析得到的结果是理论上的分支，不一定能代表实际的业务运行情况，例如在代码有bug导致分支无效的情况等。而所有流经IRIS的消息都被持久化在消息标中，基于消息表通过SQL进行统计更能反映实际的业务运行状况。可参考：https://cn.community.intersystems.com/post/intersystems-%E6%95%B0%E6%8D%AE%E5%B9%B3%E5%8F%B0%E4%BA%92%E6%93%8D%E4%BD%9C%E5%8A%9F%E8%83%BD%E8%BF%90%E8%A1%8C%E7%BB%B4%E6%8A%A4%E7%AE%A1%E7%90%86%E5%9F%BA%E7%A1%80-%E4%BA%92%E6%93%8D%E4%BD%9C%E6%B6%88%E6%81%AF%E7%AE%A1%E7%90%86https://cn.community.intersystems.com/post/%E9%9B%86%E6%88%90%E4%BA%A7%E5%93%81%E7%9A%84%E4%B8%9A%E5%8A%A1%E8%A1%8C%E4%B8%BA%E7%9B%91%E6%8E%A7 另外，IRIS所有产品都带有查看消息的web界面，可以从portal中访问，也可以作为一个url被集成到用户自己的应用中去：

背景Background 大多数网站都有一个 "Fav.ico "文件，用于设置网页的图标。大多数用户有多个环境，开发、测试和生产环境。通常情况下，你很难一眼就看出你在哪个环境中。如果能直观地通过图标看到你所处的版本和环境，可以提供更好的用户体验。在这个例子中，所有的实例都被命名为 "ENSEMBLE"。注意，这是在2022.1上使用的IRIS FOR HEALTH。 默认图标是 IR 在这篇文章中，我们将把标识改为类似于以下的内容： 图标文件 图标文件安装在你的安装文件夹csp/broker/portal中 创建一个名为Archive的文件夹放在该文件夹中 复制并粘贴ISC_IRIS_icon.ico到这个文件夹，对旧图标进行备份 使用一个图标编辑器。我使用了在线创建和编辑ICO文件| RedKetchup，因为它很容易使用，并且有简单的文本选项。 将.ico文件复制到你的本地文件，并打开它（Icon-> Open） 5. 采取铅笔工具。清除任何旧的字母（提示：改变铅笔大小可以更容易操作）。 6. Click test. Set colour. Play around with the font. DON'T FORGET TO PRESS APPLY 7. 保存图标. 8. 在一个全新安装的文件夹（DRIVELETTER:\InterSystems\HealthConnect\CSP\broker）中替换图标 9. 重新加载管理门户。. 注意你可能需要在chrome/edge上做一个硬刷新页面（通过按shift同时点击重新加载按钮）。 请注意，上述步骤在升级时可能不会生效，保存任何使用的图标，以便你可以再次更换标识。

这是一个在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）。 | 消息字符串| 1000条消息来回的时间 (秒) | |------------------------|------------------| | Python BP | 1.8 | | BPL | 1.8 | | ObjectScript | 1.4 | | 消息对象| 1000条消息来回的时间 (秒) | |------------------------|------------------| | Python BP | 3.2 | | BPL | 2.1 | | ObjectScript | 1.8 | 行中函数的时间是列中函数的x倍 : | 消息字符串| Python | BPL | ObjectScript | |------------------------|------------|------------------------|------------------| | Python | 1 | 1 | 1.3 | | BPL | 1 | 1 | 1.3 | | ObjectScript | 0.76 | 0.76 | 1 | 例如，第一行告诉我们，Python字符串的时间是Objectscript图形字符串函数的1倍，是Objectscript字符串函数的1.3倍。 ( 利用第一个表格，我们可以验证我们的结果 : 1.3 * 1.4 = 1.8 1.3是第一行最后一列表格中的x，1.4s是本节第一个表格中看到的objectscript中的字符串信息的时间，1.8s实际上是python中的字符串信息的时间，我们可以通过寻找本节第一个表格或通过前面所示的微积分找到。) 行中的函数有列中函数X倍的时间: | Messages objects| Python | BPL | ObjectScript | |------------------------|------------|------------------------|------------------| | Python | 1 | 1.5 | 1.8 | | BPL | 0.66 | 1 | 1.2 | | ObjectScript | 0.55 | 0.83 | 1 |

嗨，开发者们。 不要错过这个由InterSystems Healthcare副总裁@Donald.Woodlock主持的动手实践环节: ⏯ Machine Learning 201 - Neural Networks and Image Recognition 观看如何训练机器学习模型来做图像分类。几十年来，机器学习试图解决的最初的经典问题之一是如何在图片中区分狗和猫--这甚至是一个小孩子都能做到的事，但计算机却发现它非常困难。几十年后，这个问题被解决了，并为机器学习现在善于阅读放射学图像、识别人脸、为自动驾驶汽车识别物体类型、从卫星图像识别森林砍伐以及其他各种用例铺平了道路。我们将在这个实践环节中学习如何做到这一点。特别是，我们将解决识别手写数字的问题。我们将陆续建立更复杂的模型来提高这项任务的准确性，包括逻辑回归、前馈神经网络和卷积神经网络。 这是一个2小时的会议，通过虚拟会议的方式现场录制，有一些与会者参加。不要求有机器学习或python的经验，但最好不要讨厌编程。 你将需要一个Kaggle账户（http://www.kaggle.com）来跟上这个视频。该账户需要经过 "手机验证"，以便使用Kaggle的GPU功能，这是其中一个练习所需要的。 作为本课的一部分，你将需要的链接是：https://www.kaggle.com/competitions/digit-recognizer笔记本的链接是：http://www.donwoodlock.com/ml201/25Jul2022/index.html 祝您愉快，敬请期待!

Hi, 请问如何更改表（有数据）上的主键？谢谢！ 答： 如果数据已经存在，那么这是一项必须重视的任务，特别是如果存在继承或父/子关系，因为这将导致你的数据存储方案的改变。 最简单的方法是通过一个中间（临时）表来实现。 创建一个具有相同结构的新类，但有一个新的主键。使用SQL（不是合并命令）将数据从旧的类中移到它里面。删除旧类中的数据/索引，然后改变其中的主键。使用合并命令，将数据从新类移到旧类中。删除带有数据的新类。重建索引（如果有的话）。 几个有用的链接： MERGE 持久性对象和InterSystems IRIS SQL 持久性对象的介绍 如果仍然有问题，最好向WRC寻求帮助。 答： 如果数据已经存在，那么这是一项必须重视的任务，特别是如果存在继承或父/子关系，因为这将导致你的数据存储方案的改变。 最简单的方法是通过一个中间（临时）表来实现。 创建一个具有相同结构的新类，但有一个新的主键。使用SQL（不是合并命令）将数据从旧的类中移到它里面。删除旧类中的数据/索引，然后改变其中的主键。使用合并命令，将数据从新类移到旧类中。删除带有数据的新类。重建索引（如果有的话）。 几个有用的链接： MERGE

1.Caché数据库有没有办法配置然后用sql读取数据库实时变化的数据，类似于mssql那样？我看了可以写类去读取global获取journal的值，但是怎么用sql读呢？ 2.不行的话，那用什么方式可以读取到journal日志文件，并输出日志文件的内容？ 先谢谢大家了！！！ 请参考CDC 系列文章：https://cn.community.intersystems.com/post/cdc%E7%B3%BB%E5%88%97%E4%B9%8B%E4%B8%80-%EF%BC%9A%E4%BD%BF%E7%94%A8dejournal-filter%E5%9C%A8intersystems-iriscach%C3%A9%E4%B8%8A%E9%80%9A%E8%BF%87mirroring%E5%AE%9E%E7%8E%B0cdc%E5%8A%9F%E8%83%BD 这个试过了，配置dejournal没有问题，但是用$$$JRNNEWVAL(Address) 输入偏移量获取不到值的 注意文章中的提示： 1. $$$JRNNEWVAL(Address) 、$$$JRNOLDVAL(Address)`这2个宏定义在%syJrnRecord.inc文件里，因此需要将这个include文件加入ZCustom.MirrorDejournal类定义：Include %syJrnRecord 2.在InterSystems IRIS上修改并编译dejournal过滤器类后，需要重启异步镜像成员的Mirror，以使更改生效。 加了这个定义，并重启了的Mirror的，还是获取不到值的 使用的产品版本是什么？Dejournal filter是在Mirror report类型的异步镜像成员做的还是在shadow上做的？不同给的版本对应不同的处理方式。 同时还是建议将问题提到WRC：support@intersystems.com，他们会给予更详细的错误分析以及解决方案。 是在Mirror report类型的异步镜像成员上做的，版本是Cache for Windows (x86-64) 2016.2 (Build 736_0_16871U) Wed Dec 21 2016 09:38:49 EST版本 可以参考 %SYS.Journal.File.cls 这个类下的代码是如何使用$$$JRNNEWVAL(Address) 、$$$JRNOLDVAL(Address)的。

可以使用内嵌REST API用描述文件生成REST服务 请求消息如下： POST： http://[YourServer]/api/mgmnt/v2/INTEROP/cmAPI Body： API 描述文件，例如下面的Json文件Basic Authorization Username: 用户名 Basic Authorization Password: 密码 Content-Type Header: application/json ** 注意**：调用接口前，需要创建相应命名空间，本示例为INTEROP API 描述文件： { "swagger": "2.0", "info": { "description": "An API for coffee sales using InterSystems IRIS", "version": "1.0.0", "title": "Coffee Maker API", "license": { "name": "Apache 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0.html" } }, "schemes": [ "https" ], "paths": { "/coffeemakers": { "post": { "description": "Returns all coffeemakers\n", "operationId": "QueryAll", "produces": [ "application/json" ], "parameters": [], "responses": { "200": { "description": "Success" }, "500": { "description": "Server error" } } } }, "/newcoffeemaker": { "post": { "description": "Add a new coffeemaker to the store. ID is autogenerated. Other info must be provided in the request body. Name and brand are required fields. Returns new coffeemaker\n", "operationId": "NewMaker", "produces": [ "application/json" ], "parameters": [ { "in": "body", "name": "body", "required": true, "schema": { "$ref": "#/definitions/CoffeeMaker" } } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Invalid message body" }, "500": { "description": "Server error" } } } }, "/coffeemaker": { "post": { "description": "Retrieve existing coffeemaker given ID and data. Returns coffeemaker\n", "operationId": "QueryMaker", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "query", "description": "CoffeemakerID", "required": true, "type": "integer" }, { "name": "prod", "in": "query", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Success" }, "404": { "description": "Coffeemaker not found" }, "500": { "description": "Server error" } } }, "put": { "description": "Update existing coffeemaker given ID and data. Returns updated coffeemaker\n", "operationId": "EditMaker", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "query", "description": "CoffeemakerID", "required": true, "type": "integer" }, { "in": "body", "name": "body", "description": "coffeemaker info", "required": true, "schema": { "$ref": "#/definitions/CoffeeMaker" } }, { "name": "prod", "in": "query", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Success" }, "400": { "description": "Invalid message body" }, "404": { "description": "Coffeemaker not found" }, "500": { "description": "Server error" } } }, "delete": { "description": "Delete existing cofffeemaker given ID. Returns deleted coffeemaker\n", "operationId": "RemoveMaker", "produces": [ "application/json" ], "parameters": [ { "name": "id", "in": "query", "description": "CoffeemakerID", "required": true, "type": "integer" }, { "name": "prod", "in": "query", "required": false, "type": "boolean" } ], "responses": { "200": { "description": "Success" }, "404": { "description": "Coffeemaker not found" } } } } }, "definitions": { "CoffeeMaker": { "type": "object", "properties": { "Name": { "type": "string" }, "Brand": { "type": "string" }, "Price": { "type": "number" }, "NumCups": { "type": "integer" }, "Color": { "type": "string" }, "Img": { "type": "string" } } } } } 返回消息： { "msg": "New application cmAPI created" }

# 第十五章 使用管理门户SQL接口（二） # 过滤模式内容 Management Portal SQL界面的左侧允许查看模式(或匹配筛选器模式的多个模式)的内容 1. 通过单击SQL interface页面顶部的Switch选项，指定希望使用的名称空间。 这将显示可用名称空间的列表，可以从中进行选择。 2. 应用筛选器或从模式下拉列表中选择模式。 可以使用Filter字段通过输入搜索模式来筛选列表。 可以在一个模式或多个模式中筛选模式，或筛选表/视图/过程名(项)。 搜索模式由模式名、点(`.`)和项目名组成——每个名称由文字和通配符的某种组合组成。字面值不区分大小写。 通配符是: - 星号(`*`)表示0个或多个任意类型的字符。 - 下划线(`_`)表示任意类型的单个字符。 - 撇号(`'`)倒装前缀，意为“不”(除了)。 - 反斜杠(`\`)转义字符:`\_`表示字面上的下划线字符。 例如，`S*`返回所有以`S S*`开头的模式。 `Person`返回所有以`S. *`开头的模式中的所有Person项。 `Person*`返回所有模式中以`Person开头`的所有项。 可以使用逗号分隔的搜索模式列表来选择满足所列模式(或逻辑)中的任何一种的所有项。 例如,`* .Person * *`。 `Employee*`选择所有模式中的所有Person和Employee项。 若要应用筛选器搜索模式，请单击refresh按钮或按Tab键。 过滤器搜索模式将一直有效，直到显式地更改它。 过滤器字段右侧的`“x”`按钮清除搜索模式。 3. 从schema下拉列表中选择一个模式将覆盖并重置之前的任何筛选器搜索模式，选择单个模式。 指定筛选器搜索模式将覆盖之前的任何模式。 4. 可选地，使用下拉“应用到”列表来指定要列出的项目类别:表、视图、过程、缓存查询，或以上所有。 默认为`All`。 在“应用到”下拉列表中指定的任何类别都受到筛选器或模式的限制。 在“应用到”中没有指定的类别继续在名称空间中列出该类别类型的所有项。 5. 可选地，单击System复选框以包含系统项目(名称以`%`开头的项目)。 默认情况下不包含系统项。 6. 展开类别的列表，列出指定架构或指定筛选器搜索模式的项。 展开列表时，不包含项的任何类别都不会展开。 7. 单击展开列表中的项，在SQL界面的右侧显示其目录详细信息。 如果所选项目是表或过程，则Catalog Details类名信息提供到相应类参考文档的链接。 请注意，筛选器设置是用户自定义的，并保留以供该用户将来使用。 ## Browse选项卡 Browse选项卡提供了一种方便的方式，可以快速查看名称空间中的所有模式，或者名称空间中经过过滤的模式子集。 可以选择Show All Schemas或Show Schemas with Filter，这将应用在管理门户SQL界面左侧指定的过滤器。 通过单击模式名称标题，可以按字母升序或降序列出模式。 每个列出的模式都提供指向其关联表、视图、过程和查询(缓存的查询)列表的链接。 如果模式没有该类型的项，则在该模式列表列中显示一个连字符(而不是命名链接)。 这使能够快速获得关于模式内容的信息。 单击“表”、“视图”、“过程”或“查询”链接将显示有关这些项的基本信息的表。 通过单击表标题，可以按该列的值升序或降序对列表进行排序。 过程表总是包括区段过程，而不管管理门户SQL界面左侧的过程设置如何。 可以使用Catalog Details选项卡获得关于单个表、视图、过程和缓存查询的更多信息。 从Browse选项卡中选择表或视图不会激活该表的`Open Table`链接。 # 目录详情 管理门户提供每个表，视图，过程和缓存查询的目录详细信息。管理门户SQL界面的过滤架构内容（左侧）组件允许您选择单个项目以显示其目录详细信息。 ## 目录表的详细信息 每个表提供以下目录详细信息选项： - 表信息：表类型：表类型：无论是表，全局临时或系统表（仅在选择系统复选框时显示系统表），所有者名称，最后编译的时间戳，外部和读取的布尔值，类名称，范围大小，子表的名称和/或父表（如果相关）和一个或多个引用字段到其他表（如果相关），无论是使用`％storage.persistent`默认存储类，无论是支持位图指标， `ROWID`字段名称，`ROWID`基于（如果相关）的字段列表，以及表是否被分析。如果有一个显式分片键，它会显示分片键字段。 类名是在Intersystems类参考文档中的相应条目的链接。类名是通过删除标点字符，如标识符和类实体名称中所述从表名派生的唯一包。 只有当当前表中的某个字段对另一个表有一个或多个引用时，引用才会出现在表信息中。 这些对其他表的引用作为指向所引用表的表信息的链接列出。 Sharded:如果表是一个分片主表，那么表信息将显示分片本地类和表的名称，并链接到InterSystems类参考文档中相应的条目。 如果该表是一个碎片本地表，表信息将显示碎片主类和表的名称，并链接到InterSystems类参考文档中相应的条目。 只有选中“System”复选框时，才会显示“Shard-local”表。 该选项还为打开表时要加载的行数提供了一个可修改的值。 这将设置打开表中显示的最大行数。 可用范围从1到10,000; 默认值为100。 管理门户将一个超出可用范围的值修正为一个有效值:0修正为100; 一个小数四舍五入到下一个更大的整数; 大于10,000的数字更正为10,000。 - 字段:表中字段的列表，显示字段名，数据类型，列#，必需的，惟一的，排序，隐藏，MaxLen, MaxVal, MinVal，流，容器，xDBC类型，引用，版本列，选择性，离群值选择性，离群值和平均字段大小。 - 映射/索引:为表定义的索引列表，显示:索引名、SQL映射名、列、类型、块计数、映射继承和全局。 索引名称是索引属性名称，然后遵循属性命名约定;从SQL索引名称生成时，将删除SQL索引名称中的标点符号（例如下划线）。 SQL映射名称是索引的SQL名称。生成的SQL映射名称与约束名称相同，并遵循相同的命名约定（下面描述）。列指定为索引指定的字段或逗号分隔的字段列表;它可以指定index collation类型和full schinea.table.field参考，如下例所示：`$$sqlupper（{sample.people.name}）`。类型可以是以下之一：位图范围，数据/主，索引（标准索引），位图或`bitslice`索引以及唯一的约束。块计数包含计数和该计数的确定：由Class Author（定义）明确地设置，由可调组织（测量）计算，或由类编译器（估计）估计。如果映射继承？是的，map是从超类继承的。全局是包含索引数据的下标全局的名称。索引全局的命名约定在索引全局名称中描述。您可以向ZWRITE提供此全局名称以显示索引数据。 此选项还为每个索引提供重建索引的链接。 - 触发：为表显示的触发器列表显示：触发名称，时间事件，订单，代码。 - 约束：表格的字段列表，显示：约束名称，约束类型和约束数据（括号中列出的字段名称）。约束包括主键，外键和唯一约束。主键是定义，唯一;它仅列出一次。此选项列出约束名称的约束;使用显示组件字段的逗号分隔列表的约束数据列出了一次涉及多个字段的约束。约束类型可以是唯一的主键，隐式主键，外键或隐式外键。 还可以通过调用`Information_schema.constraint_column_usage`来列出约束。此列表按字段名称约束。以下示例返回字段的名称和所有唯一，主键，外键和`Check Constraints`的约束的名称： ```sql SELECT Column_Name,Constraint_Name FROM INFORMATION_SCHEMA.CONSTRAINT_COLUMN_USAGE WHERE TABLE_SCHEMA='Sample' AND TABLE_NAME='Person' ```  如果该表定义为`％PublicraWID`，并且没有定义显式主键，则`RowID`字段列出了具有约束名称`RowidField_As_PKey`的`Contriced`主键的约束类型。 对于显式约束，约束名称是如下生成的： - 字段定义中指定的约束：例如，`fullname varchar（48）`唯一或`fullname varchar（48）`主键。字段的约束名称值是具有语法`tableName_ctype＃`的生成值，其中ctype是唯一的，`pkey`或`fkey`，`＃`是在表定义中指定的顺序分配给未命名约束的顺序整数。例如，如果`FullName`具有`MyTest`表中的第二个未命名的唯一约束（不包括ID字段），则`FullName`的生成约束名称将是`mytest_unique2`;如果`fullname`是`MyTest`表中指定的主键和第3个未命名约束（不包括ID字段），则`FullName`的生成约束名称将是`MyTest_pKey3`。 - 约束关键字命名约束子句：例如，约束`UFULLNAME`唯一（名字，`LastName`）或约束`Pkname`主键（`FullName`）），约束名称是指定的唯一约束名称。例如，`MyTest`表中的名字和`LastName`每个都将每个约束名称`UfullName`; `fullname`将具有约束名称`pkname`。 - 未命名约束子句：例如，唯一（名字，姓氏）或主键（`FullName`）。约束名称值是具有语法`tableNamectype＃`的生成值，其中`ctype`是唯一的，`pkey`或`fkey`，`##`是在表定义中指定的顺序分配给未命名约束的顺序整数。例如，如果`FirstName`和`LastName`具有`MyTest`表中的第2个未命名的唯一约束（不包括ID字段），则`FirstName`和`LastName`的生成约束名称将是`MyTestunique2`;如果`FullName`是`MyTest`表中指定的主要键和第3个未命名的约束（不包括ID字段），则`FullName`的生成约束名称将是`MyTestPKEY3`。 （注意混合大写/小写，没有下划线。） 如果一个字段涉及多个唯一约束，则为每个约束名称单独列出。 - 缓存查询：表的缓存查询列表显示：例程名称，查询文本，创建时间，源，查询类型。 - 表的SQL语句：为此表生成的SQL语句列表。与命名空间的SQL语句相同的信息。 ## 目录的视图详细信息 Management Portal SQL接口还提供视图，过程和缓存查询的目录详细信息： 为每个视图提供以下目录详细信息选项： - 查看信息：所有者名称，最后编译的时间戳。使用“编辑视图”链接并保存更改时，此时间戳更新。 定义为只读，视图是可更新的布尔值：如果仅读取的视图定义，则它们分别设置为1和0。否则，如果查看视图是从单个表定义的，它们被设置为0和1;如果视图由已加入的表定义，则它们设置为0和0。可以使用编辑视图链接更改此选项。 类名是唯一的包。通过删除标点字符，如标识符和类实体名称中所述，从视图名称派生的名称。 如果查看定义包含“使用”选项“子句，则仅列出选项。它可以是本地的或级联。您可以使用编辑视图链接更改此选项。 类类型是视图。它提供了编辑视图链接以编辑视图定义。 查看文本是用于定义视图的`SELECT`语句。可以使用编辑视图链接更改视图定义。 字段列表包括字段名称，数据类型，maxlen参数，maxval参数，minval参数，blob（`％stream.globalcharacter`或`％stream.globalbinary`字段），长度，精度和比例。 - 查看的SQL语句：为此视图生成的SQL语句列表。与命名空间的SQL语句相同的信息。 ## 存储过程的目录详细信息 为每个过程提供以下目录详细信息： - 存储过程信息： 类名是一个唯一的包。通过将类型标识符( `‘func’, ‘meth’, ‘proc’, or ‘query’`)预定到类名（例如，SQL函数`MyProc`变为`FuncMyProc`）并删除标点符号字符，如标识符和类实体名称中所述。类文档是Intersystems类参考中相应条目的链接。过程类型（例如，函数）。方法或查询名称生成的类方法或类查询的名称;此名称在标识符和类实体名称中描述。运行过程链接提供交互方式的选项。 - 存储过程SQL语句：为此存储过程生成的SQL语句列表。与命名空间的SQL语句相同的信息。 ## 缓存查询的目录详细信息 缓存查询提供查询的全文，一个选项来显示查询执行计划，以及交互式执行缓存查询的选项。 # 向导 - 数据导入向导 - 运行向导将数据从文本文件导入Intersystems Iris类。 - 数据导出向导 - 运行向导将数据从Intersystems Iris类导出到文本文件中。 - 数据迁移向导 - 运行向导以从外部源迁移数据，并创建一个Intersystems Iris类定义来存储它。 - 链接表向导 - 运行向导，以链接到外部源中的表或视图，就像它是本机Intersystems Iris数据一样。 - 链接过程向导 - 运行向导，以链接到外部源中的过程。 # 操作 - 创建视图 - 显示一个页面以创建视图。使用此选项的说明提供了本书的“定义和使用视图”章节。 - 打印目录 - 允许打印有关表定义的完整信息。单击打印目录显示打印预览。通过单击此打印预览上的指数，触发器和/或约束，可以从目录打印输出中包含或排除此信息。 - Purege缓存查询 - 提供三种用于清除缓存查询的选项：清除当前命名空间的所有缓存查询，清除指定表的所有缓存查询，或者仅清除所选缓存的查询。 - 调谐表信息 - 对选定的表运行调谐表工具。这计算了每个表列对当前数据的选择性。选择性值1表示定义为唯一（因此具有所有唯一数据值）的列。选择性值为`1.0000％`表示未定义所有当前数据值是唯一值的唯一列。 `1.0000％`的百分比值更大，指示当前数据中该列的重复值的相对数量。通过使用这些选择性值，可以确定要定义的索引以及如何使用这些索引来优化性能。 - 调整架构中的所有表 - 运行调谐表工具，针对所属于当前命名空间中指定架构的所有表。 - 重建表索引 - 重建指定表的所有索引。 - 删除此项目 - 删除（删除）指定的表定义，查看定义，过程或缓存查询。必须具有适当的权限来执行此操作。除非表类定义包括[`DDLOWALLED`]，否则否则不能在通过定义持久性类创建的表上使用删除。否则，操作失败了，使用`SQLCode -300`错误，其中包含类`“Schema.TableName”`的`％MSG DDL`。如果相应的持久性类具有子类（派生类），则不能在表格上使用删除;使用`％msg`类`'schema.tableName'`具有派生类`SQLCode -300`错误失败，因此无法通过DDL删除。 如果一个类被定义为链接表，则下降操作也会将链接表放在本地系统上，即使链接的表类未被定义为ddlowed。下降不会删除实际表此链接引用服务器上的引用。 - 导出所有语句 - 将所有SQL语句导出在当前命名空间中。 SQL语句以XML格式导出。可以选择导出到文件，或导出到浏览器显示页面。 - 导入语句 - 将SQL语句从XML文件导入当前命名空间。 # 打开表 如果在管理门户SQL接口的左侧选择表或视图，则会显示该表或视图的目录详细信息。页面顶部的打开表链接也变为活动状态。打开表显示表中的实际数据（或通过视图访问）。数据以显示格式显示。 默认情况下，将显示前100行数据;通过在“目录详细信息”选项卡信息中将表打开时，通过设置要加载的行数来修改此默认值。如果表格中的行数多于此行到加载值，则在数据显示的底部显示越多的数据...指示器。如果表格中的行较少，则要加载值的行数，则在数据显示的底部显示完整的指示符。 一列数据类型`％Stream.globalcharacter`将实际数据（最多100个字符）显示为字符串。超出前100个字符的附加数据由省略号（`...`）表示。 一列数据类型`％Stream.Globalbinary`显示为。 # 工具 System Explorer，SQL，Tools下拉列表提供对以下工具的访问。这些是系统资源管理器，工具，SQL性能工具的相同工具： - SQL运行时统计信息：用户界面生成指定查询的SQL运行时统计信息。 - 索引分析仪：用于收集指定架构的各种类型索引分析的用户界面。 - 替代表演计划：用户界面生成指定查询的备用显示计划。 - 生成报告以将SQL查询性能报告提交给Intersystems WRC（全球响应中心客户支持）。要使用此报告工具，必须先从WRC获取WRC跟踪号码。 - 导入报告以通过文件名导入现有WRC报告。仅用于Intersystems使用。 

各位好， 你曾建立过一个镜像环境吗？它是否有一个私有网络、虚拟IP地址和SSL配置？ 在做了几次之后，我意识到这是一个漫长的过程，而且需要很多手动操作来生成证书和配置每个IRIS实例。 对于经常要做这件事的人来说，这是一个痛苦的过程。 例如，质量保证团队可能需要为每个新的应用程序版本创建一个新的镜像环境来测试。支持团队可能需要创建一个镜像环境来重现一个复杂的问题。 我们肯定需要工具来快速创建这些镜像环境。 在这篇文章中，我们将用如下环境创建一个镜像样例： - 仲裁机 - 主服务器 - 故障切换备份成员 - 读写报告异步成员 - 节点间日志转移的SSL配置 - 镜像环境中的私有网络 - 虚拟IP地址 - 镜像数据库  乍一看，它似乎有点复杂，看起来需要大量的代码，但不要担心。 在OpenExchange上有一些库，可以轻松地执行大多数操作。 本文的目的是提供一个例子，说明如何根据你的需要调整这个过程，但在安全问题上，它不是一个最佳实践指南。 现在，让我们来创建我们的样本。 ### 工具和库 - [PKI-script](https://openexchange.intersystems.com/package/PKI-Script): 公钥基础设施（PKI）是一个与IRIS集成的功能，它允许你生成一个自签名的证书并拥有你的授权服务器。在伟大的[Pete Greskoff的文章](https://community.intersystems.com/post/creating-ssl-enabled-mirror-intersystems-iris-using-public-key-infrastructure-pki)之后，PKI-script的目标是以编程方式执行所有操作，避免在管理门户中进行任何手动操作。 该库包括用于镜像的实用方法。 然而，如果你已经有了证书，你可以用它们来代替PKI-Script。 - [config-api](https://openexchange.intersystems.com/package/Config-API): 这个库将被用来配置IRIS。它从1.1.0版本开始支持镜像配置。我们将不对如何使用这个库进行详细描述。 [这里](https://community.intersystems.com/post/environment-setup-config-api) 已经有一组文章。简而言之，config-api将被用来创建IRIS模板配置文件（JSON格式）并轻松加载。 - [ZPM](https://openexchange.intersystems.com/package/ObjectScript-Package-Manager). - Docker. ### Github 页 你可以在[iris-mirroring-samples repository](https://github.com/lscalese/iris-mirroring-samples/)上找到所有必要的资源文件。 ### 准备你的系统 克隆现有的资源库： ```bash git clone https://github.com/lscalese/iris-mirroring-samples cd iris-mirroring-samples ``` 如果你喜欢从头开始创建一个样本，而不是克隆资源库，只需创建一个带有子目录的新目录: `backup` 和 `config-files`. 下载 [irissession.sh](https://raw.githubusercontent.com/lscalese/iris-mirroring-samples/master/session.sh) : ``` mkdir -p iris-mirroring-samples/backup iris-mirroring-samples/config-files cd iris-mirroring-samples wget -O session.sh https://raw.githubusercontent.com/lscalese/iris-mirroring-samples/master/session.sh ``` 为了避免以后出现 "权限拒绝 "的问题，我们需要创建`irisowner`组，`irisowner`用户，并将备份目录的组改为`irisowner`。 ```bash sudo useradd --uid 51773 --user-group irisowner sudo groupmod --gid 51773 irisowner sudo chgrp irisowner ./backup ``` 这个目录将被用作卷，在与其他节点建立第一个镜像成员后共享数据库备份。 ### 获得IRIS许可证 镜像在IRIS社区版中不可用。 如果你还没有有效的IRIS容器许可证，请用你的账户连接到 [全球响应中心(WRC)](https://wrc.intersystems.com)。 点击 "Actions" --> "SW distribtion", 然后点击 "Evaluations" 按钮并选择"Evaluation License"; 填写表单。 把你的许可证文件`iris.key`复制到这个目录。 ###登录Intersystems 容器注册中心(Containers Registry) 为了方便起见，我们使用Intersystems Containers Registry（ICR）来提取docker镜像。如果你不知道你的docker登录名/密码，只要用你的WRC账户连接到[SSO.UI.User.ApplicationTokens.cls](https://login.intersystems.com/login/SSO.UI.User.ApplicationTokens.cls) 就可以检索到你的ICR Token。 ```bash docker login -u="YourWRCLogin" -p="YourICRToken" containers.intersystems.com ``` ### 创建`myappdata`数据库和global 我们现在并没有真正创建`myappdata`数据库，而是准备一个配置，在docker构建时创建它。 为此，我们只是用JSON格式创建一个简单的文件。 config-api库将被用来在IRIS实例中加载它。 为此，我们只是用JSON格式创建一个简单的文件。 config-api库将被用来在IRIS实例中加载它。 创建文件[config-files/simple-config.json](https://github.com/lscalese/iris-mirroring-samples/blob/master/config-files/simple-config.json) ```json { "Defaults":{ "DBDATADIR" : "${MGRDIR}myappdata/", "DBDATANAME" : "MYAPPDATA" }, "SYS.Databases":{ "${DBDATADIR}" : {} }, "Databases":{ "${DBDATANAME}" : { "Directory" : "${DBDATADIR}" } }, "MapGlobals":{ "USER": [{ "Name" : "demo.*", "Database" : "${DBDATANAME}" }] }, "Security.Services" : { "%Service_Mirror" : { /* Enable the mirror service on this instance */ "Enabled" : true } } } ``` 这个配置文件允许你用默认设置创建一个新的数据库，并在USER命名空间做global映射`demo.*`。 关于[config-api](https://openexchange.intersystems.com/package/config-api) 配置文件功能的更多信息请参考相关的[文章](https://community.intersystems.com/post/environment-setup-config-api) 或[github页](https://community.intersystems.com/post/environment-setup-config-api) ### Docker 文件 Docker文件是基于现有的 [docker模板](https://github.com/intersystems-community/objectscript-docker-template)的，但我们需要做一些修改，以创建一个工作目录，安装使用虚拟IP的工具，安装ZPM等等。 我们的IRIS image对每个镜像成员都是一样的。镜像将根据其角色The mirroring will be set up on the container starting with the correct configuration depending on its role (第一成员，故障转移备份成员，或读写报告成员) 在容器上以正确的配置开始设置。 请看下面Dockerfile上的注释： ```Dockerfile ARG IMAGE=containers.intersystems.com/intersystems/iris:2021.1.0.215.0 # 不需要从WRC下载image。它将在构建时从ICR中提取。 FROM $IMAGE USER root # COPY session.sh / COPY iris.key /usr/irissys/mgr/iris.key # /opt/demo 将是我们的工作目录，用于存储我们的配置文件和其他安装文件。 # 安装iputils-arping 以得到一个arping 命令。这在配置虚拟IP时会用到。 # 下载最新ZPM 版本 (ZPM 仅包含在社区版中)。 RUN mkdir /opt/demo && \ chown ${ISC_PACKAGE_MGRUSER}:${ISC_PACKAGE_IRISGROUP} /opt/demo && \ chmod 666 /usr/irissys/mgr/iris.key && \ apt-get update && apt-get install iputils-arping && \ wget -O /opt/demo/zpm.xml https://pm.community.intersystems.com/packages/zpm/latest/installer USER ${ISC_PACKAGE_MGRUSER} WORKDIR /opt/demo # 设置默认镜像(Default Mirror)角色为主控（master） # 它将在运行时被重写在docker-compose文件上（第一个实例的主文件、备份和报告）。 ARG IRIS_MIRROR_ROLE=master # 将config-files目录的内容复制到/opt/demo。 # 目前我们只创建了一个simple-config来设置我们的数据库和global映射。 # 在本文的后面，我们将添加其他配置文件来设置镜像。 ADD config-files . SHELL [ "/session.sh" ] # 安装 ZPM # 用 ZPM 安装config-api 和 pki-script # 用config-api加载simple-config.json文件，用以： # - 创建"myappdata" 数据库， # - 为 "myappdata "数据库中global "demo.*"在命名空间 "USER "中添加一个global映射。 # 基本上，安装ObjectScript应用程序的入口在这里。 # 对于这个例子，我们将加载simple-config.json来创建一个简单的数据库和一个global映射。 RUN \ Do $SYSTEM.OBJ.Load("/opt/demo/zpm.xml", "ck") \ zpm "install config-api" \ zpm "install pki-script" \ Set sc = ##class(Api.Config.Services.Loader).Load("/opt/demo/simple-config.json") # 复制镜像初始化脚本。 COPY init_mirror.sh / # 执行一个启动后的脚本，配置镜像。 # init_mirror.sh的内容将在本文后面描述。 CMD ["-a", "/init_mirror.sh"] ``` ### 制作 IRIS image Docker文件已经准备好了；我们可以制作image了。: ``` docker build --no-cache --tag mirror-demo:latest . ``` 这个image将会运行 将被用于运行主节点、备份节点和报告节点。 ### 准备第一个镜像成员的配置文件 config-api库允许配置一个镜像，所以我们必须为第一个镜像成员创建一个专门的配置文件`config-files/mirror-master.json` 为方便起见，注释直接位于JSON中。你可以下载 [没有注释的mirror-master.json](https://raw.githubusercontent.com/lscalese/iris-mirroring-samples/master/config-files/mirror-master.json). 所有的IP地址将通过`Docker-compose`文件分配给每个节点。 ```json { "Defaults":{ /* Section contains all variables */ "MirrorName" : "Demo", /* The name of our mirror */ "ArbiterNode" : "172.16.238.10|2188", /* IP Address and port of the arbiter node */ "VirtualAddress" : "172.16.238.100/24", /* Virtual IP Address */ "VirtualAddressInterface" : "eth0", /* Network interface used for the Virtual IP Address. */ "MirrorAddress" : "172.16.220.20", /* IP Address of this node in the private mirror network */ "AgentAddress" : "172.16.238.20", /* IP Address of this node (Agent is installed on the same machine) */ "SystemName" : "master", /* This instance name in the mirror */ "DBDir" : "${MGRDIR}myappdata/", /* Database directory to add to the Demo mirror */ "DBName" : "MYAPPDATA" /* Database name in the mirror */ }, "SYS.MirrorMaster" : { "${MirrorName}" : { "Config" : { "Name" : "${MirrorName}", "SystemName" : "${SystemName}", "UseSSL" : true, "ArbiterNode" : "${ArbiterNode}", "VirtualAddress" : "${VirtualAddress}", "VirtualAddressInterface" : "${VirtualAddressInterface}", "MirrorAddress": "${MirrorAddress}", "AgentAddress": "${AgentAddress}" }, "Databases" : [{ /* List of databases to add to the mirror */ "Directory" : "${DBDir}", "MirrorDBName" : "${DBName}" }], "SSLInfo" : { /* SSL Configuration, certificates are generated by PKI */ "CAFile" : "/usr/irissys/mgr/CAServer/CA_Server.cer", "CertificateFile" : "/usr/irissys/mgr/master_client.cer", "PrivateKeyFile" : "/usr/irissys/mgr/master_client.key", "PrivateKeyPassword" : "", "PrivateKeyType" : "2" } } } } ``` ### 准备故障转移备份成员的配置文件 创建一个配置文件，故障转移备份成员`config-files/mirror-backup.json`. 它看起来像第一个成员。 ```json { "Defaults":{ /* Section contains all variables */ "MirrorName" : "Demo", /* Mirror to join */ "AgentAddress" : "172.16.238.20", /* Agent IP Address of the first mirror member */ "SystemName" : "backup", /* This instance name in the mirror */ "PrimaryInstanceName" : "IRIS", /* IRIS Instance name of the first mirror member */ "VirtualAddressInterface" : "eth0", /* Network interface used for the Virtual IP Address. */ "DBDir" : "${MGRDIR}myappdata/", /* DB in mirror */ "MirrorAddress" : "172.16.220.30" /* IP Address of this node in the private mirror network */ }, "SYS.MirrorFailOver" : { "${MirrorName}" : { "Config": { "Name" : "${MirrorName}", "SystemName" : "${SystemName}", "InstanceName" : "${PrimaryInstanceName}", "AgentAddress" : "${AgentAddress}", "AgentPort" : "2188", "AsyncMember" : false, "AsyncMemberType" : "" }, "Databases" : [{ "Directory" : "${DBDir}" }], "LocalInfo" : { "VirtualAddressInterface" : "${VirtualAddressInterface}", "MirrorAddress": "${MirrorAddress}" }, "SSLInfo" : { "CAFile" : "/usr/irissys/mgr/CA_Server.cer", "CertificateFile" : "/usr/irissys/mgr/backup_client.cer", "PrivateKeyFile" : "/usr/irissys/mgr/backup_client.key", "PrivateKeyPassword" : "", "PrivateKeyType" : "2" } } } } ``` ### 准备读写报告异步成员的配置文件 它与故障转移配置文件非常相似。 不同之处在于`AsyncMember`、`AsyncMemberType`和`MirrorAddress`的值。 创建文件`./config-files/mirror-report.json`： ```json { "Defaults":{ "MirrorName" : "Demo", "AgentAddress" : "172.16.238.20", "SystemName" : "report", "PrimaryInstanceName" : "IRIS", "VirtualAddressInterface" : "eth0", "DBDir" : "${MGRDIR}myappdata/", "MirrorAddress" : "172.16.220.40" }, "SYS.MirrorFailOver" : { "${MirrorName}" : { "Config": { "Name" : "${MirrorName}", "SystemName" : "${SystemName}", "InstanceName" : "${PrimaryInstanceName}", "AgentAddress" : "${AgentAddress}", "AgentPort" : "2188", "AsyncMember" : true, "AsyncMemberType" : "rw" }, "Databases" : [{ "Directory" : "${DBDir}" }], "LocalInfo" : { "VirtualAddressInterface" : "${VirtualAddressInterface}", "MirrorAddress": "${MirrorAddress}" }, "SSLInfo" : { "CAFile" : "/usr/irissys/mgr/CA_Server.cer", "CertificateFile" : "/usr/irissys/mgr/report_client.cer", "PrivateKeyFile" : "/usr/irissys/mgr/report_client.key", "PrivateKeyPassword" : "", "PrivateKeyType" : "2" } } } } ``` ### 配置IRIS节点并生成证书 所有的配置文件都准备好了! 我们的[Dockerfile](https://github.com/lscalese/iris-mirroring-samples/blob/master/Dockerfile)的最后一行是`CMD ["-a", "/init_mirror.sh"]`。 现在我们要写这个脚本来生成证书，并用相关的配置文件来设置每个IRIS节点。 正如你在这个脚本中看到的那样，生成证书的代码非常简单： * `Do ##class(lscalese.pki.Utils).MirrorMaster(,"",,,,"backup,report")` -主控节点。 它配置了PKI服务器，PKI客户端，请求证书；等待验证，获得证书，自动接受验证节点的进一步请求，持续5分钟。自动接受的请求只限于`故障转移备份主机` 和 `报告异步成员主机`。 * `Do ##class(lscalese.pki.Utils).MirrorBackup("${PKISERVER}","")` -备份节点和报告节点。 配置 PKI 客户端，请求证书，等待验证，获得证书。 ```bash #!/bin/bash # 用来测试镜像的数据库 DATABASE=/usr/irissys/mgr/myappdata # 目录包含由主控节点备份的myappdata，以便在其他节点上恢复。 BACKUP_FOLDER=/opt/backup # 主控节点的json config-api格式的镜像配置文件。 MASTER_CONFIG=/opt/demo/mirror-master.json # json config-api格式的镜像配置文件，用于故障转移备份节点。 BACKUP_CONFIG=/opt/demo/mirror-backup.json # 报告异步节点的json config-api格式的镜像配置文件。 REPORT_CONFIG=/opt/demo/mirror-report.json # 镜像名字... MIRROR_NAME=DEMO # 镜像成员清单 MIRROR_MEMBERS=BACKUP,REPORT # PKI服务器主机：端口（PKI服务器安装在主实例上）。 PKISERVER=master:52773 # 在主控节点上操作。 # 在这个实例上配置公钥基础设施服务器，并生成证书以配置使用SSL的镜像。 # 请参见文章https://community.intersystems.com/post/creating-ssl-enabled-mirror-intersystems-iris-using-public-key-infrastructure-pki。 # 和相关的工具https://openexchange.intersystems.com/package/PKI-Script。 # 使用config-api加载镜像配置与/opt/demo/simple-config.json文件。 # 启动一个作业，自动接受其他名为 "备份 （backup）"和 "报告 (report)"的成员加入镜像（避免在门户管理中进行手动验证，最大延迟为600秒）。 master() { rm -rf $BACKUP_FOLDER/IRIS.DAT iris session $ISC_PACKAGE_INSTANCENAME -U %SYS

你好！ 本文简单介绍一款工具，帮您理解InterSystems产品（从IRIS到Caché、Ensemble以及HealthShare）中的类及其结构。 简言之，它将类或整个包可视化，显示类之间的关系，并向开发人员和团队领导提供各种信息，而无需到 Studio 中检查代码。 如果您正在学习InterSystems产品，经常查看项目，或只对InterSystems技术解决方案中的新内容感兴趣，欢迎阅读ObjectScript类浏览器概述！ InterSystems 产品简介 IRIS（之前称为Caché) 是一个多模型DBMS。您可以使用SQL查询来访问它，也可以通过各种编程语言可用的接口与存储的对象和过程进行交互。但最多的还是使用DBMS原生内置语言--ObjectScript (COS) 开发应用程序。 Caché支持DBMS级别的类。有两种主要的类类型：Persistent（可以存储在数据库中）和 Registered（不存储在数据库中，扮演程序和处理程序的角色）。还有几种特殊的类类型：Serial（可集成到持久类中用于创建复杂数据类型（如：地址）的类），DataType（用于创建用户定义的数据类型）、Index、View 和 Stream。 进入类浏览器 Caché类浏览器是一个工具，它将Caché类的结构可视化为图表，显示类之间的依赖关系和所有相关信息，包括各种类元素的方法代码、查询、xData块、注释、文档和关键字。 功能 类浏览器使用扩展版UML类图进行可视化，因为Caché有一组很重要但不被标准UML支持的附加实体：查询、xData块、方法和属性的大量关键字（如System、ZenMethod、Hidden、ProcedureBlock等）、父子关系和一多关系、类类型等。 Caché 类浏览器（1.14.3版）允许您执行以下操作： 显示包、类图或整个包的层次结构； 编辑图表显示后的外观； 保存类图的当前图像； 保存一个图表的当前外观，并在将来恢复； 按图表或类树中显示的任何关键字搜索； 使用工具提示获得关于类、其属性、方法、参数、查询和xData块的完整信息； 查看方法、查询或xData块的代码； 启用或禁用任何图表元素的显示，包括图形图标。 为了更好理解下文内容，先看下类浏览器的如何对类进行可视化的。举个例子，让我们显示来自“samples”命名空间的“cinema”包： 详细信息和功能概述 左侧边栏包含一个包树。将鼠标指针放在包名称上，然后单击出现在其右侧的按钮以显示整个包。在包树中选择类，将其与其链接的类一起呈现。 类浏览器可以显示类之间的几种依赖关系类型： 1. 继承。以白色实心箭头显示，箭头指向继承的类； 2. 类之间的“关联”或关系。如果其中一个类的字段包含另一个类的类型，图表构建器将把它显示为关联关系； 3. 父子关系和一多关系：维护数据完整性的规则。 如果将鼠标指针指向该关系，则创建该关系的属性将高亮显示： 注意，类浏览器不会更深入，也不会为当前包之外的类绘制依赖关系。它将只显示当前包中的类，如果需要限制类浏览器查找类的深度，请使用“依赖级别”设置： 类本身显示为一个矩形，分为六个部分： 1. 类名：将鼠标指针指向类名，可以了解它是何时创建和修改的，查看注释以及所有分配给这个类的关键字。双击类头将打开其文档； 2. 类参数：所有带类型、关键字和注释的赋值参数。斜体的参数以及任何属性都有工具提示并且可以悬停； 3. 类属性与参数类似； 4. 方法：点击任何方法都可以查看其源代码。COS 语法将被高亮显示； 5. 查询：与方法类似--点击可以查看源代码； 6. xData块：主要包含XML数据的块。点击将显示块中格式化的源代码。 默认每个类都显示有许多图形图标。点击屏幕右上角的“帮助”按钮，了解每个图标的含义。如果您需要默认显示更严格或更包容的 UML 类图，以及任何类的任何部分，可以在设置部分禁用。 如果关系图太大，而且您也不太熟悉，可以使用快速图表搜索功能。包含您输入的关键字的任何部分的类将被高亮显示。要跳转到下一个匹配项，只需按 Enter 键或再次单击搜索按钮： 最后，在完成了图表编辑，去掉所有不必要关系，并将元素安放好，实现期望的外观之后，可以点击左下角的“下载”按钮来保存： 激活固定按钮 时，元素在当前类（或包）组的图表上的位置将被固定。例如，如果您选择A类和B类，然后用固定按钮保存视图，则再次选择A类和B类时将看到完全相同的视图，即使在重新启动浏览器或机器之后也不会变化。但是如果您只选择A类，布局将是默认的。 安装 要安装Caché类浏览器，只需将最新版本xml包导入到任何命名空间中。导入后就能看到名为hostname/ClassExplorer/（末尾的斜杠不能丢）的新web应用程序。 详细安装说明 1. 下载最新版Caché类浏览器压缩包； 2. 提取名为Cache/CacheClassExplorer-vX.X.X.xml的XML文件； 3. 使用以下方法之一将包导入任何命名空间： 1. 只需将XML文件拖到Studio上； 2. 使用系统管理门户：系统资源管理器 -> 类 -> 导入，并指定本地文件路径； 3. 使用terminal命令： do ##class(%Installer.Installer).InstallFromCommandLine(“Path/Installer.cls.xml”); 4. 读取导入日志--如果顺利安装，就可以通过 http://hostname/ClassExplorer/ 打开 web 应用程序。如果出了问题，请检查以下内容： 1. 是否有足够权限将类导入该命名空间； 2. web应用程序用户是否有足够权限访问不同的命名空间； 3. 如果出现错误404，只需检查是否在 URL 末尾添加了斜杠。 附加截图 [截图 1] DSVRDemo 包，鼠标指针悬停在一个类名上。 [截图 2] DataMining 包，在图表中搜索“TreeInput”关键字。 [截图 3] JavaDemo.JavaListSample 类中的方法代码视图。 [截图 4] 查看 ClassExplorer.Router 类中的 Xdata 块内容。 您可以尝试在标准SAMPLES命名空间中使用类浏览器：演示。这个项目的评测视频。 欢迎任何反馈、建议和意见--提交到这里或GitHub仓库。希望对您有用！

$HOROLOG（$H） 表示当前的本地日期和时间，是由两个整数值组成的字符串，这些整数是计数器，是InterSystems IRIS存储格式，不是用户可读的日期和时间。 ddddd,sssss 代码示例： w $H,! 北京时间2021年12月29日15：15：30时，输出结果为： 66107,54930 第一个整数，ddddd，是当前日期，表示为自1840年12月31日以来的天数，其中第1天是1841年1月1日。这个日期到达的最大年年限是9999年12月31日，所以这个整数的最大值是2980013。$HOROLOG不能直接用于表示1840年到9999年范围之外的日期 第二个整数，sssss，是当前的时间，表示为从当天午夜开始的秒数计数。系统将时间字段从0递增到86399秒。当午夜时分达到86399时，系统将时间字段重置为0，并将日期字段增加1。 你可以通过调用Horolog()方法获得相同的当前日期和时间信息，如下所示。 WRITE $SYSTEM.SYS.Horolog() $NOW() $NOW()返回当前进程的本地日期和时间，是InterSystems IRIS存储格式，不是用户可读的日期和时间。 ddddd,sssss.ffffff 代码示例： w $NOW(),! 北京时间2021年12月29日15：15：30时，输出结果为： 66107,54930.383622 $ZTIMESTAMP $ZTIMESTAMP返回UTC日期和时间，是InterSystems IRIS存储格式，不是用户可读的日期和时间。带有小数秒，小数秒以三位数的精度表示（Windows系统），或以六位数的精度表示（UNIX®系统） 代码示例： w $ZTIMESTAMP,！ 北京时间2021年12月29日15：15：30时，输出结果为： 66107,26130.383 $NOW() vs $HOROLOG vs $ZTIMESTAMP $HOROLOG包含了InterSystems IRIS存储格式的、经过变体调整的本地日期和时间。本地时区是由$ZTIMEZONE特殊变量的当前值决定的，然后根据本地时间变体进行调整，如夏令时。它只返回整数秒，小数秒会被截断。 $NOW()根据$ZTIMEZONE特殊变量的值确定本地时区。本地时间不会因本地时间变体（如夏令时）而调整。因此，它可能与本地时钟时间不一致。$NOW(tzmins)返回与指定的tzmins时区参数对应的时间和日期。$ZTIMEZONE的值被忽略。 $ZTIMESTAMP返回UTC日期和时间。 日期和时间的转换 $ZDATE 将$HOROLOG的日期部分，即ddddd，转换为用户可读的形式。 ​ WRITE $ZDATE($PIECE($HOROLOG,",",1)) 输出结果为： 12/29/2021 $ZTIME 将$HOROLOG的时间部分，即sssss，转换为用户可读的形式。 $ZDATETIME 将$HOROLOG的日期和时间，同时转换为用户可读的形式。 当使用$HOROLOG时，在这些函数中设置时间值的精度总是返回零作为小数秒。 $ZDATETIME(hdatetime,dformat,tformat,precision,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt,localeopt) $ZDT(hdatetime,dformat,tformat,precision,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt,localeopt) 参数描述请参考参数解析 参数 描述 hdatetime 内部格式的日期和时间值：$HOROLOG]或者 $ZTIMESTAMP dformat 一个整数，指定返回日期值的格式 tformat 一个整数，指定返回时间值的格式 precision 一个整数，指定返回时间值的小数位数（小数秒）：只有当hdatetime格式可以包括小数时间值（$ZTIMESTAMP格式），并且选择的tformat选项包括秒时，精度才适用。 monthlist 可选的 - 一个字符串或一个变量的名称，用于指定一组月名。 这个字符串必须以一个分界符开始，它的12个条目必须以这个分界符分开。 例如： January February March April May June July August September October November December Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec monthlist仅在dformat为2、5、6、7、9、18或20时有效。 yearopt 一个整数代码，指定以两位数或四位数的数值表示年份。 startwin 滑动窗口的开始，在这个窗口中，日期用两位数的年份表示。 当你使用yearopt为3或5时，你必须提供startwin，startwin对任何其他yearopt值都是无效的。 当yearopt=3时，startwin是一个$HOROLOG日期格式的绝对日期，表示滑动窗口的开始日期。 当yearopt=5时，startwin是一个数值，表示滑动窗口的起始年份，以当前年份之前的年数表示。 endwin 滑动窗口的末端，在这个窗口中，日期用两位数的年份表示。 当yearopt为3或5时，你可以选择提供endwin。endwin在任何其他yearopt值下无效。 当yearopt=3时，endwin是一个$HOROLOG日期格式的绝对日期，表示滑动窗口的结束日期。 当yearopt=5时，endwin是一个数值，表示滑动窗口的结束年限，以当前年限后的年数表示。 当yearopt=5时，滑动窗口总是从startwin中指定的年份的1月1日开始，到endwin中指定的年份的12月31日结束，或者是隐含的结束年份（如果你省略endwin）。 如果省略endwin（或指定为-1），有效的滑动窗口将是100年的长度。 如果你同时提供startwin和endwin，它们指定的滑动窗口的持续时间不能超过100年。 mindate 有效日期范围的下限。指定为$HOROLOG的整数日期计数，例如 0代表1840年12月31日，2/22/2018表示为64701。 支持的mindate值：正的整数，0 或-1 maxdate 有效日期范围的上限，指定为整数$HOROLOG日期计数. 例如，1/1/2100表示为94599 指定一个大于maxdate的hdatetime日期会产生一个VALUE OUT OF RANGE错误。 指定一个大于2980013的maxdate会产生一个VALUE OF RANGE错误。 你可以指定maxdate，也可以不指定mindate。指定一个小于mindate的maxdate会产生一个ILLEGAL VALUE错误。 erropt 当hdatetime无效时要返回的表达式。为这个参数指定一个值可以抑制与无效或超出范围的hdatetime值有关的错误代码。$ZDATETIME不发出错误信息，而是返回erropt。 localeopt 一个布尔标志，指定对dformat、tformat、monthlist、yearopt、mindate和maxdate默认值以及其他日期和时间特征使用哪种语言： localeopt=0：当前语言属性设置决定这些参数默认值。 localeopt=1：ODBC标准语言决定这些参数默认值。 localeopt没有指定：dformat值决定这些参数默认值。 $ZDATETIMEH 将用户可读的日期和时间，转换为$HOROLOG（ddddd,sssss）格式 $ZDATETIMEH(datetime,dformat,tformat,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt,localeopt) $ZDTH(datetime,dformat,tformat,monthlist,yearopt,startwin,endwin,mindate,maxdate,erropt,localeopt) 参数描述请参考参数解析 可以使用 "T "或 "t "字母代码来指定当前日期。但是，dformat必须是5、6、7、8、9或15。 WRITE $ZDATETIMEH("T",5) 输出： 66107,0 当前日期前三天： WRITE $ZDATETIMEH("T-3",5) 输出： 66104,0 $ZTIMEZONE ： 时区 $ZTIMEZONE是一个从格林威治子午线开始的固定时区偏移量，它不对当地的季节性时间变体进行调整，如夏令时。 代码示例： w $ZTIMEZONE,! 输出结果为： -480

# 第七章 SQL表之间的关系 要在表之间强制执行引用完整性，可以定义外键。修改包含外键约束的表时，将检查外键约束。 # 定义外键 有几种方法可以在InterSystems SQL中定义外键： - 可以定义两个类之间的关系。定义关系会自动将外键约束投影到SQL。 - 可以在类定义中添加显式外键定义（对于关系未涵盖的情况）。 - 可以使用`CREATE TABLE`或`ALTER TABLE`命令添加外键。可以使用`ALTER TABLE`命令删除外键。 用作外键引用的`RowID`字段必须是公共的。引用隐藏的`RowID`？有关如何使用公用（或专用）`RowID`字段定义表的信息。 **一个表（类）的外键最大数目为400。** ## 外键引用完整性检查 外键约束可以指定更新或删除时的引用操作。 在`CREATE TABLE reference action`子句中描述了使用DDL定义这个引用操作。 在类定义引用的`OnDelete`和`OnUpdate`外键关键字中定义了一个持久化类来定义这个引用操作，该类投射到一个表。 在创建分片表时，这些引用操作必须设置为无操作。 默认情况下，InterSystemsIRIS®数据平台对`INSERT`，`UPDATE`和`DELETE`操作执行外键引用完整性检查。如果该操作将违反参照完整性，则不会执行；该操作将发出`SQLCODE -121，-122，-123或-124`错误。参照完整性检查失败会生成如下错误： ```java 错误＃5540：SQLCODE：-124消息：表'HealthLanguage.FKey2'中至少存在1行，该行引用键NewIndex1-外键约束'NewForeignKey1'（字段'Pointer1'）的NO ACTION引用操作失败[Execute + 5 ^ IRISSql16：USER] ``` 可以使用`$SYSTEM.SQL.SetFilerRefIntegrity（）`方法在系统范围内禁止此检查。若要确定当前设置，请调用`$SYSTEM.SQL.CurrentSettings（）`。 默认情况下，当删除带有外键的行时，InterSystems IRIS将在相应的被引用表的行上获取长期（直到事务结束）共享锁。这样可以防止在引用行上的`DELETE`事务完成之前对引用行进行更新或删除。这样可以防止删除引用行，然后回退删除引用行的情况。如果发生这种情况，外键将引用不存在的行。如果使用`NoCheck`定义外键，或者使用`％NOCHECK`或`％NOLOCK`指定引用行的`DELETE`，则不会获取此锁定。 使用持久性类定义定义表时，可以使用`NoCheck`关键字定义外键，以禁止将来对该外键进行检查。` CREATE TABLE`不提供此关键字选项。 可以使用`％NOCHECK`关键字选项禁止检查特定操作。 默认情况下，InterSystems IRIS还对以下操作执行外键引用完整性检查。如果指定的操作违反了引用完整性，则不执行该命令： - `ALTER TABLE DROP COLUMN`。 - `ALTER TABLE DROP CONSTRAINT`删除约束 问题`-317 SQLCODE`。 可以使用`SET`选项`COMPILEMODE=NOCHECK`来抑制外键完整性检查。 - 删除表。问题`-320 SQLCODE`。可以使用`SET`选项`COMPILEMODE = NOCHECK`来抑制外键插入检查。 - 触发器事件，包括事件之前。 例如，如果删除操作因违反外键引用完整性而不能执行，则不会执行`BEFORE DELETE`触发器。 在父/子关系中，没有定义子元素的顺序。 应用程序代码不能依赖于任何特定的顺序。 # 父表和子表 ## 定义父表和子表 在定义投射到表的持久类时，可以使用`relationship`属性指定两个表之间的父/子关系。 下面的例子定义了父表: ```java Class Sample.Invoice Extends %Persistent { Property Buyer As %String(MAXLEN=50) [Required]; Property InvoiceDate As %TimeStamp; Relationship Pchildren AS Sample.LineItem [ Cardinality = children, Inverse = Cparent ]; } ``` 下面的例子定义了一个子表: ```java Class Sample.LineItem Extends %Persistent { Property ProductSKU As %String; Property UnitPrice As %Numeric; Relationship Cparent AS Sample.Invoice [ Cardinality = parent, Inverse = Pchildren ]; } ``` 注意这两句话： - `Relationship Pchildren AS Sample.LineItem [ Cardinality = children, Inverse = Cparent ];` - `Relationship Cparent AS Sample.Invoice [ Cardinality = parent, Inverse = Pchildren ];` 在Management Portal SQL interface Catalog Details选项卡中，表信息提供了子表和/或父表的名称。 如果是子表，则提供对父表的引用，如:`parent->Sample.Invoice`。 子表本身可以是子表的父表。 (子表的子表被称为“孙”表。) 在本例中，表`Info`提供了父表和子表的名称。 ## 向父表和子表插入数据 在将相应的记录插入子表之前，必须将每个记录插入父表。 例如: ```java INSERT INTO Sample.Invoice (Buyer,InvoiceDate) VALUES ('yaoxin',CURRENT_TIMESTAMP) ``` ```java INSERT INTO Sample.LineItem (Cparent,ProductSKU,UnitPrice) VALUES (1,'45-A7',99.95) INSERT INTO Sample.LineItem (Cparent,ProductSKU,UnitPrice) VALUES (1,'22-A1',0.75) ```  尝试插入没有对应父记录ID的子记录时，会使用`%msg`子表`'Sample生成SQLCODE -104错误。 LineItem'`引用父表中不存在的行。 在子表上的插入操作期间，在父表的相应行上获得共享锁。 在插入子表行时，该行被锁定。 然后，锁被释放(直到事务结束时才被持有)。 这确保了在插入操作期间引用的父行不会被更改。 ## 标识父表和子表 在嵌入式SQL中，可以使用主机变量数组来标识父表和子表。 在子表中，主机变量数组的下标0被设置为父引用(`Cparent`)，格式为parentref，下标1被设置为子记录ID，格式为`parentref|| childf`。 在父表中，没有定义下标0。 如下面的例子所示: ```java /// d ##class(PHA.TEST.SQL).FatherChildTable() ClassMethod FatherChildTable() { KILL tflds,SQLCODE,C1 &sql(DECLARE C1 CURSOR FOR SELECT *,%TABLENAME INTO :tflds(),:tname FROM Sample.Invoice) &sql(OPEN C1) IF SQLCODE

# 第二十一章 导入和导出SQL数据 在InterSystems IRIS®Data Platform Management Portal中，有用于导入和导出数据的工具： - 从文本文件导入数据 - 将数据导出到文本文件 这些工具使用动态SQL，这意味着查询是在运行时准备和执行的。可以导入或导出的行的最大大小为3,641,144个字符。 还可以使用%SQL.Import.Mgr类导入数据，使用%SQL.Export.Mgr类导出数据。 # 从文本文件导入数据 可以将数据从文本文件导入到合适的InterSystems IRIS类中。执行此操作时，系统将在表中为该类创建并保存新行。该类必须已经存在并且必须编译。要将数据导入到此类中，请执行以下操作： 1. 从管理门户中选择系统资源管理器，然后选择SQL。使用页面顶部的切换选项选择一个命名空间；这将显示可用命名空间的列表。 2. 在页面顶部，单击向导下拉列表，然后选择数据导入。 3. 在向导的第一页上，从指定外部文件的位置开始。对于导入文件所在的位置，请单击要使用的服务器的名称。 4. 然后输入文件的完整路径和文件名。 5. 对于选择架构名称，单击要向其中导入数据的InterSystems IRIS包。 6. 对于选择表名，单击将包含新创建的对象的类。 7. 然后单击下一步。 8. 在向导的第二页上，单击将包含导入数据的列。 9. 然后单击下一步。 10. 在向导的第三页上，描述外部文件的格式。 - 有关用什么分隔符分隔您的列？，请单击与此文件中的分隔符对应的选项。 - 单击第一行是否包含列标题？如果文件的第一行不包含数据，则选中此复选框。 - 对于字符串引号，单击指示此文件用于开始和结束字符串数据的引号分隔符字符的选项。 - 对于日期格式，请单击指示此文件中日期格式的选项。 - 对于时间格式，请单击指示此文件中的时间格式的选项。 - 对于时间戳格式，请单击指示此文件中的时间戳格式的选项。 - 单击禁用验证？如果不希望向导在导入时验证数据，请选中此复选框。 - 使用%SortBegin/%SortEnd？如果不希望向导在导入期间重新生成索引，请选中此复选框。如果选中延迟索引生成，向导将在将导入的数据插入到表中之前为该类调用%SortBegin方法。导入完成后，向导将调用%SortEnd方法。不执行任何验证(与使用%NOCHECK的INSERT相同)。这是因为当使用%SortBegin/%SortEnd时，在SQL INSERT期间不能检查索引的唯一性。如果选中延迟索引构建，则假定导入的数据有效，不会检查其有效性。 - 或者，单击“预览数据”以查看向导将如何分析此文件中的数据。 11. 单击“下一步”。 12. 检查条目，然后单击Finish。向导将显示“数据导入结果”对话框。 13. 单击关闭。或者单击给定的链接以查看后台任务页面。 在任何一种情况下，向导都会启动一个后台任务来完成工作。 # 将数据导出到文本文件 可以将给定类的数据导出到文本文件。为此： 1. 从管理门户中选择系统资源管理器，然后选择SQL。使用页面顶部的切换选项选择一个命名空间；这将显示可用命名空间的列表。 2. 在页面顶部，单击向导下拉列表，然后选择数据导出。 3. 在向导的第一页上： - 输入要创建以保存导出数据的文件的完整路径和文件名。 - 从下拉列表中，选择要从中导出数据的命名空间、方案名和表名。 - 或者，从Charset下拉列表中选择一个字符集；默认值为Device Default。 - 然后单击下一步。 4. 在向导的第二页上，选择要导出的列。然后单击下一步。 5. 在向导的第三页上，描述外部文件的格式。 - 有关用什么分隔符分隔的列？，请单击与此文件中的分隔符对应的选项。 - 单击导出列标题？如果要将列标题导出为文件的第一行，请选中此复选框。 - 对于字符串引号，单击一个选项以指示如何开始和结束此文件中的字符串数据。 - 对于日期格式，单击一个选项以指示要在此文件中使用的日期格式。 - (可选)单击“预览数据”以查看结果的外观。然后单击下一步。 6. 检查条目，然后单击Finish。该向导将显示“数据输出结果”对话框。 7. 单击关闭。或单击给定的链接以查看后台任务页面。 在任何一种情况下，向导都启动后台任务来完成工作。