Azure API for FHIR についてよく寄せられる質問

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 プロバイダーがサポートされますか?

当社は、ID プロバイダーとして Microsoft Azure Active Directory をサポートしています。

Azure API for FHIR で Azure AD B2C を使用できますか?

いいえ、Azure API for FHIR では、B2C をサポートしていません。 より詳細なアクセスの制御が必要な場合は、オープンソースの FHIR プロキシを検討することをお勧めします。

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 Health Data Services と Azure API for FHIR の違いは何ですか?

Azure API for FHIR は一般提供されているマネージド FHIR サービスです。 Azure Health Data Services を使うと、同じワークスペース内に FHIR サービスと DICOM サービスをデプロイできます。 詳細については、Azure Health Data Services の概要を参照してください。

Microsoft FHIR Server for Azure と Azure API for FHIR の違いは何ですか?

Azure API for FHIR は、オープンソースの Microsoft FHIR Server for Azure サーバーのホスト マネージド バージョンです。 マネージド サービスでは、メンテナンスや更新プログラムがすべて Microsoft によって提供されます。

FHIR Server for Azure を実行するときに、基になるサービスに直接アクセスできますが、サーバーのメンテナンスや更新、PHI データを格納する場合はすべての必要なコンプライアンス作業も担当します。

Azure API for FHIR はどのリージョンで使用できますか?

複数の geo リージョンで、パブリックと政府機関の両方に対して一般提供しています。 Microsoft の政府機関向けクラウド サービスの詳細については、FedRAMP による Azure サービスを参照してください。

Azure API for FHIR にリリースされる内容はどこで確認できますか?

リリース ノート ページには、前月に管理サービスにリリースされたすべての内容の概要が記載されています。

Azure API for FHIR のリリース内容については、オープンソース FHIR サーバーのリリースを参照してください。 マネージド サービスにリリースされる場合、Azure-API-for-FHIR を使用して項目にタグを付ける作業を行いました。通常は、オープンソースのリリース ページから 2 週間後に利用可能になります。 また、独自の環境でテストする場合に、ビルドをテストする方法に関する手順を掲載しました。

管理サービスに現在含まれているリリース パッケージを確認するには、software.version プロパティにある Azure API for FHIR の機能の説明を参照してください。 デプロイされているパッケージが表示されます。

データベースで実行されている FHIR のバージョン (R4 または STU3) はどこで確認できますか?

機能ステートメントで公開されている正確な FHIR のバージョンは、fhirVersion プロパティで確認できます。

Azure API for FHIR を STU3 から R4 へ切り替えることはできますか?

いいえ。 既存のデータベースのバージョンを変更する方法はありません。 新しい Azure API for FHIR を作成し、データを再度読み込む必要があります。 STU3 データを R4 に変換することから始める場所として、JSON to 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 をサポートしていますか?

はい。FHIR での SMART 機能は 、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 未満である必要があります。 これは基になるデータ ストアの制限であり、この値を増やすことはできません。

Azure API for FHIR を XML で表示するにはどうすればよいですか?

管理サービスでは JSON のみをサポートしています。 オープンソースの FHIR サーバーは、JSON と XML をサポートしています。 オープンソースの XML バージョンを表示するには、_format= application/fhir+xml を使います。

_count にはどのような制限がありますか?

_count の現在の上限は 1000 です。 _count を 1000 より大きい値に設定すると、バンドルに 1000 レコードのみが表示されるという警告が表示されます。

グループ エクスポート機能に制限はありますか?

グループ エクスポートでは、グループ リソースのすべての特性ではなく、含まれている参照のみがグループからエクスポートされます。

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 はサポートされていますか?

はい、patient-$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/$export) ではサポートされていません。 患者レベルでも使用できるようにする作業を行っています。

Azure API for FHIR の削除の種類にはどのような違いがありますか?

Azure API for FHIR では、2 種類の基本的な削除がサポートされています。 それは削除と条件付き削除です。

  • 削除を使うと、論理的な削除 (最も一般的な種類) の実行を選んでも、レコードの履歴バージョンを復旧することができます。
  • 条件付き削除を使うと、検索条件を渡して、リソースを 1 項目ずつ、または一度に複数の項目を削除することができます。
  • 削除と条件付き削除のいずれでも、hardDelete パラメーターを渡した場合、すべてのレコードと履歴が削除され、復旧できなくなります。

Azure API for FHIR で削除されたレコードを復旧するにはどうすればよいですか?

hardDelete パラメーターを使わない場合、削除されたファイルを復旧できます。 Azure API for FHIR 内に 1 つ以上のレコードがまだ存在するはずです。 レコードを見つけるには、リソースに対して履歴検索を行い、データのある最後のバージョンを探します。

Azure API for FHIR の使用

Azure API for FHIR のログ分析を有効にするにはどうすればよいですか?

監査ログを有効にする方法とサンプル クエリの詳細については、「Azure API for FHIR で診断ログを有効にする」を参照してください。 ログに追加情報を含める場合は、カスタム HTTP ヘッダーの使用に関するページを参照してください。

データの読み込みと更新のときに 429 が発生します。 これを解決するには、どうすればよいですか?

これを解決するには、スループットを上げるか、自動スケーリングに切り替えて、要求を処理するのに十分なコンピューティングを確保します。 問題が解決しない場合は、サポート チケットを開いてください。

RU を下げるにはどうすればよいですか? それができず、RU が設定よりも高くなります。

RU の最小値は、1 GB あたり少なくとも 40 RU である必要があります。 この最小値を下回ると、データを読み込むときにデータベースの RU が増加します。

ワークフロー内での Azure API for FHIR の使用例は、どこで確認できますか?

正常性アーキテクチャ GitHub ページに使用可能な参照アーキテクチャのコレクションがあります。

Azure API for FHIR の機能とサービス

FHIR サービスで正常性チェックを実行できますか?

FHIR サービスで正常性チェックを実行するには、GET 要求に「」と入力{{fhirurl}}/health/checkします。 FHIR サービスの状態が表示されるはずです。 応答で 200 と OverallStatus が "正常" である HTTP 状態コード応答は、正常性チェックが成功したことを意味します。 エラーが発生した場合は、HTTP 状態コード 404 (見つかりません) または状態コード 500 (内部サーバー エラー) を含むエラー応答と、一部のシナリオでは応答本文に詳細情報が表示されます。

既定のキーではなく個人用キーを使用してデータを暗号化する方法はありますか?

はい。Azure API for FHIR では、Azure Cosmos DB のサポートを利用して、カスタマー マネージド キーを構成できます。 個人キーを使ったデータの暗号化については、「保存状態のカスタマー マネージド キーを構成する」を参照してください。