これは InterSystems FAQ サイトの記事です。
InterSystems IRIS Data Platform（以下IRISと表記）ではマルチモデルのサポートにより、データに対して様々なアクセス手法を使用することができます。

主だったアクセス手法としてダイレクトアクセス、SQLアクセス、オブジェクトアクセスがあります。
 

ダイレクトアクセス は、IRISのネイティブ構造であるグローバルと呼ばれるキーバリュー型のデータに直接アクセスする方法です。

SQLアクセス は、リレーショナルデータベースシステムにアクセスするための標準言語であるSQLを使用してデータにアクセスする方法です。

オブジェクトアクセス は、オブジェクト指向言語でオブジェクトを操作するための表記法として幅広く利用されるドット記法を使用してデータにアクセスする方法です。

ダイレクトアクセスとSQLアクセスおよびオブジェクトアクセスでは、処理の抽象度が異なります。

抽象度が高くなるに伴い、内部的な処理のオーバヘッドが増加するため、単純な1スレッド単位でのアクセススピードの速さについては、ダイレクトアクセスが、SQLアクセスとオブジェクトアクセスに比較して速い場合が多いです。

しかしながら、今後SQLアクセスに関してより高速に処理できるよう様々な開発が進行中です。

これは InterSystems FAQ サイトの記事です。
 

実行ログデータなどトランザクション中にロールバックが発生しても前の状態に戻ってほしくないデータがあります。

それらのデータをロールバックされないデータベースIRISTEMPに配置することで上記の要件に対応できます。

一時グローバルと IRISTEMP データベース

ロールバックさせたくないテーブルの実体をこのデータベースにマッピングすることでロールバック後に情報を残すことができます。

ただし、このデータベースはIRIS再起動で内容がクリアされますので、永続的に保持したい場合には、いずれかのタイミング(ロールバック後等)で永続テーブルにコピーを行う必要があります。

また、これとは別に、トランザクション対象外としたいテーブル操作の前にプロセスのジャーナル記録を停止し、操作完了後にジャーナル記録を再開することで、その操作をトランザクション対象外にすることもできます。

ただしこの方法は、ミラーリングをお使いいただく際にはご使用いただけません。

%NOJRN を使用したプロセス・レベルでのジャーナリングの管理

デベロッパーコミュニティの記事

これは InterSystems FAQ サイトの記事です。
 

正規表現を使用する$Locate()関数がご使用いただけます。

正規表現の使用方法

使用方法の例は以下の様になります。

USER>write str
あいうえおかきくけこABC123456さしすせそ 
USER>write $locate(str,"[A-Za-z]{3}[0-9]{6}",,,val)
11 
USER>write val
ABC123

これは InterSystems FAQ サイトの記事です。

クライアントからターミナルにログイン（接続）できない時、ターミナル接続を可能にするサービスが有効になっていないことが原因として考えられます。

ターミナル接続を可能にするサービスが有効になっていないことが原因として考えられます。

管理ポータル ：[ホーム] > [システム管理] > [サービス] 

有効になっていない場合は、リンクをクリックしてサービス定義編集画面を開き、"サービス有効"にチェックを入れて保存します。

もう一つの原因としてはOSのファイアウォールによりターミナル接続が遮断されている場合が考えられます。

リモートでターミナル接続される場合はファイアウォールの設定を無効にしてお使い下さい。

これは、2022.2の開発者プレビュープログラムのリリース第5弾です。 プレビューリリースは、隔週で更新される予定で、準備が整い次第、機能を追加していく予定です。  2022.2では、SQL管理、クラウド統合、KafkaおよびJMSアダプタ、SQL Loaderなどにおいて、多くのアップデート、修正、機能強化が行われています。 製品改善のため、開発者コミュニティを通じてフィードバックをお寄せください

列指向ストレージに関して、Early Access Program (EAP) を受け付けています。ご興味のある方はぜひ Early Access Program にご参加ください。

今後の開発者向けプレビューでは、Ubuntu 22.04 LTSへの対応や、コミュニティエディションでの制限の変更などが予定されています。ご期待ください！

