InterSystems IRISは総合データプラットフォームです
InterSystems IRISは、企業にとって最も価値のある資産(データ)の取得、共有、理解、そしてデータに基づく行動のために必要なすべてのものを提供します。
完全なプラットフォームである InterSystems IRIS は、複数の開発技術を統合する必要がありません。より少ないコードで開発が可能で、そのアプリケーションは、システムリソース、メンテナンスなども少なくて済みます。
これは、InterSystems FAQサイトの記事です。
区切り識別子は、区切り文字で囲まれた一意の識別子です。
InterSystems SQL は、その区切り文字として二重引用符 「"」 をサポートしています。
一方、リテラル値を区切る場合は、一重引用符「'」を使用します。
例えば、下記のSQLにおいて、
①は、Nameの値が「AAA」という文字列である、という検索条件と解釈されますが、
②は、Name列 = AAA列、という結合条件と解釈されます。※実際にAAA列が無ければエラーとなります。
①
selectfromwhere
②
リテラル値(文字列、数値)を示す区切り文字として二重引用符「"」を使用したい場合は、
下記を実行し、この区切り識別子サポートするためのオプションを無効にします。
これにより、「'AAA'」と「"AAA"」はどちらも同様に「AAA」という文字列を示すことになり、
上記①・②のSQLは、どちらも、同義に解釈されます。
これは、InterSystems FAQサイトの記事です。
既定では、InterSystems製品で表すことのできる日時の最小値は、1840年12月31日 0時0分0秒 です。
USER>write$ZDATETIME ですが、アプリ内での用途や、他DBからの登録などで、それよりも前の日付時刻を登録する必要がある場合があります。
その場合には、日付日時のプロパティに、MINVAL(最小値)を設定することでサポートできます。
下記は、％DateTime型、％TeimaStamp型のプロパティに、最小値：西暦1年1月1日0時0分0秒と設定したものです。
※2023.3および2024.1以降のバージョンでは、％DateTime型のMINVALの設定は必要なく、1840年12月31日 0時0分0秒より前の日時でも問題なく登録できます。％TimeStamp型の場合は、引き続き設定が必要です。
これは InterSystems FAQ サイトの記事です。
新しいインデックスを定義した後、インデックスの再構築が完了する前にクエリを実行するとデータが存在しているにもかかわらず「検索結果0件」や検索結果数が徐々に増えるような状況が発生します。
インデックスを永続クラス定義（またはテーブル定義）に追加しコンパイルすることで今まで使用していたクエリ実行経路が削除され、再度同じクエリを実行するタイミングで新しいインデックス定義を含めた実行経路が作成されるためです。（この時にインデックス再構築が完了していないとインデックスデータが存在しない、または不完全であるため0件や徐々に検索結果数が増えるような状況を起こします。）
これを起こさなために、新しいインデックスの再構築が終了するまでクエリオプティマイザにインデックスを使用させないように指定する方法が用意されています。
※ 2024/8/2： 2024.1以降から利用できる方法を追加しました。
CREATE INDEXのDEFERオプションを使用します（オプションを付けないCREATE INDEX文では、作成時にインデックスの再構築も同時に行われます）。
リリースハイライト
2024.2 は Continuous Delivery(CD)リリースです。
2024.2 には多くのアップデートや拡張機能が追加されています。
開発者向け機能の強化
インターシステムズは、InterSystems IRIS、InterSystems IRIS for Health、HealthShare Health Connect のメンテナンスバージョン 2024.1.1 をリリースしました。2024.1.1 は 2024.1.0 に対するバグフィックスを提供しています。詳細な情報は、以下のページをご参照ください（すべて英語版です）
【キットのご案内】
本製品は、従来からのインストーラパッケージ形式と、コンテナイメージ形式をご用意しています。その一覧は、サポートプラットフォームページをご覧ください。
インストーラパッケージは WRC Direct から入手できます。InterSystems IRIS、IRIS for Health は から、HealthShare Health Connect は から、それぞれ入手してください。
コンテナイメージは から入手できます。コンテナイメージには 2024.1 のタグが付けられています。
このリリースには、コミュニティ・エディションのインストーラパッケージやコンテナイメージはありません。
各製品のバージョン番号は 2024.1.1.347.0 です。AIX キットの場合のみ、ビルド番号は 2024.1.1.347.1 です。
ご好評をいただいておりますインターシステムズ開発者向けオンラインセミナー、9月は以下のテーマで開催いたします。
[概要]
はじめはユートピアになると考えられていたサイバー空間にも多様な脅威が出現し、日々変化し続けています。
多くの分野で活用されている IRIS と IRIS for Health、より厳しいセキュリティ要件は避けられない未来とも言えるでしょう。
本セッションではIRISインスタンスと管理するデータを保護する方法について概要をご説明します。
[こんな方にお勧め]
IRISの管理機能に興味ある方
IRISを使用したソリューションを設計される方
ご多用中とは存じますが、皆様のご参加をお待ち申し上げております！
これは InterSystems FAQ サイトの記事です。
通常SQLCODE -114（一致する行が既に別のユーザにロックされています）のエラーはロックが競合した場合に発生します。
こちらはレコードロック競合があったり、ロック閾値を超える更新を行いテーブルロックに昇格した際に、そのテーブルレコードに対して別のプロセスよりSelectを行い共有ロックを取ろうとして失敗した(ロック待ちがタイムアウトとなった)場合に発生します。
Selectで共有ロックを取る場合というのは、IRIS の ISOLATION LEVEL がREAD COMMITTED（デフォルトはREAD UNCOMMITTED）で、Selectを行った場合です。
例：Sample.Personテーブルにテーブルロックがかかった状態で以下を実行する場合
USER>:sql
SQL Command Line Shell
----------------------------------------------------
The command prefix is currently setq
こちらは、
これは InterSystems FAQ サイトの記事です。
JDBC および ODBC 経由でInterSystemsIRISから外部データベースにアクセスしたい場合、SQLゲートウェイを使用しリンクテーブルを作成して接続できます。
2023.1以降のバージョンでは、リンクテーブルに加えて、外部テーブル／FOREIGN TABLE を使用することが可能となりました（外部テーブルの定義）。
外部テーブルというのは、物理的に別の場所に保存されているデータを IRIS SQL に投影する非常に便利な機能です。
外部テーブルを使用する場合は、Java（2023.1の場合は1.8～）を事前にインストールし、JAVA_HOME環境変数を設定するだけで、簡単に接続することが可能です。
※JAVA_HOME環境変数設定例：
外部テーブルの使用方法については、以下の記事で紹介しております。
レシピデータセットを外部テーブルで読み込み、組み込みPythonでLLMを使って分析する (Langchain + OpenAI)
こちらの記事では、外部テーブルで作成できる2種類のテーブル（「CSVファイル直接接続」と「外部DBへのJDBCゲートウェイ経由での接続」）の簡単なサンプル作成例と、外部テーブルの特徴を紹介しています。
a.
埋め込みPythonは、同じプロセス空間で、IRIS言語とPython言語を組み合わせて使える面白い環境を提供しますが、組み合わせて使う場合、オブジェクトタイプとそのアクセス方法の違いをはっきり意識して使わないと混乱するように思います。その使い分けの勉強の為、両言語のオブジェクト参照から、その構造を解析ダンプするツールを作ってみました。とくに、実行中のPython情報が、ZWRITE Oref コマンドでの表示しかないようなので、有用かも知れません。ツールは、まだ、間違い、改良等があると思います（教えて下さい）が、ポストします。
ツール本体： Py.Dump.cls
ClassExtends%RegisteredObject"||"簡易・テストエントリー:Py.Dump.mac
ROUTINE Py.Dump
#テストサンプル：Py.Sample.cls
実行例 入力 oref は Py.Sample.cls の メソッド s1 と s10 の返り値
42これは InterSystems FAQ サイトの記事です。
管理ポータル > [システム管理] > [セキュリティ] 以下の設定は、%SYSネームスペースにあるSecurityパッケージ以下クラスが提供するメソッドを利用することでプログラムから作成することができます。
以下シナリオに合わせたセキュリティ設定例をご紹介します。
シナリオの中で使用するソースを2種類インポートします。
アプリケーション用RESTディスパッチクラスをインポートします。
ClassExtends%CSP.REST"application/json"続いて、Test.Humanテーブル用定義もインポートします。
Asそれでは設定してみましょう。
1) RESTアプリケーション（/testApp）があり、USERネームスペースで動作するRESTアプリケーションに対して不特定多数のユーザが利用できるようにします＝（認証なしアクセスを許可します）。
これは InterSystems FAQ サイトの記事です。
SQLゲートウェイの接続設定は管理ポータルで作成できますが、プログラムでも作成が可能です。
管理ポータル：
[システム管理] > [構成] > [接続性] > [SQLゲートウェイ接続]
こちらのトピックでは、ODBC/JDBCそれぞれの設定をプログラムで行う方法をご紹介します。
set##class接続テストは以下のように行います。
USER>USER>これは InterSystems FAQ サイトの記事です。
管理ポータル > [システム管理] > [セキュリティ] 以下の設定は、%SYSネームスペースにあるSecurityパッケージ以下クラスが提供するメソッドを利用することでプログラムから作成することができます。
ユーザ設定については、Security.Usersクラスのを使えば作成できますが、ユーザを作成するだけでは適切な権限が付与されずに目的のデータにアクセスできない状況もあります。
例）testAユーザ作成
【ご参考】%SYSset##class上記メソッドで作成した結果は以下の通りです。（ロール付与無し、テーブルに対する権限の割り当てもなしの状態）
以降の解説では、以下のシナリオをもとにした設定を行っていきます。
シナリオ：アプリケーション開発者用ロールとユーザを作成する
1) アプリケーション開発者のtestAは、USERネームスペースにログインするアプリケーション開発者です（＝%DevelopmentリソースのUse許可を与えます）。
2) このユーザはUSERネームスペース内で自由にテーブルの作成・参照・更新が行えるよう適切な特権を持つように定義します。
1) のアプリケーション開発者testAの作成は、以下の通りです。
InterSystems Reports 24.1 がリリースされ、WRC の Components エリアから入手いただけるようになりました。本製品は InterSystems Reports Designer と InterSystems Reports Server と表記されており、Mac OSX、Windows、Linux 版を入手いただけます。
この新バージョンには、弊社パートナーの insightsoftware 社によるすばらしい拡張機能が含まれています。InterSystems Reports 24.1 は Logi Report 24.1 SP2 をベースにしており、以下の機能が含まれます。
これは InterSystems FAQ サイトの記事です。
こちらの記事では、「IRISでシャドウイングの代わりにミラーリングを構成する方法」を紹介しました。
今回は、「プログラムでシャドウイングの代わりにミラーリングを構成する方法（Windows版）」を紹介します。
【今回のサンプル・ミラー構成について】
| 正サーバ（ミラー・プライマリ） | 副サーバ（ミラー・非同期） | |
| ミラー名 | MIRRORSET | MIRRORSET |
| ミラーメンバ名 | MACHINEA | MACHINEC |
| IPアドレス | 35.77.84.159 | 54.248.39.237 |
では、ミラーの構成手順をご紹介します。手順は以下になります。
1. ISCAgentの自動起動設定および起動 ※Windowsコマンドプロンプトで実行
C:\Users\Administrator>sc config ISCAgent start=auto
C:\Users\Administrator>sc start ISCAgent2.
これは InterSystems FAQ サイトの記事です。
メッセージログ（messages.log）／コンソールログ(cconsole.log) に以下のようなメッセージが表示される場合があります。
このメッセージ出力は、ライトデーモンのデータベースファイルへの書き込み処理の遅延を示しています。
その原因としては、ディスクI/O負荷が高く、そのI/O要求量に対してディスク処理性能が不足していることが考えられます。
ディスクI/O負荷の原因としては以下が考えられます。
もしアンチウイルスソフトがインストールされている場合は、「アンチウイルスソフト（セキュリティソフト）のスキャンから除外してほしいリスト」に記述している情報を参考に、InterSystems製品の対象ファイルをスキャンの対象外に設定変更してください。
開発者の皆さん、こんにちは！
次のInterSystems プログラミングコンテストの内容についてご案内します📣
期間： 2024年7月15日～2024年8月4日
賞金総額：$14,000
.jpg)
これは InterSystems FAQ サイトの記事です。
監査ログはシステムDB内テーブル（%SYS.Audit）に記録されていますので、そのテーブルに対するクエリを実行して抽出したり、%SYS.Auditテーブルに用意されていストアドプロシージャを利用して情報を取得しファイル出力するようにプログラムを用意することもできます。
以下にご紹介する内容は「」に関連した内容で、監査ログのファイル出力を管理ポータルの機能を利用した例とプログラムを利用した例でご紹介します。
管理ポータル > [システムエクスプローラ] > [SQL]を開き、%SYSネームスペースに接続します。
システムのチェックを入れ、スキーマに%SYSを指定した後、プロシージャの階層を展開するとプロシージャリストが参照できます。
%SYS.Audit_ で始まるプロシージャが監査ログに対して実行できるプロシージャです。
SQL文例）InterSystems製品内ユーザのSuperUserに対する監査ログをストアドプロシージャ：%SYS,Audit_ListByUser を利用して出力しています。
call'SuperUser'引数については、クラスリファレンス：%SYS.Audit_ListByUserをご参照ください。
管理ポータル内の「印刷」の機能を利用するとファイル出力できます。
これは InterSystems FAQ サイトの記事です。
PythonスクリプトファイルやPythonで記述されたIRIS内メソッドを呼び出す際、エラーが発生した場合の対応方法をご紹介します。
説明使用するコードや資料PDFは公開しています👉 test1.py、FS.Utilsクラス、コードのコピー元、ビデオで解説している資料PDF
Embedded Python 自習用ビデオをご用意しています（項目別にYouTubeプレイリストをご用意しています）。
各プレイリストについて詳しくはこちらをご参照ください👉【はじめてのInterSystems IRIS】Embedded Python セルフラーニングビデオシリーズ公開！
これは InterSystems FAQ サイトの記事です。
InterSystems製品のサーバサイドでファイル入出力を行うと、文字列はシステムで設定されたファイル入出力用文字コードに自動変換され、文字単位でREADします。
ファイルから入力する文字をバイト単位で操作するためには、自動変換を行わない無変換の状態でファイル入力を行い指定バイトずつ読みながら読んだ分だけUnicodeに手動で変換していく必要があります。
変換には$ZCONVERT()関数を使用します。（$ZCONVERT()には省略形があり$ZCVT()でも同様の操作が行えます。）
なお、READした指定バイトを変換する際、文字の全バイトが含まれない場合もあるため、途中までの読み取りになった文字列を第4引数に指定する変数に設定できるようになっています。
次回読み取り時に途中だった文字を自動的に先頭に追加し、$ZCONVERT()の処理を実行します。
《メモ》ファイル入出力の文字コードについては、以下管理ポータルの画面で確認できます。
管理ポータル > 構成 > 国際言語設定 > 構成したデフォルト値
入力／出力テーブルの表の「ファイル」
以下の文章がファイルにUTF8で保存されているとします。
無変換でファイル入力を行うには、%Stream.FileBinaryクラス
これは InterSystems FAQ サイトの記事です。
IRIS2024.1以降のバージョンをインストールしようとした際に、以下のようなエラーになることがあります。
これは、2024.1以降のバージョンより最小CPUの条件として、AVX および BMI 拡張命令が含まれることが条件となっているのですが、ご使用の環境に含まれない（仮想環境やFTサーバ等の特殊なシステムでは無効化されている場合も）ときに出力されるエラーです。
最小CPUサポートバージョンについては、以下のドキュメントをご覧ください。
Minimum Supported CPU
現在使用中のCPUの拡張命令セットの情報の確認方法については、以下のDC記事をご覧ください。
CPU のマイクロアーキテクチャファミリと命令セットの判定方法
Linuxの場合は、lscpuコマンド、または lshw -class processor コマンドで確認できます。
これは InterSystems FAQ サイトの記事です。
現時点（2024年3月）では、コミュニティに掲載されているPythonライブラリ「iris-dollar-list」を利用することでIRISの$LIST()形式のデータをPythonのリストとして利用することができます。
※標準ツールではありませんがご利用いただけます。詳細はコミュニティの記事「もう1つの $ListBuild() の実装：Pythonライブラリ「iris-dollar-list」」をご参照ください。
WindowsにインストールしたIRISで使用する場合は、以下の方法で「iris-dollar-list」をインストールしてください。
※Windows以外にインストールしたIRISでは、pipコマンドを利用した通常の方法でインストールできます。
コマンドプロンプトを開き、以下実行します。（IRISをデフォルトインストールしたときのディレクトリで掲載しています）
> cd> irispip install --target C:\InterSystems\IRIS\mgr\python iris-dollar-list実行例は以下の通りです。
USER>この他に、
近頃、LLM や AI などに関する話題で非常ににぎわっています。 ベクトルデータベースもそれなりに関わっており、IRIS 以外では、世界中で多様なサポートがすでに実現されています。
なぜベクトルなのでしょうか？
理由は他にも多数あります。
そこで、この Python コンテストでは、このサポートを実装してみることにしました。 残念ながら時間内に完成させることはできませんでしたが、その理由を以下で説明します。
ご好評をいただいておりますインターシステムズ開発者向けオンラインセミナー、連続3回のシリーズでお届けする新機能のご紹介、
7月は以下のテーマで開催いたします。
[概要]
InterSystems IRIS および IRIS for Health 2024.1では、Embedded Pythonの利用範囲をますます拡大する新機能が追加されました。
・Python WSGI標準に準拠するWebアプリケーションの作成
・Python BPLエディタ
・フレキシブル組み込み Python ランタイム
本セッションでは、これら新機能をデモを交えてご紹介します。IRISをPythonで開発する際の新たなオプションとしていただければ幸いです。
[こんな方にお勧め]
・IRISに関わる技術者の方
・Pythonに興味のある方
・Python技術者の方
ご多用中とは存じますが、皆様のご参加をお待ち申し上げております！
SSL/TLS を使用するように InterSystems IRIS スーパーサーバを構成した際に、「管理ポータルに接続できなくなった」というお問い合わせを時々いただきます。
こちらの記事では、その際の対処法をご案内します。
スーパーサーバを SSL/TLS 化するために、以下のドキュメントにある方法を設定されると思います。
TLS を使用するための InterSystems IRIS スーパーサーバの構成
その際に、SSL/TLSサポートレベル を 「必須」にしてしまうと、管理ポータルに接続できなくなる場合があります。
※管理ポータル：
IRIS2024.1 ～ [システム管理] > [セキュリティ] > [スーパーサーバ]
～IRIS2023.1 [システム管理] > [セキュリティ] > [システム・セキュリティ] > [システムワイドセキュリティパラメータ]
「必須」に設定する場合、すべてのクライアントからの接続を SSL/TLS 化する必要があります。
これは、WebゲートウェイからIRISへの接続にもあてはまるため、「Webゲートウェイ <==> IRIS」間を SSL/TLS 設定していない場合は、管理ポータル（REST/CSPを含む）に接続ができなくなってしまいます。
これは、InterSystems FAQサイトの記事です。
IRIS/IRIS for Health2024.1以降のバージョンのSQLで、JSON_TABLE関数がサポートされています。
【ドキュメント】JSON_TABLE(SQL)
これを使用することにより、JSON形式データを表形式で取得することが出来ます。
【例】郵便番号情報を外部から取得し、表形式にマッピングする。
(取得データ(JSON))
{
"message"null（SQL例)
※下記の実行には、SSL構成が必要になります。事前に構成を作成して、その構成名を使用してください。
'https://zipcloud.ibsnet.co.jp/api/search?zipcode=1600023'(取得結果(表形式))
2024.1より前のバージョンで、同様のことを行いたい場合は、以下のようにJSONを取得してパースし、テーブルに格納する処理を作成して対応します。
(ObjectScript例)
このたび InterSystems IRIS 2024.1 の日本語ドキュメントが完成しました。以下のURLでご参照いただけます。
InterSystems IRIS® データ・プラットフォーム 2022.3 からライセンス消費メカニズムにRESTとSOAPを追加しました。この変更により、コア・ベースライセンス以外でRESTまたはSOAPを使用している場合、アップグレード後にライセンス消費量が多くなる可能性があります。この勧告がお使いのシステムに該当するかどうかは、以下にあるFAQ(英語)のリンクをご参照ください。.
ライセンス使用について、こちらの表にまとめています。
|
製品 |
REST と SOAP のリクエストがライセンスを消費するかどうか |
|
InterSystems Caché® |
する |
|
InterSystems Ensemble® |
しない |
|
InterSystems IRIS, InterSystems IRIS® for Health, Health Connect 2022.3 より前 |
しない |
|
InterSystems IRIS, InterSystems IRIS for Health, Health Connect 2022.3 以降 |
する |
開発者の皆さん、こんにちは。
（2024/5/30：6月の日時、ウェビナー内容を更新しました）
InterSystems IRIS、InterSystems IRIS for Healthの新バージョン2024.1がリリースされました。
様々な機能の追加や実験的機能としての追加が行われましたが、その中から以下3種類の内容についてウェビナーを開催します！📣
✅4月23日（火）13時半～14時：IRIS 2024.1の管理用Webサーバ（PWS）廃止に備えて
YouTube公開しました👉https://youtu.be/bVwWZt1oNws?list=PLzSN_5VbNaxCeC_ibw2l-xneMCwCVf-Or
✅5月30日（木）13時半～14時：ベクトル検索機能のご紹介
YouTube公開しました👉https://youtu.be/v0G7K2et_Yk?list=PLzSN_5VbNaxB39_H2QMMEG_EsNEFc0ASz
✅6月25日（火）13時半～14時：FHIR新機能のご紹介～2024.1～
オンデマンド配信はこちら👉https://event.on24.com/wcc/r/4597704/ADA161B6446E6BA01623C875CF596FD0
（資料PDFもオンデマンド配信画面よりダウンロードいただけます）
連続3回のシリーズでお届けする新機能についてのウェビナー
【セッション概要】
IRIS2024 .1では、いくつかのFHIR関連の新機能の追加および機能強化が行われました。本ウェビナーではFHIRオブジェクトモデルの機能概要を中心に、2023.1以降のバージョン追加および強化されたIRIS for HealthのFHIR機能についてお話しいたします。
【こんな方にお勧め】
・現在、FHIR関連開発をされている方。
・アプリケーションのFHIR対応を検討されている方。
皆様のご参加をお待ち申し上げております！
こちら の記事では、LinuxでODBC接続を行う方法 をご紹介しました。
今回は、 した IRIS に対して、ODBCで SSL/TLS 接続をする方法をご紹介します。
LinuxでODBC接続を行う方法 の記事で紹介している手順で、SSL/TLS なしでODBC接続できる環境を用意していることを前提にご説明します。
手順は以下のようになります。手順の詳細は、この後で説明します。
３．TLS 構成ファイル odbcssl.ini を作成します
４．環境変数 ISC_SSLconfigurations で <path>/odbcssl.ini を指定します
CA証明書に問題がないか証明書情報を確認します。
※ ***.***.***.*** ：接続先IRISサーバのIPアドレス
# openssl s_client -connect ***.***.***.***:1972 -showcerts -CAfile /home/ec2-user/ca_certificate.crt < /dev/null「Verify return code: 0 (ok)」が返れば、CA証明書に問題はありません。