Azure API for FHIR からの移行に関する移行戦略
重要
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、および MedTech サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。
Azure Health Data Services FHIR® サービスは、正常性データ統合のための次世代プラットフォームです。 これは、多様な健康データ交換のための管理されたエンタープライズグレードの FHIR、DICOM、および MedTech サービスを提供します。
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 サービスに移行する必要があります。 プロセスを容易にするために、準備状況の評価、データの準備、アプリケーションの移行、新しいサービスへのカットオーバーに役立つツールとヒントをいくつか作成しました。
推奨される方法
データを移行するには、次の手順に従います。
- 手順 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 Proxy |
計画された非推奨: • ローカル RBAC (9/6/23) • SMART on FHIR プロキシ (9/21/26) |
| データ ストレージ ボリューム | 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 コネクタは、MedTech サービスによって成功します。 既存または新しい Azure Health Data Services ワークスペース内に MedTech サービスと対応する FHIR サービスをデプロイし、デバイスを新しい Azure Events Hubs デバイス イベント ハブにポイントする必要があります。 MedTech サービスのデプロイで、既存の IoT コネクタ デバイスと宛先マッピング ファイルを使用します。
既存の IoT コネクタ デバイスの FHIR データを Azure API for FHIR サービスから Azure Health Data Services FHIR サービスに移行する場合は、移行ツールで一括エクスポートおよびインポート機能を使用します。 もう 1 つの移行パスは、新しい MedTech サービスをデプロイし、MedTech サービスを介して IoT デバイス メッセージを再生することです。
手順 2:移行を準備する
まず、移行計画を作成します。 次の表で説明されている移行パターンをお勧めします。 組織のダウンタイムに対する許容度に応じて、移行を容易にするために特定のパターンとツールを使用することを決定できます。
| 移行パターン | 詳細 | 方法はありますか。 |
|---|---|---|
| リフト アンド シフト | 最も簡単なパターンです。 データ パイプラインで長いダウンタイムを許容できる場合に最適です。 | 組織に最適なオプションを選択します: • Azure API for FHIR でデータを $export し、Azure Health Data Services FHIR サービスに $import するワークフロー を構成します。 • GitHub リポジトリには、これらのコマンドの実行に関するヒントと、 $import ペイロードの作成を自動化するためのスクリプトが用意されています。 • $export と $import を使用して、データを移行するための独自のツールを作成します。 |
| 増分コピー | ダウンタイムを短縮したリフトアンドシフトの継続的なバージョン。 コピーに時間がかかる大量のデータや、移行中に引き続き Azure API for FHIR を実行する場合に最適です。 | お客様の組織に最適なオプションをお選びください。 • この移行パターンに役立つ OSS 移行ツール を作成しました。 • データを段階的に移行するための独自のツールを作成します。 |
OSS 移行ツールに関する考慮事項
OSS 移行ツールを使用する場合は、移行ツールの機能と制限事項を確認して理解してください。
Azure API for FHIR サーバーを準備する
移行するデータを特定します。
この機会に、使用しなくなったデータまたは FHIR サーバーをクリーンアップしてください。
履歴バージョンを移行するかどうかを決定します。
新しい Azure Health Data Services FHIR サービス サーバーをデプロイします。
まず、Azure Health Data Services ワークスペースをデプロイします。
次に、Azure Health Data Services FHIR サービス サーバーをデプロイします。 詳細については、「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 Service サーバーが安定していることを確信したら、Azure Health Data Services FHIR サービスの使用を開始して、ビジネス シナリオを満たすことができます。 Azure API for FHIR で実行されている残りのパイプラインをすべてオフにします。 必要に応じて、移行ツールで使用された中間ストレージ アカウントからデータを削除します。 Azure API for FHIR サーバーからデータを削除し、Azure API for FHIR アカウントの使用を停止します。
Note
FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。