Azure API for FHIR: 基本
FHIR とは何でしょうか?
高速ヘルスケア相互運用性リソース (Fast Healthcare Interoperability Resources) は、略して FHIR ("ファイア" と発音) と呼ばれ、さまざまな医療システム間で医療データの交換を可能にする相互運用性標準です。 この標準は HL7 組織によって策定され、世界各国の医療機関で採用されています。 FHIR の最新バージョンは R4 (Release 4) です。 Azure API for FHIR では、R4 と以前のバージョンの STU3 (Standard for Trial Use 3) がサポートされています。 FHIR の詳細については、HL7.org のページを参照してください。
FHIR API のデータは Azure に格納されるのですか?
はい。データは Azure のマネージド データベースに格納されます。 Azure API for FHIR では、基になるデータ ストアに直接アクセスすることはできません。
基になるデータにアクセスするにはどうすればよいですか?
管理サービスでは、基になるデータにアクセスできません。 これは、Azure API for FHIR が医療データに必要なプライバシーとコンプライアンスの認定を確実に提供できるようにするためです。 基になるデータにアクセスする必要がある場合は、オープンソースの FHIR サーバーを使用できます。
どの ID プロバイダーがサポートされますか?
Microsoft Entra ID は ID プロバイダーとしてサポートされています。
Azure API for FHIR のバックアップと復旧ポリシーは何ですか?
マネージド サービスのデータは 4 時間ごとに自動的にバックアップされ、2 つのバックアップが維持されます。 したがって、リテンション期間は 8 時間です。 データの復旧はサポート チームによって行われ、目標復旧ポイント (RPO) は 240 分未満です。
お客様は、サポート チケットを使用して、データの復元または既定のデータ バックアップ ポリシーの変更を要求できます。
どのバージョンの FHIR がサポートされますか?
バージョン 4.0.0 と 3.0.1 がサポートされています。 詳細については、 FHIR でサポートされている機能を参照してください。 FHIR バージョン間 (STU3 から R4) の変更点については、HL7 FHIR のバージョン履歴に関するページも参考になります。
Azure IoT Connector for FHIR (プレビュー) では現在、FHIR バージョン R4 のみがサポートされており、Azure API for FHIR の R4 インスタンスで表示されます。
Azure API for FHIR はどのリージョンで利用できますか?
複数の geo リージョンでパブリックと政府機関の両方に対して一般提供されています。 Microsoft の政府機関向けクラウド サービスの詳細については、 FedRAMP による Azure サービスに関するページを参照してください。
Azure API for FHIR でリリースされる内容はどこで確認できますか?
リリース ノート ページには、前月に管理サービスにリリースされたすべての内容の概要が記載されています。
Azure API for FHIR でリリースされる内容の詳細については、オープンソースの FHIR サーバーの リリース を参照してください。 マネージド サービスにリリースされ、通常はオープンソースのリリース ページから 2 週間後に利用可能になる場合は、Azure-API-for-FHIR で項目にタグを付ける作業を行いました。 独自の環境で テストする場合にビルドをテストする方法 の手順も含まれています。
マネージド サービスに現在含まれているリリース パッケージを確認するには、azure API for FHIR の capability ステートメントを software.version プロパティで確認できます。 デプロイされているパッケージが表示されます。
データベースで実行されている FHIR (R4/STU3) のバージョンはどこで確認できますか?
capability ステートメントで公開されている FHIR の正確なバージョンは、 fhirVersion プロパティにあります。
Azure API for FHIR を STU3 から R4 に切り替えることができますか?
いいえ。 既存のデータベースのバージョンを変更する方法はありません。 新しい Azure API for FHIR を作成し、データを再読み込みする必要があります。 STU3 データの R4 への変換から始める場所として 、JSON から FHIR へのコンバーター を利用できます。
Azure API for FHIR の URL をカスタマイズできますか?
いいえ。 Azure API for FHIR の URL は変更できません。
FHIR の実装と仕様
SMART on FHIR とは何でしょうか?
SMART (Substitutable Medical Applications and Reusable Technology) on FHIR は、FHIR サーバーやその他の医療 IT システム (電子カルテ、医療情報交換など) にパートナー アプリケーションを統合するための一連のオープン仕様です。 SMART on FHIR アプリケーションを作成することで、さまざまなシステムでアプリケーションにアクセスして活用できるようにします。 SMART の詳細については、 SMART Health IT の Web サイトを参照してください。
Azure API for FHIR は SMART on FHIR をサポートしていますか?
はい。SMART on FHIR 機能は、 AHDS サンプルを使用してサポート。 これは SMART on FHIR(Enhanced) と呼ばれます。 SMART on FHIR(Enhanced) は、「SMART on FHIR 実装ガイド (v 1.0.0)」と「§170.315(g)(10) 患者および住民サービス基準の標準化 API の要件」を満たすと見なされます。 詳細については、 SMART on FHIR(Enhanced) のドキュメントを参照してください。
カスタム FHIR リソースを作成できますか?
カスタム FHIR リソースは許可されていません。 カスタム FHIR リソースが必要な場合、拡張機能を使用して基本的なリソースの上にカスタム リソースを構築できます。
Azure API for FHIR で拡張機能はサポートされていますか?
有効な FHIR JSON データをサーバーに読み込むことができます。 拡張機能を定義する構造体定義を格納する場合は、これを構造体定義リソースとして保存できます。 拡張機能を検索するには、独自の検索パラメーターを定義する必要があります。
アップロードできるリソースのサイズにはどのような制限がありますか?
リソースは 2 MB 未満である必要があります。 これは基になるデータストアからの制限であり、この値を増やすことはできません。
XML で Azure API for FHIR を表示するにはどうすればよいですか?
管理サービスでは JSON のみをサポートしています。 オープンソースの FHIR サーバーは、JSON と XML をサポートしています。 オープンソースの XML バージョンを表示するには、_format= application/fhir+xml を使います。
_count にはどのような制限がありますか?
_count の現在の上限は 1000 です。 _countを 1000 を超える値に設定すると、バンドルに 1,000 レコードのみが表示されるという警告がバンドルに表示されます。
グループ エクスポート機能に制限はありますか?
グループ のエクスポートでは、含まれる参照のみをグループからエクスポートし、 グループ リソースのすべての特性をエクスポートするわけではありません。
Azure API for FHIR にバンドルを投稿できますか?
現在、 バッチ バンドルの投稿はサポートされていますが、Azure API for FHIR でのトランザクション バンドルの投稿はサポートされていません。 トランザクション バンドルのサポートが必要な場合は、Azure Health Data Services で FHIR サービスを使用できます。
Azure API for FHIR で 1 人の患者のすべてのリソースを取得するにはどうすればよいですか?
Patient-$everything 操作を使用することも、Azure API for FHIR でコンパートメント検索を使用することもできます。 これにより、特定の患者に関連するすべてのリソースを取得できます。 患者コンパートメントには、患者自体ではなく患者に関連するすべてのリソースが含まれているため、結果に患者リソースが必要な場合は、患者を取得するためにも検索する必要があることに注意してください。
Azure API for FHIR でリソースを検索するときの既定の並べ替えは何ですか?
最後に更新された日付 (_sort=_lastUpdated) による並べ替えがサポートされています。 また、FirstName、LastName、BirthDate、および ClinicalDate 要素の_sortもサポートしています。 サポートされているその他の検索パラメーターの詳細については、「 FHIR 検索の概要」を参照してください。
Azure API for FHIR は$everythingをサポートしていますか?
はい。患者$everythingのサポートがあります。 詳細については、 Patient-$Everything のハウツー ガイドを参照してください。
Azure API for FHIR は用語操作をサポートしていますか?
いいえ。現在、Azure API for FHIR では用語操作はサポートされていません。
$exportのしくみ
$exportは FHIR 仕様の一部です。 FHIR サービスがマネージド ID とストレージ アカウントで構成されていて、マネージド ID がそのストレージ アカウントにアクセスできる場合は、FHIR API で$exportを呼び出すことができ、すべての FHIR リソースがストレージ アカウントにエクスポートされます。 詳細については、 記事$exportを参照してください。
EHR データを識別解除するためのすぐに使用するソリューションはありますか?
FHIR データを識別解除するためのオープンソース ツールがあります。 同じテクノロジは、 識別解除 されたエクスポートの形式で Azure API for FHIR にも統合されます。
識別解除されたエクスポートは、患者レベルとグループ レベルでも使用できますか?
匿名化エクスポートは現在、完全なシステム エクスポート (/$export) でのみサポートされており、Patient エクスポート (/Patient/$export) ではサポートされていません。 患者レベルでも利用できるように取り組んでいます。
Azure API for FHIR の削除の種類の違いは何ですか?
Azure API for FHIR では、2 種類の基本的な削除がサポートされています。 これらは 削除と条件付き削除です。
- Delete を使用すると、論理的な削除 (最も一般的な種類) を実行し、レコードの履歴バージョンを回復することができます。
- 条件付き削除を使用すると、検索条件を渡して、リソースを一度に 1 つまたは複数のアイテムを一度に 1 つずつ削除できます。
- Delete または Conditional Delete を使用して、
hardDeleteパラメーターを渡した場合、すべてのレコードと履歴が削除され、回復不能になります。
Azure API for FHIR で削除されたレコードを回復するにはどうすればよいですか?
hardDelete パラメーターを使用しない場合は、削除されたファイルを回復できます。 Azure API for FHIR のレコードは引き続き存在する必要があります。 レコードは、リソースの履歴検索を実行し、データを含む最後のバージョンを検索することで見つけることができます。
Azure API for FHIR の使用
Azure API for FHIR のログ分析を有効にする方法
監査ログとサンプル クエリの有効化の詳細については、「 Azure API for FHIR で診断ログを有効にする」を参照してください。 ログに追加情報を含める場合は、 カスタム HTTP ヘッダーの使用を参照してください。
データの読み込みと更新時に 429 秒が発生します。 これを解決するにはどうすればよいですか?
これを解決するには、 スループット を増やすか 、自動スケール に切り替えて、要求を処理するのに十分なコンピューティングがあることを確認します。 問題が解決しない場合は、サポート チケットを開いてください。
RU を下げる方法と、設定した RU よりも RU が高い場合はどうすればよいですか。
RU の最小値は、GB あたり少なくとも 40 RU である必要があります。 データを読み込む際に、この最小値を下回ると、データベース上の RU が増加します。
ワークフロー内で Azure API for FHIR を使用する例はどこで確認できますか?
正常性アーキテクチャの GitHub ページには、参照アーキテクチャのコレクションが用意されています。
Azure API for FHIR の機能とサービス
FHIR サービスで正常性チェックを実行できますか?
FHIR サービスで正常性チェックを実行するには、GET 要求に「 {{fhirurl}}/health/check 」と入力します。 FHIR サービスの状態が表示されるはずです。 HTTP 状態コードの応答が 200 で、OverallStatus が "正常" である場合は、正常性チェックが成功したことを意味します。
エラーが発生した場合は、HTTP 状態コード 404 (Not Found) または状態コード 500 (内部サーバー エラー) を含むエラー応答と、一部のシナリオでの応答本文の詳細情報が表示されます。
既定のキーではなく、個人用キーを使用してデータを暗号化する方法はありますか?
はい。Azure API for FHIR では、Azure Cosmos DB からのサポートを利用して、カスタマー マネージド キーを構成できます。 個人キーを使用したデータの暗号化の詳細については、「 REST でカスタマー マネージド キーを構成する」を参照してください。
プロビジョニング状態が原因で FHIR リソースを削除できない場合はどうすればよいですか?
FHIR リソースに対してディザスター リカバリーが有効になっているかどうかを確認します。 その場合は、ディザスター リカバリー機能を無効にします。
Azure API for FHIR サービスから HTTP 状態コード 429 を受け取った場合はどうすればよいですか?
FHIR インスタンスに関連付けられている RU 消費量を確認します。 RU 消費量が多い (約 100%) 場合は、調整エラーが RU 使用率が高い時間に対応しているかどうかを確認します。 その場合は、サービスの自動スケールを有効にし、サービスに割り当てられている RU を増やすことを検討してください。 詳細については、 Azure API for FHIR の自動スケーリング に関するページを参照してください。