通常、CDリリースにはサポートされているすべてのプラットフォーム向けの標準インストールパッケージと、OCI（Open Container Initiative、別名Dockerコンテナ）形式のコンテナイメージが付属しています。  詳細については、サポートされるプラットフォームのドキュメントをご参照ください。

インストールパッケージとプレビューキーは、WRCのプレビューダウンロードサイトまたは評価サービスのウェブサイト（2022.

Studio では、クラスを直接その名前で開くことができます。何度もクリックしながら目的のクラスに到達するまでパッケージツリー内を移動する必要はありません。

Ctrl + O（またはファイル -> 開く）を押せば、以下のようにクラス名を入力するだけです。

Enter を押すと、クラスが開きます。

VSCode ではこれをどのようにして行えるでしょうか？

これは InterSystems FAQ サイトの記事です。
 

テーブル(クラス) のデータを削除する際に %KillExtent() というメソッドを使用すると、レコードを1ずつ削除するのではなく、データを格納しているデータグローバル、インデックス定義のグローバル(ノード) をまとめて 削除することができます。

kill ^ISJ.xxxD
kill ^ISJ.xxxI

のようにデータグローバルやインデックスグローバルをまとめて削除するのと同じような動作となります。
そのため、ジャーナルレコードへの出力は最小限になります。

使用例：

write ##class(ISJ.xxx).%KillExtent()

ただし、トランザクション下で実行すると一括 Kill の場合でも保存されているレコードに応じたジャーナルレコードが生成されるのでご注意ください。

また、以下のドキュメントの注意書きにあるように、他クラス(テーブル)への参照などが含まれているクラスで実施されると整合性に問題が発生する場合がありますのでご注意ください。

%KillExtent() メソッド
 

こちらを必要なだけ記述したタスククラスを作成すると、タスクスケジューラから定期的に実行できます。
タスククラスの作成方法は、以下のトピックをご覧ください。

【FAQ】定期的に処理を実行する事は出来ますか？

【ご参考】

IRIS 2021.

これは InterSystems FAQ サイトの記事です。
 

TCP アダプタを使用するビジネスホストの [接続中を維持（StayConnected）]と[プールサイズ（PoolSize）]のデフォルト設定値は以下の通りです。

ネットワークの問題でビジネスホストへの接続が切断された場合に、プロダクション側では切断されたことを検知できないため新しい接続を受け付けません。

またこの状況の時、イベントログにも記録されません。

StayConnected が デフォルト値（-1）の場合、接続がタイムアウトしないため新しい接続を受け付けるためには、ビジネスホストを再起動する必要があります。

このような状況を回避するためには、StayConnected を 0 以上の値に設定することを推奨します。

例えば300（秒）に設定した場合、TCP ビジネスホストは 300 秒以上新たなメッセージを受信しなかった場合に、自動的に接続を切断して再接続できます。

処理量の多いシステムの場合には、通常 StayConnected の値をさらに小さな値、例えば 5（秒）に設定します。

これは InterSystems FAQ サイトの記事です。
 

コンソールログに任意のメッセージを書き込む方法として%SYS.System クラスの WriteToConsoleLog メソッドを使用することができます。

以下に例を示します。 

%SYS>write ##class(%SYS.System).WriteToConsoleLog("xxxxx log message",0,0)
1

WriteToConsoleLogメソッドに指定できるパラメータの詳細は、以下のドキュメントをご参照下さい。

クラスリファレンス（%SYS.System）【IRIS】

クラスリファレンス（%SYS.System）

これは、2022.2の開発者プレビュープログラムのリリース第4弾です。 プレビューリリースは、隔週で更新される予定で、準備が整い次第、機能を追加していく予定です。  2022.2では、SQL管理、クラウド統合、KafkaおよびJMSアダプタ、SQL Loaderなどにおいて、多くのアップデート、修正、機能強化が行われています。 製品改善のため、開発者コミュニティを通じてフィードバックをお寄せください

列指向ストレージに関して、Early Access Program (EAP) を受け付けています。ご興味のある方はぜひ Early Access Program にご参加ください。

開発者プレビュー４ではRed Hat RHEL 9のサポートが追加されました。

