重要
Azure API for FHIR は、2026 年 9 月 30 日に廃止されます。 移行戦略に従って、その日までに Azure Health Data Services FHIR® サービスに切り替えてください。 Azure API for FHIR が廃止されたため、2025 年 4 月 1 日以降、新しい顧客のデプロイは許可されません。 Azure Health Data Services FHIR サービス は、お客様が他の Azure サービスへの統合を使用して FHIR および DICOM サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。
Azure Health Data Services FHIR® サービスは、正常性データ統合のための次世代プラットフォームです。 これは、多様な健康データ交換のための管理されたエンタープライズグレードのFHIRおよびDICOMサービスを提供します。
FHIR データを Azure API for FHIR から Azure Health Data Services FHIR サービスに移行すると、組織はパフォーマンス、スケーラビリティ、セキュリティ、コンプライアンスの向上の恩恵を受けることができます。 組織は、Azure API for FHIR では利用できない新機能にアクセスすることもできます。
Azure API for FHIR は 2026 年 9 月 30 日に廃止されるため、可能な限り早く FHIR データを Azure Health Data Services FHIR サービスに移行する必要があります。 プロセスがいっそう容易になるように、Microsoft は、準備状況の評価、データの準備、アプリケーションの移行、新しいサービスへのカットオーバーに役立つツールとヒントをいくつか作成しました。
推奨される方法
データを移行するには、次の手順に従います:
- 手順 1:適応性を評価する
- 手順 2:移行を準備する
- 手順 3: データとアプリケーション ワークロードを移行する
- 手順 4: Azure API for FHIR から Azure Health Data Services にカットオーバーする
手順 1:適応性を評価する
Azure API for FHIR と Azure Health Data Services の違いを比較します。 また、既存のアーキテクチャを再検討し、変更が必要かどうかを評価します。
| 機能 | Azure API for FHIR | Azure Health Data Services |
|---|---|---|
| 設定 | サポートされています • ローカル RBAC • SMART on FHIR プロキシ |
非推奨の予定: • ローカル RBAC (9/6/23、2023 年 9 月 6 日) • SMART on FHIR プロキシ (9/21/26、2026 年 9 月 21 日) |
| データ ストレージ ボリューム | 4 TB より大きい | 現在のサポートは 4 TB です。 4 TB 超過が必要な場合は、Azure サポート リクエストを開きます |
| データのイングレス | OSS 内で利用可能なツール |
$import 操作 |
| 自動スケーリング | 要求に応じてサポートされ、料金が発生します | 既定で有効になっていて、追加料金なし |
| 検索パラメーター | サポートされているバンドルの種類: Batch • Include および revinclude、iterate 修飾子はサポートされていません • 名、姓、生年月日、臨床日をサポートしている並べ替え |
サポートされているバンドルの種類: Batch とトランザクション • 選択可能な検索パラメーター • Include、revinclude、および iterate 修飾子はサポートされていません • 文字列フィールドと dateTime フィールドをサポートする並べ替え |
| イベント | サポートされていません | サポートされています |
| インフラストラクチャ | サポートされています • 顧客管理キー • リージョン間 DR (ディザスター リカバリー) |
サポートされています • PITR (ポイント イン タイム リストア) • 顧客管理キー 今後の予定: • 可用性ゾーンのサポート |
使用中のアーキテクチャに影響を与える可能性がある考慮事項
同期エージェントは非推奨になっています。 同期エージェントを使用して Dataverse に接続する場合は、データ統合ツールキットの概要を参照してください
FHIR プロキシは非推奨になっています。 イベントに FHIR プロキシを使用している場合は、組み込みのイベント機能を参照してください。 代替手段は、Azure Health Data Services ツールキットを使用してカスタマイズおよび構築できます。
SMART on FHIR プロキシは非推奨になっています。 新しい SMART on FHIR 機能を使用する必要があります。 詳細情報: SMART on FHIR
Azure Health Data Services FHIR サービスは、ローカル RBAC やカスタム機関をサポートしていません。 トークン発行者機関は、FHIR サービスが実行されているテナントの認証エンドポイントである必要があります。
IoT コネクタは、Azure API for FHIR サービスを使用している場合のみサポートされます。 既存の IoT コネクタ デバイスの FHIR データを Azure API for FHIR サービスから Azure Health Data Services の FHIR サービスに移行することを希望する場合は、移行ツール内にある一括エクスポートおよびインポート機能を使用します。
手順 2:移行を準備する
最初に、移行計画を作成します。 次の表で説明されている移行パターンをお勧めします。 ダウンタイムに対する組織の許容度に応じて、移行を容易にするために、特定のパターンとツールを使用することを決定できます。.
| 移行パターン | 詳細 | 方法はありますか。 |
|---|---|---|
| リフト アンド シフト | 最も簡単なパターンです。 データ パイプラインがダウンタイムを許容できる場合に最適です。 | お客様の組織に最適なオプションをお選びください。 • Azure API for FHIR 上でデータを $export し、Azure Health Data Services FHIR サービスに $import するワークフロー を構成します。 • GitHub リポジトリには、これらのコマンドの実行に関するヒントと、 $import ペイロードの作成を自動化するのに役立つスクリプトがあります。 • $export と $import を使用して、データを移行するための独自ツールを作成します。 |
| 増分コピー | ダウンタイムを短縮したリフト アンド シフトの継続的なバージョン。 コピーに長い時間がかかる大量のデータや、移行中に Azure API for FHIR を引き続き実行する場合に最適です。 | お客様の組織に最適なオプションをお選びください。 • Microsoft は、この移行パターンに役立つ OSS 移行ツールを作成しました。 • データをインクリメンタル (増分) 形式で移行するための独自ツールを作成します。 |
OSS 移行ツールに関する考慮事項
OSS 移行ツールを使用する方針を決定した場合は、移行ツールの機能と制限事項を確認して理解してください。
Azure API for FHIR サーバーを準備する
移行しようとするデータを特定します。
この機会を利用して、使用しなくなったデータや FHIR サーバーをクリーンアップします。
履歴バージョンの移行を希望するかどうかを決定します。
新しい Azure Health Data Services FHIR サービス サーバーをデプロイします。
最初に、Azure Health Data Services のワークスペースをデプロイします。
次に、Azure Health Data Services FHIR サービス サーバーをデプロイします。 詳細については、「Deploy a FHIR service within Azure Health Data Services (Azure Health Data Services 内に FHIR サービスをデプロイする)」を参照してください。
新しい Azure Health Data Services FHIR サービス サーバーを構成します。 新しいサーバーに対して Azure API for FHIR と同じ構成を使用する必要がある場合は、移行ツールのドキュメントで、確認しようとする項目の推奨される一覧を参照してください。 移行する前に、設定を構成します。
手順 3: データを移行する
お客様の組織に最適な移行パターンを選択します。 OSS 移行ツールを使用している場合は、GitHub の手順に従います。
手順 4: アプリケーションを移行し、設定を再構成する
古い FHIR サーバーを指していたアプリケーションを移行します。
新しい FHIR サーバーの URL をポイントするように、アプリケーションのエンドポイントを変更します。
これらのアプリに対応するアクセス許可をもう一度設定します。
移行後に、新しい Azure Health Data Services FHIR サービス サーバーの残りの設定を再構成します。
Azure Health Data Services FHIR サービスと Azure API for FHIR サーバーの構成が同じであるか再確認することを希望する場合は、両方のメタデータ エンドポイントを確認して、2 つのサーバーを比較できます。
以前に古い Azure API for FHIR サーバーで実行されていたジョブ (たとえば、
$exportジョブなど) を設定する
手順 5: Azure Health Data Services FHIR サービスにカットオーバーする
Azure Health Data Services FHIR サービス サーバーが安定していることを確信した後、Azure Health Data Services FHIR サービスの使用を開始し、ビジネス シナリオを満たすことができます。 Azure API for FHIR で実行されている残りのパイプラインをすべてオフにします。 必要に応じて、移行ツールで使用した中間ストレージ アカウントからデータを削除します。 Azure API for FHIR サーバーからデータを削除し、Azure API for FHIR アカウントの使用を停止します。
Note
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。