HealthRecordCommunity
FHIR🌏 International🏛 InterSystems整理済

FHIRカスタム実装における`_summary=count`検索の注意点

An Important Gotcha in FHIR Custom Interaction Strategy Implementation - For a Speedy ...

2026年8月2日InterSystems

サマリー

InterSystemsは、v2023.1で特定のFHIR検索(`_summary=count`を使用)を高速化する機能強化を実施した。しかし、ユーザーが独自のインタラクション戦略を実装する場合、この新しいSELECT COUNTクエリの動作をカスタムクラス内で明示的に制御する必要がある。

詳細

本記事は、InterSystems IRIS for HealthにおけるFHIRサーバーの実装に関する技術解説である。v2023.1で追加された機能強化により、`_summary=count`パラメータを使用する検索がSELECT COUNTクエリを利用して高速化されるようになった。この仕組みをカスタムインタラクション戦略(Interaction Strategy)として実装する場合、開発者は自身のクラス内で`isSelectCountAllowed`メソッドをオーバーライドし、明示的にSELECT COUNTの実行を許可する(OPT IN)必要がある。デフォルトでは、この機能はベースとなる'Json/JsonAdvSQL'戦略でのみTrueが返るため、カスタムロジックを追加した際は必ず対応が必要である。 ログ確認により、変更前は「Run Match Query」としてデータ取得が行われるのに対し、変更後は「Run Count Query」として`SELECT COUNT(*)`クエリが実行されていることが確認できる。このCOUNT機能を利用することで、検索結果が最大件数を超える場合に発生するSearchTooCostlyエラーを回避しつつ、リソース数をカウントすることが可能となる。 本技術は、FHIRのデータアクセス効率と安定性を高めるための重要な実装上の注意点を提供するものである。

📰
原文を読む
community.intersystems.com
→

Original content copyright by respective publishers