CDリリースには、サポートされているすべてのプラットフォーム向けの標準インストールパッケージと、OCI（Open Container Initiative、別名Dockerコンテナ）形式のコンテナイメージが付属しています。  詳細については、サポートされるプラットフォームのドキュメントをご参照ください。

インストールパッケージとプレビューキーは、WRCのプレビューダウンロードサイトまたは評価サービスのウェブサイト（2022.2へのアクセスには「Show Preview Software」をチェックしてください）から入手できます。

これは InterSystems FAQ サイトの記事です。
 

残念ながら良い方法はありません。

もし処理の流れとして突然処理を中断されると不都合がある場合には、OnunloadHandler内でalertメソッドにより、Xボタンを押さないように注意を促すようなメッセージを出す方法が考えられます。

一般的には、ユーザ都合で処理中断されてもサーバ側処理内でデータの整合性等に不都合が発生しない様にアプリケーションの実装を行う必要があります。

ページのアンロード時に呼び出されるOnunloadHandler内でサーバ・メソッドを呼び出す方法は様々な問題があるため、使用することはお勧めしません。

これは InterSystems FAQ サイトの記事です。
TRYブロック内で任意のカスタムエラーを発生させたい場合、以下のように throw で例外を渡すことが可能です。

以下のサンプルでは、Stcount が 1 より小さい場合にカスタムエラーを発生させています。

Class User.Test
{

ClassMethod ExceptionTest()
 {
    try
    {
      // : some codes
      if (Stcount<1) {
          throw ##class(%Exception.General).%New(" ユーザ定義エラー","5001","ロケーション","エラー時のデータ")  
          // ユーザ作成エラーは5001以降
      }
    }
    catch ex
    {
      write "エラー #", ex.Code, ": ", ex.Name, " : ", ex.Location, " ", ex.Data
      return
    }
 }
}

上の例では、Stcount が 1 より小さい場合、以下のようなエラーが出力されます。

USER>do ##class(User.Test).

Embedded Python で Excel のデータを IRIS グローバルに格納する方法 では Excel データを pandas.DataFrame に取り込んで、それを InterSystems IRIS グローバルに保存する方法をご紹介しました。

今回は「lxml を使用し Web スクレイピングした表(テーブル)のデータを InterSystems IRIS グローバルに格納する」方法をご紹介します。

※以下は Windows 上の IRIS でのインストール方法になります。
　UNIX ベースのシステムでは、pip3 コマンドを使用してインストールします。詳細は ドキュメント をご覧ください。

最初に、irispip コマンドで必要なライブラリをインストールします。
今回は、pandas、lxml の2つのライブラリをインストールします。

開発者の皆さん、こんにちは！

Flaskを使うと簡単にWebアプリが作成できるようでしたので、Embedded Pythonを利用してIRISに保存した月毎の歩数データ（テーブル／グローバル）を matplotlibを利用してグラフ表示する簡単なWebアプリを作成してみました。

使っているPythonスクリプトファイルやHTMLは以下の通りです（図例はテーブルからデータを取る例ですが、サンプルにはグローバルからデータを取得する例も含まれます）。

サンプルはこちらに置いています👉https://github.com/Intersystems-jp/WalkSteps

IRISのインストール環境に合わせて、サンプルのディレクトリを分けています。

＜Windows にIRISをインストールされている場合＞
https://github.com/Intersystems-jp/WalkSteps/tree/master/Windows　をご覧ください。
Windows上Pythonのバージョンは3.9で試しています。3.10では動作しませんでしたので、3.9でお試しください。

＜Windows以外にIRISをインストールされている場合＞
https://github.com/Intersystems-jp/WalkSteps/tree/master/Linux　をご覧ください。

これは InterSystems FAQ サイトの記事です。
 

ObjectScript言語は、Java言語等がサポートしている型キャストをサポートしていません。

ただし、メソッドのキャストはサポートしています。

詳細は以下ドキュメントページをご参照ください。

メソッドのキャスト【IRIS】
メソッドのキャスト

InterSystems ObjectScript言語はJava言語や.NetのC#言語のような静的型付き言語とは異なり、動的型付き言語に分類される言語になります。

従って型の解釈は実行時に行われ、宣言時に型を合わせるという必要性がないため型キャストのような仕組みを用意していません。

