從 Azure API for FHIR 移轉的移轉策略
重要
Azure API for FHIR 將於 2026 年 9 月 30 日淘汰。 請依照移轉策略，在該日期前轉換至 Azure 健康資料服務 FHIR 服務。 由於 Azure API for FHIR 已淘汰，因此從 2025 年 4 月 1 日開始，將不允許新的部署。 Azure 健康資料服務 FHIR 服務是 Azure API for FHIR 的進化版本，可讓客戶透過與其他 Azure 服務整合來管理 FHIR、DICOM 和醫療技術服務。
Azure 健康資料服務 FHIR 服務是新一代的健康情況資料整合平台。 此服務提供受控的企業級 FHIR、DICOM 和醫療技術服務，以進行多元化的健康情況資料交換。
當您將 FHIR 資料從 Azure API for FHIR 移轉至 Azure 健康資料服務 FHIR 服務時，您的組織可以從改善的效能、可擴縮性、安全性和合規性中獲益。 組織也可以存取 Azure API for FHIR 中不可用的新功能。
Azure API for FHIR 將於 2026 年 9 月 30 日淘汰，因此您必須儘快將您的 FHIR 資料移轉至 Azure 健康資料服務 FHIR 服務。 為了簡化此過程，我們建立了一些工具和秘訣，協助您評估整備程度、準備資料、移轉應用程式，以及切換至新服務。
建議的方法
若要移轉您的資料，請遵循下列步驟：
- 步驟 1：評估整備程度
- 步驟 2：準備遷移
- 步驟 3：移轉資料和應用程式工作負載
- 步驟 4：從 Azure API for FHIR 切換至 Azure 健康資料服務
步驟 1：評估整備程度
比較 Azure 健康資料服務與Azure API for FHIR 之間的差異。 另外也請檢閱您的架構，並評估是否需要進行任何變更。
| 功能 | Azure API for FHIR | Azure 健康資料服務 |
|---|---|---|
| 設定 | 支援： • 本機 RBAC • SMART on FHIR Proxy |
計劃淘汰： • 本機 RBAC (9/6/23) • SMART on FHIR Proxy (9/21/26) |
| 資料存放磁碟區 | 超過 4 TB | 目前的支援為 4 TB (如果您需要超過 4 TB，請開啟 Azure 支援要求) |
| 資料輸入 | OSS 中可用的工具 | $import 作業 |
| 自動調整 | 依要求支援並須支付費用 | 預設為啟用，不需額外費用 |
| 搜尋參數 | 支援的套件組合類型：批次 • Include 和 revinclude，不支援 iterate 修飾元 • 支援名字、姓氏、出生日期和臨床日期排序 |
支援的套件組合類型：批次和交易 • 可選取的搜尋參數 • Include 和 revinclude，並支援 iterate 修飾元 • 支援字串和 dateTime 欄位排序 |
| 事件 | 不支援 | 支援 |
| 基礎結構 | 支援： • 客戶管理的金鑰 • 跨區域 DR (災害復原) |
支援： • PITR (時間點還原) • 客戶管理的金鑰 近期： • 可用性區域支援 |
可能會影響您的結構的考量事項
同步代理程式即將淘汰。 如果您使用同步代理程式連線至 Dataverse，請參閱資料整合工具組概觀
FHIR Proxy 即將淘汰。 如果您針對事件使用 FHIR Proxy，請參閱內建事件功能。 您可以使用 Azure 健康資料服務工具組來自訂和建置替代方案。
SMART on FHIR Proxy 即將淘汰。 您需要使用 FHIR 適用的 SMART 的新功能。 其他資訊：FHIR 適用的 SMART
Azure 健康資料服務 FHIR 服務不支援本機 RBAC 和自訂授權。 權杖發卡機構授權單位需為執行 FHIR 服務的租用戶的驗證端點。
IoT 連接器僅支援使用 Azure API for FHIR 服務。 IoT 連接器將被醫療技術服務取代。 您需要在現有或新的 Azure 健康資料服務工作區內部署醫療技術服務和對應的 FHIR 服務，並將您的裝置指向新的 Azure 事件中樞裝置事件中樞。 藉助醫療技術服務部署，使用現有的 IoT 連接器裝置和目的地對應檔。
如果您想要將現有的 IoT 連接器裝置 FHIR 資料從 Azure API for FHIR 服務移轉至 Azure 健康資料服務 FHIR 服務，請使用移轉工具中的大量匯出和匯入功能。 另一個移轉路徑是部署新的醫療技術服務，並透過醫療技術服務重新執行 IoT 裝置訊息。
步驟 2：準備遷移
首先建立移轉計劃。 我們建議使用表格中所述的移轉模式。 根據貴組織對停機時間的容忍度，您可能會決定使用特定模式和工具來協助您進行移轉。
| 移轉模式 | 詳細資料 | 怎麼做？ |
|---|---|---|
| 隨即轉移 | 最簡單的模式。 如果您的資料管線可承受更長的停機時間則適用。 | 選擇最適合貴組織的選項： • 設定工作流程以在 Azure API for FHIR 上使用 $export 匯出您的資料，然後使用 $import 匯入至 Azure 健康資料服務 FHIR 服務。 • GitHub 存放庫 提供執行這些命令的秘訣，以及可協助自動化建立 $import 承載的指令碼。 • 或者建立您自己的工具，以使用 $export 和 $import 來移轉資料。 |
| 增量備份 | 直接移轉的持續版本，停機時間較少。 適用於需要較長時間複製的大量資料，或如果您想要在移轉期間繼續執行 Azure API for FHIR。 | 選擇最適合您組織的選項。 • 我們已建立 OSS 移轉工具 ，以協助進行此移轉模式。 • 或者建立您自己的工具，以增量方式移轉資料。 |
OSS 移轉工具考量
如果您決定使用 OSS 移轉工具，請參閱並瞭解移轉工具的功能和限制。
準備 Azure API for FHIR 伺服器
識別要移轉的資料。
請利用這個機會清除您不再使用的資料或 FHIR 伺服器。
決定是否要移轉歷史版本。
部署新的 Azure 健康資料服務 FHIR 服務伺服器。
首先，部署 Azure 健康資料服務工作區。
然後，部署 Azure 健康資料服務 FHIR 服務伺服器。 更多資訊：在 Azure 健康資料服務內部署 FHIR 服務
設定您的新 Azure 健康資料服務 FHIR 服務伺服器。 如果您需要針對新伺服器使用與 Azure API for FHIR 相同的組態，請參閱移轉工具文件中的建議檢查項目清單。 在移轉之前進行設定。
步驟 3：移轉資料
選擇最適合貴組織的移轉模式。 如果您使用 OSS 移轉工具，請遵循 GitHub 上的指示操作。
步驟 4：移轉應用程式和重新進行設定
移轉指向舊版 FHIR 伺服器的應用程式。
變更應用程式上的端點，使其指向新 FHIR 伺服器的 URL。
為這些 app 再次設定權限。
在移轉之後，重新設定新的 Azure 健康資料服務 FHIR 服務伺服器中的任何其餘設定。
如果您想要再次檢查以確定 Azure 健康資料服務 FHIR 服務和 Azure API for FHIR 伺服器具有相同的組態，您可以檢查兩者的中繼資料端點進行比較與比對兩部伺服器。
設定先前在舊版 Azure API for FHIR 伺服器中執行的任何作業 (例如 $export 作業)
步驟 5：切換至 Azure 健康資料服務 FHIR 服務
在您確信 Azure 健康資料服務 FHIR 服務伺服器穩定之後，您就可以開始使用 Azure 健康資料服務 FHIR 服務來滿足您的商務實例。 關閉在 Azure API for FHIR 上執行的任何其餘管線、視需要從移轉工具中使用的中繼儲存體帳戶刪除資料、從 Azure API for FHIR 伺服器刪除資料，以及解除委任您的 Azure API for FHIR 帳戶。