これは InterSystems FAQ サイトの記事です。
 

ミラーリングが同期の対象とするのはデータベースファイルのみです。

アプリケーションに必要なその他のファイル(CSPファイル、画像ファイル、ドキュメントファイルなど）をミラーセットを構成する二台のサーバー間で同期させるには、

1. NASなどを導入して共有ディスク上にそれらのファイルを配置する方法
2. または同期ソフトを導入して二台のサーバー間のファイルを同期させる方法

などの方法が考えられます。

また、2の方法ではWindows上ではRoboCopy、Linuxの場合にはrsyncという同期ソフトを使った実例があります。

irisコマンドのqlistまたはlistを使用して出力先をファイルにして出力することができます。

qlistの結果は、^を区切り文字としたテキスト形式で出力されます。

^で区切られた3番目の部分に稼働状況のデータがあります。

$ iris qlist IRIS > iris.log
$ cat iris.log

IRIS^/Applications/iris^2022.1.0.164.0^running, since Thu Apr  7 16:37:03 2022^iris.cpf^1972^52773^0^alert^IRIS^^^/Applications/iris

listの場合には、先頭にstatus:と表示された行に稼働状況のデータがあります。

Unix系のOSの場合

$ iris list IRIS > iris.log
$ cat iris.log

Configuration 'IRIS'   (default)

directory:    /Applications/iris

versionid:    2021.2.0.650.0

datadir:      /Applications/iris

conf file:    iris.

タスク成功時・失敗時、それぞれ通知メールを送信することができます。

そのためには事前にターミナルからTASKMGRルーチン を実行して、メールサーバを登録する必要があります。

> zn "%SYS"
> do ^TASKMGR

1) タスク作成
2) タスク編集
3) タスク一覧
4) タスク削除
5) タスク一時停止
6) タスク再開
7) タスク実行
8) タスクリポート
9) タスクマネージャオプション
10) 終了 

そして、メニューから9) タスクマネージャーオプションを選んで 

オプション?9
 
1) タスクマネージャ情報
2) タスクマネージャを開始する
3) タスクマネージャ一時停止
4) タスクマネージャ再開
5) タスクマネージャ履歴
6) メール設定定義
7) 終了

 次に6) メール設定定義を選びます。
 

オプション?6
 
1) メールサーバ定義
2) サーバポート定義
3) 返信先定義
4) 送信者定義
5) タイムゾーン
6) 認証ユーザ定義
7) SSL 構成を定義
8) 終了

そこで以下2点を最低限設定します。
 

1) メールサーバ定義 (SMTPサーバ名)  例: xxxxxx.xxxxx.com

4) 送信者定義 (通知メールのFROMアドレス) 例: m123456@gmail.

これは、2022.2の開発者プレビュープログラムのリリース第3弾です。 プレビューリリースは、隔週で更新される予定で、準備が整い次第、機能を追加していく予定です。  2022.2では、SQL管理、クラウド統合、KafkaおよびJMSアダプタ、SQL Loaderなどにおいて、多くのアップデート、修正、機能強化が行われています。 製品改善のため、開発者コミュニティを通じてフィードバックをお寄せください

列指向ストレージに関して、Early Access Program (EAP) を受け付けています。ご興味のある方はぜひ Early Access Program にご参加ください。

 CDリリースには、サポートされているすべてのプラットフォーム向けの標準インストールパッケージと、OCI（Open Container Initiative、別名Dockerコンテナ）形式のコンテナイメージが付属しています。  詳細については、サポートされるプラットフォームのドキュメントをご参照ください。

インストールパッケージとプレビューキーは、WRCのプレビューダウンロードサイトまたは評価サービスのウェブサイト（2022.2へのアクセスには「Show Preview Software」をチェックしてください）から入手できます。

開発者の皆さん、こんにちは！ DICOM 統合を実装したことはありますか？ おそらく例やシミュレーターを探したことはあるかもしれません。 この記事では、有用な例を紹介したいと思います。

DICOM はヘルスケアの分野で画像診断に広く使用されているメッセージ規格です。DICOM 規格は、IRIS For Health と Health Connect の両方を使用して、相互運用性の本番環境で使用することができます。これについては、ドキュメントをご覧ください。

多くの場合、DICOM 統合を開発する際に外部システム（PACS など）をシミュレーターで実行すると非常に便利です。実際のシステムに接続する前に、実装したいフローを完全にテストすることができます。

IRIS For Health と dcm4che というシミュレーターを使った DICOM 統合の例があります。

この例では、2 つのシナリオが実装されています。

埋め込み PDF で DICOM メッセージを受信する

DICOM 画像をクエリして PACS から取得する

クエリフロー:

取得フロー:

さまざまな貢献をぜひお待ちしています :)

これは InterSystems FAQ サイトの記事です。

管理ポータルメニュー [Interoperability] > [構成] > [システムのデフォルト設定] で設定したデータを移行する場合、設定値が格納されているグローバル変数をエクスポートし、移行先システムでインポートします。

画面で登録した以下のような情報は、

グローバル変数 ^Ens.Config.DefaultSettingsD に格納されています。

認証情報については、グローバル変数 ^Ens.SecondaryData.Password に格納されます。

InterSystems IRIS をご利用の場合は、このグローバルは xxxSECONDARY(xxx はネームスペース名)のデータベースに格納されます。

InterSystems IRIS for Health をご利用の場合は、このグローバルはネームスペースのデフォルトデータベースに格納されます。

xxxSECONDARYデータベースについて詳細は、以下ドキュメントをご参照ください。

InterSystems IRIS のパスワード資格情報の格納場所

【関連トピックのご紹介】

• xxxENSTEMP、xxxSECONDARYは何のデータベースですか？

IRIS 2022.1では Embedded Python が導入されました。Embedde Python によって、IRISの独自言語である ObjectScript と Python の親和性の良さをぜひ実感いただけると嬉しいです。今回の記事では、日本語PDFをPythonライブラリを利用して作成し、さらに ObjectScript と融合するところまで見ていただこうと思います。

iris コマンドを使用することで実行できます。
iris コマンド(iris.exe)は、＜インストールディレクトリ＞\bin にインストールされています。 書式：

iris run インスタンス名 tag^routine([parameter-list]) ネームスペース名

iris run インスタンス名 ##CLASS(package.class).method([parameter-list]) ネームスペース名

インスタンス名は、管理ポータル（システム管理ポータル）の右上にある [インスタンス：] に表示されている文字列です。

実行する環境に応じて一部の文字 ^ や " をエスケープする必要があります。

Windowsの場合は、以下のようなエスケープが必要となります。

例： USERネームスペースで do info^test(123,"abc") を実行します。

c:\InterSystems\IRIS\bin>iris terminal IRIS info^^test(123,\"abc\") USER

例： USERネームスペースで do ##class(Test.Class1).test(123,"abc") を実行します。

c:\InterSystems\IRIS\bin>iris run IRIS ##class(Test.Class1).

CPU：サポート対象OSが問題なく動作するもの
以下のページをご参考ください。

 サポート対象プラットフォーム

ディスク容量：アプリケーションの要件を除外した場合、 IRISをインストールするためには、最低1.5GB以上の空き容量が必要です。
 

ストレージの計画

 実際に必要となる容量は、インストーラでセットアップタイプで "カスタム(Custom)"

を選択すると、インストールコンポーネント毎にご確認いただけます。

メモリ：推奨メモリー値は、アプリケーションや物理メモリサイズによるため

一概には言えませんが、IRISの全プロセスで使用するメモリサイズは以下になります。

①プロセスパーティション * ⑤プロセス数

 ＋

②データベースキャッシュ

 ＋

③ルーチンキャッシュ

 ＋

④一般ヒープメモリ

計算式でのこれらのパラメータは、業務アプリケーションの特性により異なってきます。

以前に導入実績のある業務アプリケーションの場合、既存システムでどの様に設定されたかも参考にしてください。

 ①プロセスパーティション(プロセスあたりの最大メモリ)

   管理ポータルで設定します。既定値は 262,144(KB)です。

IRISがc:\InterSystems\IRISにインストールされているとします。
(1) a.py を C:\InterSystems\IRIS\lib\python に置きます。

a.py
 

def test():  
  print('Hello World!')

(2) それを IRISのクラスから実行します。
 

ClassMethod xx() [ Language = python ]
{
    import a
    a.test()
}

USER>do ##class(User.test).xx()
Hello World!

もし、a.py を別のディレクトリ C:\temp に置きたい場合は、C:\temp\ をPythonのPATHに指定する必要があります。

以下の方法があります。

(A)  管理ポータル＞システム管理＞構成＞追加設定＞メモリ詳細＞PythonPath

の値に C:\tempを設定し、a.pyをそのディレクトリに置き、IRISを再起動します。
 

ClassMethod xx() [ Language = python ]
{
   import a
   a.test()
}

開発者の皆さん、こんにちは！

PythonでExcelからPDFへ変換を行うには、pywinを使うとできるらしいので、IRISにあるデータをDataframeに設定した後Excelに出力し、ExcelからPDFに変換する流れを、Embedded Pythonで試してみました。

メモ：pywinはWindows環境下で動くモジュールのようです。

Excelに出力するデータですが、例では、SELECTの結果をDataframeに格納する方法を利用しています。グローバル変数の情報をDataframeに格納する方法については、以下の記事で詳しくご紹介しています。ぜひご参照ください。
Embedded Python で IRIS グローバル($LB) を Pandas Dataframe に変換する方法

まずは、必要なモジュールをインストールする必要があるので、pywin32 モジュールを irispipを使ってインストールします。

以下の例では、IRIS for Health が c:\InterSystems\IRISHealth にインストールされている状態で実行しています。

Embedded Pythonは、IRIS／IRIS for Health どちらでも利用できます。

これは InterSystems FAQ サイトの記事です。

Question:

IRIS Data Platformは大量のトラフィック処理に耐えられますか?

Answer:

IRIS Data Platformは他のデータベースシステムに比較してデータの処理スピードおよび処理能力の面で優れています。

ESGという外部機関が実際に他社データベース製品とのベンチマークテストを実施した結果に関するレポートを公表しています。

またウルシステムズ社による検証結果も公開されています。

ご参考いただければ幸いです。

ESGによるスピードテストの検証結果

ウルシステムズ社ベンチマーク結果レポート
 

IRISリリース2022.1のご紹介

本稿は、「InterSystems IRIS、IRIS for Health、HealthShare Health Connect 2022.1がリリースされました！」でご案内している内容を、補足解説する内容となります。

紹介ビデオ

米国本社プロダクトマネージャーによる本リリースのハイライトのご紹介ビデオ(英語)です。 https://www.intersystems.com/resources/whats-new-in-intersystems-iris-2022-1

リリース内容

年一度のEMリリースです。

これは InterSystems FAQ サイトの記事です。

バージョン2015.2以降から、Windows上のインストール環境では、サービス・アカウントを
　「Windowsコントロールパネル ＞ 管理ツール ＞ サービス ＞ InterSystems IRIS/Cache Controller for XX」
の「ローカル・システムアカウント」から Windows の任意の管理者アカウントに変更した場合に <NOTOPEN> エラー または -1 が返ります。

この状況を回復するためには、以下2つの設定をする必要があります。

1. 「Windowsコントロールパネル > 管理ツール > サービス > InterSystems IRIS/Cache Controller for XX」
    のログオン設定を、「ローカルシステムアカウント」に戻す
2. irisinstall/cinstall  コマンドを使用してInterSystems IRIS サービス・アカウントを変更する

2 の手順は以下になります。

Windowsコマンドプロンプトを管理者権限で起動し、以下コマンドを使用して変更します。
この設定を有効するためには、インスタンスの再起動が必要です。

これは InterSystems FAQ サイトの記事です。

デフォルトではテーブルのカラムの順番はシステムが自動的に決定します。

順番を変更するにはクラス定義を行う際にプロパティ・キーワード SqlColumnNumber でプロパティ毎に明示的に順番を設定してください。

例：

ドキュメントは以下をご参照ください。

SqlColumnNumber

なお、SQLテーブル名を変えたい場合は SqlTableName 、カラム名(フィールド名)を変えたい場合は SqlFieldName を指定します。

ともに、永続クラスのみに適用されます。